CTreeCtrl::SetItem

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

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CTreeCtrl-Klasse

Hierarchien-Diagramm

CTreeCtrl::GetItem