Formatierungstipps für das "ListBox"-Steuerelement

  • Artikel

Ee371162.0b2c798e-86c6-4ea2-a8a6-5cf1f12be1e2(DE-DE,Expression.30).png

Das ListBox-Steuerelement stellt eine Auflistung von Elementen dar. Sie können ein ListBox-Steuerelement aufüllen, indem Sie das Steuerelement an eine Datenquelle binden oder ungebundene Elemente anzeigen. Das ListBox-Steuerelement ist ein Steuerelement. Das bedeutet, dass Sie dieses Element mit Elementen auffüllen können, die Text oder andere Steuerelemente enthalten.

Wie alle Steuerelemente kann das ListBox-Steuerelement (also auch jedes im ListBox-Objekt enthaltene ListBox-Steuerelement) geändert werden, um dem Element ein Aussehen zu verleihen, das vom Design des Standardelements abweicht. Das Standarddesign des ListBox-Steuerelements sieht folgendermaßen aus:

Ee371162.3cc2d3af-6781-4937-b068-c3448a56406d(DE-DE,Expression.30).png

Wichtige ListBox-Steuerelementeigenschaften

Sie können das im ListBox-Steuerelement ausgewählte Element festlegen, indem Sie die SelectedIndex-Eigenschaft unter Allgemeine Eigenschaften im Eigenschaftenpanel festlegen. Der Wert -1 zeigt das ListBox-Objekt an, ohne dass eine Auswahl getroffen wurde. Der Wert 0 zeigt das ListBox-Objekt mit dem ersten ausgewählten Element an.

Um dem ListBox-Steuerelement Elemente hinzuzufügen, können Sie manuell ListBoxItem-Objekte hinzufügen oder Sie können eine Datenauflistung mit dem ListBox-Objekt verknüpfen, um die Elemente automatisch anzeigen zu lassen.

Weitere Informationen finden Sie unter Binden eines Objekts an Daten und Erstellen von Beispieldaten.

Teile der ListBox-Vorlage

ListBox-Steuerelemente verwenden eine Vorlage, die die Darstellung dieser Elemente definiert: die ListBox-Vorlage Jeder einzelne Teil dieser Vorlage übernimmt eine bestimmte Rolle hinsichtlich der Darstellung und des Verhaltens des ListBox-Objekts, auf das die Vorlage angewendet wird.

Ee371162.alert_tip(DE-DE,Expression.30).gifTipp:

Um die Elemente eines ListBox-Steuerelements gestalten zu können, müssen weitere Vorlagen geändert werden. Wenn z. B ein ListBox-Steuerelement datengebunden ist, handelt es sich bei der Vorlage, die das Steuerelement zur Gestaltung der Elemente verwendet, um eine generierte Elementvorlage (Datenvorlage). Wenn das ListBox-Steuerelement nicht datengebunden ist, steht keine Vorlage zur Verfügung, die das Steuerelement auf die Elemente anwenden kann, die im Steuerelement enthalten sind. Stattdessen können Sie die Vorlage der einzelnen Elemente wie etwa die ListBoxItem-Vorlage ändern.

Es können andere Objekte in der Vorlage enthalten sein, um die Darstellung des ListBox-Steuerelements optisch aufzubessern. Allerdings ist das Verhalten des Teils, das in der folgenden Tabelle aufgeführt wird, an einen Vertrag gebunden.

Wenn Sie die Teile einer Vorlage anzeigen möchten, öffnen Sie das Teilepanel während der Bearbeitung der Vorlage. Im Panel Objekte und Zeitachsen wird neben einem Objekt, das die Rolle eines Teils im Teilepanel übernimmt, ein Symbol Ee371162.6cf58c39-edba-4a0e-acbc-1da272f9a387(DE-DE,Expression.30).png angezeigt.

Teilename

Objekttyp

Beschreibung

ScrollViewer

ScrollViewer

Objekt, das den Inhalt eines bildlauffähigen Fensters anzeigt.

Dieses Teil ist obligatorisch.

