TVINSERTSTRUCTW-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 folgen.

Syntax

typedef struct tagTVINSERTSTRUCTW {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXW itemex;
    TV_ITEMW  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTW, *LPTVINSERTSTRUCTW;

Member

hParent

Typ: HTREEITEM

Handle mit dem übergeordneten Element. Wenn dieser Member der TVI_ROOT Wert oder NULL ist, wird das Element im Stammverzeichnis des Strukturansichtssteuerelements eingefügt.

hInsertAfter

Typ: HTREEITEM

Handle mit dem Element, nach dem das neue Element eingefügt werden soll, oder 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 Unions in dieser Struktur wurden aktualisiert, um mit Compilern zu arbeiten, die keine namenlosen Unions unterstützen. Wenn Ihr Compiler keine namenlosen Unions 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 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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h