共用方式為

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

要求

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