CTreeCtrl::SetItem

Article
06/10/2015

Appelez cette fonction pour définir les attributs de l'élément d'arborescence spécifié.

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

Paramètres

pItem
Un pointeur vers une structure de TVITEM qui contient les nouveaux attributs de l'élément, comme décrit dans Kit de développement logiciel Windows.
hItem
Handle de l'élément dont les attributs doivent être définis. Consultez le membre de hItem de la structure d' TVITEM dans Kit de développement logiciel Windows.
nMask
Spécifier entier qui l'attribut au jeu. Consultez le membre de MASK de la structure d' TVITEM .
lpszItem
Adresse d'une chaîne contenant le texte de l'élément.
nImage
Index de l'image de l'élément dans la liste d'images du contrôle arborescence. Consultez le membre iImage de la structure TVITEM.
nSelectedImage
Index de l'image sélectionnée de l'élément dans la liste d'images du contrôle arborescence. Consultez le membre d' iSelectedImage de la structure d' TVITEM .
nState
Spécifie des valeurs pour les états de l'élément. Consultez le membre de État de la structure d' TVITEM .
nStateMask
Spécifie les états doivent être définis. Consultez le membre de stateMask de la structure d' TVITEM .
lParam
Une valeur spécifique à l'application de 32 bits associé à l'élément.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Dans la structure d' TVITEM , le membre de hItem identifie l'élément, et le membre de MASK spécifie que l'attribut au jeu.

Si le membre de MASK ou le paramètre d' nMask spécifie la valeur d' TVIF_TEXT , le membre de pszText ou l' lpszItem est l'adresse d'une chaîne terminée par le caractère NULL et le membre de cchTextMax est ignoré. Si MASK (ou nMask) spécifie la valeur d' TVIF_STATE , le membre de stateMask ou le paramètre d' nStateMask spécifie que les états d'élément à modifier et le membre de état ou le paramètre d' nState contient des valeurs pour ces rapports.

Exemple

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