CTreeCtrl::InsertItem
Bir ağaç görünümü denetiminin yeni bir öğe eklemek için bu işlevini çağırın.
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
);
Parametreler
lpInsertStruct
Bir işaretçi bir TVINSERTSTRUCT eklenecek ağaç görünümü öğesi özniteliklerini belirtir.nMask
Ayarlamak için hangi özniteliklerin belirten bir tamsayı.Bkz: TVITEM , yapı Windows SDK.lpszItem
Maddenin metni içeren bir dize adresidir.nImage
Ağaç görünümü denetiminin resim listesinde öğenin resmindeki dizini.nSelectedImage
Ağaç görünümü denetiminin resim listesinde öğenin seçili resim dizini.nState
Maddenin durumları için değerleri belirtir.Bkz: ağaç görünümü denetiminin öğesinin durumları Windows SDK uygun durumlar listesi.nStateMask
Hangi Devletler ayarlanmasını belirtir.Bkz: TVITEM , yapı Windows SDK.lParam
Maddeyle ilişkili bir 32-bit uygulamaya özgü değeri.hParent
Eklenen maddenin üst işleci.hInsertAfter
Daha sonra eklenecek yeni madde, madde işleci.
Dönüş Değeri
Başarılı olursa yeni öğenin tutamacı; Aksi halde null.
Notlar
Ağaç denetimi öğesi eklerken her işlev sürümünü kullanmak isteyebileceğiniz durumlara örnek gösterir.
Örnek
// 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);
Gereksinimler
Başlık: afxcmn.h