Auf das ScrollViewer-Objekt in der ListBox-Vorlage kann eine geänderte Vorlage angewendet werden. Auf die ScrollBar-Objekte des ScrollViewer-Objekts können ebenfalls geänderte Vorlagen angewendet werden. Dadurch entstehen Vorlagen, die in folgender Weise eingebettet sind:

Ee371162.b8a37dc0-a65e-4fe1-8a9f-df485bb1bbae(DE-DE,Expression.30).png

Ee371162.095c13e8-6ed8-4572-9bd2-b2d6bdfdf199(DE-DE,Expression.30).png

Ein ListBox-Steuerelement. Das ListBox-Steuerelement ist ein Container für eine Liste von Elementen. Es ist entweder an Elemente in einer Datenquelle gebunden oder zeigt einzelne ungebundene Objekte an.
Ee371162.e1a62fcf-2f5c-4263-95fe-a9bf97616b85(DE-DE,Expression.30).png

Ein ScrollViewer-Steuerelement innerhalb der ListBox-Vorlage.
Ee371162.b36987f6-e914-4b58-99f2-a76c47128837(DE-DE,Expression.30).png

Ein ungebundenes Element im ListBox-Steuerelement.
Ee371162.41999197-e26c-42b9-8039-58ce07f5b5ba(DE-DE,Expression.30).png

Ein vertikales ScrollBar-Steuerelement innerhalb der ScrollViewer-Vorlage.
Ee371162.a5d608f2-bba2-48c5-8b15-2c115db86acc(DE-DE,Expression.30).png

Ein vertikales Thumb-Steuerelement innerhalb der ScrollBar-Vorlage.
Ee371162.15de085f-48f5-41dd-a286-e3dcb4cfd18b(DE-DE,Expression.30).png

Ein vertikales RepeatButton-Steuerelement innerhalb der ScrollBar-Vorlage, um den Wert des ScrollBar-Steuerelements in großen Schritten zu verringern.
Ee371162.1d2fe38a-3fd8-4951-b978-7e44b6f2401d(DE-DE,Expression.30).png

Ein vertikales RepeatButton-Steuerelement innerhalb der ScrollBar-Vorlage, um den Wert des ScrollBar-Steuerelements in kleinen Schritten zu verringern.

Weitere Informationen zum Gestalten von ScrollViewer- und ScrollBar-Objekten finden Sie unter Gestaltungstipps für "ScrollViewer"-Steuerelemente und Formatierungstipps für "ScrollBar"-Steuerelemente.

Status des ListBox-Steuerelements

Das ListBox-Steuerelement kann einen der drei folgenden Status der ValidationStates-Statusgruppe annehmen:

Zustandsname

Beschreibung

Valid

Darstellung des ListBox-Steuerelements, wenn das Steuerelement gültig ist.

InvalidUnfocused

Darstellung des ListBox-Steuerelements, wenn das Steuerelement ungültig ist und über keinen Tastaturfokus verfügt.

InvalidFocused

Darstellung des ListBox-Steuerelements, wenn das Steuerelement ungültig ist und über einen Tastaturfokus verfügt.

Wenn Sie einen Status auswählen, wird die Statusaufzeichnung aktiviert und die vorgenommenen Änderungen für diesen Status werden aufgezeichnet. Um die Statusaufzeichnung zu deaktivieren, klicken Sie auf die Aufzeichnungsschaltfläche Ee371162.0dcc6415-6d4e-4fcf-a9a3-eb4664cb6cbc(DE-DE,Expression.30).png auf der Zeichenfläche, oder wählen Sie Basis im Zuständepanel aus.

So konvertieren Sie Objekte in ein ListBox-Steuerelement

