Beispiel für ein Hilfebezeichnungsfeld für einen Aktionsbereich

Aktualisiert: November 2007

Hinweis:
Dieses Beispiel kann nur in Microsoft Office Excel 2007 und Microsoft Office Word 2007 ausgeführt werden.

In diesem Beispiel ist ein Steuerelement enthalten, das dynamische, kontextbezogene Hilfe zu einem Aktionsbereich für ein Dokument oder ein Arbeitsblatt bietet, das mit XML zugeordnete Bereiche beinhaltet. Das Steuerelement wird automatisch mit dem XML-Schema verknüpft und verwendet für den Hilfetext Schemaanmerkungen. Wenn ein Benutzer die Einfügemarke in einem Bereich positioniert, der einen XML-Knoten enthält, zeigt das Steuerelement den zugehörigen Bereichsnamen und den Anmerkungstext an. Der Entwickler kann mithilfe der Steuerelementeigenschaften angeben, was geschieht, wenn ein Bereich über keinen Anmerkungstext verfügt.

Das Steuerelement verfügt über vier Eigenschaften, mit denen Sie festlegen können, was das Steuerelement anzeigen soll, wenn kein Anmerkungstext vorhanden ist. Diese Eigenschaften werden im Fenster Eigenschaften im Abschnitt Inhalt angezeigt.

• UseAncestorAnnotation
  Gibt an, ob der Anmerkungstext des vorhergehenden Bereichs vom Steuerelement angezeigt werden soll, wenn im ausgewählten Bereich kein Anmerkungstext angegeben ist.

• AnnotationType
  Bestimmt, ob die Elementtyp- oder Elementnamensanmerkung angezeigt wird.

• PlaceholderText
  Der Text, den das Steuerelement anzeigt, wenn keine Anmerkung vorhanden ist.

• ShowLocationName
  Aktiviert bzw. deaktiviert das Anzeigen des Bereichsnamens im Hilfelabelsteuerelement.

Im Beispiel der Hilfebezeichnung finden Sie eine Projektmappe mit drei Projekten: ein Steuerelement-Bibliothekprojekt, ein Word-Dokumentprojekt und ein Excel-Arbeitsmappenprojekt. Das Word-Projekt und das Excel-Projekt veranschaulichen die Verwendung des Steuerelements. Wenn Sie auf unterschiedliche Bereiche des Dokuments oder Arbeitsblatts klicken, zeigt das Hilfebezeichnungsfeld den Text aus dem zugeordneten XML-Schemabereich an.

Sicherheitshinweis:

Dieser Beispielcode veranschaulicht ein Konzept und zeigt nur den Code an, der für dieses Konzept relevant ist. Der Code entspricht möglicherweise nicht den Sicherheitsanforderungen bestimmter Umgebungen und sollte daher nicht in diesem Format verwendet werden. Es wird empfohlen, Sicherheits- und Fehlerbehandlungscode hinzuzufügen, um Projekte sicherer und robuster zu gestalten. Microsoft stellt diesen Beispielcode wie besehen und ohne Garantie zur Verfügung.

Informationen über das Installieren des Beispielprojekts auf dem Computer finden Sie unter Gewusst wie: Installieren und Verwenden von Beispieldateien in der Hilfe.

Download sample

So führen Sie dieses Beispiel aus

• Drücken Sie F5.

Veranschaulicht

Dieses Beispiel zeigt, wie ein Benutzersteuerelement erstellt und in ein Projekt integriert wird. Außerdem wird gezeigt, wie auf Ereignisse in mit XML zugeordneten Bereichen zu reagieren ist.

Siehe auch

Konzepte

XML-Schemas und Daten (Visual Studio Tools for Office)

Aktionsbereichsübersicht

Exemplarische Vorgehensweisen für Anpassungen der Benutzeroberfläche

Weitere Ressourcen

Beispiele auf Dokumentebene