Compartilhar via


WM_PAINT

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Enviada por um aplicativo quando Windows ou outro aplicativo faz uma solicitação para tinta uma parte da janela de um aplicativo.

Syntax

WM_PAINT hdc = (HDC) wParam;

Parameters

  • hDC
    Identificador de contexto de dispositivo (hDC) na qual desenhar.

    Se este parâmetro é NULL, use o contexto dispositivo usar como padrão.

    Este parâmetro é usado por alguns comum controles para habilitar desenho em um contexto dispositivo Other Than o contexto dispositivo usar como padrão.

    Outras Janelas segura podem ignorar esse parâmetro.

Return Value

Um aplicativo deve retornar zero se ele processa esta mensagem.

Remarks

Envia um aplicativo de WM_PAINT mensagem quando a sistema operacional ou outro aplicativo faz uma solicitação para tinta uma parte da janela do aplicativo. Esta mensagem é enviada quando UpdateWindow é chamado, ou ele é enviado por DispatchMessage quando o aplicativo obtém um WM_PAINT mensagem por chamado GetMessage ou PeekMessage. A seqüência de eventos segue esta ordem:

  • DispatchMessage determina para onde enviar esta mensagem.
  • GetMessage Ou PeekMessage Determina qual mensagem para distribuir e retorna essa mensagem quando não houver nenhuma outra mensagem em fila de mensagens do aplicativo.
  • DispatchMessage Envia esta mensagem para o apropriado procedimento janela.

O sistema envia um interno WM_PAINT mensagem somente uma vez. Depois da mensagem interna é retornada pelo GetMessage Ou PeekMessage, ou é enviado para uma janela por UpdateWindow, o sistema não postagem ou enviar qualquer mais WM_PAINT As mensagens até que a janela é invalidada.

Um aplicativo deve chamar BeginPaint e EndPaint na resposta para WM_PAINT As mensagens ou transmitir a mensagem para o DefWindowProc função para validar a janela. DefWindowProc Valida a região atualização; Ele pode enviar a mensagem WM_ERASEBKGND Se segundo plano a janela precisa ser apagados.

Além disso, um aplicativo deve verificar para pintura interna necessária examinando suas estruturas internas dados para cada WM_PAINT mensagem, pois um WM_PAINT mensagem pode ter sido causada por um não-NULL atualização.

Para alguns comum controles, o usar como padrão WM_PAINT mensagem processamento verifica o wParam parâmetro. Se wParam não-NULL, o controle assume que o valor é um identificador para um contexto dispositivo (hDC) e pinta usando esse contexto dispositivo.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

BeginPaint
DefWindowProc
DispatchMessage
EndPaint
GetMessage
GetUpdateRect
PeekMessage
UpdateWindow
WM_ERASEBKGND