CCHookProc

9/9/2008

Essa função é um função callback Application-defined ou Library-defined que é usada com o Cor caixa de diálogo comum. CCHookProc recebe mensagens ou notificações destinadas o procedimento caixa de diálogo usar como padrão.

Syntax

UINT APIENTRY CCHookProc(
  HWND hdlg, 
  UINT uiMsg, 
  WPARAM wParam, 
  LPARAM lParam
);

Parameters

• hdlg
  [no] Identificador para o Cor janela caixa diálogo para o qual a mensagem destina.

• uiMsg
  [no] Identifica a mensagem sendo recebida.

• wParam
  [no] Especifica informações adicionais sobre a mensagem. O significado exato depende de como o valor da uiMsg parâmetro.

• lParam
  [no] Especifica informações adicionais sobre a mensagem. O significado exato depende de como o valor da uiMsg parâmetro.

  Se a pasta uiMsg parâmetro indica o WM_INITDIALOG mensagem, lParam é um ponteiro para um CHOOSECOLOR (estrutura) contendo os valores especificados quando o diálogo foi criado.

Return Value

Zero indica que o procedimento caixa diálogo usar como padrão processa a mensagem. Nonzero indica que o procedimento caixa diálogo usar como padrão Ignora a mensagem.

Remarks

Quando você usa o ChooseColor (função) função para criar um Cor caixa diálogo, você pode fornecer um CCHookProc procedimento gancho para processo mensagens ou notificações destinadas o procedimento caixa de diálogo. Para habilitar o procedimento gancho, use o CHOOSECOLOR estrutura que é passado para a função de criação diálogo. Especificar o endereço do procedimento de gancho in a lpfnHook membro e especificar o sinalizador CC_ENABLEHOOK in a Sinalizadores membro.

O procedimento caixa de diálogo usar como padrão processa a mensagem WM_INITDIALOG antes de transmiti-la para o procedimento gancho. Para todas as outras mensagens, o procedimento gancho recebe a mensagem primeiro. Em seguida, o valor de retorno do procedimento de gancho determina se o procedimento diálogo usar como padrão processa a mensagem ou ignora-lo.

Se o procedimento gancho processa o WM_CTLCOLORDLG mensagem, ela deve retornar um válido identificador pincel de pintura de segundo plano da caixa de diálogo. Em geral, se o procedimento gancho processa qualquer mensagem WM_CTLCOLOR*, ela deve retornar um válido identificador pincel de pintura de segundo plano do controle especificado.

Fazer não chamar o EndDialog função do procedimento de gancho. Em vez disso, o procedimento gancho pode chamar o PostMessage função para postagem uma mensagem WM_COMMAND com o valor para o procedimento caixa de diálogo IDABORT. Lançamento IDABORT fecha a caixa diálogo e faz com que a função caixa diálogo para retornar FALSE. Se você precisa saber por que o procedimento gancho fechado o caixa de diálogo, você deverá fornecer seu próprio mecanismo de comunicação entre o procedimento gancho e seu aplicativo.

Você pode subclasse controla o padrão da caixa de diálogo comum. No entanto, o procedimento caixa de diálogo comum pode também subclasse de controles. Devido a isso, você deve subclasse controles quando o procedimento gancho processa a mensagem WM_INITDIALOG. Isso garante que o procedimento subclasse recebe as mensagens de controle-específica antes o procedimento subclasse definido pelo procedimento caixa de diálogo.

Requirements

Header	commdlg.h
Windows Embedded CE	Windows CE 2.0 and later

See Also

Reference

ChooseColor (function)
EndDialog
PostMessage
WM_INITDIALOG
WM_CTLCOLORDLG
CHOOSECOLOR (structure)