BeginDeferWindowPos

9/9/2008

Essa função aloca memória para um múltiplo-estrutura posição janela e retorna o identificador para a estrutura.

Syntax

HDWP BeginDeferWindowPos( 
  int nNumWindows 
);

Parameters

• nNumWindows
  [no] Especifica o número inicial do Windows para o qual a armazenar informações posição. O DeferWindowPos função aumenta o tamanho da estrutura, se necessário.

Return Value

Se a função for bem-sucedido, o valor de retorno identifica o múltiplo-janela — estrutura posição. NULL Indica que são recursos sistema insuficiente disponível para alocar a estrutura. Para informações de erro estendidas get, chamar GetLastError.

Exemplo de código

Aqui, BeginDeferWindowPos é usado para informações get na ordem a atualização uma janela.

void DXView_OnSize(HWND hWnd)
{
    HDWP hDWP;
    RECT ClientRect;
    int Height;
    HWND hKeyTreeWnd, hValueListWnd;
    int x;
    int dx;
    if ((hDWP =  BeginDeferWindowPos (2)) != NULL)
    {
        GetClientRect(hWnd, &ClientRect);
...
}

Remarks

O múltiplo-janela — estrutura posição é uma estrutura interna; Um aplicativo não é possível acessá-la diretamente.

DeferWindowPos Preenche o múltiplo-janela — estrutura posição com informações sobre a posição destino para um ou mais janelas prestes a ser movido. O EndDeferWindowPos função aceita o identificador para essa estrutura e reposiciona os Windows usando as informações armazenadas de estrutura.

Se algum das janelas de múltiplo-janela — estrutura posição têm o conjunto sinalizador SWP_HIDEWINDOW ou SWP_SHOWWINDOW, nenhum das janelas são reposicionados.

Se o sistema deve aumentar o tamanho do múltiplo-janela — estrutura posição além de tamanho inicial especificado pelo nNumWindows parâmetro, mas não é possível alocar memória suficiente para fazer isso, o sistema falha posicionamento de janela inteira (seqüênciaBeginDeferWindowPos, DeferWindowPos, e EndDeferWindowPos). Especificando o tamanho máximo necessário, um aplicativo pode detecção e processo falha no início do processo.

Requirements

See Also

Reference

DeferWindowPos
EndDeferWindowPos
Windows Functions