CTreeCtrl::SetItem

Artículo
02/19/2013

Llame a esta función para establecer los atributos del elemento especificado de la vista de árbol.

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

Parámetros

pItem
Un puntero a una estructura de TVITEM que contiene los atributos del nuevo elemento, como se describe en Windows SDK.
hItem
Identificador del elemento cuyos atributos deben estar establecidos.Vea el miembro de hItem de la estructura de TVITEM en Windows SDK.
nMask
Especificar el entero que admite el conjunto.Vea el miembro de mask de la estructura de TVITEM .
lpszItem
Dirección de cadena que contiene el texto del elemento.
nImage
Índice del elemento en la lista del control de vista de árbol.Vea el miembro iImage de la estructura TVITEM.
nSelectedImage
Índice de la imagen seleccionada del elemento en la lista del control de vista de árbol.Vea el miembro de iSelectedImage de la estructura de TVITEM .
nState
Especifica los valores para los estados del elemento.Vea el miembro de Estado de la estructura de TVITEM .
nStateMask
Especifica que los estados deben estar establecidas.Vea el miembro de stateMask de la estructura de TVITEM .
lParam
Valor específico de la aplicación de 32 bits asociado al elemento.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

En la estructura de TVITEM , el miembro de hItem identifica el elemento, y el miembro de mask especifica que admite el conjunto.

Si el miembro de mask o el parámetro de nMask especifica el valor de TVIF_TEXT , el miembro de pszText o lpszItem es la dirección de una cadena terminada en null y se omite el miembro de cchTextMax .Si mask (o nMask) especifica el valor de TVIF_STATE , el miembro de stateMask o el parámetro de nStateMask especifica que el elemento indica para cambiar y el miembro de state o el parámetro de nState contiene valores para esos estados.

Ejemplo

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