CTreeCtrl::InsertItem

Článek
06/10/2015

Volání této funkce můžete vložit nové položky ve stromovém zobrazení.

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

Parametry

lpInsertStruct
Ukazatel TVINSERTSTRUCT , určuje atributy vkládají položky zobrazení stromu.
nMask
Celé číslo určující atributy, které chcete nastavit.Najdete TVITEM struktury v .
lpszItem
Řetězec obsahující text na položku Adresa.
nImage
Index obrázku pro položky v seznamu stromové zobrazení ovládacího prvku obrázek.
nSelectedImage
Index obrázku položky vybrané v seznamu stromové zobrazení ovládacího prvku obrázek.
nState
Určuje hodnoty pro položky státy.Viz stromové zobrazení ovládacího prvku položku států v seznam příslušných států.
nStateMask
Určuje, které státy mají být nastaveny.Najdete TVITEM struktury v .
lParam
Hodnota 32bitové aplikace související s položkou.
hParent
Popisovač nadřazeného vložené položky.
hInsertAfter
Popisovač zboží, po které se vkládá nová položka.

Vrácená hodnota

Popisovač nové položky, pokud je úspěšná. jinak NULL.

Poznámky

Příkladem situací, ve kterých chcete použít každou verzi funkce při vkládání řídicí položky stromu.

Příklad

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