Função BeginPaint (winuser.h)
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) |