Projeto Aprenda em Casa - Cursos gratuitos

Clube VB - Gerando arquivos de Help para aplicações VB - Parte VI

Aula 44

Na verdade, linkar o arquivo de ajuda é muito mais fácil do que propriamente criar o mesmo. Podemos utilizar o arquivo gerado de duas formas:

1. Chamando o arquivo por inteiro, e neste caso o usuário irá navegar dentro das opções disponíveis;

2. Chamando por um dos níveis de tópicos criados, desta forma, você estaria linkando o Help a um assunto em específico, por intermédio por exemplo de um menu.

Iremos primeiramente estudar a opção 01. O processo para se linkar um HELP a sua aplicação, sendo que esta ligação seja feita com o total conteúdo do HELP é simples, observe os passos a seguir:

1. acesse o menu Project, escolha o item Project Properties...;

Na janela que aparece, na aba General, selecione no campo Help File Name o arquivo Help que você deseja utilizar no projeto. Observe que o VB suporta arquivos de help tanto no formato HLP quanto no formato CHM:

2. Para visualizarmos como um projeto chama o help, compile o projeto e quando ele estiver sendo executado, clique em F1 para que o help seja visualizado

Agora, vamos dificultar um pouco o processo, fazendo com que o sistema possa abrir os arquivos de HELP através dos tópicos gerados. Mas como isso é possível? A resposta é simples:

Você lembra que ao criar a sua janela de HELP, utilizou o mapeamento dos tópicos através da janela MAP? Onde, incluímos para o tópico CONTEÚDO o MAP 100 e assim sucessivamente? Pois então, desta forma podemos dentro de nossa aplicação, chamar um assunto em específico no HELP, para isso, basta proceder da forma que segue:

1. Inclua na aplicação que irá receber o HELP um componente COMMON DIALOG;

2. Altere a propriedade NAME do mesmo para AJUDA;

3. Clique com o botão direito do mouse em PROJECT1, no PROJECT EXPLORER;

4. No menu suspenso que é apresentado, selecione a opção PROJECT PROPERTIES;

5. Na caixa de diálogo que foi aberta, defina o campo HELP FILE como o arquivo de ajuda a ser vinculado ao aplicativo;

6. No evento FORM_LOAD() do formulário, entre com a seguinte codificação:

AJUDA.HELPFILE=APP.HELPFILE

7. Lembre-se de que “AJUDA” equivale ao componente COMMON DIALOG que representará o arquivo ajuda;

8. Em seguida, na opção de menu ou no botão que irá chamar um determinado tópico do arquivo de ajuda, basta incluir a seguinte sequência de comandos (supondo que a solicitação da abertura da ajuda, partisse de uma opção de menu) :

Private Sub opcaoajuda_click()

With ajuda

.helpcontext=”100”

.helpcommand=cdlhelpcontext

.ShowHelp

End With

End Sub

Observe que a linha HELPCONTEXT=”100”, representa um dos tópicos que queremos ligar a esta opção do menu que abre o arquivo de ajuda, neste nosso exemplo, a mesma poderia ser 100/200 ou 300.

Desta forma você vinculou o seu arquivo de ajuda a sua aplicação principal.

Voltar