CTreeCtrl::InsertItem

Artykuł
02/27/2013

Wywołanie tej funkcji, aby wstawić nowy element w widoku drzewa.

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
Wskaźnik do TVINSERTSTRUCT , który określa atrybuty elementu widoku drzewa ma zostać wstawiony.
nMask
Liczba całkowita określająca ustawić atrybuty.Zobacz TVITEM struktury w Windows SDK.
lpszItem
Adres ciąg zawierający tekst elementu.
nImage
Indeks elementu obrazu na liście obrazów formantu widoku drzewa.
nSelectedImage
Indeks elementu wybranego obrazu na liście obrazów formantu widoku drzewa.
nState
Określa wartości elementu Państwa.Zobacz Państwa elementu formantu widoku drzewa w Windows SDK dla listy odpowiednich Państw.
nStateMask
Określa, które Państwa powinny zostać przedstawione.Zobacz TVITEM struktury w Windows SDK.
lParam
Wartości specyficznych dla aplikacji 32-bitowych skojarzone z elementem.
hParent
Uchwyt wstawionego elementu nadrzędnego.
hInsertAfter
Uchwyt elementu, po którym nowy element jest wstawiany.

Wartość zwracana

Uchwyt nowego elementu w przypadku powodzenia; w przeciwnym razie NULL.

Uwagi

W przykładzie sytuacje, w których można użyć każdej wersji funkcji podczas wstawiania elementu formantu drzewa.

Przykład

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