Função BeginDeferWindowPos (winuser.h)

Artigo
08/27/2023

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

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-window-l1-1-4 (introduzido no Windows 10, versão 10.0.14393)