CTreeCtrl::SetItem

Artikel
02/26/2013

Rufen Sie diese Funktion, um die Attribute des angegebenen Strukturansichtelements festzulegen.

BOOL SetItem(
   TVITEM* pItem 
);
BOOL SetItem(
   HTREEITEM hItem,
   UINT nMask,
   LPCTSTR lpszItem,
   int nImage,
   int nSelectedImage,
   UINT nState,
   UINT nStateMask,
   LPARAM lParam 
);

Parameter

pItem
Ein Zeiger auf eine TVITEM-Struktur, die die Attribute des neuen Elements enthält, wie in Windows SDK beschrieben.
hItem
Handle des Elements, dessen Attribute festgelegt werden sollen.Siehe den hItem-Member der TVITEM-Struktur in Windows SDK.
nMask
Ganzzahliges angibt, das zum, um festzulegen.Siehe den mask-Member der TVITEM-Struktur.
lpszItem
Adresse einer Zeichenfolge, die den Text des Elements enthält.
nImage
Index des Bilds des Elements in der Bildliste der Strukturansicht.Siehe den iImage-Member der TVITEM-Struktur.
nSelectedImage
Index des ausgewählten Bilder des Elements in der Bildliste der Strukturansicht.Siehe den iSelectedImage-Member der TVITEM-Struktur.
nState
Gibt Werte für die Zustände des Elements an.Siehe den Zustand-Member der TVITEM-Struktur.
nStateMask
Gibt an, welche Zustände festgelegt werden sollen.Siehe den stateMask-Member der TVITEM-Struktur.
lParam
Ein anwendungsspezifisches 32-Bit-Wert mit dem Element zugeordnet.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

In der TVITEM-Struktur identifiziert der hItem-Member das Element, und der mask-Member gibt an, der zum, um festzulegen.

Wenn der mask-Member oder der nMask-Parameter den Wert TVIF_TEXT angibt, ist der pszText-Member oder lpszItem die Adresse einer auf NULL endende Zeichenfolge und der cchTextMax-Member wird ignoriert.Wenn mask (oder nMask) den TVIF_STATE-Wert angegeben wird, gibt der stateMask-Member oder der nStateMask-Parameter an, den Element angibt, um zu ändern und der state-Member oder der nState-Parameter enthält die Werte für diese Zustände.

Beispiel

// Show the item at the point myPoint in bold.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);

if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
   m_TreeCtrl.SetItem(hItem, TVIF_STATE, NULL, 0, 0, TVIS_BOLD, 
      TVIS_BOLD, 0);
}