CTreeCtrl
Sınıf
Windows ortak ağaç görünümü denetiminin işlevselliğini sağlar.
Sözdizimi
class CTreeCtrl : public CWnd
Üyeler
Ortak Oluşturucular
Veri Akışı Adı | Açıklama |
---|---|
CTreeCtrl::CTreeCtrl |
Bir CTreeCtrl nesne oluşturur. |
Genel Yöntemler
Veri Akışı Adı | Açıklama |
---|---|
CTreeCtrl::Create |
Ağaç görünümü denetimi oluşturur ve bunu bir CTreeCtrl nesneye ekler. |
CTreeCtrl::CreateDragImage |
Belirtilen ağaç görünümü öğesi için sürükleme bit eşlemi oluşturur. |
CTreeCtrl::CreateEx |
Belirtilen Windows genişletilmiş stilleriyle bir ağaç denetimi oluşturur ve bunu bir CTreeCtrl nesneye ekler. |
CTreeCtrl::DeleteAllItems |
Ağaç görünümü denetimindeki tüm öğeleri siler. |
CTreeCtrl::DeleteItem |
Ağaç görünümü denetimindeki yeni bir öğeyi siler. |
CTreeCtrl::EditLabel |
Belirtilen ağaç görünümü öğesini yerinde düzenler. |
CTreeCtrl::EndEditLabelNow |
Geçerli ağaç görünümü denetimindeki bir ağaç görünümü öğesinin etiketindeki düzenleme işlemini iptal eder. |
CTreeCtrl::EnsureVisible |
Ağaç görünümü öğesinin ağaç görünümü denetiminde görünür olmasını sağlar. |
CTreeCtrl::Expand |
Belirtilen ağaç görünümü öğesinin alt öğelerini genişletir veya daraltılır. |
CTreeCtrl::GetBkColor |
Denetimin geçerli arka plan rengini alır. |
CTreeCtrl::GetCheck |
Ağaç denetim öğesinin denetim durumunu alır. |
CTreeCtrl::GetChildItem |
Belirtilen ağaç görünümü öğesinin alt öğesini alır. |
CTreeCtrl::GetCount |
Bir ağaç görünümü denetimiyle ilişkili ağaç öğelerinin sayısını alır. |
CTreeCtrl::GetDropHilightItem |
Sürükle ve bırak işleminin hedefini alır. |
CTreeCtrl::GetEditControl |
Belirtilen ağaç görünümü öğesini düzenlemek için kullanılan düzenleme denetiminin tutamacını alır. |
CTreeCtrl::GetExtendedStyle |
Geçerli ağaç görünümü denetiminin kullandığı genişletilmiş stilleri alır. |
CTreeCtrl::GetFirstVisibleItem |
Belirtilen ağaç görünümü öğesinin ilk görünür öğesini alır. |
CTreeCtrl::GetImageList |
Ağaç görünümü denetimiyle ilişkili görüntü listesinin tutamacını alır. |
CTreeCtrl::GetIndent |
Bir ağaç görünümü öğesinin uzaklığını (piksel cinsinden) üst öğesinden alır. |
CTreeCtrl::GetInsertMarkColor |
Ağaç görünümü için ekleme işaretini çizmek için kullanılan rengi alır. |
CTreeCtrl::GetItem |
Belirtilen ağaç görünümü öğesinin özniteliklerini alır. |
CTreeCtrl::GetItemData |
Bir öğeyle ilişkili uygulamaya özgü değeri döndürür. |
CTreeCtrl::GetItemExpandedImageIndex |
Geçerli ağaç görünümü denetiminin belirtilen öğesi genişletilmiş durumda olduğunda görüntülenecek görüntünün dizinini alır. |
CTreeCtrl::GetItemHeight |
Ağaç görünümü öğelerinin geçerli yüksekliğini alır. |
CTreeCtrl::GetItemImage |
Bir öğeyle ilişkili görüntüleri alır. |
CTreeCtrl::GetItemPartRect |
Geçerli ağaç görünümü denetiminde belirtilen öğenin belirtilen bir bölümü için sınırlayıcı dikdörtgeni alır. |
CTreeCtrl::GetItemRect |
Ağaç görünümü öğesinin sınırlayıcı dikdörtgenini alır. |
CTreeCtrl::GetItemState |
Bir öğenin durumunu döndürür. |
CTreeCtrl::GetItemStateEx |
Geçerli ağaç görünümü denetiminde belirtilen öğenin genişletilmiş durumunu alır. |
CTreeCtrl::GetItemText |
Bir öğenin metnini döndürür. |
CTreeCtrl::GetLastVisibleItem |
Geçerli ağaç görünümü denetimindeki son genişletilmiş öğeyi alır. |
CTreeCtrl::GetLineColor |
Ağaç görünümü denetimi için geçerli çizgi rengini alır. |
CTreeCtrl::GetNextItem |
Belirtilen ilişkiyle eşleşen sonraki ağaç görünümü öğesini alır. |
CTreeCtrl::GetNextSiblingItem |
Belirtilen ağaç görünümü öğesinin sonraki eşdüzeyini alır. |
CTreeCtrl::GetNextVisibleItem |
Belirtilen ağaç görünümü öğesinin bir sonraki görünür öğesini alır. |
CTreeCtrl::GetParentItem |
Belirtilen ağaç görünümü öğesinin üst öğesini alır. |
CTreeCtrl::GetPrevSiblingItem |
Belirtilen ağaç görünümü öğesinin önceki eşdüzeyini alır. |
CTreeCtrl::GetPrevVisibleItem |
Belirtilen ağaç görünümü öğesinin önceki görünür öğesini alır. |
CTreeCtrl::GetRootItem |
Belirtilen ağaç görünümü öğesinin kökünü alır. |
CTreeCtrl::GetScrollTime |
Ağaç görünümü denetimi için en fazla kaydırma süresini alır. |
CTreeCtrl::GetSelectedCount |
Geçerli ağaç görünümü denetimindeki seçili öğelerin sayısını alır. |
CTreeCtrl::GetSelectedItem |
Seçili durumdaki ağaç görünümü öğesini alır. |
CTreeCtrl::GetTextColor |
Denetimin geçerli metin rengini alır. |
CTreeCtrl::GetToolTips |
Bir ağaç görünümü denetimi tarafından kullanılan alt ToolTip denetimin tutamacını alır. |
CTreeCtrl::GetVisibleCount |
Bir ağaç görünümü denetimiyle ilişkili görünür ağaç öğelerinin sayısını alır. |
CTreeCtrl::HitTest |
İmlecin nesneyle ilgili CTreeCtrl geçerli konumunu döndürür. |
CTreeCtrl::InsertItem |
Ağaç görünümü denetimine yeni bir öğe ekler. |
CTreeCtrl::ItemHasChildren |
Belirtilen öğede alt öğeler varsa sıfır olmayan öğeyi döndürür. |
CTreeCtrl::MapAccIdToItem |
Belirtilen erişilebilirlik tanımlayıcısını tutamaçla geçerli ağaç görünümü denetimindeki ağaç görünümü öğesine eşler. |
CTreeCtrl::MapItemToAccID |
Belirtilen tanıtıcıyı geçerli ağaç görünümü denetimindeki bir ağaç görünümü öğesiyle bir erişilebilirlik tanımlayıcısına eşler. |
CTreeCtrl::Select |
Belirtilen ağaç görünümü öğesini seçer, görünüme kaydırarak veya yeniden çizer. |
CTreeCtrl::SelectDropTarget |
Ağaç öğesini sürükleyip bırakma işleminin hedefi olarak yeniden çizer. |
CTreeCtrl::SelectItem |
Belirtilen ağaç görünümü öğesini seçer. |
CTreeCtrl::SelectSetFirstVisible |
Belirtilen ağaç görünümü öğesini ilk görünür öğe olarak seçer. |
CTreeCtrl::SetAutoscrollInfo |
Geçerli ağaç görünümü denetiminin otomatik kayıt hızını ayarlar. |
CTreeCtrl::SetBkColor |
Denetimin arka plan rengini ayarlar. |
CTreeCtrl::SetCheck |
Ağaç denetim öğesinin denetim durumunu ayarlar. |
CTreeCtrl::SetExtendedStyle |
Geçerli ağaç görünümü denetimi için genişletilmiş stilleri ayarlar. |
CTreeCtrl::SetImageList |
Ağaç görünümü denetimiyle ilişkili görüntü listesinin tutamacını ayarlar. |
CTreeCtrl::SetIndent |
Ağaç görünümü öğesinin üst öğesinden uzaklığını (piksel olarak) ayarlar. |
CTreeCtrl::SetInsertMark |
Ağaç görünümü denetiminde ekleme işaretini ayarlar. |
CTreeCtrl::SetInsertMarkColor |
Ağaç görünümü için ekleme işaretini çizmek için kullanılan rengi ayarlar. |
CTreeCtrl::SetItem |
Belirtilen ağaç görünümü öğesinin özniteliklerini ayarlar. |
CTreeCtrl::SetItemData |
Bir öğeyle ilişkili uygulamaya özgü değeri ayarlar. |
CTreeCtrl::SetItemExpandedImageIndex |
Geçerli ağaç görünümü denetiminin belirtilen öğesi genişletilmiş durumda olduğunda görüntü dizinini görüntüleyecek şekilde ayarlar. |
CTreeCtrl::SetItemHeight |
Ağaç görünümü öğelerinin yüksekliğini ayarlar. |
CTreeCtrl::SetItemImage |
Görüntüleri bir öğeyle ilişkilendirir. |
CTreeCtrl::SetItemState |
Öğenin durumunu ayarlar. |
CTreeCtrl::SetItemStateEx |
Geçerli ağaç görünümü denetiminde belirtilen öğenin genişletilmiş durumunu ayarlar. |
CTreeCtrl::SetItemText |
Öğenin metnini ayarlar. |
CTreeCtrl::SetLineColor |
Ağaç görünümü denetimi için geçerli çizgi rengini ayarlar. |
CTreeCtrl::SetScrollTime |
Ağaç görünümü denetimi için maksimum kaydırma süresini ayarlar. |
CTreeCtrl::SetTextColor |
Denetimin metin rengini ayarlar. |
CTreeCtrl::SetToolTips |
Ağaç görünümü denetiminin alt ToolTip denetimini ayarlar. |
CTreeCtrl::ShowInfoTip |
Geçerli ağaç görünümü denetiminde belirtilen öğe için bilgi ipucu görüntüler. |
CTreeCtrl::SortChildren |
Belirli bir üst öğenin alt öğelerini sıralar. |
CTreeCtrl::SortChildrenCB |
Uygulama tanımlı sıralama işlevini kullanarak belirli bir üst öğenin alt öğelerini sıralar. |
Açıklamalar
"Ağaç görünümü denetimi", belgedeki başlıklar, dizindeki girdiler veya diskteki dosyalar ve dizinler gibi öğelerin hiyerarşik listesini görüntüleyen bir penceredir. Her öğe bir etiket ve isteğe bağlı bit eşlemli görüntüden oluşur ve her öğenin kendisiyle ilişkilendirilmiş alt öğeler listesi olabilir. Kullanıcı bir öğeye tıklayarak ilişkili alt öğe listesini genişletebilir ve daraltabilir.
Bu denetim (ve dolayısıyla CTreeCtrl
sınıfı) yalnızca Windows 98 ve Windows NT sürüm 4 ve üzeri altında çalışan programlarda kullanılabilir.
kullanma CTreeCtrl
hakkında daha fazla bilgi için bkz:
Devralma Hiyerarşisi
CTreeCtrl
Gereksinimler
Üstbilgi: afxcmn.h
CTreeCtrl::Create
bir iletişim kutusu şablonunda ağaç denetimini belirtirseniz veya kullanıyorsanız CTreeView
, iletişim kutusu veya görünüm oluşturulduğunda ağaç denetiminiz otomatik olarak oluşturulur.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametreler
dwStyle
Ağaç görünümü denetiminin stilini belirtir. Windows SDK'sında açıklandığı gibi, içinde CreateWindow
açıklanan pencere stillerini ve ağaç görünümü denetim stillerinin herhangi bir bileşimini uygulayın.
rect
Ağaç görünümü denetiminin boyutunu ve konumunu belirtir. Nesne veya RECT
yapı olabilirCRect
.
pParentWnd
Ağaç görünümü denetiminin üst penceresini ( genellikle bir CDialog
) belirtir. Bu olmamalıdır NULL
.
nID
Ağaç görünümü denetiminin kimliğini belirtir.
Dönüş Değeri
Başlatma başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Ağaç denetimini başka bir pencerenin alt penceresi olarak oluşturmak istiyorsanız üye işlevini kullanın Create
. kullanarak Create
ağaç denetimi oluşturursanız, diğer ağaç görünümü stillerine ek olarak geçirmelisiniz WS_VISIBLE
.
İki adımda bir CTreeCtrl
oluşturursunuz. Önce oluşturucuyu çağırın, sonra ağaç görünümü denetimini oluşturan ve nesnesine ekleyen öğesini çağırınCreate
CTreeCtrl
.
Genişletilmiş pencere stilleriyle ağaç denetimi oluşturmak için yerine öğesini çağırın CreateEx
Create
.
Örnek
// Assuming your window has a CTreeCtrl member named m_TreeCtrl,
// you can create the tree control window with a child ID of ID_MYTREE
// using a call like this:
m_TreeCtrl.Create(WS_VISIBLE | WS_TABSTOP | WS_CHILD | WS_BORDER |
TVS_HASBUTTONS | TVS_LINESATROOT | TVS_HASLINES |
TVS_DISABLEDRAGDROP | TVS_NOTOOLTIPS | TVS_EDITLABELS,
CRect(10, 10, 300, 100), this, ID_MYTREE);
// The control will have the appropriate window styles, and the tree
// control styles specified are those most commonly used.
CTreeCtrl::CreateEx
Bir denetim (alt pencere) oluşturmak ve nesneyle ilişkilendirmek için bu işlevi çağırın CTreeCtrl
.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametreler
dwExStyle
Oluşturulan denetimin genişletilmiş stilini belirtir. Genişletilmiş Windows stillerinin listesi için Windows SDK'sında parametresine CreateWindowEx
bakındwExStyle
.
dwStyle
Ağaç görünümü denetiminin stilini belirtir. Windows SDK'sında açıklandığı gibi, içinde CreateWindow
açıklanan pencere stillerini ve ağaç görünümü denetim stillerinin herhangi bir bileşimini uygulayın.
rect
oluşturulacak pencerenin boyutunu ve konumunu istemci koordinatlarında pParentWnd
açıklayan bir RECT
yapı başvurusu.
pParentWnd
Denetimin üst öğesi olan pencere işaretçisi.
nID
Denetimin alt pencere kimliği.
Dönüş Değeri
Aksi takdirde başarılı olursa sıfır olmayan 0.
Açıklamalar
Create
Yerine, Windows genişletilmiş stil ön biçimi WS_EX_
tarafından belirtilen genişletilmiş Windows stilleri uygulamak için kullanınCreateEx
.
CTreeCtrl::CreateDragImage
Ağaç görünümü denetiminde verilen öğe için bir sürükleme bit eşlemi oluşturmak, bit eşlem için bir resim listesi oluşturmak ve bit eşlemi resim listesine eklemek için bu işlevi çağırın.
CImageList* CreateDragImage(HTREEITEM hItem);
Parametreler
hItem
Sürüklenecek ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Başarılı olursa, sürükleme bit eşleminin eklendiği resim listesinin işaretçisi; aksi takdirde NULL
.
Açıklamalar
Bir uygulama, öğe sürüklenirken görüntüyü görüntülemek için görüntü listesi işlevlerini kullanır.
CImageList
Nesne kalıcıdır ve bittiğinde silmeniz gerekir. Örneğin:
HTREEITEM hItem = m_TreeCtrl.GetSelectedItem();
CImageList *pImageList = m_TreeCtrl.CreateDragImage(hItem);
// Do something with the image list.
delete pImageList;
CTreeCtrl::CTreeCtrl
Bir CTreeCtrl
nesne oluşturur.
CTreeCtrl();
CTreeCtrl::DeleteAllItems
Ağaç görünümü denetimindeki tüm öğeleri silmek için bu işlevi çağırın.
BOOL DeleteAllItems();
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Örnek
// The underlying Windows API always returns TRUE
VERIFY(m_TreeCtrl.DeleteAllItems());
CTreeCtrl::DeleteItem
Ağaç görünümü denetiminden bir öğeyi silmek için bu işlevi çağırın.
BOOL DeleteItem(HTREEITEM hItem);
Parametreler
hItem
Silinecek ağaç öğesinin tanıtıcısı. Değere TVI_ROOT
sahipsehitem
, tüm öğeler ağaç görünümü denetiminden silinir.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Örnek
// Look at all of the root-level items
HTREEITEM hCurrent = m_TreeCtrl.GetChildItem(TVI_ROOT);
while (hCurrent != NULL)
{
// Get the text for the item. Notice we use TVIF_TEXT because
// we want to retrieve only the text, but also specify TVIF_HANDLE
// because we're getting the item by its handle.
TVITEM item;
TCHAR szText[1024];
item.hItem = hCurrent;
item.mask = TVIF_TEXT | TVIF_HANDLE;
item.pszText = szText;
item.cchTextMax = 1024;
BOOL bWorked = m_TreeCtrl.GetItem(&item);
// Try to get the next item
hCurrent = m_TreeCtrl.GetNextItem(hCurrent, TVGN_NEXT);
// If we successfuly retrieved an item, and the item's text
// contains a lowercase letter 'e', delete the item.
if (bWorked && _tcschr(item.pszText, 'e'))
m_TreeCtrl.DeleteItem(item.hItem);
}
CTreeCtrl::EditLabel
Belirtilen öğenin metnini yerinde düzenlemeye başlamak için bu işlevi çağırın.
CEdit* EditLabel(HTREEITEM hItem);
Parametreler
hItem
Düzenlenecek ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Başarılı olursa, öğe metnini düzenlemek için CEdit
kullanılan nesneye bir işaretçi; aksi takdirde NULL
.
Açıklamalar
Düzenleme, öğenin metni, metni içeren tek satırlı düzenleme denetimiyle değiştirilerek gerçekleştirilir.
Örnek
// Make sure the focus is set to the tree control.
m_TreeCtrl.SetFocus();
// Show the edit control on the label of the selected item.
// The tree control must have the TVS_EDITLABELS style set.
HTREEITEM hSel = m_TreeCtrl.GetSelectedItem();
CEdit *pmyEdit = m_TreeCtrl.EditLabel(hSel);
ASSERT(pmyEdit != NULL);
CTreeCtrl::EndEditLabelNow
Düzenleme işlemini geçerli ağaç görünümü denetimindeki bir ağaç görünümü öğesinin etiketinde sonlandırıyor.
BOOL EndEditLabelNow(BOOL fCancelWithoutSave);
Parametreler
fCancelWithoutSave
[in] TRUE
düzenleme işlemini tamamlanmadan önce ağaç görünümü öğesinde yapılan değişiklikleri atmak veya FALSE
işlemi sonuçlanmadan önce ağaç görünümü öğesinde değişiklikleri kaydetmek için.
Dönüş Değeri
TRUE
bu yöntem başarılı olursa; aksi takdirde , FALSE
.
Açıklamalar
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_ENDEDITLABELNOW
.
CTreeCtrl::EnsureVisible
Ağaç görünümü öğesinin görünür olduğundan emin olmak için bu işlevi çağır.
BOOL EnsureVisible(HTREEITEM hItem);
Parametreler
hItem
Görünür hale getirilmekte olan ağaç öğesinin tutamacı.
Dönüş Değeri
Sistemin belirtilen öğenin görünür olduğundan emin olmak için ağaç görünümü denetimindeki öğeleri kaydırıp kaydırmadığını döndürür TRUE
. Aksi takdirde, dönüş değeri şeklindedir FALSE
.
Açıklamalar
Gerekirse, işlev üst öğeyi genişletir veya öğe görünür olacak şekilde ağaç görünümü denetimini kaydırıyor.
Örnek
HTREEITEM hItem = m_TreeCtrl.GetSelectedItem();
// hmyItem is the item that I want to ensure is visible.
HTREEITEM hmyItem = m_TreeCtrl.GetChildItem(hItem);
// Expand the parent, if possible.
HTREEITEM hParent = m_TreeCtrl.GetParentItem(hmyItem);
if (hParent != NULL)
m_TreeCtrl.Expand(hParent, TVE_EXPAND);
// Ensure the item is visible.
m_TreeCtrl.EnsureVisible(hmyItem);
CTreeCtrl::Expand
Verilen üst öğeyle ilişkili alt öğe listesini (varsa) genişletmek veya daraltmak için bu işlevi çağırın.
BOOL Expand(
HTREEITEM hItem,
UINT nCode);
Parametreler
hItem
Genişletilmekte olan ağaç öğesinin tanıtıcısı.
nCode
Gerçekleştirilecek eylemin türünü gösteren bayrak. Bu bayrak aşağıdaki değerlerden birine sahip olabilir:
TVE_COLLAPSE
Listeyi daraltıyor.TVE_COLLAPSERESET
Listeyi daraltıp alt öğeleri kaldırır. DurumTVIS_EXPANDEDONCE
bayrağı sıfırlanır. Bu bayrak bayrakla birlikteTVE_COLLAPSE
kullanılmalıdır.TVE_EXPAND
Listeyi genişletir.TVE_TOGGLE
Liste şu anda genişletilmişse daraltılır veya daraltılmışsa genişletilir.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Örnek
örneğine CTreeCtrl::EnsureVisible
bakın.
CTreeCtrl::GetBkColor
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETBKCOLOR
davranışını uygular.
COLORREF GetBkColor() const;
Dönüş Değeri
COLORREF
Denetim için geçerli pencere arka plan rengini temsil eden değer. Bu değer -1 ise, denetim sistem penceresi rengini kullanıyordur. Bu durumda, denetimin kullandığı geçerli sistem rengini almak için kullanabilirsiniz ::GetSysColor(COLOR_WINDOW)
.
Örnek
örneğine CTreeCtrl::SetTextColor
bakın.
CTreeCtrl::GetCheck
Öğenin denetim durumunu almak için bu üye işlevini çağır.
BOOL GetCheck(HTREEITEM hItem) const;
Parametreler
hItem
Durum HTREEITEM
bilgilerinin alındığı yer.
Dönüş Değeri
Ağaç denetim öğesi işaretliyse sıfır olmayan; aksi takdirde 0.
Örnek
örneğine CTreeCtrl::SetCheck
bakın.
CTreeCtrl::GetChildItem
tarafından hItem
belirtilen öğenin alt öğesi olan ağaç görünümü öğesini almak için bu işlevi çağırın.
HTREEITEM GetChildItem(HTREEITEM hItem) const;
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Başarılı olursa alt öğenin tanıtıcısı; aksi takdirde NULL
.
Örnek
HTREEITEM hmyItem = m_TreeCtrl.GetSelectedItem();
// Delete all of the children of hmyItem.
if (m_TreeCtrl.ItemHasChildren(hmyItem))
{
HTREEITEM hNextItem;
HTREEITEM hChildItem = m_TreeCtrl.GetChildItem(hmyItem);
while (hChildItem != NULL)
{
hNextItem = m_TreeCtrl.GetNextItem(hChildItem, TVGN_NEXT);
m_TreeCtrl.DeleteItem(hChildItem);
hChildItem = hNextItem;
}
}
CTreeCtrl::GetCount
Ağaç görünümü denetimindeki öğelerin sayısını almak için bu işlevi çağırın.
UINT GetCount() const;
Dönüş Değeri
Ağaç görünümü denetimindeki öğelerin sayısı.
Örnek
// Delete all of the items from the tree control.
m_TreeCtrl.DeleteAllItems();
ASSERT(m_TreeCtrl.GetCount() == 0);
CTreeCtrl::GetDropHilightItem
Sürükle ve bırak işleminin hedefi olan öğeyi almak için bu işlevi çağırın.
HTREEITEM GetDropHilightItem() const;
Dönüş Değeri
Başarılı olursa öğenin tanıtıcısı bırakıldı; aksi takdirde NULL
.
Örnek
// Set the item at the point myPoint as the drop target.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SelectDropTarget(hItem);
ASSERT(m_TreeCtrl.GetDropHilightItem() == hItem);
}
CTreeCtrl::GetEditControl
Ağaç görünümü öğesinin metnini düzenlemek için kullanılan düzenleme denetiminin tutamacını almak için bu işlevi çağırın.
CEdit* GetEditControl() const;
Dönüş Değeri
Başarılı olursa, öğe metnini düzenlemek için kullanılan düzenleme denetiminin işaretçisi; aksi takdirde NULL
.
Örnek
// The string replacing the text in the edit control.
LPCTSTR lpszmyString = _T("New text!");
// Replace the text in the label edit control, if possible.
CEdit *pEdit = m_TreeCtrl.GetEditControl();
if (pEdit != NULL)
{
pEdit->SetWindowText(lpszmyString);
}
CTreeCtrl::GetExtendedStyle
Geçerli ağaç görünümü denetiminin kullandığı genişletilmiş stilleri alır.
DWORD GetExtendedStyle() const;
Dönüş Değeri
Geçerli ağaç görünümü denetiminin genişletilmiş stillerinin bit düzeyinde bir bileşimini (VEYA) içeren bir değer. Daha fazla bilgi için bkz . Ağaç Görünümü Denetimi Genişletilmiş Stilleri.
Açıklamalar
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_GETEXTENDEDSTYLE
.
CTreeCtrl::GetFirstVisibleItem
Ağaç görünümü denetiminin ilk görünür öğesini almak için bu işlevi çağırın.
HTREEITEM GetFirstVisibleItem() const;
Dönüş Değeri
İlk görünür öğenin tutamacı; aksi takdirde NULL
.
Örnek
örneğine CTreeCtrl::SetCheck
bakın.
CTreeCtrl::GetImageList
Ağaç görünümü denetimiyle ilişkili normal veya durum görüntüsü listesinin tutamacını almak için bu işlevi çağırın.
CImageList* GetImageList(UINT nImageList) const;
Parametreler
nImageList
Alınacak resim listesinin türü. Görüntü listesi aşağıdaki değerlerden biri olabilir:
TVSIL_NORMAL
Ağaç görünümü öğesi için seçili ve seçilmemiş görüntüleri içeren normal görüntü listesini alır.TVSIL_STATE
Kullanıcı tanımlı durumdaki ağaç görünümü öğelerinin görüntülerini içeren durum görüntüsü listesini alır.
Dönüş Değeri
Başarılı olursa denetimin görüntü listesinin işaretçisi; aksi takdirde NULL
.
Açıklamalar
Ağaç görünümü denetimindeki her öğenin kendisiyle ilişkilendirilmiş bir çift bit eşlemli görüntüsü olabilir. Bir resim, öğe seçildiğinde, diğeri ise öğe seçilmediğinde görüntülenir. Örneğin, bir öğe seçildiğinde açık bir klasör ve seçili olmadığında kapalı bir klasör görüntüleyebilir.
Resim listeleri hakkında daha fazla bilgi için sınıfına CImageList
bakın.
Örnek
ASSERT(m_TreeCtrl.GetImageList(TVSIL_NORMAL) == NULL);
m_TreeCtrl.SetImageList(&m_TreeImages, TVSIL_NORMAL);
ASSERT(m_TreeCtrl.GetImageList(TVSIL_NORMAL) == &m_TreeImages);
CTreeCtrl::GetIndent
Alt öğelerin üst öğelerine göre girintili olduğu miktarı piksel cinsinden almak için bu işlevi çağırın.
UINT GetIndent() const;
Dönüş Değeri
Piksel cinsinden ölçülen girinti miktarı.
Örnek
// Double the indent.
UINT uIndent = m_TreeCtrl.GetIndent();
m_TreeCtrl.SetIndent(2 * uIndent);
CTreeCtrl::GetInsertMarkColor
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETINSERTMARKCOLOR
davranışını uygular.
COLORREF GetInsertMarkColor() const;
Dönüş Değeri
COLORREF
Geçerli ekleme işareti rengini içeren bir değer.
Örnek
// Use the highliight color for the insert mark color.
COLORREF crColor = ::GetSysColor(COLOR_HIGHLIGHT);
m_TreeCtrl.SetInsertMarkColor(crColor);
ASSERT(m_TreeCtrl.GetInsertMarkColor() == crColor);
CTreeCtrl::GetItem
Belirtilen ağaç görünümü öğesinin özniteliklerini almak için bu işlevi çağırın.
BOOL GetItem(TVITEM* pItem) const;
Parametreler
pItem
Windows SDK'da açıklandığı gibi bir TVITEM
yapı işaretçisi.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Örnek
örneğine CTreeCtrl::DeleteItem
bakın.
CTreeCtrl::GetItemData
Belirtilen öğeyle ilişkili uygulamaya özgü değeri almak için bu işlevi çağırın.
DWORD_PTR GetItemData(HTREEITEM hItem) const;
Parametreler
hItem
Verileri alınacak öğenin tanıtıcısı.
Dönüş Değeri
tarafından hItem
belirtilen öğeyle ilişkilendirilmiş, işaretçi boyutundaki uygulamaya özgü değer.
Örnek
HTREEITEM hmyItem = m_TreeCtrl.GetSelectedItem();
// Delete all of the children of hmyItem whose item data is
// not equal to zero.
if (m_TreeCtrl.ItemHasChildren(hmyItem))
{
HTREEITEM hNextItem;
HTREEITEM hChildItem = m_TreeCtrl.GetChildItem(hmyItem);
while (hChildItem != NULL)
{
hNextItem = m_TreeCtrl.GetNextItem(hChildItem, TVGN_NEXT);
if (m_TreeCtrl.GetItemData(hChildItem) != 0)
{
m_TreeCtrl.DeleteItem(hChildItem);
}
hChildItem = hNextItem;
}
}
CTreeCtrl::GetItemExpandedImageIndex
Geçerli ağaç görünümü denetiminin belirtilen öğesi genişletilmiş durumda olduğunda görüntülenecek görüntünün dizinini alır.
int GetItemExpandedImageIndex(HTREEITEM hItem)const;
Parametreler
hItem
[in] Ağaç görünümü denetim öğesinin tutamacı.
Dönüş Değeri
Belirtilen öğe genişletilmiş durumdayken görüntülenecek görüntünün dizini.
Açıklamalar
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_GETITEM
. Bu ileti, ağaç görünümü denetim öğesini açıklayan yapıyı döndürür TVITEMEX
ve bu yöntem bu yapıdan üyeyi iExpandedImage
alır.
CTreeCtrl::GetItemHeight
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETITEMHEIGHT
davranışını uygular.
SHORT GetItemHeight() const;
Dönüş Değeri
Öğenin piksel cinsinden yüksekliği.
Örnek
// Double the height of the items.
SHORT sHeight = m_TreeCtrl.GetItemHeight();
m_TreeCtrl.SetItemHeight(2 * sHeight);
CTreeCtrl::GetItemImage
Ağaç görünümü denetimindeki her öğenin kendisiyle ilişkilendirilmiş bir çift bit eşlemli görüntüsü olabilir.
BOOL GetItemImage(
HTREEITEM hItem,
int& nImage,
int& nSelectedImage) const;
Parametreler
hItem
Görüntüsü alınacak öğenin tanıtıcısı.
nImage
Ağaç görünümü denetiminin görüntü listesinde öğenin görüntüsünün dizinini alan tamsayı.
nSelectedImage
Ağaç görünümü denetiminin görüntü listesinde öğenin seçili görüntüsünün dizinini alan tamsayı.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Resimler, bir öğenin etiketinin sol tarafında görünür. Bir resim, öğe seçildiğinde, diğeri ise öğe seçilmediğinde görüntülenir. Örneğin, bir öğe seçildiğinde açık bir klasör ve seçili olmadığında kapalı bir klasör görüntüleyebilir.
Öğe görüntüsünün dizinini ve ağaç görünümü denetiminin görüntü listesinden seçilen görüntüsünü almak için bu işlevi çağırın.
Örnek
HTREEITEM hmyItem = m_TreeCtrl.GetSelectedItem();
// If the selected image is the same as the nonselected image
// then make the selected image one more than the nonselected image.
if (m_TreeCtrl.ItemHasChildren(hmyItem))
{
HTREEITEM hItem = m_TreeCtrl.GetChildItem(hmyItem);
int nImage, nSelectedImage;
while (hItem != NULL)
{
m_TreeCtrl.GetItemImage(hItem, nImage, nSelectedImage);
if (nImage == nSelectedImage)
{
m_TreeCtrl.SetItemImage(hItem, nImage, nImage + 1);
}
hItem = m_TreeCtrl.GetNextSiblingItem(hItem);
}
}
CTreeCtrl::GetItemPartRect
Geçerli ağaç görünümü denetiminde belirtilen öğenin belirtilen bir bölümü için sınırlayıcı dikdörtgeni alır.
BOOL GetItemPartRect(
HTREEITEM hItem,
int nPart,
LPRECT lpRect)const;
Parametreler
hItem
[in] Ağaç görünümü denetim öğesinin tutamacı.
nPart
[in] Bölümün tanımlayıcısı. olarak ayarlanmalıdır TVGIPR_BUTTON
.
lpRect
[out] Bir RECT
yapı işaretçisi. Bu yöntem başarılı olursa, yapı ve nPart
tarafından hItem
belirtilen bölümün dikdörtgen koordinatlarını alır.
Dönüş Değeri
TRUE
bu yöntem başarılı olursa; aksi takdirde , FALSE
.
Açıklamalar
Her ağaç denetim öğesi bir grafik dikdörtgeni ile sınırlanır. Bu dikdörtgendeki bir noktaya tıklandığında, öğeye tıklandığı söylenir. Bu yöntem, dikdörtgendeki bir noktaya tıklandığında parametre tarafından tanımlanan öğeye isabet edilmesi için en büyük dikdörtgeni hItem
döndürür.
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_GETITEMPARTRECT
. Daha fazla bilgi için makroya TreeView_GetItemPartRect
bakın.
Örnek
İlk kod örneği, m_treeCtrl
geçerli ağaç görünümü denetimine erişmek için kullanılan bir değişkeni tanımlar. Kod örneği ayrıca işaretsiz bir tamsayı ve birkaç HTREEITEM
değişken tanımlar. Bu değişkenler sonraki örnekte kullanılır.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
Sonraki kod örneği, kök ağaç görünümü öğesine tanıtıcı almak için erişilebilirlik tanımlayıcısını ve CTreeCtrl::MapAccIdToItem
yöntemini kullanır. Daha sonra örnek tutamacını ve CTreeCtrl::GetItemPartRect
yöntemini kullanarak bu öğenin çevresine 3B dikdörtgen çizer. Kod örneğinin gösterilmeyen önceki bir bölümünde, Birleşik Devletler için kök ülke/bölge düğümünden, Pensilvanya ve Washington eyaletleri için alt düğümlerden ve bu eyaletlerdeki şehirler için ağaç öğelerinden oluşan bir ağaç görünümü oluşturduk. Kök ağaç görünümü öğesini bir erişilebilirlik tanımlayıcısıyla ilişkilendirmek için yöntemini kullandık CTreeCtrl::MapItemToAccID
.
CRect rect;
HTREEITEM hUS = m_treeCtrl.MapAccIdToItem(accIdUS);
m_treeCtrl.GetItemPartRect(hUS, TVGIPR_BUTTON, &rect);
m_treeCtrl.GetDC()->Draw3dRect(&rect, RGB(255, 0, 0), RGB(0, 0, 255));
CTreeCtrl::GetItemRect
hItem için sınırlayıcı dikdörtgeni almak ve görünür olup olmadığını belirlemek için bu işlevi çağırın.
BOOL GetItemRect(
HTREEITEM hItem,
LPRECT lpRect,
BOOL bTextOnly) const;
Parametreler
hItem
Ağaç görünümü denetim öğesinin tutamacı.
lpRect
Sınırlayıcı dikdörtgeni alan bir RECT
yapıya yönelik işaretçi. Koordinatlar, ağaç görünümü denetiminin sol üst köşesine göredir.
bTextOnly
Bu parametre sıfırdan farklıysa sınırlayıcı dikdörtgen yalnızca öğenin metnini içerir. Aksi takdirde, öğenin ağaç görünümü denetiminde kaplayan tüm satırı içerir.
Dönüş Değeri
Öğe görünür durumdaysa sıfır olmayan ve içinde sınırlayıcı dikdörtgen bulunur lpRect
. Aksi takdirde, başlatılmamış 0 lpRect
.
Örnek
HTREEITEM hmyItem = m_TreeCtrl.GetSelectedItem();
// Dump the bounds of hmyItem.
if (hmyItem != NULL)
{
RECT r;
m_TreeCtrl.GetItemRect(hmyItem, &r, FALSE);
TRACE(TEXT("left = %d, top = %d, right = %d, bottom = %d\r\n"),
r.left,
r.top,
r.right,
r.bottom);
}
CTreeCtrl::GetItemState
tarafından hItem
belirtilen öğenin durumunu döndürür.
UINT GetItemState(
HTREEITEM hItem,
UINT nStateMask) const;
Parametreler
hItem
Durumu alınacak öğenin tanıtıcısı.
nStateMask
Alınacak bir veya daha fazla durumu gösteren maske. için olası değerler hakkında daha fazla bilgi içinnStateMask
, Windows SDK'sında yapı ve stateMask
üyelerinin TVITEM
tartışmalarına state
bakın.
Dönüş Değeri
UINT
tarafından nStateMask
belirtilen değerlerin C++ bit düzeyinde OR işlecini (|
) tutan bir. Olası değerler hakkında bilgi için bkz CTreeCtrl::GetItem
. . Belirli bir durumun değerini bulmak için, aşağıdaki örnekte gösterildiği gibi bir C++ bit düzeyinde AND işleci (&
) f durum değerini ve dönüş değerini gerçekleştirin.
Örnek
// Show all of the visible items in bold.
HTREEITEM hItem = m_TreeCtrl.GetFirstVisibleItem();
while (hItem != NULL)
{
m_TreeCtrl.SetItemState(hItem, TVIS_BOLD, TVIS_BOLD);
ASSERT(TVIS_BOLD & m_TreeCtrl.GetItemState(hItem, TVIS_BOLD));
hItem = m_TreeCtrl.GetNextVisibleItem(hItem);
}
CTreeCtrl::GetItemStateEx
Geçerli ağaç görünümü denetiminde belirtilen öğenin genişletilmiş durumunu alır.
UINT GetItemStateEx(HTREEITEM hItem) const;
Parametreler
hItem
[in] Ağaç görünümü denetim öğesinin tutamacı.
Dönüş Değeri
Öğenin genişletilmiş durumu. Daha fazla bilgi için yapının üyesine TVITEMEX
bakınuStateEx
.
Açıklamalar
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_GETITEM
. Bu ileti, ağaç görünümü denetim öğesini açıklayan yapıyı döndürür TVITEMEX
ve bu yöntem bu yapıdan üyeyi uStateEx
alır.
CTreeCtrl::GetItemText
tarafından hItem
belirtilen öğenin metnini döndürür.
CString GetItemText(HTREEITEM hItem) const;
Parametreler
hItem
Metni alınacak öğenin tanıtıcısı.
Dönüş Değeri
CString
Öğenin metnini içeren bir nesne.
Örnek
örneğine CTreeCtrl::GetNextItem
bakın.
CTreeCtrl::GetLastVisibleItem
Geçerli ağaç görünümü denetimindeki son genişletilmemiş düğüm öğesini alır.
HTREEITEM GetLastVisibleItem() const;
Dönüş Değeri
Yöntem başarılı olursa, son genişletilmemiş düğüm öğesinin tanıtıcısı; aksi takdirde , NULL
.
Açıklamalar
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_GETNEXTITEM
. Daha fazla bilgi için bu iletinin TVGN_LASTVISIBLE
parametresindeki flag
bayrağına bakın.
Örnek
İlk kod örneği, m_treeCtrl
geçerli ağaç görünümü denetimine erişmek için kullanılan bir değişkeni tanımlar. Kod örneği ayrıca işaretsiz bir tamsayı ve birkaç HTREEITEM
değişken tanımlar. Bu değişkenlerden biri veya daha fazlası sonraki örnekte kullanılır.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
Sonraki kod örneği, son genişletilmemiş ağaç görünümü düğüm öğesine bir tanıtıcı alır ve ardından bu öğenin çevresine bir 3B dikdörtgen çizer. Kod örneğinin gösterilmeyen önceki bir bölümünde, Birleşik Devletler için kök ülke/bölge düğümünden, Pensilvanya ve Washington eyaletleri için alt düğümlerden ve bu eyaletlerdeki şehirler için ağaç öğelerinden oluşan bir ağaç görünümü oluşturduk.
CRect rect;
HTREEITEM hLast = m_treeCtrl.GetLastVisibleItem();
m_treeCtrl.GetItemPartRect(hLast, TVGIPR_BUTTON, &rect);
m_treeCtrl.GetDC()->Draw3dRect(&rect, RGB(255, 0, 0), RGB(0, 0, 255));
CTreeCtrl::GetLineColor
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETLINECOLOR
davranışını uygular.
COLORREF GetLineColor() const;
Dönüş Değeri
Geçerli çizgi rengi.
Örnek
COLORREF cr = m_TreeCtrl.GetLineColor();
CTreeCtrl::GetNextItem
parametresi tarafından belirtilen ilişkiyi içeren ağaç görünümü öğesini öğesine almak için hItem
bu işlevi çağırınnCode
.
HTREEITEM GetNextItem(
HTREEITEM hItem,
UINT nCode) const;
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
nCode
ile ilişkisinin hItem
türünü gösteren bir bayrak. Bu bayrak aşağıdaki değerlerden biri olabilir:
TVGN_CARET
Seçili durumdaki öğeyi alır.TVGN_CHILD
parametresi tarafındanhItem
belirtilen öğenin ilk alt öğesini alır.TVGN_DROPHILITE
Sürükle ve bırak işleminin hedefi olan öğeyi alır.TVGN_FIRSTVISIBLE
İlk görünür öğeyi alır.TVGN_LASTVISIBLE
Ağaçtaki son genişletilmiş öğeyi alır. Bu, ağaç görünümü penceresinde görünen son öğeyi almaz.TVGN_NEXT
Sonraki eşdüzey öğeyi alır.TVGN_NEXTVISIBLE
Belirtilen öğeyi izleyen sonraki görünür öğeyi alır.TVGN_PARENT
Belirtilen öğenin üst öğesini alır.TVGN_PREVIOUS
Önceki eşdüzey öğeyi alır.TVGN_PREVIOUSVISIBLE
Belirtilen öğeden önce gelen ilk görünür öğeyi alır.TVGN_ROOT
Belirtilen öğenin parçası olduğu kök öğenin ilk alt öğesini alır.
Dönüş Değeri
Başarılı olursa sonraki öğenin tanıtıcısı; aksi takdirde NULL
.
Açıklamalar
Alınan öğe ağacın kök düğümüyse bu işlev döndürülecektir NULL
. Örneğin, bu iletiyi ağaç görünümünün TVGN_PARENT
kök düğümünün birinci düzey alt öğesinde bayrağıyla birlikte kullanırsanız, ileti döndürür NULL
.
Örnek
Döngüde kullanma GetNextItem
örneği için bkz CTreeCtrl::DeleteItem
. .
// find the currently selected item
HTREEITEM hCurSel = m_TreeCtrl.GetNextItem(TVI_ROOT, TVGN_CARET);
// report it to the user
if (hCurSel == NULL)
{
AfxMessageBox(_T("There is no selected item"));
}
else
{
CString str;
str.Format(_T("The currently selected item is \"%s\""),
(LPCTSTR)m_TreeCtrl.GetItemText(hCurSel));
AfxMessageBox((LPCTSTR)str);
}
CTreeCtrl::GetNextSiblingItem
öğesinin sonraki eşdüzeyini almak için bu işlevi çağırın hItem
.
HTREEITEM GetNextSiblingItem(HTREEITEM hItem) const;
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Sonraki eşdüzey öğenin tanıtıcısı; aksi takdirde NULL
.
Örnek
HTREEITEM hmyItem = m_TreeCtrl.GetSelectedItem();
// Show all of the children of hmyItem in bold.
if (m_TreeCtrl.ItemHasChildren(hmyItem))
{
HTREEITEM hItem = m_TreeCtrl.GetChildItem(hmyItem);
while (hItem != NULL)
{
m_TreeCtrl.SetItemState(hItem, TVIS_BOLD, TVIS_BOLD);
hItem = m_TreeCtrl.GetNextSiblingItem(hItem);
}
}
CTreeCtrl::GetNextVisibleItem
öğesinin bir sonraki görünür öğesini almak için bu işlevi çağırın hItem
.
HTREEITEM GetNextVisibleItem(HTREEITEM hItem) const;
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Sonraki görünür öğenin tutamacı; aksi takdirde NULL
.
Örnek
örneğine CTreeCtrl::SetCheck
bakın.
CTreeCtrl::GetParentItem
öğesinin üst öğesini almak için bu işlevi çağırın hItem
.
HTREEITEM GetParentItem(HTREEITEM hItem) const;
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Üst öğenin tutamacı; aksi takdirde NULL
.
Açıklamalar
Belirtilen öğenin üst öğesi ağacın kök düğümüyse bu işlev döndürülecektir NULL
.
Örnek
örneğine CTreeCtrl::EnsureVisible
bakın.
CTreeCtrl::GetPrevSiblingItem
öğesinin önceki eşdüzeyini almak için bu işlevi çağırın hItem
.
HTREEITEM GetPrevSiblingItem(HTREEITEM hItem) const;
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Önceki eşdüzeyin tutamacı; aksi takdirde NULL
.
Örnek
HTREEITEM hmyItem = m_TreeCtrl.GetSelectedItem();
// Show all of the previous siblings of hmyItem in bold.
HTREEITEM hItem = hmyItem;
while (hItem != NULL)
{
m_TreeCtrl.SetItemState(hItem, TVIS_BOLD, TVIS_BOLD);
hItem = m_TreeCtrl.GetPrevSiblingItem(hItem);
}
CTreeCtrl::GetPrevVisibleItem
öğesinin önceki görünür öğesini almak için bu işlevi çağırın hItem
.
HTREEITEM GetPrevVisibleItem(HTREEITEM hItem) const;
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Önceki görünür öğenin tutamacı; aksi takdirde NULL
.
Örnek
HTREEITEM hmyItem = m_TreeCtrl.GetSelectedItem();
// Show all of the previous visible items of hmyItem in bold.
HTREEITEM hItem = hmyItem;
while (hItem != NULL)
{
m_TreeCtrl.SetItemState(hItem, TVIS_BOLD, TVIS_BOLD);
hItem = m_TreeCtrl.GetPrevVisibleItem(hItem);
}
CTreeCtrl::GetRootItem
Ağaç görünümü denetiminin kök öğesini almak için bu işlevi çağırın.
HTREEITEM GetRootItem() const;
Dönüş Değeri
Kök öğenin tutamacı; aksi takdirde NULL
.
Örnek
örneğine CTreeCtrl::EditLabel
bakın.
CTreeCtrl::GetScrollTime
Ağaç görünümü denetimi için en uzun kaydırma süresini almak için bu üye işlevini çağırın.
UINT GetScrollTime() const;
Dönüş Değeri
Milisaniye cinsinden maksimum kaydırma süresi.
Açıklamalar
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETSCROLLTIME
davranışını uygular.
CTreeCtrl::GetSelectedCount
Geçerli ağaç görünümü denetimindeki seçili öğelerin sayısını alır.
UINT GetSelectedCount();
Dönüş Değeri
Seçili öğelerin sayısı.
Açıklamalar
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_GETSELECTEDCOUNT
.
CTreeCtrl::GetSelectedItem
Ağaç görünümü denetiminin seçili durumdaki öğesini almak için bu işlevi çağırın.
HTREEITEM GetSelectedItem() const;
Dönüş Değeri
Seçili öğenin tutamacı; aksi takdirde NULL
.
Örnek
// Expand the selected item and make it visible, if possible.
HTREEITEM hItem = m_TreeCtrl.GetSelectedItem();
if ((hItem != NULL) && m_TreeCtrl.ItemHasChildren(hItem))
{
m_TreeCtrl.Expand(hItem, TVE_EXPAND);
m_TreeCtrl.EnsureVisible(hItem);
}
CTreeCtrl::GetTextColor
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETTEXTCOLOR
davranışını uygular.
COLORREF GetTextColor() const;
Dönüş Değeri
COLORREF
Geçerli metin rengini temsil eden bir değer. Bu değer -1 ise, denetim metin rengi için sistem rengini kullanıyordur.
Örnek
örneğine CTreeCtrl::SetTextColor
bakın.
CTreeCtrl::GetToolTips
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETTOOLTIPS
davranışını uygular.
CToolTipCtrl* GetToolTips() const;
Dönüş Değeri
Ağaç denetimi tarafından kullanılacak nesne CToolTipCtrl
işaretçisi. Create
Üye işlevi stilini TVS_NOTOOLTIPS
kullanıyorsa, hiçbir araç ipucu kullanılmaz ve NULL
döndürülür.
Açıklamalar
MFC uygulaması GetToolTips
, araç CToolTipCtrl
ipucu denetiminin tutamacı yerine ağaç denetimi tarafından kullanılan bir nesnesi döndürür.
Örnek
// If the tree control does not have a tooltips control,
// then use m_ToolTips as the tooltips for the tree control.
if (m_TreeCtrl.GetToolTips() == NULL)
{
m_TreeCtrl.SetToolTips(&m_ToolTips);
}
CTreeCtrl::GetVisibleCount
Ağaç görünümü denetimindeki görünür öğelerin sayısını almak için bu işlevi çağırın.
UINT GetVisibleCount() const;
Dönüş Değeri
Ağaç görünümü denetimindeki görünür öğelerin sayısı; aksi takdirde - 1.
Örnek
örneğine CTreeCtrl::SetCheck
bakın.
CTreeCtrl::HitTest
Belirtilen noktanın ağaç görünümü denetiminin istemci alanına göre konumunu belirlemek için bu işlevi çağırın.
HTREEITEM HitTest(
CPoint pt,
UINT* pFlags = NULL) const;
HTREEITEM HitTest(TVHITTESTINFO* pHitTestInfo) const;
Parametreler
pt
Test için noktanın istemci koordinatları.
pFlags
İsabet testinin sonuçları hakkında bilgi alan bir tamsayı işaretçisi. Açıklamalar bölümündeki üyenin altında flags
listelenen değerlerden biri veya daha fazlası olabilir.
pHitTestInfo
Isabet testinin konumunu içeren ve isabet testinin sonuçları hakkında bilgi alan bir TVHITTESTINFO
yapının adresi.
Dönüş Değeri
Belirtilen noktayı kaplayan veya NULL
hiçbir öğe noktayı kaplarsa ağaç görünümü öğesinin tanıtıcısı.
Açıklamalar
Bu işlev çağrıldığında parametresi, pt
test için noktanın koordinatlarını belirtir. işlevi, belirtilen noktada veya NULL
hiçbir öğe noktayı kaplarsa öğenin tutamacını döndürür. Ayrıca parametresi, pFlags
belirtilen noktanın konumunu gösteren bir değer içerir. Olası değerler şunlardır:
Value | Açıklama |
---|---|
TVHT_ABOVE |
İstemci alanının üstünde. |
TVHT_BELOW |
İstemci alanının altında. |
TVHT_NOWHERE |
İstemci alanında, ancak son öğenin altında. |
TVHT_ONITEM |
Bir öğeyle ilişkilendirilmiş bit eşlem veya etikette. |
TVHT_ONITEMBUTTON |
Bir öğeyle ilişkilendirilmiş düğmede. |
TVHT_ONITEMICON |
Bir öğeyle ilişkili bit eşlem üzerinde. |
TVHT_ONITEMINDENT |
Bir öğeyle ilişkili girintide. |
TVHT_ONITEMLABEL |
Bir öğeyle ilişkilendirilmiş etikette (dize). |
TVHT_ONITEMRIGHT |
Öğenin sağındaki alanda. |
TVHT_ONITEMSTATEICON |
Kullanıcı tanımlı durumdaki ağaç görünümü öğesinin durum simgesinde. |
TVHT_TOLEFT |
İstemci alanının solunda. |
TVHT_TORIGHT |
İstemci alanının sağındaki. |
Örnek
// Select the item that is at the point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SelectItem(hItem);
}
CTreeCtrl::InsertItem
Ağaç görünümü denetimine yeni öğe eklemek için bu işlevi çağır.
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
Eklenecek ağaç görünümü öğesinin özniteliklerini belirten bir TVINSERTSTRUCT
işaretçi.
nMask
Ayarlanacağı öznitelikleri belirten tamsayı. TVITEM
Windows SDK'sının yapısına bakın.
lpszItem
Öğenin metnini içeren dizenin adresi.
nImage
Ağaç görünümü denetiminin görüntü listesinde öğenin görüntüsünün dizini.
nSelectedImage
Ağaç görünümü denetiminin görüntü listesinde öğenin seçili görüntüsünün dizini.
nState
Öğenin durumlarının değerlerini belirtir. Uygun durumların listesi için bkz. Windows SDK'sında Ağaç Görünümü Denetim Öğesi Durumları.
nStateMask
Hangi durumların ayarlandığını belirtir. TVITEM
Windows SDK'sının yapısına bakın.
lParam
Öğeyle ilişkilendirilmiş, işaretçi boyutundaki uygulamaya özgü bir değer.
hParent
Eklenen öğenin üst öğesinin tanıtıcısı.
hInsertAfter
Yeni öğenin eklendiği öğenin tanıtıcısı.
Dönüş Değeri
Başarılı olursa yeni öğenin tanıtıcısı; aksi takdirde NULL
.
Açıklamalar
Örnek, bir ağaç denetim öğesi eklerken işlevin her sürümünü kullanmak isteyebileceğiniz durumları 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);
CTreeCtrl::ItemHasChildren
tarafından hItem
belirtilen ağaç öğesinin alt öğeleri olup olmadığını belirlemek için bu işlevi kullanın.
BOOL ItemHasChildren(HTREEITEM hItem) const;
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
tarafından hItem
belirtilen ağaç öğesinin alt öğeleri varsa sıfır olmayan; yoksa 0.
Açıklamalar
Öyleyse, bu alt öğeleri almak için komutunu kullanabilirsiniz CTreeCtrl::GetChildItem
.
Örnek
örneğine CTreeCtrl::GetSelectedItem
bakın.
CTreeCtrl::MapAccIdToItem
Belirtilen erişilebilirlik tanımlayıcısını geçerli ağaç görünümü denetimindeki ağaç görünümü öğesinin tutamacıyla eşler.
HTREEITEM MapAccIdToItem(UINT uAccId) const;
Parametreler
uAccId
[in] Ağaç görünümü öğesindeki bir öğenin erişilebilirlik tanımlayıcısı.
Dönüş Değeri
Parametreye karşılık gelen uAccId
ağaç görünümü öğesinin (HTREEITEM
) tanıtıcısı. Daha fazla bilgi için yapının üyesine TVITEMEX
bakınhItem
.
Açıklamalar
Erişilebilirlik yardımcıları, engelli kişilerin bilgisayarları kullanmalarını sağlayan uygulamalardır. Erişilebilirlik tanımlayıcısı, arabirim tarafından bir penceredeki IAccessible
bir öğeyi benzersiz olarak belirtmek için kullanılır. API'ler IAccessible
hakkında daha fazla bilgi için bkz . Microsoft Etkin Erişilebilirlik.
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_MAPACCIDTOHTREEITEM
.
Örnek
İlk kod örneği, m_treeCtrl
geçerli ağaç görünümü denetimine erişmek için kullanılan bir değişkeni tanımlar. Kod örneği ayrıca işaretsiz bir tamsayı ve birkaç HTREEITEM
değişken tanımlar. Bu değişkenler sonraki örnekte kullanılır.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
Sonraki kod örneği, kök ağaç görünümü öğesine tanıtıcı almak için erişilebilirlik tanımlayıcısını ve CTreeCtrl::MapAccIdToItem
yöntemini kullanır. Örnekte tanıtıcı ve CTreeCtrl::GetItemPartRect
yöntemi kullanılarak bu öğenin çevresine 3B dikdörtgen çizilmektedir. Kod örneğinin gösterilmeyen önceki bir bölümünde, Birleşik Devletler için kök ülke/bölge düğümünden, Pensilvanya ve Washington eyaletleri için alt düğümlerden ve bu eyaletlerdeki şehirler için ağaç öğelerinden oluşan bir ağaç görünümü oluşturduk. Kök ağaç görünümü öğesini bir erişilebilirlik tanımlayıcısıyla ilişkilendirmek için yöntemini kullandık CTreeCtrl::MapItemToAccID
.
CRect rect;
HTREEITEM hUS = m_treeCtrl.MapAccIdToItem(accIdUS);
m_treeCtrl.GetItemPartRect(hUS, TVGIPR_BUTTON, &rect);
m_treeCtrl.GetDC()->Draw3dRect(&rect, RGB(255, 0, 0), RGB(0, 0, 255));
CTreeCtrl::MapItemToAccID
Geçerli ağaç görünümü denetimindeki bir ağaç görünümü öğesinin belirtilen tutamacını bir erişilebilirlik tanımlayıcısı ile eşler.
UINT MapItemToAccID(HTREEITEM hItem) const;
Parametreler
hItem
[in] Denetimdeki ağaç görünümü öğesinin tutamacı. Daha fazla bilgi için yapının üyesine TVITEMEX
bakınhItem
.
Dönüş Değeri
hItem parametresine karşılık gelen erişilebilirlik tanımlayıcısı.
Açıklamalar
Erişilebilirlik yardımcıları, engelli kişilerin bilgisayarları kullanmalarını sağlayan uygulamalardır. Erişilebilirlik tanımlayıcısı, arabirim tarafından bir penceredeki IAccessible
bir öğeyi benzersiz olarak belirtmek için kullanılır. API'ler IAccessible
hakkında daha fazla bilgi için bkz . Microsoft Etkin Erişilebilirlik.
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_MAPHTREEITEMTOACCID
.
Örnek
İlk kod örneği, m_treeCtrl
geçerli ağaç görünümü denetimine erişmek için kullanılan bir değişkeni tanımlar. Kod örneği ayrıca işaretsiz bir tamsayı ve birkaç HTREEITEM
değişken tanımlar. Bu değişkenler sonraki örnekte kullanılır.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
Sonraki kod örneği, ağaç görünümü denetim öğesi için bir kimlik numarası alır. Kod örneğinin gösterilmeyen önceki bir bölümünde, Birleşik Devletler için kök ülke/bölge düğümünden, Pensilvanya ve Washington eyaletleri için alt düğümlerden ve bu eyaletlerdeki şehirler için ağaç öğelerinden oluşan bir ağaç görünümü oluşturduk. Bu kod örneği, kök ülke/bölge düğümü için benzersiz bir kimlik numarası alır.
// Map an accessibility identifier to the Pennsylvania node.
accIdUS = m_treeCtrl.MapItemToAccId(hCountry);
CTreeCtrl::Select
Verilen ağaç görünümü öğesini seçmek, öğeyi görünüme kaydırmak veya öğeyi sürükleyip bırakma işleminin hedefini belirtmek için kullanılan stilde yeniden çizmek için bu işlevi çağırın.
BOOL Select(
HTREEITEM hItem,
UINT nCode);
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
nCode
Gerçekleştirecek eylem türü. Bu parametre aşağıdaki değerlerden biri olabilir:
TVGN_CARET
Seçimi verilen öğeye ayarlar.TVGN_DROPHILITE
Belirli bir öğeyi sürükle ve bırak işleminin hedefini belirtmek için kullanılan stilde yeniden çizer.TVGN_FIRSTVISIBLE
Ağaç görünümünü dikey olarak kaydırarak verilen öğenin ilk görünür öğe olması sağlanır.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
nCode
değerini TVGN_CARET
içeriyorsa, üst pencere ve TVN_SELCHANGED
bildirim iletilerini alırTVN_SELCHANGING
. Ayrıca, belirtilen öğe daraltılmış bir üst öğenin alt öğesiyse, üst öğenin alt öğe listesi belirtilen öğeyi ortaya çıkarmak için genişletilir. Bu durumda, üst pencere ve TVN_ITEMEXPANDED
bildirim iletilerini alırTVN_ITEMEXPANDING
.
Örnek
örneğine CTreeCtrl::HitTest
bakın.
CTreeCtrl::SelectDropTarget
Sürükle ve bırak işleminin hedefini belirtmek için kullanılan stildeki öğeyi yeniden çizmek için bu işlevi çağırın.
BOOL SelectDropTarget(HTREEITEM hItem);
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Örnek
// Set the item at the point myPoint as the drop target.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SelectDropTarget(hItem);
ASSERT(m_TreeCtrl.GetDropHilightItem() == hItem);
}
CTreeCtrl::SelectItem
Verilen ağaç görünümü öğesini seçmek için bu işlevi çağırın.
BOOL SelectItem(HTREEITEM hItem);
Parametreler
hItem
Ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
ise hItem
NULL
, bu işlev öğe seçmez.
Örnek
// Select the item that is at the point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SelectItem(hItem);
}
CTreeCtrl::SelectSetFirstVisible
Verilen öğenin ilk görünür öğe olması için ağaç görünümünü dikey olarak kaydırmak için bu işlevi çağırın.
BOOL SelectSetFirstVisible(HTREEITEM hItem);
Parametreler
hItem
İlk görünür öğe olarak ayarlanacak ağaç öğesinin tanıtıcısı.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
İşlev, pencereye ve TVGN_FIRSTVISIBLE
ileti parametrelerini içeren TVM_SELECTITEM
bir ileti gönderir.
Örnek
// Select the item at the point myPoint as the first visible item.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SelectSetFirstVisible(hItem);
}
CTreeCtrl::SetAutoscrollInfo
Geçerli ağaç görünümü denetiminin otomatik kayıt hızını ayarlar.
BOOL SetAutoscrollInfo(
UINT uPixelsPerSec,
UINT uUpdateTime);
Parametreler
uPixelsPerSec
[in] Kaydıracak saniyedeki piksel sayısı.
uUpdateTime
[in] Denetimin güncelleştirmeleri arasındaki zaman aralığı.
Dönüş Değeri
Her zaman TRUE
döndürür.
Açıklamalar
Otomatik kayıt parametreleri, şu anda görünür olmayan bir öğeyi görüntülemek için kaydırmak için kullanılır. Ağaç görünümü denetimi, Ağaç Görünümü Denetimi Genişletilmiş Stilleri'nde açıklanan genişletilmiş stile sahip TVS_EX_AUTOHSCROLL
olmalıdır.
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_SETAUTOSCROLLINFO
.
Örnek
İlk kod örneği, m_treeCtrl
geçerli ağaç görünümü denetimine erişmek için kullanılan bir değişkeni tanımlar. Kod örneği ayrıca işaretsiz bir tamsayı ve birkaç HTREEITEM
değişken tanımlar. Bu değişkenler sonraki örnekte kullanılır.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
Sonraki kod örneği, geçerli ağaç görünümü denetiminin otomatik kayıt davranışını ayarlar. Kod örneğinin gösterilmeyen önceki bir bölümünde, Birleşik Devletler için kök ülke/bölge düğümünden, Pensilvanya ve Washington eyaletleri için alt düğümlerden ve bu eyaletlerdeki şehirler için ağaç öğelerinden oluşan bir ağaç görünümü oluşturduk. Odaklanmış ağaç öğesini görüntülemek için otomatik olarak kaydırılabilmesi için ağaç görünümü denetimini kasıtlı olarak daralttık. Kod örneği ağaç görünümü denetimini, ağaç öğesi görünüme gelene kadar her 5 saniyede bir saniyede 30 piksel otomatik olarak kaydıracak şekilde ayarlar.
// Scroll 30 pixels/sec and redraw every 5 seconds.
m_treeCtrl.SetAutoscrollInfo(30, 5);
CTreeCtrl::SetBkColor
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETBKCOLOR
davranışını uygular.
COLORREF SetBkColor(COLORREF clr);
Parametreler
clr
COLORREF
Yeni arka plan rengini içeren bir değer. Bu değer -1 ise, denetim arka plan rengi için sistem rengini kullanmaya geri döner.
Dönüş Değeri
COLORREF
Geçerli metin rengini temsil eden bir değer. Bu değer -1 ise, denetim metin rengi için sistem rengini kullanıyordur.
Örnek
örneğine CTreeCtrl::SetTextColor
bakın.
CTreeCtrl::SetCheck
Ağaç denetim öğesinin denetim durumunu ayarlamak için bu üye işlevini çağırın.
BOOL SetCheck(
HTREEITEM hItem,
BOOL fCheck = TRUE);
Parametreler
hItem
HTREEITEM
Denetim durumu değişikliğini almak için.
fCheck
Ağaç denetim öğesinin işaretlenip işaretlenmeyeceğini gösterir. Varsayılan olarak, SetCheck
öğeyi denetlenecek şekilde ayarlar.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Ağaç denetim öğesi işaretlendiğinde (fCheck
olarak ayarlandığında TRUE
), öğe bitişik bir onay işaretiyle görüntülenir.
Örnek
UINT uCount = m_TreeCtrl.GetVisibleCount();
HTREEITEM hItem = m_TreeCtrl.GetFirstVisibleItem();
// Toggle the check state of all the visible items.
for (UINT i = 0; i < uCount; i++)
{
ASSERT(hItem != NULL);
m_TreeCtrl.SetCheck(hItem, !m_TreeCtrl.GetCheck(hItem));
hItem = m_TreeCtrl.GetNextVisibleItem(hItem);
}
Onay kutularını kullanmak için ağaç denetimini doldurmadan önce ayarlayın TVS_CHECKBOXES
.
m_TreeCtrl.ModifyStyle(0, TVS_CHECKBOXES);
HTREEITEM aItem = m_TreeCtrl.InsertItem(_T("AAA"));
m_TreeCtrl.SetCheck(aItem);
CTreeCtrl::SetExtendedStyle
Geçerli ağaç görünümü denetimi için genişletilmiş stilleri ayarlar.
DWORD SetExtendedStyle(
DWORD dwExMask,
DWORD dwExStyles);
Parametreler
dwExMask
[in] Geçerli ağaç görünümü denetimindeki hangi stillerin bu yöntemden etkileneceğini belirten bit maskesi. Bu parametre sıfırsa, yoksayılır ve parametrenin dwExStyles
değeri ağaç görünümü denetimine atanır. Ağaç Görünümü Denetimi Genişletilmiş Stilleri'nde açıklanan stillerin sıfır veya bit düzeyinde birleşimini (OR) belirtin.
dwExStyles
[in] Geçerli ağaç görünümü denetiminde hangi stillerin ayarlandığını veya temizlendiğini belirten bit maskesi. Stillerin birleşimini ayarlamak için, Ağaç Görünümü Denetimi Genişletilmiş Stilleri'nde açıklanan stillerin bit düzeyinde bir bileşimini (VEYA) belirtin. Bir stil kümesini temizlemek için sıfır belirtin.
Dönüş Değeri
Önceki genişletilmiş denetim stillerini içeren bir değer.
Açıklamalar
Bu yöntem parametresinde dwExMask
belirtilen stilleri temizler ve ardından parametresinde dwExStyles
belirtilen stilleri ayarlar. Yalnızca değişen bitlere karşılık gelen genişletilmiş stiller dwExMask
.
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_SETEXTENDEDSTYLE
.
Örnek
İlk kod örneği, m_treeCtrl
geçerli ağaç görünümü denetimine erişmek için kullanılan bir değişkeni tanımlar. Kod örneği ayrıca işaretsiz bir tamsayı ve birkaç HTREEITEM
değişken tanımlar. Bu değişkenler sonraki örnekte kullanılır.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
Sonraki kod örneği, genişletilmiş stili geçerli ağaç görünümü denetimine ekler TVS_EX_AUTOHSCROLL
. Kod örneğinin gösterilmeyen önceki bir bölümünde, Birleşik Devletler için kök ülke/bölge düğümünden, Pensilvanya ve Washington eyaletleri için alt düğümlerden ve bu eyaletlerdeki şehirler için ağaç öğelerinden oluşan bir ağaç görünümü oluşturduk. Odaklanmış ağaç öğesini görüntülemek için otomatik olarak kaydırılabilmesi için ağaç görünümü denetimini kasıtlı olarak daralttık.
m_treeCtrl.SetExtendedStyle(TVS_EX_AUTOHSCROLL, TVS_EX_AUTOHSCROLL);
CTreeCtrl::SetImageList
Ağaç görünümü denetimi için normal veya durum görüntüsü listesini ayarlamak ve yeni görüntüleri kullanarak denetimi yeniden çizmek için bu işlevi çağırın.
CImageList* SetImageList(
CImageList* pImageList,
int nImageListType);
Parametreler
pImageList
Atanacak görüntü listesinin işaretçisi. ise pImageList
NULL
, tüm görüntüler ağaç görünümü denetiminden kaldırılır.
nImageListType
Ayarlanacağı görüntü listesi türü. Görüntü listesi aşağıdaki değerlerden biri olabilir:
TVSIL_NORMAL
Ağaç görünümü öğesi için seçili ve seçilmemiş görüntüleri içeren normal görüntü listesini ayarlar. Yer paylaşımlı görüntüler için bu durumu kullanmanız gerekir.TVSIL_STATE
Kullanıcı tanımlı durumdaki ağaç görünümü öğelerinin görüntülerini içeren durum görüntüsü listesini ayarlar.
Dönüş Değeri
Varsa, önceki görüntü listesinin işaretçisi; aksi takdirde NULL
.
Örnek
örneğine CTreeCtrl::GetImageList
bakın.
CTreeCtrl::SetIndent
Ağaç görünümü denetiminin girinti genişliğini ayarlamak ve denetimi yeni genişliği yansıtacak şekilde yeniden çizmek için bu işlevi çağırın.
void SetIndent(UINT nIndent);
Parametreler
nIndent
Girintinin piksel cinsinden genişliği. Sistem tanımlı minimum genişlikten küçükse nIndent
, yeni genişlik sistem tanımlı minimum olarak ayarlanır.
Örnek
örneğine CTreeCtrl::GetIndent
bakın.
CTreeCtrl::SetInsertMark
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETINSERTMARK
davranışını uygular.
BOOL SetInsertMark(
HTREEITEM hItem,
BOOL fAfter = TRUE);
Parametreler
hItem
HTREEITEM
ekleme işaretinin yerleştirileceği öğeyi belirtir. Bu bağımsız değişken NULL ise, ekleme işareti kaldırılır.
fAfter
Ekleme işaretinin belirtilen öğeden önce mi yoksa sonra mı yerleştirildiğini belirten BOOL değeri. Bu bağımsız değişken sıfır değilse, ekleme işareti öğenin arkasına yerleştirilir. Bu bağımsız değişken sıfırsa, ekleme işareti öğenin önüne yerleştirilir.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Örnek
// Set the insert mark to be before the item at the point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SetInsertMark(hItem, FALSE);
}
CTreeCtrl::SetInsertMarkColor
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETINSERTMARKCOLOR
davranışını uygular.
COLORREF SetInsertMarkColor(COLORREF clrNew);
Parametreler
clrNew
COLORREF
Yeni ekleme işareti rengini içeren bir değer.
Dönüş Değeri
Önceki COLORREF
ekleme işareti rengini içeren bir değer.
Örnek
örneğine CTreeCtrl::GetInsertMarkColor
bakın.
CTreeCtrl::SetItem
Belirtilen ağaç görünümü öğesinin özniteliklerini ayarlamak için bu işlevi çağırın.
BOOL SetItem(TVITEM* pItem);
BOOL SetItem(
HTREEITEM hItem,
UINT nMask,
LPCTSTR lpszItem,
int nImage,
int nSelectedImage,
UINT nState,
UINT nStateMask,
LPARAM lParam);
Parametreler
pItem
Windows SDK'da açıklandığı gibi yeni öğe özniteliklerini içeren bir TVITEM
yapıya yönelik işaretçi.
hItem
Öznitelikleri ayarlanacak öğenin tanıtıcısı. Windows SDK'sında hItem
yapının üyesine TVITEM
bakın.
nMask
Ayarlanacağı öznitelikleri belirten tamsayı. mask
Yapının üyesine TVITEM
bakın.
lpszItem
Öğenin metnini içeren dizenin adresi.
nImage
Ağaç görünümü denetiminin görüntü listesinde öğenin görüntüsünün dizini. iImage
Yapının üyesine TVITEM
bakın.
nSelectedImage
Ağaç görünümü denetiminin görüntü listesinde öğenin seçili görüntüsünün dizini. iSelectedImage
Yapının üyesine TVITEM
bakın.
nState
Öğenin durumlarının değerlerini belirtir. State
Yapının üyesine TVITEM
bakın.
nStateMask
Hangi durumların ayarlandığını belirtir. stateMask
Yapının üyesine TVITEM
bakın.
lParam
Öğeyle ilişkilendirilmiş, işaretçi boyutundaki uygulamaya özgü bir değer.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Yapıda TVITEM
, hItem
üye öğeyi tanımlar ve mask
üye ayarlanacağı öznitelikleri belirtir.
mask
Üye veya nMask
parametre değeri belirtiyorsaTVIF_TEXT
, pszText
üye veya lpszItem
değeri null olarak sonlandırılan dizenin adresidir ve cchTextMax
üye yoksayılır. (veya nMask
) değeri belirtirse TVIF_STATE
mask
, stateMask
üye veya nStateMask
parametre hangi öğe durumlarının değiştireceğini belirtir ve state
üye veya nState
parametre bu durumların değerlerini içerir.
Örnek
// 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);
}
CTreeCtrl::SetItemData
Belirtilen öğeyle ilişkili uygulamaya özgü değeri ayarlamak için bu işlevi çağırın.
BOOL SetItemData(
HTREEITEM hItem,
DWORD_PTR dwData);
Parametreler
hItem
Verileri alınacak öğenin tanıtıcısı.
dwData
tarafından hItem
belirtilen öğeyle ilişkilendirilmiş, işaretçi boyutundaki uygulamaya özgü değer.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Örnek
CString str;
HTREEITEM hItem;
// Insert 20 items into the tree control making every item's
// data be the handle of the item.
for (int i = 0; i < 20; i++)
{
str.Format(TEXT("item %d"), i);
hItem = m_TreeCtrl.InsertItem(str);
if (hItem != NULL)
{
m_TreeCtrl.SetItemData(hItem, (DWORD_PTR)hItem);
}
}
CTreeCtrl::SetItemExpandedImageIndex
Geçerli ağaç görünümü denetiminin belirtilen öğesi genişletilmiş durumda olduğunda görüntü dizinini görüntüleyecek şekilde ayarlar.
BOOL SetItemExpandedImageIndex(
HTREEITEM hItem,
int iExpandedImage);
Parametreler
hItem
[in] Ağaç görünümü denetim öğesinin tutamacı.
iExpandedImage
[in] Belirtilen öğe genişletilmiş durumdayken görüntülenecek görüntünün dizini.
Dönüş Değeri
TRUE
bu yöntem başarılı olursa; aksi takdirde , FALSE
.
Açıklamalar
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_SETITEM
. Bu yöntem, parametresini iExpandedImage
bir TVITEMEX
yapının üyesine iExpandedImage
atar ve sonra iletide bu yapıyı kullanır.
Örnek
İlk kod örneği, m_treeCtrl
geçerli ağaç görünümü denetimine erişmek için kullanılan bir değişkeni tanımlar. Kod örneği ayrıca işaretsiz bir tamsayı ve birkaç HTREEITEM
değişken tanımlar. Bu değişkenler sonraki örnekte kullanılır.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
Sonraki kod örneği, yöntemin CTreeCtrl::GetItemExpandedImageIndex
yöntemi tarafından ayarlanan değeri döndürip döndürmediğini saptamak için basit bir testtir CTreeCtrl::SetItemExpandedImageIndex
. Kod örneğinin gösterilmeyen önceki bir bölümünde, Birleşik Devletler için kök ülke/bölge düğümünden, Pensilvanya ve Washington eyaletleri için alt düğümlerden ve bu eyaletlerdeki şehirler için ağaç öğelerinden oluşan bir ağaç görünümü oluşturduk.
CString str;
CString msg = _T("The set and retrieved item expanded image ")
_T("indexes are%s equal.");
int nSetItem = 0;
m_treeCtrl.SetItemExpandedImageIndex(hCountry, nSetItem);
int nItem = m_treeCtrl.GetItemExpandedImageIndex(hCountry);
if (nItem == nSetItem)
str.Format(msg, _T(""));
else
str.Format(msg, _T(" not"));
AfxMessageBox(str, MB_ICONINFORMATION);
CTreeCtrl::SetItemHeight
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETITEMHEIGHT
davranışını uygular.
SHORT SetItemHeight(SHORT cyHeight);
Parametreler
cyHeight
Ağaç görünümündeki her öğenin yeni yüksekliğini piksel cinsinden belirtir. Bu bağımsız değişken görüntülerin yüksekliğinden küçükse, görüntülerin yüksekliğine ayarlanır. Bu bağımsız değişken eşit değilse, en yakın çift değere yuvarlanır. Bu bağımsız değişken -1 ise, denetim varsayılan öğe yüksekliğini kullanmaya geri döner.
Dönüş Değeri
Öğelerin piksel cinsinden önceki yüksekliği.
Örnek
örneğine CTreeCtrl::GetItemHeight
bakın.
CTreeCtrl::SetItemImage
Görüntüleri bir öğeyle ilişkilendirir.
BOOL SetItemImage(
HTREEITEM hItem,
int nImage,
int nSelectedImage);
Parametreler
hItem
Resmi ayarlanacak öğenin tutamacı.
nImage
Ağaç görünümü denetiminin görüntü listesinde öğenin görüntüsünün dizini.
nSelectedImage
Ağaç görünümü denetiminin görüntü listesinde öğenin seçili görüntüsünün dizini.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Ağaç görünümü denetimindeki her öğenin kendisiyle ilişkilendirilmiş bir çift bit eşlemli görüntüsü olabilir. Resimler, bir öğenin etiketinin sol tarafında görünür. Bir resim, öğe seçildiğinde, diğeri ise öğe seçilmediğinde görüntülenir. Örneğin, bir öğe seçildiğinde açık bir klasör ve seçili olmadığında kapalı bir klasör görüntüleyebilir.
Öğe görüntüsünün dizinini ve ağaç görünümü denetiminin görüntü listesinde seçili görüntüsünü ayarlamak için bu işlevi çağırın.
Görüntüler hakkında daha fazla bilgi için bkz CImageList
. .
Örnek
örneğine CTreeCtrl::GetItemImage
bakın.
CTreeCtrl::SetItemState
tarafından hItem
belirtilen öğenin durumunu ayarlar.
BOOL SetItemState(
HTREEITEM hItem,
UINT nState,
UINT nStateMask);
Parametreler
hItem
Durumu ayarlanacak öğenin tanıtıcısı.
nState
Öğe için yeni durumları belirtir.
nStateMask
Hangi durumların değiştirileceği belirtir.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Durumlar hakkında bilgi için bkz. CTreeCtrl::GetItem
.
Örnek
örneğine CTreeCtrl::GetItemState
bakın.
CTreeCtrl::SetItemStateEx
Geçerli ağaç görünümü denetiminde belirtilen öğenin genişletilmiş durumunu ayarlar.
BOOL SetItemStateEx(
HTREEITEM hItem,
UINT uStateEx);
Parametreler
hItem
[in] Ağaç görünümü denetim öğesinin tutamacı.
uStateEx
[in] Öğenin genişletilmiş durumu. Daha fazla bilgi için yapının üyesine TVITEMEX
bakınuStateEx
.
Dönüş Değeri
TRUE
bu yöntem başarılı olursa; aksi takdirde , FALSE
.
Açıklamalar
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_SETITEM
. Bu yöntem, parametresini uStateEx
bir TVITEMEX
yapının üyesine uStateEx
atar ve sonra iletide bu yapıyı kullanır.
Örnek
İlk kod örneği, m_treeCtrl
geçerli ağaç görünümü denetimine erişmek için kullanılan bir değişkeni tanımlar. Kod örneği ayrıca işaretsiz bir tamsayı ve birkaç HTREEITEM
değişken tanımlar. Bu değişkenler sonraki örnekte kullanılır.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
Sonraki kod örneği, ağaç görünümü öğesini devre dışı durumuna ayarlar. Kod örneğinin gösterilmeyen önceki bir bölümünde, Birleşik Devletler için kök ülke/bölge düğümünden, Pensilvanya ve Washington eyaletleri için alt düğümlerden ve bu eyaletlerdeki şehirler için ağaç öğelerinden oluşan bir ağaç görünümü oluşturduk. Bu kod örneği, Pennsylvania düğümünü devre dışı durumuna ayarlar.
// Disable the Pennsylvania node.
m_treeCtrl.SetItemStateEx(hPA, TVIS_EX_DISABLED);
CTreeCtrl::SetItemText
tarafından hItem
belirtilen öğenin metnini ayarlar.
BOOL SetItemText(
HTREEITEM hItem,
LPCTSTR lpszItem);
Parametreler
hItem
Metni ayarlanacak öğenin tanıtıcısı.
lpszItem
Öğenin yeni metnini içeren dizenin adresi
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Örnek
// Clear the text of the item at point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SetItemText(hItem, NULL);
}
CTreeCtrl::SetLineColor
Ağaç görünümü denetimi için geçerli çizgi rengini ayarlamak için bu üye işlevini çağırın.
COLORREF SetLineColor(COLORREF clrNew = CLR_DEFAULT);
Parametreler
clrNew
Yeni çizgi rengi.
Dönüş Değeri
Önceki çizgi rengi.
Açıklamalar
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETLINECOLOR
davranışını uygular.
Örnek
COLORREF clrPrev = m_TreeCtrl.SetLineColor(RGB(255, 0, 0));
CTreeCtrl::SetScrollTime
Ağaç görünümü denetimi için maksimum kaydırma süresini ayarlamak için bu üye işlevini çağırın.
UINT SetScrollTime(UINT uScrollTime);
Parametreler
uScrollTime
Milisaniye cinsinden yeni maksimum kaydırma süresi. Bu değer 100'den küçükse 100'e yuvarlanacaktır.
Dönüş Değeri
Milisaniye cinsinden önceki maksimum kaydırma süresi.
Açıklamalar
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETSCROLLTIME
davranışını uygular.
CTreeCtrl::SetTextColor
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETTEXTCOLOR
davranışını uygular.
COLORREF SetTextColor(COLORREF clr);
Parametreler
clr
COLORREF
Yeni metin rengini içeren bir değer. Bu bağımsız değişken -1 ise, denetim metin rengi için sistem rengini kullanmaya geri döner.
Dönüş Değeri
COLORREF
Önceki metin rengini temsil eden bir değer. Bu değer -1 ise, denetim metin rengi için sistem rengini kullanıyordu.
Örnek
// change text color to white and background to dark blue
m_TreeCtrl.SetTextColor(RGB(255, 255, 255));
ASSERT(m_TreeCtrl.GetTextColor() == RGB(255, 255, 255));
m_TreeCtrl.SetBkColor(RGB(0, 0, 128));
ASSERT(m_TreeCtrl.GetBkColor() == RGB(0, 0, 128));
// force repaint immediately
m_TreeCtrl.Invalidate();
CTreeCtrl::SetToolTips
Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETTOOLTIPS
davranışını uygular.
CToolTipCtrl* SetToolTips(CToolTipCtrl* pWndTip);
Parametreler
pWndTip
Ağaç denetiminin kullanacağı nesnenin CToolTipCtrl
işaretçisi.
Dönüş Değeri
Daha önce denetim tarafından kullanılan araç ipucunun bulunduğu bir CToolTipCtrl
nesnenin işaretçisi veya NULL
daha önce hiçbir araç ipucu kullanılmadıysa.
Açıklamalar
Araç ipuçlarını kullanmak için, nesneyi oluştururken CTreeCtrl
stili belirtinTVS_NOTOOLTIPS
.
Örnek
örneğine CTreeCtrl::GetToolTips
bakın.
CTreeCtrl::ShowInfoTip
Geçerli ağaç görünümü denetiminde belirtilen öğe için bilgi ipucu görüntüler.
void ShowInfoTip(HTREEITEM hItem);
Parametreler
hItem
[in] Denetimdeki ağaç görünümü öğesinin tanıtıcısı. Daha fazla bilgi için yapının üyesine TVITEMEX
bakınhItem
.
Açıklamalar
Araç ipuçları ve bilgi ipuçları arasındaki fark hakkında daha fazla bilgi için bkz . Araç ipuçları ve Bilgi ipuçları.
Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TVM_SHOWINFOTIP
.
CTreeCtrl::SortChildren
Ağaç görünümü denetiminde verilen üst öğenin alt öğelerini alfabetik olarak sıralamak için bu işlevi çağırın.
BOOL SortChildren(HTREEITEM hItem);
Parametreler
hItem
Alt öğeleri sıralanacak olan üst öğenin tanıtıcısı. ise hItem
NULL
, sıralama ağacın kökünden devam eder.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
SortChildren
ağaçta yinelenmez; yalnızca ilk alt öğeleri hItem
sıralanır.
Örnek
// Sort all of the items in the tree control.
m_TreeCtrl.SortChildren(TVI_ROOT);
CTreeCtrl::SortChildrenCB
Öğeleri karşılaştıran uygulama tanımlı bir geri çağırma işlevini kullanarak ağaç görünümü öğelerini sıralamak için bu işlevi çağırın.
BOOL SortChildrenCB(LPTVSORTCB pSort);
Parametreler
pSort
Bir TVSORTCB
yapı işaretçisi.
Dönüş Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Yapının karşılaştırma işlevi, lpfnCompare
ilk öğenin ikinci öğeden önce olması gerekiyorsa negatif bir değer, ikinciyi izlemesi gerekiyorsa pozitif bir değer veya iki öğe eşdeğerse sıfır döndürmelidir.
lParam1
ve lParam2
parametreleri, karşılaştırılmakta olan lParam
iki öğenin yapısının üyesine TVITEM
karşılık gelir. parametresi, lParamSort
yapının üyesine TV_SORTCB
karşılık gelirlParam
.
Örnek
// Sort the item in reverse alphabetical order.
int CALLBACK MyCompareProc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort)
{
// lParamSort contains a pointer to the tree control.
// The lParam of an item is just its handle,
// as specified with SetItemData
CTreeCtrl* pmyTreeCtrl = (CTreeCtrl*)lParamSort;
CString strItem1 = pmyTreeCtrl->GetItemText((HTREEITEM)lParam1);
CString strItem2 = pmyTreeCtrl->GetItemText((HTREEITEM)lParam2);
return strItem2.Compare(strItem1);
}
TVSORTCB tvs;
// Sort the tree control's items using my
// callback procedure.
tvs.hParent = TVI_ROOT;
tvs.lpfnCompare = MyCompareProc;
tvs.lParam = (LPARAM)&m_TreeCtrl;
m_TreeCtrl.SortChildrenCB(&tvs);
Ayrıca bkz.
MFC Örneği CMNCTRL1
CWnd
Sınıf
Hiyerarşi Grafiği
CImageList
Sınıf