OFNHookProcOldStyle

O procedimento de gancho de OFNHookProcOldStyle é um função callback application-defined ou library-defined que é usado com os Abrir e Salvar como caixas de diálogo comuns. A função recebe mensagens ou notificações destinadas o procedimento caixa de diálogo.

O LPOFNHOOKPROC tipo define um ponteiro para este função callback. OFNHookProcOldStyle é um espaço reservado para o nome função application-defined ou library-defined.

Se você especificar o Sinalizar OFN_EXPLORER quando você cria uma caixa de diálogo comum Abrir ou Salvar como , e você quer um procedimento de gancho, você deve usar um procedimento de gancho do explorador-estilo OFNHookProc.

 (UINT OFNHookProcOldStyle de retorno de chamada HWND  hdlg, / / identificador para a janela de caixa de diálogoUINTpasta uiMsg / / mensagem identificadorWPARAMwParam, / / parâmetro da mensagemLPARAMlParam / / parâmetro da mensagem);
 

Parâmetros

hdlg
Identificador para a janela caixa de diálogo Abrir ou Salvar como a que se destina a mensagem.
pasta uiMsg
Identifica a mensagem sendo recebida.
wParam
Especifica informações adicionais sobre a mensagem. O significado exato depende do valor da pasta uiMsg parâmetro.
lParam
Especifica informações adicionais sobre a mensagem. O significado exato depende do valor da pasta uiMsg parâmetro.

Se a pasta uiMsg parâmetro indica o WM_INITDIALOG mensagem, lParam é um ponteiro para uma estrutura OPENFILENAME contendo que os valores especificados quando a caixa de diálogo comum foi criada.

Retornar valores

Se o procedimento gancho retorna zero, o procedimento de caixa de diálogo padrão processa a mensagem.

Se o procedimento gancho retorna um valor diferente de zero, o procedimento de caixa de diálogo padrão ignora a mensagem.

Observações

Quando você usa o GetOpenFileName ou GetSaveFileName funções para criar uma caixa de diálogo Abrir ou Salvar como de estilo antigo, você pode fornecer um procedimento de gancho de OFNHookProcOldStyle . Para habilitar o procedimento gancho, use a OPENFILENAME estrutura que é passado para a função de criação diálogo. Especifica o ponteiro para o procedimento gancho na lpfnHook membro e especificar o sinalizador OFN_ENABLEHOOK in o sinalizadores membro.

O procedimento de caixa de diálogo padrão processa a mensagem WM_INITDIALOG antes de passá-lo para o procedimento de 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 caixa de diálogo usar como padrão processa a mensagem ou ignora-lo.

Se o procedimento gancho processa a mensagem WM_CTLCOLORDLG, 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 WM_CTLCOLOR message, ela deve retornar um válido identificador pincel de pintura de segundo plano do controle especificado.

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

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

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Definido pelo usuário.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, GetOpenFileName, GetSaveFileName, OFNHookProc, OPENFILENAME, WM_INITDIALOG

Index