CTreeCtrl::SetItem

Artigo
08/25/2010

Chame essa função para conjunto os atributos do item de modo de exibição de árvore especificada.

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 para um TVITEM estrutura que contém sistema autônomo novos atributos do item, conforme descrito no Windows SDK.
hItem
Identificador do item cujos atributos devem ser definidas.Consulte o hItem membro do TVITEM estruturar no Windows SDK.
nMask
inteiro especificando quais atributos ao conjunto.Consulte o máscara membro do TVITEM estrutura.
lpszItem
Endereço de uma seqüência de caracteres que contém o texto do item.
nImage
Índice da imagem do item na lista de imagens controle de modo de exibição de árvore's.Consulte o iImage membro de TVITEM estrutura.
nSelectedImage
Índice do item selecionado imagem na lista de imagem controle de modo de exibição de árvore's.Consulte o iSelectedImage membro do TVITEM estrutura.
nState
Especifica valores para os estados do item.Consulte o Estado membro do TVITEM estrutura.
nStateMask
Especifica quais estados devem ser definidas.Consulte o stateMask membro do TVITEM estrutura.
lParam
Um valor específico do aplicativo de 32 bit associado ao item.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Comentários

No TVITEM estrutura, o hItem membro identifica o item e o máscara membro Especifica os atributos a serem definidas.

Se o máscara membro ou a nMask parâmetro especifica a TVIF_TEXT valor, o pszText membro ou a lpszItem é o endereço de uma seqüência de caracteres terminada com caractere nulo e o cchTextMax membro será ignorado.If máscara (or nMask) Especifica a TVIF_STATE valor, o stateMask membro ou a nStateMask parâmetro especifica qual item informa para alterar o estado membro ou nState parâmetro 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);
}