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:

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:

#define I_CHILDRENAUTO (-2)

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

Anforderungen

Siehe auch

Hinzufügen von Tree-View Elementen