Freigeben über


CTreeCtrl::SetItemStateEx

Legt den erweiterten Zustand des angegebenen Elements im aktuellen Strukturansicht-Steuerelement fest.

BOOL SetItemStateEx(
     HTREEITEM hItem, 
     UINT uStateEx
);

Parameter

Parameter

Description

[in] hItem

Handle für ein Strukturansicht-Steuerelement-Element.

[in] uStateEx

Der erweiterte Zustand des Elements.Weitere Informationen finden Sie im uStateEx-Member der TVITEMEX-Struktur.

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 uStateEx-Member einer Struktur TVITEMEXuStateEx 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 wird ein Strukturansichtelement dem deaktivierten Zustand.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.Dieses Codebeispiel legt den Pennsylvania-Knoten dem deaktivierten Zustand.

    // Disable the Pennsylvania node.
    m_treeCtrl.SetItemStateEx( hPA, TVIS_EX_DISABLED );

Siehe auch

Referenz

CTreeCtrl-Klasse

Hierarchien-Diagramm

CTreeCtrl::GetItemStateEx

TVM_SETITEM

TVITEMEX