Função de retorno de chamada DLGPROC (winuser.h)

Função de retorno de chamada definida pelo aplicativo usada com as famílias de funções CreateDialog e DialogBox . Ele processa mensagens enviadas para uma caixa de diálogo modal ou modeless. O tipo DLGPROC define um ponteiro para essa função de retorno de chamada. DialogProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

DLGPROC Dlgproc;

INT_PTR Dlgproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parâmetros

unnamedParam1

Tipo: HWND

Um identificador para a caixa de diálogo. Esse parâmetro normalmente é chamado de hWnd.

unnamedParam2

Tipo: UINT

A mensagem. Esse parâmetro normalmente é chamado de uMsg.

unnamedParam3

Tipo: WPARAM

Informações adicionais específicas da mensagem. Esse parâmetro normalmente é chamado de wParam.

unnamedParam4

Tipo: LPARAM

Informações adicionais específicas da mensagem. Esse parâmetro normalmente é chamado de lParam.

Valor de retorno

Tipo: INT_PTR

Normalmente, o procedimento da caixa de diálogo deve retornar TRUE se tiver processado a mensagem e FALSE se não tiver. Se o procedimento da caixa de diálogo retornar FALSE, o gerenciador de diálogo executará a operação de caixa de diálogo padrão em resposta à mensagem.

Se o procedimento da caixa de diálogo processar uma mensagem que exija um valor retornado específico, o procedimento da caixa de diálogo deverá definir o valor retornado desejado chamando SetWindowLong(hwndDlg, DWL_MSGRESULT, lResult) imediatamente antes de retornar TRUE. Observe que você deve chamar SetWindowLong imediatamente antes de retornar TRUE; Fazer isso anteriormente pode fazer com que o valor DWL_MSGRESULT seja substituído por uma mensagem de caixa de diálogo aninhada.

As mensagens a seguir são exceções às regras gerais declaradas acima. Consulte a documentação da mensagem específica para obter detalhes sobre a semântica do valor retornado.

• WM_CHARTOITEM
• WM_COMPAREITEM
• WM_CTLCOLORBTN
• WM_CTLCOLORDLG
• WM_CTLCOLOREDIT
• WM_CTLCOLORLISTBOX
• WM_CTLCOLORSCROLLBAR
• WM_CTLCOLORSTATIC
• WM_INITDIALOG
• WM_QUERYDRAGICON
• WM_VKEYTOITEM

Observações

Você deve usar o procedimento da caixa de diálogo somente se usar a classe de caixa de diálogo para a caixa de diálogo. Essa é a classe padrão e é usada quando nenhuma classe explícita é especificada no modelo da caixa de diálogo. Embora o procedimento da caixa de diálogo seja semelhante a um procedimento de janela, ele não deve chamar a função DefWindowProc para processar mensagens indesejadas. Mensagens indesejadas são processadas internamente pelo procedimento da janela da caixa de diálogo.

Requirements

Consulte também

Conceitual

Caixas de diálogo

WM_INITDIALOG

Referência

CreateDialog

CreateDialogIndirect

CreateDialogIndirectParam

CreateDialogParam

DefWindowProc

Caixa de diálogo

DialogBoxIndirect

DialogBoxIndirectParam

DialogBoxParam

SetFocus