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
Parameter |
Description |
|---|---|
[in] hItem |
Handle für ein Strukturansicht-Steuerelement-Element. |
[in] iExpandedImage |
Der Index des Bilds, um anzuzeigen, wenn das angegebene Element im erweiterten Zustand ist. |
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);