CTreeCtrl::SetItem

Artigo
06/10/2015

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