Artigo: 315988 - Última revisão: segunda-feira, 25 de Novembro de 2002 - Revisão: 1.1

COMO: Utilizar a ajuda de HTML a partir do Visual Basic 6.0

Vista lado a ladoClique aqui para exibir o artigo traduzido e o artigo original em inglês, lado a lado.
Tradução automáticaVer isenção de responsabilidades para tradução automática
Ver produtos para os quais este artigo se aplica.
Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Reduzir tudo

Sumário

Este artigo descreve como chamar ajuda HTML a partir de uma aplicação do Visual Basic 6.0.

O ponto de entrada principal para HTMLHelp operações no Visual Basic é a função HTMLHelp . Esta função de API de programação de aplicação é declarada da seguinte forma: 
Private Declare Function HTMLHelp Lib "HHCtrl.ocx" Alias "HTMLHelpA" _
    (ByVal hWndCaller As Long, _
     ByVal pszFile As String, _
     ByVal uCommand As Long, _
     dwData As Any) As Long
o primeiro parâmetro representa uma janela principal da aplicação. O segundo parâmetro é o nome do ficheiro compilado (.chm) que contém os dados de ajuda. O terceiro parâmetro é um valor que representa um comando HTMLHelp . O quarto parâmetro é mais dados, o valor e formato dos quais depende o comando HTMLHelp .

Nota : O quarto parâmetro está declarado como 'como qualquer"(sem as aspas). O tipo real dos dados que tem de ser fornecidos depende do comando HTMLHelp que está a ser utilizado. Tenha cuidado para passar os valores de dados apropriados para o comando HTMLHelp estiver a utilizar. O programa de exemplo neste artigo demonstra como utilizar alguns destes comandos HTMLHelp .

Voltar ao topo

Requisitos

