執行窗格說明標籤範例

發行項
09/10/2008

更新：2007 年 11 月

注意事項：
這個範例只會在 Microsoft Office Excel 2007 和 Microsoft Office Word 2007 中執行。

這個範例包含控制項，該控制項在包含 XML 對應區域的文件或工作表執行窗格上，提供動態的即時線上說明。這個控制項會自動將自己與 XML 結構描述產生關聯，並使用結構描述附註做為說明文字。當使用者將插入點放在包含之 XML 程式碼的區域內時，控制項會顯示相關的區域名稱和附註文字。開發人員可以使用這個控制項的屬性，指出當區域沒有附註文字時會發生哪些狀況。

這個控制項具有四個屬性，您可以設定這些屬性，以決定控制項在沒有附註文字時要顯示什麼。這些屬性會出現在 [屬性] 視窗中稱為 [內容] 的區段內。

UseAncestorAnnotation
指定如果在選取的區域中沒有指定附註文字時，該控制項是否要顯示最接近祖系區域的附註文字。
AnnotationType
決定是否顯示項目型別或項目名稱附註。
PlaceholderText
控制項在沒有附註時會顯示的文字。
ShowLocationName
切換是否要在說明標籤控制項中顯示區域的名稱。

有一個方案的 [說明標籤] 範例中包含三個專案：控制項程式庫專案、Word 文件專案及 Excel 活頁簿專案。Word 和 Excel 專案示範如何使用控制項。當您按一下文件或工作表的不同區域時，[說明標籤] 會顯示取自關聯的 XML 結構描述區域之文字。

安全性注意事項：
這個範例程式碼是用來說明一個概念，並顯示只與該概念相關的程式碼。這可能不符合特定環境的安全性需求，而且不能完全按照顯示的方法使用。建議您加入安全性和錯誤處理程式碼，使您的專案更安全和穩固。Microsoft 以「原樣」提供這個範例程式碼，且不提供擔保。