Führen Sie einen der folgenden Schritte aus, um die Vorlage eines ListBox-Steuerelements zu ändern:

  • Zeichnen Sie eine ListBox-Steuerelement Ee371162.b174a511-dd12-4a45-a986-034de7693de9(DE-DE,Expression.30).png auf die Zeichenfläche, und erstellen Sie eine Kopie der Standardvorlage.

    Weitere Informationen finden Sie unter Erstellen oder Bearbeiten einer Vorlage.

  • Entwerfen Sie ein ListBox-Steuerelement, indem Sie Objekte zeichnen oder Bilder importieren, und verwenden Sie dann den Befehl Steuerelement erstellen.

Wenn Sie den Befehl Steuerelement erstellen verwenden, führen Sie folgende Schritte aus, um sicherzustellen, dass Sie alle Objekte erstellt haben, die für eine ListBox-Vorlage erforderlich sind:

  1. Gruppieren Sie alle Objekte, die die Darstellung des ListBox-Steuerelements definieren sollen, in ein Rastersteuerelement. Fügen Sie solche Objekte ein, die nicht zu Teilen der Vorlage werden sollen.

  2. Wählen Sie das neue Rastersteuerelement aus, und klicken Sie dann im Menü Werkzeug auf Steuerelement erstellen.

  3. Wählen Sie ListBox im angezeigten Dialogfeld aus, geben Sie der Vorlage einen Namen, und wählen Sie den Speicherort aus, an dem die Vorlage gespeichert werden soll.

    Weitere Informationen zu Speicherorten finden Sie unter Erstellen einer Ressource.

  4. Nachdem Sie auf OK geklickt haben, öffnet Microsoft Expression Blend den Vorlagenbearbeitungsmodus und zeigt die Objekte an, aus denen sich das ListBox-Steuerelement zusammensetzt. Sie können die Vorlage in diesem Modus weiter ändern. Ändern Sie z. B. Objekte, oder fügen Sie Objekte hinzu, oder wählen Sie einen Status im Zuständepanel aus, um die Darstellung der Vorlage in diesem Status zu ändern.

  5. Doppelklicken Sie im Teilepanel auf ScrollViewer. Wenn Sie das neue ScrollViewer-Objekt ausgewählt haben, zeichnen Sie ein ItemsPresenter-Steuerelement in das Objekt. Verwenden Sie das Auswahlwerkzeug Ee371162.2ff91340-477e-4efa-a0f7-af20851e4daa(DE-DE,Expression.30).png oder die Eigenschaften unter Layout im Eigenschaftenpanel, um die Größe zu ändern und diese Objekte in die Vorlage zu verschieben.

  6. Sie können ggf. einige Pinseleigenschaften von Objekten in der Vorlage mit folgenden Eigenschaften des ListBox-Objekts verbinden, die die Vorlage unter Umständen verwendet:

    • Background

    • BorderBrush

    • Foreground

    • BorderThickness

    Weitere Informationen finden Sie unter Übernehmen von Objekteigenschaften für die Vorlage.

  7. Um den Vorlagenbearbeitungsmodus zu verlassen, klicken Sie in der Breadcrumb-Leiste am oberen Rand der Zeichenfläche auf [ListBox], oder klicken Sie im Panel Objekte und Zeitachsen auf Zurück zum Anfang Ee371162.55844eb3-ed98-4f20-aa66-a6f5b23eeb2b(DE-DE,Expression.30).png.

    Weitere Informationen zur Anwendung einer neuen ListBox-Vorlage auf andere ListBox-Objekte finden Sie unter Anwenden oder Entfernen einer Ressource.

Verweise

Detaillierte Informationen zu den Eigenschaften und Ereignissen des Microsoft Silverlight-ListBox-Steuerelements finden Sie in der Silverlight Control Gallery auf MSDN.

Siehe auch

Aufgaben

Verwenden von DataGrid-Steuerelementen

Verwenden des "TreeView"-Steuerelements

Konzepte

Gestaltungstipps für häufig verwendete Silverlight-Steuerelemente

SimpleListBox-Steuerelementvorlage und SimpleListBoxItem-Steuerelementvorlage

Formatieren eines Steuerelements, das Vorlagen unterstützt

Formatieren eines Steuerelements für die Datenanzeige