帮助支持(针对 Visual Basic 6.0 用户)

更新:2007 年 11 月

本主题对 Visual Basic 6.0 中用于实现帮助的支持与其在 Visual Basic 2008 中的等效项进行了比较。

多数应用程序以帮助文件、弹出帮助和/或工具提示的形式向用户提供帮助。尽管 Visual Basic 6.0 和 Visual Basic 2008 都支持所有这三种帮助机制,但它们的实现方法却有很大区别。

概念差异

在 Visual Basic 6.0 中,可以使用 HTML 帮助或较早的 Windows 帮助格式提供帮助。在 Visual Basic 2008 中,仅支持 HTML 帮助。

在 Visual Basic 6.0 中,帮助支持基于每个项目而实现,方法是在“项目属性”对话框中指定帮助文件名。每个窗体和控件都有一个 HelpContextID 属性,该属性可以用于链接到帮助文件中的特定主题。

在 Visual Basic 2008 中,帮助支持基于每个窗体而实现,方法是向窗体添加一个或多个 HelpProvider 组件。每个窗体和控件都有 HelpKeyword 和 HelpNavigator 属性,这两个属性用于链接到特定的主题。有关更多信息,请参见 如何:在 Windows 应用程序中提供帮助

弹出帮助

在 Visual Basic 6.0 中,使用窗体的 WhatsThisButton 和 WhatsThisHelp 属性来实现弹出帮助。如果 WhatsThisButton 为 True 且 MaxButton 和 MinButton 属性均为 False,则显示“这是什么”按钮。在代码中设置 WhatsThisMode 属性可启用该按钮。

在 Visual Basic 2008 中,使用窗体的 HelpButton 属性实现弹出帮助。仅当 HelpButton 属性设置为 True 且 MaximizeBoxMinimizeBox 属性均设置为 False 时,才显示“帮助”按钮;该按钮自动启用。有关更多信息,请参见 如何:显示弹出帮助

工具提示

在 Visual Basic 6.0 中,使用控件的 ToolTipText 属性来实现工具提示。

在 Visual Basic 2008 中,通过向窗体添加 ToolTip 组件来实现工具提示。有关更多信息,请参见工具提示支持(针对 Visual Basic 6.0 用户)

ShowHelp 方法

在 Visual Basic 6.0 中,也可以使用 CommonDialog 控件的 ShowHelp 方法打开 Windows 帮助来显示帮助。在 Visual Basic 2008 中,不再支持 Windows 帮助,因而没有用于显示帮助的等效控件。

帮助支持的代码更改

下面的代码阐释 Visual Basic 6.0 和 Visual Basic 2008 在某些帮助属性常见用法的编码方法上的不同之处。

指定帮助文件

下面的示例演示如何为应用程序指定帮助文件(假定窗体包含两个使用户可以在英语和法语帮助文件之间进行选择的 OptionButton 控件)。

' 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

显示工具提示

下面演示用于显示工具提示的代码。

' 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

帮助支持等效项

Visual Basic 6.0

Visual Basic 2008

App.HelpFile 属性

HelpProvider 组件

HelpContextID 属性

SetHelpKeyword 方法。有关更多信息,请参见 如何:在 Windows 应用程序中提供帮助

ToolTipText 属性

SetToolTip 方法。有关更多信息,请参见工具提示支持(针对 Visual Basic 6.0 用户)

WhatsThisButton 属性

HelpButton 属性

WhatsThisHelp 属性

HelpButton 属性

WhatsThisHelpID 属性

HelpString 属性

WhatsThisMode 属性

无等效项。默认情况下启用。

升级说明

在 Visual Basic 2008 中使用升级向导升级 Visual Basic 6.0 项目时,所有与帮助相关的属性或代码都不会升级。在升级后需要为应用程序重新实现帮助支持。如果帮助文件是使用 HTML 帮助编写的,则可以重用该帮助文件;如果帮助文件是使用 Windows 帮助编写的,则需要重新编写该帮助文件。

请参见

任务

如何:在 Windows 应用程序中提供帮助

如何:显示弹出帮助

概念

工具提示支持(针对 Visual Basic 6.0 用户)

其他资源

在 Windows 窗体中集成用户帮助