CTreeCtrl::SetItemExpandedImageIndex

Legt den Index des Bilds fest, die angezeigt wird, wenn das angegebene Element des aktuellen Strukturansicht-Steuerelements im erweiterten Zustand befindet.

BOOL SetItemExpandedImageIndex(
     HTREEITEM hItem, 
     int iExpandedImage
);

Parameter

Rückgabewert

true, wenn diese Methode erfolgreich ist; andernfalls false.

Hinweise

Diese Methode sendet die TVM_SETITEM Meldung, die im Windows SDK beschrieben wird. Diese Methode weist dem iExpandedImage-Member einer Struktur TVITEMEXiExpandedImage den Parameter und dann Verwendung zu, die in der Meldung strukturieren.

Anforderungen

Header: afxcmn.h

Diese Methode wird in Windows Vista und höher unterstützt.

Zusätzliche Anforderungen für diese Methode werden in Build-Anforderungen für Windows Vista-gemeinsame Regelungen beschrieben.

Beispiel

Im folgenden Codebeispiel wird eine Variable, m_treeCtrl, die verwendet wird, um auf das aktuelle Strukturansicht zuzugreifen.Im Codebeispiel wird auch eine ganze Zahl ohne Vorzeichen und einige HTREEITEM-Variablen.Diese Variablen werden im folgenden Beispiel verwendet.

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;

Im folgenden Codebeispiel ist ein trivialer Test, zu bestimmen, ob die CTreeCtrl::GetItemExpandedImageIndex-Methode den Wert zurückgibt, der durch die CTreeCtrl::SetItemExpandedImageIndex-Methode festgelegt ist.In einem früheren Abschnitt des Codebeispiels, das nicht angezeigt wird, haben wir eine Strukturansicht, die aus einem Stammland/regions-Knoten für USA, untergeordnete Knoten für die Pennsylvania und Staat Washington besteht, und Strukturelemente für Orte in diesen Zuständen.

    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);

Siehe auch

Referenz

CTreeCtrl-Klasse

Hierarchien-Diagramm

TVM_SETITEM

TVITEMEX

CTreeCtrl::GetItemExpandedImageIndex