CTreeCtrl::InsertItem

Artigo
06/10/2015

Chamar essa função para inserir um novo item em um controle de exibição de árvore.

HTREEITEM InsertItem( 
   LPTVINSERTSTRUCT lpInsertStruct  
); 
HTREEITEM InsertItem( 
   UINT nMask, 
   LPCTSTR lpszItem, 
   int nImage, 
   int nSelectedImage, 
   UINT nState, 
   UINT nStateMask, 
   LPARAM lParam, 
   HTREEITEM hParent, 
   HTREEITEM hInsertAfter  
); 
HTREEITEM InsertItem( 
   LPCTSTR lpszItem, 
   HTREEITEM hParent = TVI_ROOT, 
   HTREEITEM hInsertAfter = TVI_LAST  
); 
HTREEITEM InsertItem( 
   LPCTSTR lpszItem, 
   int nImage, 
   int nSelectedImage, 
   HTREEITEM hParent = TVI_ROOT, 
   HTREEITEM hInsertAfter = TVI_LAST 
);

Parâmetros

lpInsertStruct
Um ponteiro para TVINSERTSTRUCT que especifica atributos de item do modo de exibição de árvore a ser inserido.
nMask
Especificar inteiro que atribui para definir. Consulte a estrutura de TVITEM em Windows SDK.
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.
nSelectedImage
Índice da imagem selecionada do item na lista de imagem do controle de exibição de árvore.
nState
Especifica valores para os estados de item. Consulte estados de item de controle de exibição de árvore em Windows SDK para obter uma lista de estados apropriadas.
nStateMask
Especifica que estados devem ser definidos. Consulte a estrutura de TVITEM em Windows SDK.
lParam
Um valor específico do aplicativo de 32 bits associado com o item.
hParent
Identificador do pai do item inserido.
hInsertAfter
A alça de item após o qual o novo item deve ser inserido.

Valor de retorno

Identificador do novo item se com êxito; se não NULO.

Comentários

O exemplo a seguir mostra as situações em que você talvez queira usar cada versão de função ao inserir um item de controle da árvore.

Exemplo

// Insert a root item using the structure. We must 
// initialize a TVINSERTSTRUCT structure and pass its 
// address to the call. 

TVINSERTSTRUCT tvInsert;
tvInsert.hParent = NULL;
tvInsert.hInsertAfter = NULL;
tvInsert.item.mask = TVIF_TEXT;
tvInsert.item.pszText = _T("United States");

HTREEITEM hCountry = m_TreeCtrl.InsertItem(&tvInsert);

// Insert subitems of that root. Pennsylvania is 
// a state in the United States, so its item will be a child 
// of the United States item. We won't set any image or states, 
// so we supply only the TVIF_TEXT mask flag. This 
// override provides nearly complete control over the 
// insertion operation without the tedium of initializing 
// a structure. If you're going to add lots of items 
// to a tree, you might prefer the structure override 
// as it affords you a performance win by allowing you 
// to initialize some fields of the structure only once, 
// outside of your insertion loop.

HTREEITEM hPA = m_TreeCtrl.InsertItem(TVIF_TEXT,
   _T("Pennsylvania"), 0, 0, 0, 0, 0, hCountry, NULL);

// Insert the "Washington" item and assure that it is
// inserted after the "Pennsylvania" item. This override is 
// more appropriate for conveniently inserting items with  
// images.

HTREEITEM hWA = m_TreeCtrl.InsertItem(_T("Washington"),
   0, 0, hCountry, hPA);

// We'll add some cities under each of the states. 
// The override used here is most appropriate 
// for inserting text-only items.

m_TreeCtrl.InsertItem(_T("Pittsburgh"), hPA, TVI_SORT);
m_TreeCtrl.InsertItem(_T("Harrisburg"), hPA, TVI_SORT);
m_TreeCtrl.InsertItem(_T("Altoona"), hPA, TVI_SORT);

m_TreeCtrl.InsertItem(_T("Seattle"), hWA, TVI_SORT);
m_TreeCtrl.InsertItem(_T("Kalaloch"), hWA, TVI_SORT);
m_TreeCtrl.InsertItem(_T("Yakima"), hWA, TVI_SORT);