CTreeCtrl::SetItem

Článek
06/10/2015

Volání této funkce nastavit atributy určené stromové zobrazení položky.

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

Parametry

pItem
Ukazatel TVITEM struktura, která obsahuje novou položku atributy, jak je popsáno v .
hItem
Popisovač zboží, jehož atributy budou.Najdete hItem člena TVITEM struktury v .
nMask
Celé číslo určující atributy, které chcete nastavit.Najdete Maska člen TVITEM struktury.
lpszItem
Řetězec obsahující text na položku Adresa.
nImage
Index obrázku pro položky v seznamu stromové zobrazení ovládacího prvku obrázek.Najdete iImage člena TVITEM struktury.
nSelectedImage
Index obrázku položky vybrané v seznamu stromové zobrazení ovládacího prvku obrázek.Najdete iSelectedImage člena TVITEM struktury.
nState
Určuje hodnoty pro položky státy.Najdete stavu člen TVITEM struktury.
nStateMask
Určuje, které státy mají být nastaveny.Najdete stateMask člena TVITEM struktury.
lParam
Hodnota 32bitové aplikace související s položkou.

Vrácená hodnota

Nenulová hodnota, pokud je úspěšná. jinak 0.

Poznámky

V TVITEM struktury, hItem člen označuje položky a Maska člena Určuje atributy, které chcete nastavit.

Pokud Maska členské nebo nMask parametr určuje TVIF_TEXT hodnotu, pszText členských nebo lpszItem je adresa řetězec zakončený a cchTextMax bude tato vlastnost ignorována.Pokud Maska (nebo nMask ) určuje TVIF_STATE hodnotu, stateMask členských nebo nStateMask parametr určuje, která položka státy změnit a stavu členských nebo nState parametr obsahuje hodnoty pro tyto státy.

Příklad

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