CTreeCtrl::SetItemStateEx
現在のツリー ビュー コントロール内の指定されたアイテムの展開状態を設定します。
BOOL SetItemStateEx(
HTREEITEM hItem,
UINT uStateEx
);
パラメーター
パラメーター |
説明 |
---|---|
[入力] hItem |
ツリー ビュー コントロールのアイテムへのハンドル。 |
[入力] uStateEx |
アイテムの展開状態。詳細については、TVITEMEX の構造体の uStateEx のメンバーを参照してください。 |
戻り値
このメソッドが成功した場合は true。それ以外の場合は false。
解説
このメソッドは Windows SDKで説明する TVM_SETITEM のメッセージを送信します。次に、このメソッドは TVITEMEX の構造体の uStateEx のメンバーに 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;
次のコード例は、無効な状態にツリー ビュー アイテムを設定します。表示されていないコード例では、前のセクションでは、米国のルートの国または地域のノード、およびワシントン州ペンシルバニア状態のサブノードで構成される、これらの状態の都市のツリー項目のツリー ビューを作成しました。このコード例は、無効な状態にペンシルバニアのノードを設定します。
// Disable the Pennsylvania node.
m_treeCtrl.SetItemStateEx( hPA, TVIS_EX_DISABLED );