TVINSERTSTRUCTA 結構 (commctrl.h)

  • 發行項

包含用來將新專案加入樹視圖控件的資訊。 此結構會與 TVM_INSERTITEM 訊息搭配使用。 結構與 TV_INSERTSTRUCT 結構相同，但已重新命名為遵循目前的命名慣例。

語法

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

成員

hParent

類型： HTREEITEM

父專案的句柄。 如果這個成員是TVI_ROOT值或 NULL，專案就會插入樹視圖控件的根目錄。

hInsertAfter

類型： HTREEITEM

要插入新專案或下列其中一個值的項目句柄：

值 意義
TVI_FIRST
 在清單開頭插入專案。
TVI_LAST
 在清單結尾插入專案。
TVI_ROOT
 將專案新增為根專案。
TVI_SORT
 依字母順序將專案插入清單中。

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

類型： TVITEMEX

4.71 版。 TVITEMEX 結構，其中包含要加入之專案的相關信息。

DUMMYUNIONNAME.item

類型： TVITEM

TVITEM 結構，其中包含要加入之專案的相關信息。

備註

此結構中的等位已更新為使用不支援無名稱等位的編譯程式。 如果您的編譯程式不支援無名稱等位，請先定義NONAMELESSUNION令牌，再包含 commctrl.h 頭檔。

重要 使用TVI_LAST將專案插入已包含大量專案的樹視圖節點可能需要很長的時間，導致應用程式停止回應，直到插入作業完成為止。
 

注意

commctrl.h 標頭會將TVINSERTSTRUCT定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 commctrl.h