TVINSERTSTRUCTA-Struktur (commctrl.h)

Enthält Informationen, die zum Hinzufügen eines neuen Elements zu einem Strukturansichtssteuerelement verwendet werden. Diese Struktur wird mit der TVM_INSERTITEM-Nachricht verwendet. Die Struktur ist mit der TV_INSERTSTRUCT-Struktur identisch, wurde jedoch umbenannt, um den aktuellen Benennungskonventionen zu entsprechen.

Syntax

typedef struct tagTVINSERTSTRUCTA {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXA itemex;
    TV_ITEMA  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTA, *LPTVINSERTSTRUCTA;

Member

hParent

Typ: HTREEITEM

Handle mit dem übergeordneten Element. Wenn es sich bei diesem Element um den TVI_ROOT Wert oder NULL handelt, wird das Element am Stamm des Strukturansichtssteuerelements eingefügt.

hInsertAfter

Typ: HTREEITEM

Behandeln Sie das Element, nach dem das neue Element eingefügt werden soll, oder mit einem der folgenden Werte:

Wert	Bedeutung
TVI_FIRST	Fügt das Element am Anfang der Liste ein.
TVI_LAST	Fügt das Element am Ende der Liste ein.
TVI_ROOT	Fügen Sie das Element als Stammelement hinzu.
TVI_SORT	Fügt das Element in alphabetischer Reihenfolge in die Liste ein.

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

Typ: TVITEMEX

Version 4.71. TVITEMEX-Struktur , die Informationen zum hinzuzufügenden Element enthält.

DUMMYUNIONNAME.item

Typ: TVITEM

TVITEM-Struktur , die Informationen zum hinzuzufügenden Element enthält.

Hinweise

Die Gewerkschaften in dieser Struktur wurden aktualisiert, um mit Compilern zu arbeiten, die keine namenlosen Gewerkschaften unterstützen. Wenn Ihr Compiler keine namenlosen Vereinigungen unterstützt, definieren Sie das NONAMELESSUNION-Token, bevor Sie die Commctrl.h-Headerdatei einschließen.

Wichtig Die Verwendung von TVI_LAST zum Einfügen eines Elements in einen Strukturansichtsknoten, der bereits eine große Anzahl von Elementen enthält, kann lange dauern, sodass die Anwendung nicht mehr reagiert, bis der Einfügevorgang abgeschlossen ist.

 

Hinweis

Der commctrl.h-Header definiert TVINSERTSTRUCT 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h