CTreeCtrl::SetItemExpandedImageIndex

發行項
06/10/2015

設定影像的索引顯示目前樹狀檢視控制項的指定項目時處於展開狀態。

BOOL SetItemExpandedImageIndex(
     HTREEITEM hItem, 
     int iExpandedImage
);

參數

參數	描述
[in] hItem	對樹狀檢視控制項項目的控制代碼。
[in] iExpandedImage	顯示指定項目時要使用的影像的索引已展開的狀態。

傳回值

true ，如果此方法成功;否則， false。

備註

這個方法會將 TVM_SETITEM 資訊，在 Windows SDK中描述。這個方法會指派 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);