CTreeCtrl::SetItem

Artigo
02/25/2013

Chamar essa função para definir os atributos de item especificado modo de exibição de árvore.

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
Um ponteiro a estrutura de TVITEM que contém os novos atributos de item, como descrito em Windows SDK.
hItem
Identificador de item cujos atributos devem ser definidos.Consulte o membro de hItem estrutura de TVITEM em Windows SDK.
nMask
Especificar inteiro que atribui para definir.Consulte o membro de mask estrutura de TVITEM .
lpszItem
Endereço de uma cadeia de caracteres que contém o texto do item.
nImage
Índice de imagem do item na lista de imagem do controle de exibição de árvore.Consulte o membro de iImage estrutura de TVITEM .
nSelectedImage
Índice da imagem selecionada do item na lista de imagem do controle de exibição de árvore.Consulte o membro de iSelectedImage estrutura de TVITEM .
nState
Especifica valores para os estados de item.Consulte o membro de Estado estrutura de TVITEM .
nStateMask
Especifica que estados devem ser definidos.Consulte o membro de stateMask estrutura de TVITEM .
lParam
Um valor específico do aplicativo de 32 bits associado com o item.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Em a estrutura de TVITEM , o membro de hItem identifica o item, e o membro de mask especifica que atribui para definir.

Se o membro de mask ou o parâmetro de nMask especificam o valor de TVIF_TEXT , o membro de pszText ou lpszItem são o endereço de uma cadeia de caracteres NULL-finalizada e o membro de cchTextMax é ignorado.Se mask (ou) nMaskespecificam o valor de TVIF_STATE , o membro de stateMask ou o parâmetro de nStateMask que especificam os estados de item para alterar e o membro de state ou o parâmetro de nState contêm os valores para os estados.

Exemplo

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