操作窗格帮助标签示例

项目
09/10/2008

更新：2007 年 11 月

说明：
本示例只能在 Microsoft Office Excel 2007 和 Microsoft Office Word 2007 中运行。

本示例包含一个控件，该控件为包含 XML 映射区域的文档或工作表在操作窗格中提供动态的上下文相关帮助。该控件自动与 XML 架构关联，并将架构批注用作帮助文本。当用户将插入点放入包含 XML 节点的区域中时，该控件便会显示关联区域的名称和批注文本。开发人员可以使用该控件的属性来指示当区域没有批注文本时会发生什么情况。

该控件包含四个属性，可设置这些属性来确定当没有批注文本时控件所显示的内容。这四个属性位于“属性”窗口中称为“内容”的部分中。

UseAncestorAnnotation
指定当选择的区域中未指定批注文本时，控件是否应显示最近的上级区域的批注文本。
AnnotationType
用于确定是否显示元素类型或元素名称批注。
PlaceholderText
当没有批注时控件显示的文本。
ShowLocationName
切换在 Help Label 控件中是否出现区域的名称。

在帮助标签示例中包含一个具有三个项目的解决方案：一个控件库项目、一个 Word 文档项目和一个 Excel 工作簿项目。Word 和 Excel 项目演示如何使用该控件。当单击文档或工作表的不同区域时，帮助标签便会显示从关联的 XML 架构区域获取的文本。

安全说明：
此示例代码的用途在于阐释概念，因此只显示了与该概念相关的代码。示例代码不一定满足特定环境的安全要求，不应原样照搬使用。我们建议您添加安全性代码和错误处理代码，让您的项目更加安全可靠。Microsoft 按“原样”提供此示例代码，不提供任何保证。