CFHookProc

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/9/2008

Essa função recebe mensagens destinadas o procedimento caixa de diálogo usar como padrão das Fonte caixa diálogo. Essa função é um função callback Application-defined que você usar com ChooseFont (função).

O LPCFHOOKPROC tipo define um ponteiro para este função callback. CFHookProc é um espaço reservado para o nome função Application-defined.

Syntax

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

Parameters

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

uiMsg
[no] Inteiro sem sinal que 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 CHOOSEFONT (estrutura), que contém os valores que o aplicativo especificado quando ele criado caixa de diálogo.

Return Value

Return zero se você desejar o procedimento caixa de diálogo usar como padrão ao processo de mensagem. Return de diferente de zero valor se você desejar o procedimento caixa de diálogo usar como padrão para ignorar a mensagem.

Remarks

Para todas as plataformas

Quando você usa o ChooseFont função para criar um Fonte caixa diálogo, você pode fornecer um CFHookProc função gancho às mensagens processo destinadas o procedimento caixa de diálogo. Para habilitar a função gancho, use o CHOOSEFONT estrutura que é passado para ChooseFont. Especificar o endereço da função gancho in a lpfnHook membro de CHOOSEFONT e especificar CF_ENABLEHOOK in a Sinalizadores membro.

O procedimento caixa de diálogo usar como padrão processa a mensagem WM_INITDIALOG antes de passar a mensagem para CFHookProc. Para todas as outras mensagens, a função gancho recebe a mensagem primeiro. O valor de retorno da função de gancho, em seguida, determina se o procedimento caixa diálogo usar como padrão processa ou ignora a mensagem.

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

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

Você pode subclasse controla o padrão de um caixa de diálogo comum. O procedimento caixa de diálogo, no entanto, pode também subclasse de controles. Portanto, você deverá controles subclasse quando sua função gancho processa a mensagem WM_INITDIALOG. Isso garante que a função subclasse recebe as mensagens de controle-específica antes de função subclasse definido pelo procedimento caixa de diálogo.

Para Windows incorporado CE

Procedimento de gancho pode enviar o WM_CHOOSEFONT_GETLOGFONT mensagem para caixa de diálogo para recuperar o atual valores de caixa de diálogo.

Requirements

Header	commdlg.h
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via