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 CTreeCtrlhakkında daha fazla bilgi için bkz:

• Denetimler

• Kullan -arak CTreeCtrl

• Windows SDK'sında Ağaç Görünümü Denetim Başvurusu .

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

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 CreateWindowaçı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 Createağ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ınCreateCTreeCtrl.

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 CreateWindowaçı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 pParentWndaçı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. Durum TVIS_EXPANDEDONCE bayrağı sıfırlanır. Bu bayrak bayrakla birlikte TVE_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::EnsureVisiblebakın.

CTreeCtrl::GetBkColor

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETBKCOLORdavranışı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::SetTextColorbakı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::SetCheckbakın.

CTreeCtrl::GetChildItem

tarafından hItembelirtilen öğ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::SetCheckbakı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_GETINSERTMARKCOLORdavranışı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::DeleteItembakı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 hItembelirtilen öğ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_GETITEMHEIGHTdavranışı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 nParttarafı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_treeCtrlgeç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 hItembelirtilen öğ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 nStateMaskbelirtilen 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 hItembelirtilen öğ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::GetNextItembakı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_treeCtrlgeç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_GETLINECOLORdavranışı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 hItembu 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 hItemtü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ından hItem 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::SetCheckbakı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::EnsureVisiblebakı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::EditLabelbakı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_GETSCROLLTIMEdavranışı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_GETTEXTCOLORdavranışı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::SetTextColorbakın.

CTreeCtrl::GetToolTips

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_GETTOOLTIPSdavranışı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_NOTOOLTIPSkullanı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::SetCheckbakı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::GetSelectedItembakı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_treeCtrlgeç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_treeCtrlgeç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_CARETiç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::HitTestbakı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_treeCtrlgeç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_SETBKCOLORdavranışı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::SetTextColorbakı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_treeCtrlgeç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::GetImageListbakı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::GetIndentbakın.

CTreeCtrl::SetInsertMark

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETINSERTMARKdavranışı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_SETINSERTMARKCOLORdavranışı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::GetInsertMarkColorbakı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 hItembelirtilen öğ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_treeCtrlgeç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_SETITEMHEIGHTdavranışı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::GetItemHeightbakı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::GetItemImagebakın.

CTreeCtrl::SetItemState

tarafından hItembelirtilen öğ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::GetItemStatebakı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_treeCtrlgeç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 hItembelirtilen öğ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_SETLINECOLORdavranışı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_SETSCROLLTIMEdavranışını uygular.

CTreeCtrl::SetTextColor

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TVM_SETTEXTCOLORdavranışı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_SETTOOLTIPSdavranışı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::GetToolTipsbakı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, lpfnCompareilk öğ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