CTreeCtrl::SetItemStateEx
更新 : 2007 年 11 月
現在のツリー ビュー コントロール内の指定されたアイテムの展開状態を設定します。
BOOL SetItemStateEx(
HTREEITEM hItem,
UINT uStateEx
);
パラメータ
パラメータ |
説明 |
|---|---|
[入力] hItem |
ツリー ビュー コントロール アイテムへのハンドル。 |
[入力] uStateEx |
アイテムの展開状態。詳細については、TVITEMEX 構造体の uStateEx メンバを参照してください。 |
戻り値
このメソッドが成功した場合は true。それ以外の場合は false。
解説
このメソッドは、Windows SDK で説明されている TVM_SETITEM メッセージを送信します。このメソッドは、uStateEx パラメータを TVITEMEX 構造体の uStateEx メンバに割り当ててから、その構造体をメッセージで使用します。
必要条件
ヘッダー : afxcmn.h
このメソッドは、Windows Vista およびそれ以降のバージョンでサポートされています。
このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。
使用例
次のコード例では、現在のツリー ビュー コントロールへのアクセスに使用される変数 m_treeCtrl を定義しています。コード例では、符号なし整数といくつかの HTREEITEM 変数も定義しています。これらの変数は、次の例で使用されます。
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
次のコード例では、ツリー ビュー アイテムを無効な状態に設定しています。ここには示されていないコード例の前半では、ルート ノードである米国ノード、ペンシルバニア州とワシントン州を表すサブノード、およびこれらの州の都市を表すツリー アイテムから構成されるツリー ビューを作成しました。このコード例では、Pennsylvania ノードを無効な状態に設定しています。
// Disable the Pennsylvania node.
m_treeCtrl.SetItemStateEx( hPA, TVIS_EX_DISABLED );