次の方法で共有

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 構造体を します。

備考

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

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

手記

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

必要条件

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