CTreeCtrl::SetItem

Artikel
06/10/2015

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