CTreeCtrl::SetItem

Articolo
06/10/2015

Chiamare la funzione per impostare gli attributi dell'elemento specificato della visualizzazione struttura ad albero.

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

Parametri

pItem
Un puntatore a una struttura TVITEM contenente i nuovi attributi dell'elemento, come descritto in Windows SDK.
hItem
Handle dell'elemento con gli attributi devono essere impostati. Vedere il membro hItem della struttura TVITEM in Windows SDK.
nMask
Specificare intero che gli attributi per impostare. Vedere il membro mask della struttura TVITEM.
lpszItem
Indirizzo di una stringa contenente il testo dell'elemento.
nImage
Indice dell'immagine dell'elemento nell'elenco immagini del controllo di visualizzazione ad albero. Vedere il membro iImage della struttura TVITEM.
nSelectedImage
Indice dell'immagine selezionare l'elemento nell'elenco immagini del controllo di visualizzazione ad albero. Vedere il membro iSelectedImage della struttura TVITEM.
nState
Specifica i valori degli stati degli elementi. Vedere il membro Stato della struttura TVITEM.
nStateMask
Specifica che gli stati devono essere impostati. Vedere il membro stateMask della struttura TVITEM.
lParam
Un valore specifico dell'applicazione a 32 bit associato all'elemento.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

Nella struttura TVITEM, il membro hItem identifica l'elemento e il membro mask specifica che gli attributi per impostare.

Se il membro mask o il parametro nMask specifica il valore TVIF_TEXT, il membro pszText o lpszItem è l'indirizzo di una stringa con terminazione null e il membro cchTextMax viene ignorato. Se mask (o) nMaskspecifica il valore TVIF_STATE, il membro stateMask o il parametro nStateMask specificare che l'elemento dichiara per la modifica e il membro state o il parametro nState contiene i valori per tali stati.

Esempio

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