Hilfeunterstützung für Visual Basic 6.0-Benutzer

Aktualisiert: November 2007

In diesem Thema wird die Unterstützung für das Implementieren der Hilfe in Visual Basic 6.0 mit der Entsprechung in Visual Basic 2008 verglichen.

Die meisten Anwendungen stellen Hilfe für Benutzer in Form einer Hilfedatei, kontextbezogener Hilfe und/oder QuickInfos zur Verfügung. Sowohl Visual Basic 6.0 als auch Visual Basic 2008 unterstützen alle drei Hilfemechanismen, die Methoden für deren Implementierung unterscheiden sich jedoch deutlich.

Konzeptionelle Unterschiede

In Visual Basic 6.0 konnte die Hilfe entweder über die HTML-Hilfe oder im älteren Windows-Hilfeformat bereitgestellt werden. In Visual Basic 2008 wird nur die HTML-Hilfe unterstützt.

In Visual Basic 6.0 wurde die Hilfeunterstützung für jeweils einzelne Projekte implementiert, indem im Dialogfeld Projekteigenschaften der Name einer Hilfedatei angegeben wurde. Jedes Formular und Steuerelement verfügte über eine HelpContextID-Eigenschaft, mit der ein Link mit einem bestimmten Thema in der Hilfedatei hergestellt wurde.

Die Hilfeunterstützung in Visual Basic 2008 wird für jedes Formular getrennt implementiert, indem einem Formular eine oder mehrere HelpProvider-Komponenten hinzugefügt werden. Jedes Formular und Steuerelement verfügt über eine HelpKeyword-Eigenschaft und eine HelpNavigator-Eigenschaft, mit denen ein Link mit einem bestimmten Thema erstellt wird. Weitere Informationen finden Sie unter Gewusst wie: Bereitstellen von Hilfe in einer Windows-Anwendung.

Kontextbezogene Hilfe

In Visual Basic 6.0 wurde die kontextbezogene Hilfe mit der WhatsThisButton-Eigenschaft und der WhatsThisHelp-Eigenschaft eines Formulars implementiert. Die Schaltfläche Direkthilfe wurde angezeigt, wenn WhatsThisButton den Wert True hatte und sowohl die MaxButton-Eigenschaft als auch die MinButton-Eigenschaft den Wert False hatten. Durch das Festlegen der WhatsThisMode-Eigenschaft im Code wurde die Schaltfläche aktiviert.

In Visual Basic 2008 wird die kontextbezogene Hilfe mithilfe der HelpButton-Eigenschaft eines Formulars implementiert. Die Schaltfläche Hilfe wird nur dann angezeigt, wenn die HelpButton-Eigenschaft auf True festgelegt wird und wenn sowohl die MaximizeBox-Eigenschaft als auch die MinimizeBox-Eigenschaft auf False festgelegt werden. Die Schaltfläche wird automatisch aktiviert. Weitere Informationen finden Sie unter Gewusst wie: Anzeigen der kontextbezogenen Hilfe.

QuickInfo

In Visual Basic 6.0 wurden QuickInfos mit der ToolTipText-Eigenschaft eines Steuerelements implementiert.

In Visual Basic 2008 werden QuickInfos durch Hinzufügen einer ToolTip-Komponente zu einem Formular implementiert. Weitere Informationen finden Sie unter QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer.

ShowHelp-Methode

In Visual Basic 6.0 konnte Hilfe auch angezeigt werden, indem mit der ShowHelp-Methode eines CommonDialog-Steuerelements Windows-Hilfe geöffnet wurde. Die Windows-Hilfe wird in Visual Basic 2008 nicht mehr unterstützt, und es ist kein entsprechendes Steuerelement zum Anzeigen der Hilfe vorhanden.

Änderungen am Code für die Hilfeunterstützung

Im folgenden Code werden die Unterschiede in den Codierungstechniken zwischen Visual Basic 6.0 und Visual Basic 2008 für einige gängige Verwendungsmöglichkeiten der Hilfeeigenschaften dargestellt.

Angeben einer Hilfedatei

Im folgenden Beispiel wird veranschaulicht, wie eine Hilfedatei für eine Anwendung angegeben wird. Hierbei wird davon ausgegangen, dass das Formular über zwei OptionButton-Steuerelemente verfügt, mit denen die Benutzer zwischen englischen und französischen Hilfedateien wählen können.

' 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

Anzeigen von QuickInfos

Das folgende Codebeispiel veranschaulicht, wie QuickInfos angezeigt werden.

' 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

Entsprechungen für die Hilfeunterstützung

Hinweise zum Durchführen einer Aktualisierung

Wenn ein Visual Basic 6.0-Projekt mithilfe des Aktualisierungs-Assistenten von Visual Basic 2008 aktualisiert wird, werden hilfebezogene Eigenschaften oder Codeabschnitte nicht aktualisiert. Nach der Aktualisierung muss die Hilfeunterstützung für die Anwendung neu implementiert werden. Wenn die Hilfedatei mit HTLM Help erstellt wurde, kann die Hilfedatei wiederverwendet werden. Falls sie mit Windows Help geschrieben wurde, muss sie neu erstellt werden.

Siehe auch

Aufgaben

Gewusst wie: Bereitstellen von Hilfe in einer Windows-Anwendung

Gewusst wie: Anzeigen der kontextbezogenen Hilfe

Konzepte

QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer

Weitere Ressourcen

Integrieren von Benutzerhilfe in Windows Forms