Freigeben über


Beispiel: Unterbereich-Steuerelement im Aktionsbereich

Download sample

Hinweis Erforderliche Anwendungen

Die Features in diesem Thema sind nur verfügbar, wenn die erforderlichen Anwendungen installiert sind.

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Produktkombination.

  • Eine der folgenden Entwicklungsumgebungen:

    VSTO 2005

    - oder -

    Visual Studio Team System

  • Microsoft Office 2003

Dieses Beispiel veranschaulicht benutzerdefinierte Steuerelemente in einem Aktionsbereich und beinhaltet ein reduzierbares Container-Steuerelement (das Unterbereich-Steuerelement), mit dem Sie Steuerelemente in einem Aktionsbereich besser verwalten können. Das Beispiel zeigt, wie Sie auf Ereignisse von Steuerelementen reagieren, die von einem Unterbereich-Steuerelement gehostet werden.

In dieser Beispielprojektmappe ist ein Projekt enthalten: ein Microsoft Office Word 2003-Anwendungsprojekt, das das Beispielsteuerungselement beinhaltet.

Sicherheitshinweis Hinweis

Dieser Beispielcode dient dazu, ein Konzept zu veranschaulichen. Er sollte nicht für Anwendungen oder Websites verwendet werden, da er unter Umständen nicht die sichersten Programmiermethoden wiedergibt. Microsoft übernimmt keine Haftung für zufällig entstandene Schäden oder Folgeschäden, falls der Beispielcode nicht bestimmungsgemäß verwendet wird.

Informationen über das Installieren des Beispielprojekts auf dem Computer finden Sie unter Gewusst wie: Downloaden von Beispieldateien in den Hilfethemen.

So führen Sie dieses Beispiel aus

  • Drücken Sie F5.

Veranschaulicht

Das Unterbereich-Steuerelement ist ein reduzierbarer Container, der andere Steuerelemente wie Listenfelder oder Textfelder hosten kann. Sie können dem Projekt ein Benutzersteuerelement hinzufügen und anschließend per Drag & Drop ein oder mehrere Unterbereich-Steuerelemente auf die Entwurfsoberfläche des Benutzersteuerelements ziehen. Sie können so viele Unterbereich-Steuerelemente wie nötig verwenden und sie mit den für das Projekt erforderlichen Steuerelementen auffüllen. Anschließend schreiben Sie den Code, der die Unterbereich-Steuerelemente mit dem Aktionsbereich des Dokuments verknüpft, und programmieren dann die Steuerelemente in dem jeweiligen Unterbereich.

Das Steuerelement verfügt über folgende Eigenschaften, Methoden und Ereignisse:

Eigenschaften:

  • Text. Der Text, der in der Titelleiste eines bestimmten Unterbereichs angezeigt wird.

  • HighlightColor. Die Farbe der Titelleiste, wenn diese vom Benutzer ausgewählt wird.

  • GradientBeginColor. Der Farbanfang auf der linken Seite der Titelleiste.

  • GradientEndColor. Das Farbende auf der rechten Seite der Titelleiste.

  • IsExpanded. Gibt an, ob der Unterbereich erweitert ist und die zugehörigen Elemente in einer Liste angezeigt werden.

  • IsAnimated. Gibt an, ob der Unterbereich beim Erweitern und Reduzieren aufwärts bzw. abwärts rollt.

Methoden:

  • Expand. Erweitert das Steuerelement. Diese Methode bleibt wirkungslos, wenn das Steuerelement bereits erweitert ist.

  • Collapse. Reduziert das Steuerelement. Diese Methode bleibt wirkungslos, wenn das Steuerelement bereits reduziert ist.

Ereignisse:

  • BeforeExpanding. Ein Ereignis, das ausgeführt wird, bevor das Steuerelement erweitert wird.

  • BeforeCollapsing. Ein Ereignis, das ausgeführt wird, bevor das Steuerelement reduziert wird.

  • AfterExpand. Ein Ereignis, das ausgeführt wird, nachdem das Steuerelement erweitert wurde.

  • AfterCollapse. Ein Ereignis, das ausgeführt wird, nachdem das Steuerelement reduziert wurde.

Siehe auch

Konzepte

Aktionsbereichsübersicht

Weitere Ressourcen

Beispiele für die Programmierung mit Office
Exemplarische Vorgehensweisen für die Programmierung mit Office