Função BeginDeferWindowPos (winuser.h)

Aloca memória para uma estrutura de posição de várias janelas e retorna o identificador para a estrutura.

Sintaxe

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

Parâmetros

[in] nNumWindows

Tipo: int

O número inicial de janelas para as quais armazenar informações de posição. A função DeferWindowPos aumenta o tamanho da estrutura, se necessário.

Retornar valor

Tipo: HDWP

Se a função for bem-sucedida, o valor retornado identificará a estrutura de várias posições de janela. Se recursos insuficientes do sistema estiverem disponíveis para alocar a estrutura, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A estrutura de posição de várias janelas é uma estrutura interna; um aplicativo não pode acessá-lo diretamente.

DeferWindowPos preenche a estrutura de várias posições de janela com informações sobre a posição de destino para uma ou mais janelas prestes a serem movidas. A função EndDeferWindowPos aceita o identificador dessa estrutura e reposiciona as janelas usando as informações armazenadas na estrutura.

Se o sistema precisar aumentar o tamanho da estrutura de posição de várias janelas além do tamanho inicial especificado pelo parâmetro nNumWindows , mas não puder alocar memória suficiente para fazer isso, o sistema falhará em toda a sequência de posicionamento da janela (BeginDeferWindowPos, DeferWindowPos e EndDeferWindowPos). Ao especificar o tamanho máximo necessário, um aplicativo pode detectar e processar a falha no início do processo.

Requisitos

Confira também

Conceitual

Deferwindowpos

Enddeferwindowpos

Referência

Setwindowpos

Windows