Freigeben über

TVINSERTSTRUCTA-Struktur (commctrl.h)

  • Artikel

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

Syntax

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

Angehörige

hParent

Typ: HTREEITEM-

Behandeln des übergeordneten Elements. Wenn dieses Element der TVI_ROOT Wert oder NULL-ist, wird das Element im Stammverzeichnis des Strukturansichtssteuerelements eingefügt.

hInsertAfter

Typ: HTREEITEM-

Behandeln Sie das Element, nach dem das neue Element eingefügt werden soll, oder einen 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 die Liste in alphabetischer Reihenfolge 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.

Bemerkungen

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 Headerdatei "commctrl.h" einschließen.

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

Anmerkung

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
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- commctrl.h