Os seguintes itens descrevem de hardware recomendados, software, infra-estrutura de rede, competências e conhecimentos e service packs que terá.
  • HTML Help 1.3 (http://www.microsoft.com/downloads/details.aspx?FamilyID=2363a6fc-cb70-464d-85e6-f598c11ccecf)
Dados de conhecimento anterior necessários:
  • Deverá ter conhecimentos de desenvolvimento do Visual Basic.
Voltar ao topo

Criar um ficheiro de ajuda HTML

  1. Clique em Iniciar , aponte para programas e, em seguida, clique em HTML Help Workshop duas vezes para iniciar o HTML Help Workshop.
  2. No menu ficheiro , clique em Novo .
  3. Na caixa de diálogo Novo , clique em projecto e, em seguida, clique em OK . O Assistente de novo projecto é iniciado.
  4. Siga estes passos no Assistente de novo projecto:
    1. Na primeira caixa de diálogo, prima seguinte .
    2. Na caixa de diálogo destino , introduza os nomes de ficheiro para o projecto ajuda da pasta e e, em seguida, clique em seguinte . A seguinte pasta e nome de ficheiro são exemplos:
      C:\Documents and Settings\ < o seu nome de utilizador > \My Documents\HHDemo\HHDemo.hhp
    3. Na caixa de diálogo Ficheiros existentes , prima seguinte .
    4. Clique em Concluir para criar um projecto em branco.
  5. No menu ficheiro , clique em Novo .
  6. Na caixa de diálogo Novo , clique em Ficheiro HTML , escreva predefinido para o título, clique em OK , escreva predefinida entre as tags <body> e </body> e, em seguida, guarde este ficheiro como default.htm.
  7. No menu ficheiro , clique em Novo .
  8. Na caixa de diálogo Novo , clique em Ficheiro HTML , escreva o Tópico de exemplo para o título, clique em OK , escreva o Tópico de exemplo entre as tags <body> e </body> e, em seguida, guarde este ficheiro como exemplo.htm.
  9. Na barra de ferramentas para a esquerda na janela HTML Help Workshop , clique em Adicionar/remover ficheiros de tópicos .
  10. Clique em Adicionar , procurar o ficheiro default.htm e o ficheiro exemplo.htm na caixa de diálogo selecção de ficheiros , clique em Abrir e, em seguida, clique em OK . Os dois ficheiros agora são listados na secção ficheiros à esquerda da janela do HTML Help Workshop .
  11. Abra um editor de texto, tal como o bloco de notas, e escreva o contexto seguinte ID: 
    #define DEFAULT 100
#define SAMPLE 101
    guardar o ficheiro como Map.h na mesma pasta que os outros HTMLHelp projecto ficheiros que tenha criado.
  12. Na barra de ferramentas para a esquerda na janela HTML Help Workshop HTML Help Workshop , clique em informações de API HtmlHelp , clique em Ficheiro de cabeçalho , escreva o nome do ficheiro Map.h e, em seguida, clique duas vezes em OK .
  13. No menu ficheiro , clique em Guardar todos os ficheiros .
  14. No menu ficheiro , clique em Compilar .
  15. Na caixa de diálogo criar um ficheiro compilado , clique em Compilar . Isto cria um ficheiro de ajuda HTML compilado denominado HHDemo.chm.
Voltar ao topo

Validar o ficheiro de ajuda

  1. Abra o ficheiro HHDemo.chm no Explorador do Windows.
  2. Quando abre a janela HTMLHelp , uma das páginas tópico aparece.
Voltar ao topo

Criar uma aplicação do Visual Basic que utiliza o ficheiro de ajuda

  1. Inicie um novo projecto do Visual Basic 6.0 Standard EXE.
  2. Adicione dois botões de comando ao Form1. Os botões têm os nomes predefinidos Command1 e Command2.
  3. Adicione o seguinte código à secção General Declarations do Form1: 
    Option Explicit

Private Declare Function HtmlHelp Lib "HHCtrl.ocx" Alias "HtmlHelpA" _
    (ByVal hWndCaller As Long, _
     ByVal pszFile As String, _
     ByVal uCommand As Long, _
     dwData As Any) As Long

Const HH_DISPLAY_TOPIC As Long = 0
Const HH_HELP_CONTEXT As Long = &HF

Private Sub Form_Load()
    ChDir App.Path
End Sub

Private Sub Command1_Click()
    HtmlHelp hWnd, "HHDemo.chm", HH_DISPLAY_TOPIC, ByVal "Sample.htm"
End Sub

Private Sub Command2_Click()
    HtmlHelp hWnd, "HHDemo.chm", HH_HELP_CONTEXT, ByVal 100&
End Sub
  4. Guarde os ficheiros para este projecto na mesma pasta que o ficheiro de HTMLHelp exemplo.
Voltar ao topo

Verificar se funciona

  1. Criar e executar a aplicação.
  2. Clique em Command1 . O programa HTMLHelp mostra o ficheiro de exemplo.htm tópico. Esta técnica utiliza uma procura por nome do tópico.
  3. Clique em Command2 . O programa HTMLHelp mostra o ficheiro default.htm do tópico. Esta técnica utiliza uma procura por ID de contexto.
Voltar ao topo

REFERÊNCIAS

Para obter informações adicionais sobre como utilizar a ajuda HTML no Visual Basic, clique os números de artigo existente abaixo para visualizar os artigos na base de dados de conhecimento da Microsoft:
183434  (http://support.microsoft.com/kb/183434/EN-US/ ) COMO: Utilizar a API de ajuda HTML de uma aplicação do Visual Basic
286404  (http://support.microsoft.com/kb/286404/EN-US/ ) COMO: Adicionar ajuda HTML para uma aplicação do Visual Basic 6.0 aplicação Assistente
1.3 Do SDK de ajuda de HTML contém mais informações sobre a função HTMLHelp .

Voltar ao topo
A informação contida neste artigo aplica-se a:
  • Microsoft Visual Basic 6.0 Professional Edition
  • Microsoft Visual Basic Enterprise Edition for Windows 6.0
Voltar ao topo
Palavras-chave: 
kbmt kbapi kbhowto kbhowtomaster KB315988 KbMtpt
Voltar ao topo
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine translation ou MT), não tendo sido portanto revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais. O objectivo é simples: oferecer em Português a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradução automática não é sempre perfeita. Esta pode conter erros de vocabulário, sintaxe ou gramática? erros semelhantes aos que um estrangeiro realiza ao falar em Português. A Microsoft não é responsável por incoerências, erros ou estragos realizados na sequência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualizações frequentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 315988  (http://support.microsoft.com/kb/315988/en-us/ )
Voltar ao topo