Tree-View Steuerelement erweiterte Formatvorlagen

In diesem Abschnitt werden erweiterte Stile aufgelistet, die beim Erstellen von Strukturansichtssteuerelementen verwendet werden. Der Wert erweiterter Stile ist eine bitweise Kombination dieser Stile.

Dauerhaft BESCHREIBUNG
TVS_EX_AUTOHSCROLL
Windows Vista. Entfernen Sie die horizontale Bildlaufleiste und den automatischen Bildlauf abhängig von der Mausposition.
TVS_EX_DIMMEDCHECKBOXES
Windows Vista. Fügt ein Kontrollkästchen auf der linken Seite eines bestimmten Elements hinzu, das ein Symbol eines abgeblendeten Häkchens enthält, das darauf hindeuten kann, dass ein Knoten ausgewählt ist, weil sein übergeordnetes Element ausgewählt ist. Dies schließt zusätzlich zu zwei normalen Kontrollkästchenzuständen einen abgeblendeten Kontrollkästchenzustand ein. Verwenden Sie es nicht gleichzeitig mit dem TVS_CHECKBOXES Stil. Siehe Hinweis weiter unten.
TVS_EX_DOUBLEBUFFER
Windows Vista. Gibt an, wie der Hintergrund gelöscht oder gefüllt wird.
TVS_EX_DRAWIMAGEASYNC
Windows Vista. Ruft Kalenderrasterinformationen ab.
TVS_EX_EXCLUSIONCHECKBOXES
Windows Vista. Fügt ein Kontrollkästchensymbol auf der linken Seite eines bestimmten Elements hinzu, das ein rotes X enthält. Dies schließt zusätzlich zu zwei normalen Kontrollkästchenzuständen einen Ausschluss-Kontrollkästchenzustand ein. Verwenden Sie es nicht gleichzeitig mit dem TVS_CHECKBOXES Stil. Siehe Hinweis weiter unten.
TVS_EX_FADEINOUTEXPANDOS
Windows Vista. Blenden Sie expando-Schaltflächen ein oder aus, wenn sich die Maus entfernt oder in einen Zustand bewegt, in dem der Mauszeiger auf das Steuerelement gezeigt wird.
TVS_EX_MULTISELECT
Wird nicht unterstützt. Darf nicht verwendet werden.
TVS_EX_NOINDENTSTATE
Windows Vista. Setzen Sie die Strukturansicht für die Expando-Schaltflächen nicht ein.
TVS_EX_NOSINGLECOLLAPSE
Windows Vista. Für den internen Gebrauch vorgesehen; wird nicht für die Verwendung in Anwendungen empfohlen. Reduzieren Sie das zuvor ausgewählte Strukturansichtselement nur, wenn es über dasselbe übergeordnete Element wie die neue Auswahl verfügt. Diese Formatvorlage muss mit der TVS_SINGLEEXPAND-Formatvorlage verwendet werden.
Hinweis: Dieser Stil wird in zukünftigen Versionen von Comctl32.dll möglicherweise nicht unterstützt. Außerdem ist dieser Stil nicht in commctrl.h definiert. Fügen Sie den Quelldateien Ihrer Anwendung die folgende Definition hinzu, um dieses Format zu verwenden: #define TVS_EX_NOSINGLECOLLAPSE 0x0001
TVS_EX_PARTIALCHECKBOXES
Windows Vista. Fügt ein Kontrollkästchensymbol am äußersten linken Rand eines bestimmten Elements mit einem Quadrat in der Mitte hinzu, das darauf hindeuten kann, dass der Knoten teilweise ausgewählt ist. Dies schließt zusätzlich zu zwei normalen Kontrollkästchenzuständen einen partiellen Kontrollkästchenzustand ein. Verwenden Sie es nicht gleichzeitig mit dem TVS_CHECKBOXES Stil. Siehe Hinweis weiter unten.
TVS_EX_RICHTOOLTIP
Windows Vista. Lassen Sie umfangreiche QuickInfos in der Strukturansicht zu (benutzerdefinierte Gezeichnet mit Symbol und Text).

Hinweis zur Verwendung erweiterter Kontrollkästchenstile

Das Strukturansichtssteuerelement weist ein sehr spezifisches Verhalten für die Kontrollkästchenstile auf. Wenn eine bestimmte Stil- oder EX-Kombination aktiviert wird, behält das Steuerelement diese bis zum Ende seiner Lebensdauer bei (was bedeutet, dass Sie die erste Kontrollkästchenart während der Lebensdauer des Strukturansichtssteuerelements nicht ändern können).

Um ein Strukturansichtssteuerelement mit erweiterten Kontrollkästchenstilen zu erstellen, müssen Sie zunächst das Steuerelementfenster ohne die TVS_CHECKBOXES Formatvorlage erstellen und (nach der Erstellung) die ausgewählte erweiterte Kontrollkästchenart hinzufügen, indem Sie die TVM_SETEXTENDEDSTYLE Nachricht senden oder das makro TreeView_SetExtendedStyle verwenden. Der erweiterte Kontrollkästchenstil kann eine beliebige OR-Kombination aus TVS_EX_DIMMEDCHECKBOXES, TVS_EX_EXCLUSIONCHECKBOXES oder TVS_EX_PARTIALCHECKBOXES Sein.

Das neue Strukturansichtssteuerelement bietet die 2 normalen Kontrollkästchenzustände (aktiviert und deaktiviert) sowie 1 bis 3 zusätzliche Zustände (Funktion des ausgewählten erweiterten Stils). Die normalen Zustände werden immer als 0x1000 und 0x2000 codiert, und alle zusätzlichen Zustände werden mit den nächsten Werten (0x3000, 0x4000, 0x5000) codiert. Verwenden Sie TVIS_STATEIMAGEMASK Konstanten (0xF000) als Maske, um diese Zustände von der TVITEM-Struktur abzurufen oder festzulegen.

Anforderungen

Anforderung Wert
Header
CommCtrl.h