CTreeCtrl::SetItemExpandedImageIndex
現在のツリー ビュー コントロール内の指定されたアイテムが展開状態になっているときに表示するイメージのインデックスを設定します。
BOOL SetItemExpandedImageIndex(
HTREEITEM hItem,
int iExpandedImage
);
パラメーター
パラメーター |
説明 |
|---|---|
[入力] hItem |
ツリー ビュー コントロールのアイテムへのハンドル。 |
[入力] iExpandedImage |
指定されたアイテムの展開状態になっているときに表示するイメージのインデックス。 |
戻り値
このメソッドが成功した場合は true。それ以外の場合は false。
解説
このメソッドは Windows SDKで説明する TVM_SETITEM のメッセージを送信します。次に、このメソッドは TVITEMEX の構造体の iExpandedImage のメンバーに iExpandedImage のメッセージで構成されるパラメーター、および使用を割り当てます。
必要条件
ヘッダー: 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;
次のコード例に CTreeCtrl::GetItemExpandedImageIndex のメソッドが CTreeCtrl::SetItemExpandedImageIndex のメソッドによって設定された値を返すかどうかを決定する単純なテストです。表示されていないコード例では、前のセクションでは、米国のルートの国または地域のノード、およびワシントン州ペンシルバニア状態のサブノードで構成される、これらの状態の都市のツリー項目のツリー ビューを作成しました。
CString str;
CString msg = _T("The set and retrieved item expanded image ")
_T("indexes are%s equal.");
int nSetItem = 0;
m_treeCtrl.SetItemExpandedImageIndex( hCountry, nSetItem );
int nItem = m_treeCtrl.GetItemExpandedImageIndex( hCountry );
if (nItem == nSetItem)
str.Format(msg, _T(""));
else
str.Format(msg, _T(" not"));
AfxMessageBox(str, MB_ICONINFORMATION);