Suporte de Ajuda para Usuários do Visual Basic 6.0

Artigo
08/25/2010

Este tópico compara o suporte de ajuda no Visual Basic 6.0 com seu equivalente no Visual Basic 2008.

A maioria dos aplicativos fornecem ajuda para usuários sob a forma de um arquivo ajuda, ajuda pop-up, e / ou dicas de ferramentas.Embora o Visual Basic 6.0 e Visual Basic 2008 suporte a todos os três mecanismos de Ajuda, os métodos de implementá-los diferem consideravelmente.

Diferenças Conceituais

No Visual Basic 6.0, O Help pode ser fornecido usando tanto a ajuda HTML ou o antigo formato de ajuda do Windows.In Visual Basic 2008, há suporte apenas para ajuda HTML.

O suporte de ajuda no Visual Basic 6.0 foi implementado em uma base por projeto especificando um nome de arquivo ajuda na caixa de diálogo Project Properties.Cada formulário e controle tinha um HelpContextID propriedade que pode ser usada para vincular a um tópico específico no arquivo de Ajuda.

Suporte de ajuda no Visual Basic 2008 é implementado em uma base por formulário, adicionando um ou mais HelpProvider componentes a um formulário. Cada formulário e controle tem HelpKeyword e HelpNavigator propriedades que foram usadas para vincular a um tópico específico. Para obter mais informações, consulte Como: Exibir a Ajuda em um aplicativo do Windows.

Ajuda Pop-up

A ajuda pop-up no Visual Basic 6.0 foi implementado usando o WhatsThisButton e WhatsThisHelp Propriedades de um formulário. The O que é isto botão aparecia se WhatsThisButton foi True tanto o MaxButton e MinButton propriedades foram False. Configurando o WhatsThisMode propriedade no código ativava o botão.

Ajuda pop-up no Visual Basic 2008 é implementada usando o HelpButton propriedade de um formulário. The Ajuda botão aparece somente se o HelpButton propriedade estiver definida como True tanto o MaximizeBox e MinimizeBox propriedades são definidas como False; o botão é automaticamente ativado. Para obter mais informações, consulte Como: Ajuda Pop-up Exibir.

Dicas de Ferramentas

As dicas de ferramentas no Visual Basic 6.0 foram implementadas usando o ToolTipText propriedade de um controle.

Dicas de ferramentas no Visual Basic 2008 são implementadas adicionando um ToolTip componente a um formulário. Para obter mais informações, consulte Suporte dica de ferramenta para usuários do Visual Basic 6.0.

Método ShowHelp

No Visual Basic 6.0, ajuda também pode ser exibida usando um ShowHelp método de um CommonDialog controle para em em aberto a Ajuda do Windows. A Ajuda do Windows não tem suporte no Visual Basic 2008 e não há nenhum controle equivalente para exibir a Ajuda.

Alterações de Código para o Suporte de Ajuda

O código a seguir ilustra as diferenças na codificação técnicas entre o Visual Basic 6.0 e Visual Basic 2008 para alguns usos comuns das propriedades do Help.

Especificando um Arquivo de Ajuda

O exemplo a seguir demonstra como especificar um arquivo de ajuda para seu aplicativo, assumindo que o formulário tem dois OptionButton controles que permitem que o usuário escolher entre arquivos de ajuda inglês e francês.

' Visual Basic 6.0

If Option1(0).Value = True Then

App.HelpFile = App.Path & "\EnglishHelp.chm"

Else

App.HelpFile = App.Path & "\FrenchHelp.chm"

End If

' Visual Basic
' Assumes a HelpProvider component has been added to the form.
If RadioButton1.Checked = True Then
    HelpProvider1.HelpNamespace = My.Application.Info.DirectoryPath & _
        "\EnglishHelp.chm"
Else
    HelpProvider1.HelpNamespace = My.Application.Info.DirectoryPath & _
        "\FrenchHelp.chm"
End If

Exibir uma Dica de Ferramenta

A seguir demonstra-se um código para exibir uma dica de ferramenta.

' Visual Basic 6.0

Private Sub Text1_Change()

Text1.ToolTipText = "The text has changed"

End Sub

' Visual Basic
' Assumes a ToolTip component has been added to the form.
Private Sub TextBox1_TextChanged(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles TextBox1.TextChanged
    ToolTip1.SetToolTip(TextBox1, "The text has changed")
End Sub

Suportes de Ajuda Equivalentes

Visual Basic 6,0	Visual Basic 2008
Propriedade App.HelpFile	HelpProvider componente
Propriedade HelpContextID	SetHelpKeyword método. Para obter mais informações, consulte Como: Exibir a Ajuda em um aplicativo do Windows.
Propriedade ToolTipText	SetToolTip método. Para obter mais informações, consulte Suporte dica de ferramenta para usuários do Visual Basic 6.0.
Propriedade WhatsThisButton	Propriedade HelpButton
Propriedade WhatsThisHelp	Propriedade HelpButton
Propriedade WhatsThisHelpID	Propriedade HelpString
Propriedade WhatsThisMode	Não há equivalente.Ativado por padrão.

Observações de Atualização

Quando um projeto Visual Basic 6.0 é atualizado usando o Assistente de atualização em Visual Basic 2008, quaisquer propriedades relacionadas a Ajuda ou o código não será atualizado. Você precisará reimplementar o suporte de ajuda para seu aplicativo após a atualização.Se seu arquivo de ajuda foi escrito usando a ajuda HTML, você poderá reutilizar o arquivo de ajuda; se ele foi escrito usando a ajuda do Windows será necessário ser regravado.

Consulte também

Compartilhar via