CTreeCtrl::SetItem

Artykuł
02/27/2013

Wywołanie tej funkcji, aby ustawić atrybuty elementu widoku drzewa określony.

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

Parametry

pItem
Wskaźnik do TVITEM strukturę, która zawiera nowy element atrybuty, jak opisano w Windows SDK.
hItem
Uchwyt element, którego atrybuty mają być wyznaczone.Zobacz hItem członek TVITEM struktury w Windows SDK.
nMask
Liczba całkowita określająca ustawić atrybuty.Zobacz maski członek TVITEM struktury.
lpszItem
Adres ciąg zawierający tekst elementu.
nImage
Indeks elementu obrazu na liście obrazów formantu widoku drzewa.Zobacz iImage członek TVITEM struktury.
nSelectedImage
Indeks elementu wybranego obrazu na liście obrazów formantu widoku drzewa.Zobacz iSelectedImage członek TVITEM struktury.
nState
Określa wartości elementu Państwa.Zobacz Państwo członek TVITEM struktury.
nStateMask
Określa, które Państwa powinny zostać przedstawione.Zobacz stateMask członek TVITEM struktury.
lParam
Wartości specyficznych dla aplikacji 32-bitowych skojarzone z elementem.

Wartość zwracana

Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.

Uwagi

W TVITEM struktury hItem Członkowskich identyfikuje element i maski Członkowskich określa, aby ustawić atrybuty.

Jeśli maski Członkowskie lub nMask określa parametr TVIF_TEXT wartości, pszText Członkowskich lub lpszItem jest adresem ciąg zakończony znakiem null i cchTextMax Członkowskich jest ignorowana.Jeśli maski (lub nMask) Określa TVIF_STATE wartości, stateMask Członkowskich lub nStateMask parametr określa, który element Państwa do zmiany i Państwo Członkowskich lub nState parametr zawiera wartości dla tych państw.

Przykład

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