CTreeCtrl::SetItemExpandedImageIndex

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

BOOL SetItemExpandedImageIndex(
          HTREEITEM hItem, 
          int iExpandedImage
);

パラメータ

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

戻り値

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

解説

このメソッドは、Windows SDK で説明されている TVM_SETITEM メッセージを送信します。このメソッドは、iExpandedImage パラメータを TVITEMEX 構造体の 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);