TVITEMEXA-Struktur (commctrl.h)
Gibt Attribute eines Strukturansichtselements an oder empfängt diese. Diese Struktur ist eine Erweiterung der TVITEM-Struktur . Neue Anwendungen sollten diese Struktur bei Bedarf 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;
Member
mask
Typ: UINT
Array von Flags, die angeben, welche der anderen Strukturmember gültige Daten enthalten. Wenn diese Struktur mit der TVM_GETITEM Meldung verwendet wird, gibt das Maskenelement die abzurufenden Elementattribute an. Bei Verwendung mit der TVM_SETITEM Meldung gibt die Maske die festzulegenden Attribute an. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln:
| Wert | Bedeutung |
|---|---|
|
Das cChildren-Element ist gültig. |
|
Das Strukturansichtssteuerelement behält die bereitgestellten Informationen bei und fordert sie nicht erneut an. Dieses Flag ist nur gültig, wenn die TVN_GETDISPINFO Benachrichtigung verarbeitet wird. |
|
Version 6.00 und Windows Vista. Das iExpandedImage-Element ist gültig. |
|
Das hItem-Element ist gültig. |
|
Das iImage-Element ist gültig. |
|
Das iIntegral-Element ist gültig. |
|
Das lParam-Element ist gültig. |
|
Das iSelectedImage-Element ist gültig. |
|
Die Member state und stateMask sind gültig. |
|
Version 6.00 und Windows Vista. Das uStateEx-Element ist gültig. |
|
Die Elemente pszText und cchTextMax sind gültig. |
hItem
Typ: HTREEITEM
Handle für das Element.
state
Typ: UINT
Eine Reihe von Bitflags und Bildlistenindizes, die den Status des Elements angeben. Beim Festlegen des Zustands eines Elements gibt der stateMask-Member die gültigen Bits dieses Elements an. Beim Abrufen des Zustands eines Elements gibt dieses Element den aktuellen Zustand für die bits zurück, die im stateMask-Element angegeben sind. Weitere Informationen zu diesem Member finden Sie im Abschnitt "Hinweise".
Die Bits 0 bis 7 dieses Members enthalten die Elementstatusflags. Eine Liste der möglichen Elementstatusflags finden Sie unter Strukturansicht-Steuerelementelementstatus.
Die Bits 8 bis 11 dieses Members geben den index für einbasiertes Überlagerungsbild an. Das Überlagerungsbild wird über dem Symbolbild des Elements angeordnet. Wenn diese Bits null sind, verfügt das Element über kein Überlagerungsbild. Um diese Bits zu isolieren, verwenden Sie die TVIS_OVERLAYMASK-Maske . Verwenden Sie das Makro INDEXTOOVERLAYMASK , um den Überlagerungsbildindex in diesem Member festzulegen. Die Überlagerungsbilder der Bildliste werden mit der funktion ImageList_SetOverlayImage 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 Zustandsbild eines Elements festzulegen, schließen Sie den TVIS_STATEIMAGEMASK-Wert in the stateMask member der TVITEM-Struktur ein. Die Bits 12 bis 15 des Zustandselements der Struktur geben den Index in der Statusbildliste des zu zeichnenden Bilds an.
Verwenden Sie INDEXTOSTATEIMAGEMASK, um den Statusbildindex festzulegen. Dieses Makro nimmt einen Index an und legt die Bits 12 bis 15 entsprechend fest. Um anzugeben, dass das Element kein Zustandsbild aufweist, legen Sie den Index auf 0 (null) fest. Diese Konvention bedeutet, dass image zero in der Statusimageliste nicht als Zustandsbild verwendet werden kann. Verwenden Sie die TVIS_STATEIMAGEMASK maske, um die Bits 12 bis 15 des Zustandselements zu isolieren.
stateMask
Typ: UINT
Bits des gültigen Landesmitglieds . Wenn Sie den Zustand eines Elements abrufen, legen Sie die Bits des stateMask-Elements fest, um die bits anzugeben, die im State-Member zurückgegeben werden sollen. Wenn Sie den Status eines Elements festlegen, legen Sie die Bits des stateMask-Elements fest, um die Bits des festzulegenden Zustandsmitglieds anzugeben. 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
Zeiger auf eine NULL-endende Zeichenfolge, die den Elementtext enthält, wenn die Struktur Elementattribute angibt. Wenn dieser Member der LPSTR_TEXTCALLBACK Wert ist, ist das übergeordnete Fenster für die Speicherung des Namens verantwortlich. In diesem Fall sendet das Strukturansichtssteuerelement dem übergeordneten Fenster einen TVN_GETDISPINFO Benachrichtigungscode, wenn es den Elementtext zum Anzeigen, Sortieren oder Bearbeiten und einen TVN_SETDISPINFO Benachrichtigungscode benötigt, 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 mit dem Strukturansichtssteuerelement zwar beliebige Längenzeichenfolgen als Elementtext gespeichert werden können, aber nur die ersten 260 Zeichen angezeigt werden.
cchTextMax
Typ: int
Größe des Puffers, auf den der pszText-Member in Zeichen verweist. Wenn diese Struktur zum Festlegen von Elementattributen verwendet wird, wird dieser Member ignoriert.
iImage
Typ: int
Index in der Bildliste des Strukturansichtssteuerelements des Symbolbilds, das verwendet werden soll, wenn sich das Element im nicht ausgewählten Zustand befindet. Wenn dieser Member der I_IMAGECALLBACK Wert ist, ist das übergeordnete Fenster für die Speicherung des Indexes zuständig. In diesem Fall sendet das Strukturansicht-Steuerelement dem übergeordneten Element einen TVN_GETDISPINFO Benachrichtigungscode, um den Index abzurufen, wenn das Bild angezeigt werden muss.
iSelectedImage
Typ: int
Index in der Bildliste des Strukturansichtssteuerelements des Symbolbilds, das verwendet werden soll, wenn sich das Element im ausgewählten Zustand befindet. Wenn dieser Member der I_IMAGECALLBACK Wert ist, ist das übergeordnete Fenster für die Speicherung des Indexes zuständig. In diesem Fall sendet das Strukturansicht-Steuerelement dem übergeordneten Element einen TVN_GETDISPINFO Benachrichtigungscode, um den Index abzurufen, wenn das Bild angezeigt werden muss.
cChildren
Typ: int
Flag, das angibt, ob dem Element untergeordnete Elemente zugeordnet sind. Dieser Member 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. |
|
Im übergeordneten Fenster wird nachverfolgt, ob das Element über untergeordnete Elemente verfügt. Wenn das Strukturansichtssteuerelement das Element anzeigen muss, sendet das Steuerelement dem übergeordneten Element einen TVN_GETDISPINFO Benachrichtigungscode, um zu bestimmen, ob das Element untergeordnete Elemente enthält. Wenn das Strukturansichtssteuerelement über das TVS_HASBUTTONS-Format verfügt, wird mit diesem Member bestimmt, 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 im Element keine untergeordneten Elemente eingefügt wurden. Dadurch können Sie die Schaltfläche anzeigen und gleichzeitig die Speicherauslastung des Steuerelements minimieren, indem Sie untergeordnete Elemente nur einfügen, 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 Flag wird in zukünftigen Versionen von Comctl32.dll möglicherweise nicht unterstützt. Außerdem ist dieses Flag nicht in commctrl.h definiert. Fügen Sie den Quelldateien Ihrer Anwendung die folgende Definition 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 diesen Member z. B. auf 2 festlegen, erhält das Element die doppelte Standardhöhe. Das Strukturansicht-Steuerelement zeichnet nicht den zusätzlichen Bereich, der unterhalb des Elementinhalts angezeigt wird, aber dieser Bereich kann von der Anwendung zum Zeichnen verwendet werden, wenn benutzerdefiniertes Zeichnen verwendet 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. Ein 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. Darf nicht verwendet werden.
Hinweise
Hinweis
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
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | commctrl.h |