Suporte de ajuda

Caixas de diálogo comuns fornecem ajuda Contextoual para controles padrão da caixa de diálogo. Para fornecer ajuda adicional para uma caixa de diálogo comum, você pode exibir um botão Ajuda e processar mensagens geradas quando o usuário clica no botão. O botão Ajuda é um suplemento para o padrão ajuda sensível ao contexto. O botão Ajuda é útil para descrever o propósito geral da caixa de diálogo, como ela se aplica ao seu aplicativo.

Ajuda sensível ao contexto

Todas as caixas de diálogo comuns fornecem ajuda Contextoual para controles padrão da caixa de diálogo. O usuário pode exibir a ajuda para controles individuais por qualquer um dos seguintes métodos:

Se você personalizar uma caixa de diálogo, adicionar novos controles, você também deve estender o suporte de ajuda para esses controles pelo tratamento dos pedidos de ajuda no procedimento de gancho. O procedimento gancho recebe as seguintes mensagens quando o usuário solicita ajuda.

Ação do usuário Mensagem
O usuário clicou o botão direito do mouse sobre um controle. WM_CONTEXTMENU
O usuário pressionou a tecla f1. WM_HELP
O usuário clicou no botão ? na barra de título e, em seguida, clicou em um controle. WM_HELP

Você deve processar essas mensagens para os controles que você adicionou, mas deixe-o procedimento de caixa de diálogo padrão processa as mensagens para os controles padrão. Para obter mais informações sobre como processar essas mensagens, consulte o visão geral da Ajuda.

Botão de ajuda

Você pode exibir um botão Ajuda em qualquer uma das caixas de diálogo comuns por configuração um valor SHOWHELP na sinalizadores membro da estrutura de inicialização para a caixa de diálogo. Se você exibir o botão de Ajuda , você deve processar a solicitação do usuário para obter ajuda. O tratamento pode ser feito em um dos procedimentos de janela do aplicativo ou em um procedimento de gancho de caixa de diálogo. Normalmente, você iria processar o pedido de ajuda, chamando o WinHelp função.

Para processar mensagens de ajuda em um dos seus procedimentos de janela, você deve obter um identificador de mensagem para a Cadeia de caracteres definida pelo valor HELPMSGSTRING e identificar a janela para receber mensagens. Para obter o identificador de mensagem, especifique HELPMSGSTRING como o parâmetro em uma chamar para o RegisterWindowMessage função. Quando você cria a caixa de diálogo comum, use o hwndOwner membro da estrutura de inicialização de caixa de diálogo para identificar a janela que receberá as mensagens. O procedimento caixa diálogo envia a mensagem para o procedimento de janela quando o usuário clica no botão Ajuda.

Para processar mensagens de ajuda em um procedimento de gancho, você deve Processoar a mensagem WM_COMMAND . O procedimento de gancho fornece ajuda se o parâmetro wParam dessa mensagem indica que o usuário clicou no botão Ajuda . O identificador do botão de Ajuda é a constante de pshHelp definida no DLGS.Arquivo H.

Procedimentos de gancho para os estilo do Explorer Abrir e Salvar como caixas de diálogo comuns não receber WM_COMMAND mensagens para o botão de Ajuda . Em vez disso, a caixa de diálogo envia uma mensagem de notificação CDN_HELP para o procedimento gancho quando o botão Ajuda é clicado.

Index