Existe uma biblioteca / API para ler o conteúdo de um arquivo de ajuda .hlp?

Question

Eu tenho um arquivo de ajuda para o meu programa e fui solicitado a adicionar uma descrição dos menus em uma barra de ferramentas à medida que o usuário os navega. Por isso, pensei que poderia usar o início da descrição da ajuda do menu, mas não consigo encontrar como acessar o conteúdo dele.

Eu vi o Winelp ter um idioma macro, então imaginei talvez isso, mas não consegui encontrar nenhuma referência sobre isso.

Alguém agora alguns indicadores ou exemplos de quentes para fazer isso?

Answer 1

O utilitário winelpcgi contém código da biblioteca que pode ler arquivos .hlp. A fonte está aqui: link

Eu não usei, então não posso garantir seu uso.

Answer 2

Primeiro, seu sistema de ajuda deve ter um índice em cada tópico que permita que você abra ajuda e que esse tópico apareça (se não, então verifique Ajuda e manual - Isso ajudará você a criar arquivos de ajuda mais completos). No entanto, isso não resolve diretamente seu problema, pois, pelo que eu o entendo, você deseja que isso apareça em uma janela de ferramentas.

Assim, você precisará ir embaixo da superfície e descobrir como o sistema de ajuda usa a chave para extrair as informações apropriadas. No entanto, não é um empreendimento trivial (até onde eu posso dizer) para acessar diretamente um pedaço de texto indexado e específico em um arquivo winelp. Você pode encontrar algumas informações aqui Isso é útil. Você também pode procurar os fóruns no site de ajuda e manual.

Aqui está uma pergunta maior: realmente faz sentido exibir um tópico de ajuda inteiro (mesmo que curto) quando um usuário paira sobre um item ou botão de menu? Não é para mim e passei anos em um grupo de design da interface do usuário no Bell Labs. É a) simplesmente muita informação e b) será visualmente perturbador (e, portanto, incrivelmente irritante) para usuários experientes. A prática aceita aqui é exibir uma janela do hotel de ferramentas com um descritor muito curto (1-4 palavras) do botão ("aberto" ou "arquivo aberto").

Se você deseja que a ajuda esteja disponível para cada item ou botão de menu, sugiro uma das duas alternativas.

Primeiro, considere ter um "modo de cursor de ajuda", onde o cursor usa o ícone de ajuda (uma seta com um ponto de interrogação). O usuário acessa -o através de um botão de ajuda na barra de botões. Quando no modo de cursor de ajuda, um usuário clica em qualquer item os levará ao tópico de ajuda para esse item. Eu sou meio morno para essa abordagem, pois é modal, mas certamente vi isso.

Segundo, você pode simplesmente reforçar seu sistema de ajuda um pouco. Ou seja, crie um tópico em seu sistema de ajuda que apresenta uma captura de tela do seu aplicativo. Nesta captura de tela, crie pontos quentes para cada item de menu e/ou botão e permita que o usuário acesse o tópico apropriado clicando nele. Feito certo, isso dá ao usuário uma chave visual para os tópicos que eles desejam aprender sem interferir na operação normal do seu programa.

O mais importante: antes de fazer todo o trabalho necessário para implementar seu plano atual, seja claro É o plano certo!