TVITEMA-Struktur (commctrl.h)

Artikel
11/18/2024

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 folgen. Neue Anwendungen sollten diese Struktur verwenden.

Syntax

typedef struct tagTVITEMA {
  UINT      mask;
  HTREEITEM hItem;
  UINT      state;
  UINT      stateMask;
  LPSTR     pszText;
  int       cchTextMax;
  int       iImage;
  int       iSelectedImage;
  int       cChildren;
  LPARAM    lParam;
} TVITEMA, *LPTVITEMA;

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
TVIF_CHILDREN	Das cChildren Member ist gültig.
TVIF_DI_SETITEM	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.
TVIF_HANDLE	Das hItem Member ist gültig.
TVIF_IMAGE	Das iImage Member ist gültig.
TVIF_PARAM	Das lParam- Mitglied ist gültig.
TVIF_SELECTEDIMAGE	Das iSelectedImage Member ist gültig.
TVIF_STATE	Der Status und stateMask Member sind gültig.
TVIF_TEXT	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.

Bits 0 bis 7 dieses Elements enthalten die Elementstatuskennzeichnungen. Eine Liste der möglichen Elementstatuskennzeichnungen finden Sie unter Tree-View Control Item States.

Das Überlagerungsbild wird über dem Symbolbild des Elements überlagert. Bits 8 bis 11 dieses Elements geben den 1-basierten Überlagerungsbildindex an. 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 das stateMask- Mitglied 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. Wenn Sie Bits 12 bis 15 des Zustands Member isolieren möchten, 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
null	Das Element enthält keine untergeordneten Elemente.
einer	Das Element verfügt über ein oder mehrere untergeordnete Elemente.
I_CHILDRENCALLBACK	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.
I_CHILDRENAUTO	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: `#define I_CHILDRENAUTO (-2)`

lParam

Typ: LPARAM-

Ein Wert, der dem Element zugeordnet werden soll.

Bemerkungen

Anmerkung

Der commctrl.h-Header definiert TVITEM als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Freigeben über

TVITEMA-Struktur (commctrl.h)

Syntax

Angehörige

Bemerkungen

Anforderungen

Feedback

Zusätzliche Ressourcen