Share via

TVINSERTSTRUCTW 構造体 (commctrl.h)

  • [アーティクル]

ツリー ビュー コントロールに新しい項目を追加するために使用する情報が含まれます。 この構造体は、 TVM_INSERTITEM メッセージと共に使用されます。 構造体は TV_INSERTSTRUCT 構造体と同じですが、現在の名前付け規則に従うように名前が変更されました。

構文

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

メンバー

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 構造体。

注釈

この構造体の共用体は、名前のない共用体をサポートしていないコンパイラと連携するように更新されました。 コンパイラで名前のない共用体がサポートされていない場合は、commctrl.h ヘッダー ファイルを含める前に NONAMELESSUNION トークンを定義してください。

大事な TVI_LASTを使用して、既に多数の項目が含まれているツリー ビュー ノードに項目を挿入すると、長い時間がかかり、挿入操作が完了するまでアプリケーションの応答が停止する可能性があります。
 

注意

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして TVINSERTSTRUCT を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header commctrl.h