TVITEMW-Struktur (commctrl.h)

Gibt Attribute eines Strukturansichtselements an oder empfängt sie. Diese Struktur ist identisch mit der TV_ITEM-Struktur , wurde jedoch umbenannt, um den aktuellen Benennungskonventionen zu entsprechen. Neue Anwendungen sollten diese Struktur verwenden.

Syntax

typedef struct tagTVITEMW {
  UINT      mask;
  HTREEITEM hItem;
  UINT      state;
  UINT      stateMask;
  LPWSTR    pszText;
  int       cchTextMax;
  int       iImage;
  int       iSelectedImage;
  int       cChildren;
  LPARAM    lParam;
} TVITEMW, *LPTVITEMW;

Member

mask

Typ: UINT

Array von Flags, die angeben, welche der anderen Strukturmember gültige Daten enthalten. Wenn diese Struktur mit der TVM_GETITEM-Nachricht verwendet wird, gibt das Maskenelement die abzurufenden Elementattribute an. Bei Verwendung mit der TVM_SETITEM Nachricht gibt die Maske die festzulegenden Attribute an. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln:

hItem

Typ: HTREEITEM

Handle mit dem Element.

state

Typ: UINT

Eine Reihe von Bitflags und Bildlistenindizes, die den Status des Elements angeben. Wenn Sie den Status eines Elements festlegen, gibt das stateMask-Element die gültigen Bits dieses Elements an. Beim Abrufen des Zustands eines Elements gibt dieser Member den aktuellen Zustand für die im stateMask-Element angegebenen Bits zurück.

Die Bits 0 bis 7 dieses Members enthalten die Elementstatusflags. Eine Liste der möglichen Elementstatusflags finden Sie unter Strukturansicht-Steuerelementelementzustände.

Das Überlagerungsbild wird dem Symbolbild des Elements überlagert. Die Bits 8 bis 11 dieses Members geben den 1-basierten Überlagerungsbildindex an. Wenn diese Bits 0 sind, hat das Element kein Überlagerungsbild. Um diese Bits zu isolieren, verwenden Sie die TVIS_OVERLAYMASK-Maske . Um den Überlagerungsbildindex in diesem Member festzulegen, verwenden Sie das Makro INDEXTOOVERLAYMASK . Die Überlagerungsbilder der Bildliste werden mit der ImageList_SetOverlayImage-Funktion festgelegt.

Ein Zustandsbild wird neben dem Symbol eines Elements angezeigt, um einen anwendungsdefinierten Zustand anzuzeigen. Geben Sie die Statusbildliste an, indem Sie eine TVM_SETIMAGELIST Nachricht senden. Um das Zustandsbild eines Elements festzulegen, fügen Sie den wert TVIS_STATEIMAGEMASK in das stateMask-Element der TVITEM-Struktur ein. Die Bits 12 bis 15 des Zustandselements der Struktur geben den Index in der Zustandsbildliste des zu zeichnenden Bilds an.

Um den Statusbildindex festzulegen, verwenden Sie INDEXTOSTATEIMAGEMASK. Dieses Makro nimmt einen Index an und legt die Bits 12 bis 15 entsprechend fest. Um anzugeben, dass das Element über kein Zustandsbild verfügt, legen Sie den Index auf Null fest. Diese Konvention bedeutet, dass image zero in der Statusimageliste nicht als Zustandsabbild verwendet werden kann. Um bits 12 bis 15 des Zustandsmitglieds zu isolieren, verwenden Sie die TVIS_STATEIMAGEMASK-Maske.

stateMask

Typ: UINT

Bits des Statusmitglieds , die gültig sind. Wenn Sie den Status eines Elements abrufen, legen Sie die Bits des stateMask-Members fest, um die bits anzugeben, die im Staatselement zurückgegeben werden sollen. Wenn Sie den Status eines Elements festlegen, legen Sie die Bits des stateMask-Members fest, um die Bits des zu festlegenden Staatsmitglieds anzugeben. Um den Überlagerungsbildindex eines Elements festzulegen oder abzurufen, legen Sie die TVIS_OVERLAYMASK Bits fest. Um den Zustandsbildindex eines Elements festzulegen oder abzurufen, legen Sie die TVIS_STATEIMAGEMASK Bits fest.

pszText

Typ: LPTSTR

Zeiger auf eine NULL-Zeichenfolge, die den Elementtext enthält, wenn die Struktur Elementattribute angibt. Wenn es sich bei diesem Element um den LPSTR_TEXTCALLBACK Wert handelt, 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 es den Elementtext zum Anzeigen, Sortieren oder Bearbeiten benötigt, und einen TVN_SETDISPINFO Benachrichtigungscode, 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 das pszText-Element verweist, in Zeichen. Wenn diese Struktur zum Festlegen von Elementattributen verwendet wird, wird dieser Member ignoriert.

iImage

Typ: int

Indexieren Sie in der Bildliste des Strukturansichtssteuerelements das Symbolbild, das verwendet werden soll, wenn sich das Element im nicht ausgewählten Zustand befindet. Wenn es sich bei diesem Member um den I_IMAGECALLBACK Wert handelt, 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 das Bild angezeigt werden muss.

iSelectedImage

Typ: int

Indexieren Sie in der Bildliste des Baumansicht-Steuerelements das Symbolbild, das verwendet werden soll, wenn sich das Element im ausgewählten Zustand befindet. Wenn es sich bei diesem Member um den I_IMAGECALLBACK Wert handelt, 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 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.

#define I_CHILDRENAUTO (-2)

lParam

Typ: LPARAM

Ein Wert, der dem Element zugeordnet werden soll.

Hinweise

Anforderungen