工具提示是光标悬停在工具栏、面板按钮或菜单项上时,在光标附近显示的说明信息。
与命令相关联的“说明”特性可提供该命令用途的简单说明。“说明”特性的值将显示为基本工具提示的一部分,光标悬停在工具栏按钮或功能区面板上时,将显示基本工具提示。除了说明,命令工具提示也将显示命令的名称以及指定给“命令显示名”和“标记”特性的值。
此外,还可以为命令指定扩展型帮助文件和 ID,以便显示命令的二级信息。扩展型帮助文件中的内容显示在工具提示的扩展型说明区域。工具提示的扩展型说明区域的内容存储在 XAML 文件中,并且可包含大量文字和图像。
控制工具提示的显示
用户可以通过“选项”对话框控制工具提示的显示以及何时显示指定给命令的扩展型帮助。要了解有关工具提示的详细信息,请参见《用户手册》中的设定界面选项。
XAML 文件的样例
XAML 结构是由 Microsoft 开发的格式。以下是存在于 CUIx 文件中的两个自定义命令的 XAML 文件样例。
<ResourceDictionary
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:src="clr-namespace:Autodesk.Windows;assembly=AdWindows">
<src:RibbonToolTip x:Key="MYEH_CMD_0001">
<src:RibbonToolTip.ExpandedContent>
<StackPanel>
<TextBlock Background="AntiqueWhite" TextAlignment="Center">
在 <Bold>REVISION</Bold> 图层上创建矩形修订云线。
</TextBlock>
<Image Source="images/rectcloud.jpg" Width="Auto" Height="Auto">
</Image>
</StackPanel>
</src:RibbonToolTip.ExpandedContent>
</src:RibbonToolTip>
<src:RibbonToolTip x:Key="MYEH_CMD_0002">
<src:RibbonToolTip.ExpandedContent>
<StackPanel>
<TextBlock Background="Yellow" TextAlignment="Left">
在 <Run Text=" REVISION " Foreground="Red" FontStyle="Italic"/> 图层上创建多边形修订云线。
创建多边形
修订云线。
</TextBlock>
<Image Source="images/rectcloud.jpg" Width="Auto" Height="Auto">
</Image>
</StackPanel>
</src:RibbonToolTip.ExpandedContent>
</src:RibbonToolTip>
</ResourceDictionary>
ResourceDictionary 元素用于定义 XAML 文件中的内容类型;而 scr:RibbonToolTip 元素用于定义文件中的每个扩展帮助主题。在上一个样例中有两个不同的扩展型帮助主题,它们由关键字 MYEH_CMD_0001 和
MYEH_CMD_0002 进行唯一地定义。
注意需要将定义为与 AutoCAD 2009 配合使用的扩展工具提示更新为可与 AutoCAD 2012 配合使用。有关将为 AutoCAD 2009 创建的扩展工具提示转换为可与 AutoCAD 2012 配合使用的信息,请参见本页面上“将 AutoCAD
2009 扩展工具提示转换为可与 AutoCAD 2012 配合使用的步骤”。
StackPanel 元素可将 TextBlock 和 Image 元素合为一组。用户可以在 StackPanel 元素下包含所需的任意多的 TextBlock 和 Image 元素。TextBlock 元素控制文字;Image 元素控制作为扩展型帮助的一部分的插图。要了解有关
XAML 的详细信息,请访问 Microsoft 的网站 http://www.microsoft.com 并搜索 XAML。
将工具提示添加到命令的步骤
- 在自定义用户界面编辑器中“自定义”选项卡上的“命令列表”窗格中,单击要添加工具提示的命令。
- 在“特性”窗格的“说明”字段中,为选定的命令输入工具提示文字。
- 单击“应用”。
下一次光标悬停在工具栏上的命令或功能区面板上时,文字将显示在工具提示中。
将扩展型帮助添加到命令的步骤
- 在自定义用户界面编辑器中“自定义”选项卡上的“命令列表”窗格中,单击要添加扩展帮助的命令。
- 在“特性”窗格中,选择“扩展型帮助文件”字段并单击“…”按钮。
- 在“选择扩展型帮助文件”对话框中,浏览到并选择包含命令的扩展型帮助的 XAML 文件。单击“打开”。
- 在“选择帮助 ID”对话框中,选择扩展型帮助内容的帮助 ID。单击“确定”。
- 单击“应用”。
将命令添加到工具栏或功能区面板后,如果已为工具提示启用扩展型帮助并且光标按指定的时间间隔悬停在命令上,则将显示扩展型帮助。
创建 XAML 文件的步骤
- 在文字编辑器(例如 Microsoft® Windows® 记事本)中,创建新文件并输入定义扩展型帮助内容所需的元素。
例如,在文件编辑器中输入以下文字:
<ResourceDictionary
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:src="clr-namespace:Autodesk.Windows;assembly=AdWindows">
<src:RibbonToolTip x:Key="MYEH_CMD_0003">
<src:RibbonToolTip.ExpandedContent>
<StackPanel>
<TextBlock Background="AntiqueWhite" TextAlignment="Center">
为当前图形配置设置。
</TextBlock>
</StackPanel>
</src:RibbonToolTip.ExpandedContent>
</src:RibbonToolTip>
</ResourceDictionary>
- 将文件保存为 ASCII 文本(TXT 文件),文件扩展名为 .xaml。
将 AutoCAD 2009 的扩展工具提示转换为可与 AutoCAD 2012 配合使用的格式的步骤
- 在文字编辑器(例如 Microsoft® Windows® 记事本)中打开 XAML 文件。
下面是为与 AutoCAD 2009 配合使用而创建的扩展工具提示的样例。需更改以斜体显示的文字。
<src:ProgressivePanel x:Key="MYEH_CMD_0003">
<StackPanel>
<TextBlock Background="AntiqueWhite" TextAlignment="Center">
为当前图形配置设置。
</TextBlock>
</StackPanel>
</src:ProgressivePanel>
- 更改上一步骤中以斜体显示的文字以匹配以下项:
<src:RibbonToolTip x:Key="MYEH_CMD_0003">
<src:RibbonToolTip.ExpandedContent>
<StackPanel>
<TextBlock Background="AntiqueWhite" TextAlignment="Center">
为当前图形配置设置。
</TextBlock>
</StackPanel>
</src:RibbonToolTip.ExpandedContent>
</src:RibbonToolTip>
- 将所做的更改保存到 XAML 文件。
命令
系统变量