Exibir a Ajuda contexto-Sensitive

Artigo
08/25/2010

Ajuda sensível ao contexto, para fins de discussão, refere-se para ajudar o suporte para os controles em uma caixa de diálogo que os usuários o acesso:

Pressionando a tecla F1.
Clicando com o botão direito do mouse em um controle (o que é isto?Obter ajuda).
Usando o ponteiro em forma de ponto de interrogação (o que é isto?Ajuda de ponteiro).

Para cada controle que você deseja oferecer suporte às contexto-ajuda sensível, conjunto o HelpID propriedade True.

Se necessário, adicione htmlhelp.lib à Dependências adicionais propriedade, que é no Entrada página de propriedades de do Vinculador pasta Páginas de propriedades caixa de diálogo.

As informações de fonte para obter ajuda sensível ao contexto são armazenadas em um arquivo .txt que você inclui em seu projeto HTML Help.

Para criar o contexto-ajuda relacionada ao arquivo de texto

Use um editor de texto para criar um arquivo .txt.
Formate sistema autônomo tópicos da seguinte maneira:

.topic 1

help text for control 1

.topic 2

help text for control 2

Observação:
Para obter mais informações, consulte "Designing contexto-ajuda sensível ao" na Ajuda on-line da Ajuda em HTML.Do Ajuda menu (no HTML Help Workshop), escolher Tópicos da Ajuda.

Depois de criar o arquivo .txt, adicioná-lo à seção [Files] do arquivo .hhp.

Para oferecer suporte a Ajuda para recursos em uma caixa de diálogo, você deve criar uma matriz bidimensional que mapeia IDs para ajudar a (números de tópico) IDs de controle.

Para criar a matriz bidimensional

No arquivo .cpp, para cada classe que representa uma caixa de diálogo Adicione uma matriz bidimensional ao participante da classe.Por exemplo:
```
static DWORD myarray[] = {
   IDC_CHECK1, 1,
   IDC_BUTTON1, 2,
   IDC_EDIT1, (DWORD)-1,
   0,0
};
```

Uma ID de recurso para um controle de caixa de diálogo com um número de tópico de pares de cada entrada na matriz bidimensional de contexto-ajuda relacionada ao arquivo de texto.Se não quiser que um recurso específico para que o que é isto?Ajudá-lo, use – 1.O último emparelhar nessa matriz deve ser de 0,0.

F1 acesso à Ajuda sensível ao contexto significa que os usuários poderão pressionar F1 quando um controle tem o foco para acessar a Ajuda.

Habilitar acesso F1 contexto-Ajuda relacionada

Implementar um manipulador para o WM_HELPINFO mensagem (em cada classe de caixa de diálogo onde você deseja que F1 acesso à ajuda contextual) e implementar o seguinte código para o manipulador:

BOOL CMyDlg::OnHelpInfo(HELPINFO* pHelpInfo)
{
   BOOL bRet = TRUE;

   if (pHelpInfo->iContextType == HELPINFO_WINDOW)
   {
      HWND hwnd = ::HtmlHelp(
         (HWND)pHelpInfo->hItemHandle,
         _T("my_chm.chm::/ctrlhlp.txt"),
         HH_TP_HELP_WM_HELP,
         (DWORD)(LPVOID)myarray);
      bRet = (NULL != hwnd);
   }

   return bRet;
}

O que é isto?Ajuda exibe a Ajuda do controle quando o usuário clica com o botão direito do mouse no controle.

Para implementar com o botão direito do mouse, o que é isto?Help

Implementar um manipulador (consulte Mapeamento de mensagens para funções) o WM_CONTEXTMENU mensagem em cada classe de caixa de diálogo onde você deseja que o que é isto?Ajuda (selecionar a ID para a caixa de diálogo da lista de IDs de objeto).Implemente o seguinte código para o manipulador:
```
void CMyDlg::OnContextMenu(CWnd* pWnd, CPoint point)
{
   UNREFERENCED_PARAMETER(point);

   ::HtmlHelp(
      pWnd->GetSafeHwnd(),
      _T("my_chm.chm::/ctrlhlp.txt"),
      HH_TP_HELP_CONTEXTMENU,
      (DWORD)(LPVOID)myarray);
}
```

Quando você especifica o arquivo .chm, o local esperado é o diretório de trabalho do projeto.Consulte o Depurar Guia de do Páginas de propriedades caixa de diálogo para o local do diretório de trabalho (por padrão, o diretório do projeto).Quando você especifica o arquivo de texto em .chm que contém o contexto-ajuda sensível, você deve especificar sistema autônomo informações local mesmo sistema autônomo especificadas para o arquivo .txt no arquivo de .hhp do chm.

Se já implementar F1 acesso à ajuda contextual, você pode habilitar com com facilidade o que é isto?ponteiro faz com que um ponto de interrogação aparecem na BAR de título, no canto superior direito da caixa de diálogo.

Para habilitar a que é isto?Ajudar o ponteiro em forma de ponto de interrogação

selecionar o Ajuda de contexto caixa de seleção a Estilos estendidosGuia de das propriedades de caixa de diálogo.

Consulte também

Conceitos

Ajuda em HTML: Ajuda sensível ao contexto para os programas

Compartilhar via