CTreeCtrl::SetItemExpandedImageIndex

[アーティクル]
08/09/2011

現在のツリービューコントロール内の指定されたアイテムが展開状態になっているときに表示するイメージのインデックスを設定します。

BOOL SetItemExpandedImageIndex(
     HTREEITEM hItem, 
     int iExpandedImage
);

パラメーター

パラメーター	説明
[入力] hItem	ツリービューコントロールアイテムへのハンドル。
[入力] iExpandedImage	指定したアイテムが展開状態になっているときに表示するイメージのインデックス。

戻り値

このメソッドが成功した場合は true。それ以外の場合は false。

解説

このメソッドは、送信、TVM_SETITEMに記載されているメッセージ、Windows SDK。このメソッドを割り当てます、iExpandedImageパラメーターに、iExpandedImageのメンバー、TVITEMEX構造をクリックし、[内のメッセージの構造を使用して。

必要条件

**ヘッダー:**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);