Função BeginPaint (winuser.h)

Artigo
03/09/2024

A função BeginPaint prepara a janela especificada para pintura e preenche uma estrutura PAINTSTRUCT com informações sobre a pintura.

Sintaxe

HDC BeginPaint(
  [in]  HWND          hWnd,
  [out] LPPAINTSTRUCT lpPaint
);

Parâmetros

[in] hWnd

Manipule para a janela a ser repintada.

[out] lpPaint

Ponteiro para a estrutura PAINTSTRUCT que receberá informações de pintura.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o identificador para um contexto de dispositivo de exibição para a janela especificada.

Se a função falhar, o valor retornado será NULL, indicando que nenhum contexto de dispositivo de exibição está disponível.

Comentários

A função BeginPaint define automaticamente a região de recorte do contexto do dispositivo para excluir qualquer área fora da região de atualização. A região de atualização é definida pela função InvalidateRect ou InvalidateRgn e pelo sistema após o dimensionamento, movimentação, criação, rolagem ou qualquer outra operação que afete a área do cliente. Se a região de atualização estiver marcada para apagar, BeginPaint enviará uma mensagem WM_ERASEBKGND para a janela.

Um aplicativo não deve chamar BeginPaint , exceto em resposta a uma mensagem WM_PAINT . Cada chamada para BeginPaint deve ter uma chamada correspondente para a função EndPaint .

Se o cursor estiver na área a ser pintada, BeginPaint ocultará automaticamente o cursor para evitar que ele seja apagado.

Se a classe da janela tiver um pincel de plano de fundo, BeginPaint usará esse pincel para apagar a tela de fundo da região de atualização antes de retornar.

Virtualização de DPI

Essa API não participa da virtualização de DPI. A saída retornada é sempre em termos de pixels físicos.

Exemplos

Para obter um exemplo, consulte Desenho na Área do Cliente.

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-draw-l1-1-0 (introduzido em Windows 8)