TVINSERTSTRUCT

ツリービューに新しく追加されるアイテムの情報が格納されます。この構造体はTVM_INSERTITEM メッセージで使用されます。

typedef struct tagTVINSERTSTRUCT {
    HTREEITEM  hParent;      // 親アイテムのハンドル
    HTREEITEM  hInsertAfter; // 挿入位置を表すアイテムのハンドル
#if (_WIN32_IE >= 0x0400)
    union
    {
        TVITEMEX itemex;     // 追加するアイテムについての構造体
        TVITEM item;
    } DUMMYUNIONNAME;
#else
    TVITEM item;             // 追加するアイテムについての構造体
#endif
} TVINSERTSTRUCT, FAR *LPTVINSERTSTRUCT;

※ (_WIN32_IE >= 0x0400) は Comctl32.dll Version 4.71 以降で有効

メンバ

hParent

親アイテムのハンドルを指定します。このメンバが 0xFFFF0000 (TVI_ROOT) または 0 (NULL) のときは、ツリービューのルートに挿入されます。

hInsertAfter

挿入位置を表すアイテムのハンドルを指定します。ここで指定されたアイテムの次の位置に挿入されます。または、以下の値を指定することもできます。

値	意味
0xFFFF0000 (TVI_ROOT)	アイテムをルートアイテムとして追加します。
0xFFFF0001 (TVI_FIRST)	アイテムをリストの最初の位置に挿入します。
0xFFFF0002 (TVI_LAST)	アイテムをリストの最後の位置に挿入します。
0xFFFF0003 (TVI_SORT)	アイテムをアルファベット順にリストに挿入します。

itemex

Version 4.71 以降： 追加するアイテムの情報を指定した TVITEMEX 構造体が格納されます。

item

追加するアイテムの情報を指定した TVITEM 構造体が格納されます。

対応情報

Windows 95 以降 / Windows NT 3.51 以降

変数との対応

Comctl32.dll Version 4.70 以前または itemex メンバを使用しない場合

Comctl32.dll Version 4.71 以降で itemex メンバを使用する場合