TVITEMEXA-Struktur (commctrl.h)
Gibt Attribute eines Strukturansichtselements an oder empfängt sie. Diese Struktur ist eine Verbesserung der TVITEM- Struktur. Neue Anwendungen sollten diese Struktur gegebenenfalls verwenden.
Syntax
typedef struct tagTVITEMEXA {
UINT mask;
HTREEITEM hItem;
UINT state;
UINT stateMask;
LPSTR pszText;
int cchTextMax;
int iImage;
int iSelectedImage;
int cChildren;
LPARAM lParam;
int iIntegral;
UINT uStateEx;
HWND hwnd;
int iExpandedImage;
int iReserved;
} TVITEMEXA, *LPTVITEMEXA;
Angehörige
mask
Typ: UINT-
Array von Flags, die angeben, welche der anderen Strukturmmber gültige Daten enthalten. Wenn diese Struktur mit der TVM_GETITEM Nachricht verwendet wird, gibt das Mask Element die abzurufenden Elementattribute an. Bei Verwendung mit der TVM_SETITEM Nachricht gibt die Maske die festzulegenden Attribute an. Dieses Element kann einen oder mehrere der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
Das cChildren Member ist gültig. |
|
Das Strukturansichtssteuerelement behält die bereitgestellten Informationen bei und fordert sie nicht erneut an. Dieses Kennzeichen ist nur gültig, wenn die TVN_GETDISPINFO-Benachrichtigung verarbeitet wird. |
|
Version 6.00 und Windows Vista. Das iExpandedImage Member ist gültig. |
|
Das hItem Member ist gültig. |
|
Das iImage Member ist gültig. |
|
Das iIntegral Member ist gültig. |
|
Das lParam- Mitglied ist gültig. |
|
Das iSelectedImage Member ist gültig. |
|
Der Status und stateMask Member sind gültig. |
|
Version 6.00 und Windows Vista. Das mitglied uStateEx ist gültig. |
|
Die pszText und cchTextMax Member sind gültig. |
hItem
Typ: HTREEITEM-
Behandeln sie das Element.
state
Typ: UINT-
Satz von Bitkennzeichnungen und Bildlistenindizes, die den Status des Elements angeben. Wenn Sie den Status eines Elements festlegen, gibt das stateMask Member die gültigen Bits dieses Elements an. Beim Abrufen des Status eines Elements gibt dieses Element den aktuellen Zustand für die bits zurück, die im stateMask Member angegeben sind. Weitere Informationen zu diesem Mitglied finden Sie im Abschnitt "Hinweise".
Bits 0 bis 7 dieses Elements enthalten die Elementstatuskennzeichnungen. Eine Liste der möglichen Elementstatuskennzeichnungen finden Sie unter Tree-View Control Item States.
Bits 8 bis 11 dieses Elements geben den 1-basierten Überlagerungsbildindex an. Das Überlagerungsbild wird über dem Symbolbild des Elements überlagert. Wenn diese Bits null sind, weist das Element kein Überlagerungsbild auf. Um diese Bits zu isolieren, verwenden Sie die TVIS_OVERLAYMASK Maske. Um den Überlagerungsbildindex in diesem Element festzulegen, verwenden Sie das INDEXTOOVERLAYMASK Makro. Die Überlagerungsbilder der Bildliste werden mit der ImageList_SetOverlayImage-Funktion festgelegt.
Ein Zustandsbild wird neben dem Symbol eines Elements angezeigt, um einen anwendungsdefinierten Zustand anzugeben. Geben Sie die Statusbildliste an, indem Sie eine TVM_SETIMAGELIST Nachricht senden. Um das Statusbild eines Elements festzulegen, schließen Sie den TVIS_STATEIMAGEMASK Wert in die stateMask Member der TVITEM--Struktur ein. Bits 12 bis 15 des Zustands der Struktur Member geben den Index in der Zustandsbildliste des zu zeichnenden Bilds an.
Verwenden Sie INDEXTOSTATEIMAGEMASK, um den Statusbildindex festzulegen. Dieses Makro verwendet einen Index und legt bits 12 bis 15 entsprechend fest. Um anzugeben, dass das Element kein Statusbild aufweist, legen Sie den Index auf Null fest. Diese Konvention bedeutet, dass Bild 0 in der Statusbildliste nicht als Zustandsbild verwendet werden kann. Um Bits 12 bis 15 des Zustands Member zu isolieren, verwenden Sie die TVIS_STATEIMAGEMASK Maske.
stateMask
Typ: UINT-
Bits des Zustands Mitglieds, die gültig sind. Wenn Sie den Status eines Elements abrufen, legen Sie die Bits des stateMask Member fest, um die Bits anzugeben, die im Zustand Member zurückgegeben werden sollen. Wenn Sie den Status eines Elements festlegen, legen Sie die Bits des stateMask Member fest, um die Bits des Zustands anzugeben, Element, das Sie festlegen möchten. Um den Überlagerungsbildindex eines Elements festzulegen oder abzurufen, legen Sie die TVIS_OVERLAYMASK Bits fest. Um den Statusbildindex eines Elements festzulegen oder abzurufen, legen Sie die TVIS_STATEIMAGEMASK Bits fest.
pszText
Typ: LPTSTR-
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Elementtext enthält, wenn die Struktur Elementattribute angibt. Wenn dieses Element der LPSTR_TEXTCALLBACK Wert ist, ist das übergeordnete Fenster für das Speichern des Namens verantwortlich. In diesem Fall sendet das Strukturansichtssteuerelement dem übergeordneten Fenster einen TVN_GETDISPINFO Benachrichtigungscode, wenn der Elementtext zum Anzeigen, Sortieren oder Bearbeiten und einem TVN_SETDISPINFO Benachrichtigungscode benötigt wird, wenn sich der Elementtext ändert. Wenn die Struktur Elementattribute empfängt, ist dieses Element die Adresse des Puffers, der den Elementtext empfängt. Beachten Sie, dass zwar das Strukturansichtssteuerelement die Speicherung von Längenzeichenfolgen als Elementtext zulässt, aber nur die ersten 260 Zeichen werden angezeigt.
cchTextMax
Typ: int
Die Größe des Puffers, auf den der pszText Member in Zeichen verweist. Wenn diese Struktur zum Festlegen von Elementattributen verwendet wird, wird dieses Element ignoriert.
iImage
Typ: int
Index in der Bildliste des Strukturansicht-Steuerelements des Symbolbilds, das verwendet werden soll, wenn sich das Element im nicht ausgewählten Zustand befindet. Wenn dieses Element der I_IMAGECALLBACK Wert ist, ist das übergeordnete Fenster für das Speichern des Indexes verantwortlich. In diesem Fall sendet das Strukturansichtssteuerelement dem übergeordneten Element einen TVN_GETDISPINFO Benachrichtigungscode, um den Index abzurufen, wenn es das Bild anzeigen muss.
iSelectedImage
Typ: int
Index in der Bildliste des Strukturansicht-Steuerelements des Symbolbilds, das verwendet werden soll, wenn sich das Element im ausgewählten Zustand befindet. Wenn dieses Element der I_IMAGECALLBACK Wert ist, ist das übergeordnete Fenster für das Speichern des Indexes verantwortlich. In diesem Fall sendet das Strukturansichtssteuerelement dem übergeordneten Element einen TVN_GETDISPINFO Benachrichtigungscode, um den Index abzurufen, wenn es das Bild anzeigen muss.
cChildren
Typ: int
Flag, das angibt, ob das Element untergeordnete Elemente zugeordnet hat. Dieses Element kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
Das Element enthält keine untergeordneten Elemente. |
|
Das Element verfügt über ein oder mehrere untergeordnete Elemente. |
|
Das übergeordnete Fenster verfolgt, ob das Element untergeordnete Elemente enthält. In diesem Fall sendet das Steuerelement, wenn das Strukturansichtssteuerelement das Element anzeigen muss, dem übergeordneten Element einen TVN_GETDISPINFO Benachrichtigungscode, um zu bestimmen, ob das Element untergeordnete Elemente enthält. Wenn das Strukturansicht-Steuerelement über die TVS_HASBUTTONS Formatvorlage verfügt, wird dieses Element verwendet, um zu bestimmen, ob die Schaltfläche angezeigt werden soll, die das Vorhandensein untergeordneter Elemente angibt. Sie können dieses Element verwenden, um zu erzwingen, dass das Steuerelement die Schaltfläche anzeigt, obwohl das Element keine untergeordneten Elemente eingefügt hat. Auf diese Weise können Sie die Schaltfläche anzeigen und gleichzeitig die Speicherauslastung des Steuerelements minimieren, indem untergeordnete Elemente nur eingefügt werden, wenn das Element sichtbar oder erweitert ist. |
|
Version 6.0für die interne Verwendung vorgesehen; nicht für die Verwendung in Anwendungen empfohlen. Das Strukturansichtssteuerelement bestimmt automatisch, ob das Element untergeordnete Elemente enthält.
Hinweis Dieses Kennzeichen wird in zukünftigen Versionen von Comctl32.dllmöglicherweise nicht unterstützt. Außerdem ist dieses Flag nicht in commctrl.h definiert. Fügen Sie die folgende Definition zu den Quelldateien Ihrer Anwendung hinzu, um das Flag zu verwenden:
|
lParam
Typ: LPARAM-
Ein Wert, der dem Element zugeordnet werden soll.
iIntegral
Typ: int
Höhe des Elements in Vielfachen der Standardelementhöhe (siehe TVM_SETITEMHEIGHT). Wenn Sie dieses Element z. B. auf 2 festlegen, erhält das Element zweimal die Standardhöhe. Das Strukturansicht-Steuerelement zeichnet nicht im zusätzlichen Bereich, der unterhalb des Elementinhalts angezeigt wird, aber dieser Bereich kann von der Anwendung zum Zeichnen verwendet werden, wenn benutzerdefinierten Zeichnenverwendet wird. Anwendungen, die keine benutzerdefinierte Zeichnung verwenden, sollten diesen Wert auf 1 festlegen, da andernfalls das Verhalten nicht definiert ist.
uStateEx
Typ: UINT-
Internet Explorer 6 und höher. Eine oder mehrere (als bitweise Kombination) der folgenden erweiterten Zustände.
hwnd
Typ: HWND-
Internet Explorer 6 und höher. Nicht verwendet; muss NULL-sein.
iExpandedImage
Typ: int
Internet Explorer 6 und höher. Index des Bilds in der Bildliste des Steuerelements, das angezeigt werden soll, wenn sich das Element im erweiterten Zustand befindet.
iReserved
Typ: int
Reserviertes Mitglied. Nicht verwenden.
Bemerkungen
Anmerkung
Der commctrl.h-Header definiert TVITEMEX als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Header- | commctrl.h |