Share via


CTreeCtrl-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Biedt de functionaliteit van het algemene besturingselement voor de structuurweergave van Windows.

Syntaxis

class CTreeCtrl : public CWnd

Leden

Openbare constructors

Naam Description
CTreeCtrl::CTreeCtrl Maakt een CTreeCtrl object.

Openbare methoden

Naam Description
CTreeCtrl::Create Hiermee maakt u een besturingselement voor de structuurweergave en koppelt u dit aan een CTreeCtrl object.
CTreeCtrl::CreateDragImage Hiermee maakt u een bitmap voor het opgegeven structuurweergave-item.
CTreeCtrl::CreateEx Hiermee maakt u een structuurbesturingselement met de opgegeven uitgebreide Stijlen van Windows en koppelt u dit aan een CTreeCtrl object.
CTreeCtrl::DeleteAllItems Hiermee verwijdert u alle items in een structuurweergavebesturingselement.
CTreeCtrl::DeleteItem Hiermee verwijdert u een nieuw item in een structuurweergavebesturingselement.
CTreeCtrl::EditLabel Een opgegeven structuurweergave-item in-place bewerken.
CTreeCtrl::EndEditLabelNow Hiermee annuleert u de bewerking op het label van een item in de structuurweergave in het huidige besturingselement voor de structuurweergave.
CTreeCtrl::EnsureVisible Zorgt ervoor dat een item in de structuurweergave zichtbaar is in het besturingselement voor de structuurweergave.
CTreeCtrl::Expand Hiermee worden de onderliggende items van het opgegeven structuurweergave-item uitgevouwen of samengevouwen.
CTreeCtrl::GetBkColor Haalt de huidige achtergrondkleur van het besturingselement op.
CTreeCtrl::GetCheck Hiermee haalt u de controlestatus van een boomstructuurbesturingselementitem op.
CTreeCtrl::GetChildItem Hiermee wordt het onderliggende item van een opgegeven structuurweergave opgehaald.
CTreeCtrl::GetCount Hiermee haalt u het aantal structuuritems op dat is gekoppeld aan een besturingselement voor de structuurweergave.
CTreeCtrl::GetDropHilightItem Hiermee wordt het doel van een slepen-en-neerzetten-bewerking opgehaald.
CTreeCtrl::GetEditControl Hiermee wordt de ingang opgehaald van het besturingselement bewerken dat wordt gebruikt om het opgegeven structuurweergave-item te bewerken.
CTreeCtrl::GetExtendedStyle Hiermee haalt u de uitgebreide stijlen op die door het huidige besturingselement voor structuurweergave worden gebruikt.
CTreeCtrl::GetFirstVisibleItem Hiermee wordt het eerste zichtbare item van het opgegeven structuurweergave-item opgehaald.
CTreeCtrl::GetImageList Hiermee wordt de ingang opgehaald van de lijst met afbeeldingen die is gekoppeld aan een structuurweergavebesturingselement.
CTreeCtrl::GetIndent Haalt de offset (in pixels) van een structuurweergave-item op van het bovenliggende item.
CTreeCtrl::GetInsertMarkColor Hiermee haalt u de kleur op die wordt gebruikt om de invoegmarkering voor de structuurweergave te tekenen.
CTreeCtrl::GetItem Haalt de kenmerken van een opgegeven structuurweergave-item op.
CTreeCtrl::GetItemData Retourneert de toepassingsspecifieke waarde die is gekoppeld aan een item.
CTreeCtrl::GetItemExpandedImageIndex Haalt de index van de afbeelding op die moet worden weergegeven wanneer het opgegeven item van het huidige besturingselement voor structuurweergave de uitgevouwen status heeft.
CTreeCtrl::GetItemHeight Hiermee haalt u de huidige hoogte van de items in de structuurweergave op.
CTreeCtrl::GetItemImage Hiermee worden de afbeeldingen opgehaald die zijn gekoppeld aan een item.
CTreeCtrl::GetItemPartRect Hiermee wordt de begrenzingsrechthoek opgehaald voor een opgegeven deel van een opgegeven item in het huidige besturingselement voor structuurweergave.
CTreeCtrl::GetItemRect Hiermee haalt u de begrenzingsrechthoek van een structuurweergave-item op.
CTreeCtrl::GetItemState Retourneert de status van een item.
CTreeCtrl::GetItemStateEx Hiermee wordt de uitgebreide status van het opgegeven item opgehaald in het huidige besturingselement voor structuurweergave.
CTreeCtrl::GetItemText Retourneert de tekst van een item.
CTreeCtrl::GetLastVisibleItem Hiermee wordt het laatste uitgevouwen item opgehaald in het huidige besturingselement voor structuurweergave.
CTreeCtrl::GetLineColor Hiermee haalt u de huidige lijnkleur voor het besturingselement voor de structuurweergave op.
CTreeCtrl::GetNextItem Hiermee wordt het volgende structuurweergave-item opgehaald dat overeenkomt met een opgegeven relatie.
CTreeCtrl::GetNextSiblingItem Hiermee wordt het volgende item van het opgegeven structuurweergave-item opgehaald.
CTreeCtrl::GetNextVisibleItem Hiermee wordt het volgende zichtbare item van het opgegeven structuurweergave-item opgehaald.
CTreeCtrl::GetParentItem Hiermee wordt het bovenliggende item van het opgegeven structuurweergave-item opgehaald.
CTreeCtrl::GetPrevSiblingItem Hiermee haalt u het vorige niveau van het opgegeven structuurweergave-item op.
CTreeCtrl::GetPrevVisibleItem Hiermee haalt u het vorige zichtbare item van het opgegeven structuurweergave-item op.
CTreeCtrl::GetRootItem Haalt de hoofdmap van het opgegeven structuurweergave-item op.
CTreeCtrl::GetScrollTime Hiermee haalt u de maximale schuiftijd voor het besturingselement voor de structuurweergave op.
CTreeCtrl::GetSelectedCount Hiermee wordt het aantal geselecteerde items opgehaald in het huidige besturingselement voor structuurweergave.
CTreeCtrl::GetSelectedItem Hiermee haalt u het geselecteerde structuurweergave-item op.
CTreeCtrl::GetTextColor Hiermee haalt u de huidige tekstkleur van het besturingselement op.
CTreeCtrl::GetToolTips Haalt de ingang op naar het onderliggende ToolTip besturingselement dat wordt gebruikt door een structuurweergavebesturingselement.
CTreeCtrl::GetVisibleCount Hiermee haalt u het aantal zichtbare structuuritems op dat is gekoppeld aan een besturingselement voor de structuurweergave.
CTreeCtrl::HitTest Retourneert de huidige positie van de cursor die is gerelateerd aan het CTreeCtrl object.
CTreeCtrl::InsertItem Hiermee voegt u een nieuw item in een besturingselement voor de structuurweergave in.
CTreeCtrl::ItemHasChildren Retourneert niet-nul als het opgegeven item onderliggende items bevat.
CTreeCtrl::MapAccIdToItem Hiermee wordt de opgegeven toegankelijkheids-id toegewezen aan de ingang van een structuurweergave-item in het huidige besturingselement voor structuurweergave.
CTreeCtrl::MapItemToAccID Hiermee wordt de opgegeven ingang toegewezen aan een item in de structuurweergave in het huidige besturingselement voor structuurweergave met een toegankelijkheids-id.
CTreeCtrl::Select Selecteert, schuift naar de weergave of tekent een opgegeven structuurweergave-item opnieuw.
CTreeCtrl::SelectDropTarget Hiermee wordt het structuuritem opnieuw getekend als doel van een slepen-en-neerzetten-bewerking.
CTreeCtrl::SelectItem Hiermee selecteert u een opgegeven structuurweergave-item.
CTreeCtrl::SelectSetFirstVisible Hiermee selecteert u een opgegeven structuurweergave-item als het eerste zichtbare item.
CTreeCtrl::SetAutoscrollInfo Hiermee stelt u de automatische inschrijvingssnelheid van het huidige besturingselement voor structuurweergave in.
CTreeCtrl::SetBkColor Hiermee stelt u de achtergrondkleur van het besturingselement in.
CTreeCtrl::SetCheck Hiermee stelt u de controlestatus van een boomstructuurbesturingselementitem in.
CTreeCtrl::SetExtendedStyle Hiermee stelt u de uitgebreide stijlen voor het huidige besturingselement voor structuurweergave in.
CTreeCtrl::SetImageList Hiermee stelt u de greep in van de lijst met afbeeldingen die is gekoppeld aan een structuurweergavebesturingselement.
CTreeCtrl::SetIndent Hiermee stelt u de verschuiving (in pixels) van een structuurweergave-item van het bovenliggende item in.
CTreeCtrl::SetInsertMark Hiermee stelt u de invoegmarkering in een structuurweergavebesturingselement in.
CTreeCtrl::SetInsertMarkColor Hiermee stelt u de kleur in die wordt gebruikt om de invoegmarkering voor de structuurweergave te tekenen.
CTreeCtrl::SetItem Hiermee stelt u de kenmerken van een opgegeven structuurweergave-item in.
CTreeCtrl::SetItemData Hiermee stelt u de toepassingsspecifieke waarde in die aan een item is gekoppeld.
CTreeCtrl::SetItemExpandedImageIndex Hiermee stelt u de index van de afbeelding in die moet worden weergegeven wanneer het opgegeven item van het huidige besturingselement voor structuurweergave de uitgevouwen status heeft.
CTreeCtrl::SetItemHeight Hiermee stelt u de hoogte van de items in de structuurweergave in.
CTreeCtrl::SetItemImage Hiermee koppelt u afbeeldingen aan een item.
CTreeCtrl::SetItemState Hiermee stelt u de status van een item in.
CTreeCtrl::SetItemStateEx Hiermee stelt u de uitgebreide status van het opgegeven item in het huidige besturingselement voor structuurweergave in.
CTreeCtrl::SetItemText Hiermee stelt u de tekst van een item in.
CTreeCtrl::SetLineColor Hiermee stelt u de huidige lijnkleur in voor het besturingselement structuurweergave.
CTreeCtrl::SetScrollTime Hiermee stelt u de maximale schuiftijd voor het besturingselement voor de structuurweergave in.
CTreeCtrl::SetTextColor Hiermee stelt u de tekstkleur van het besturingselement in.
CTreeCtrl::SetToolTips Hiermee stelt u het onderliggende ToolTip besturingselement van een structuurweergave in.
CTreeCtrl::ShowInfoTip Geeft de infotip weer voor het opgegeven item in het huidige besturingselement voor de structuurweergave.
CTreeCtrl::SortChildren Hiermee worden de onderliggende items van een bepaald bovenliggend item gesorteerd.
CTreeCtrl::SortChildrenCB Hiermee sorteert u de onderliggende items van een bepaald bovenliggend item met behulp van een door de toepassing gedefinieerde sorteerfunctie.

Opmerkingen

Een 'structuurweergavebesturingselement' is een venster waarin een hiërarchische lijst met items wordt weergegeven, zoals de koppen in een document, de vermeldingen in een index of de bestanden en mappen op een schijf. Elk item bestaat uit een label en een optionele bitmapafbeelding en elk item kan een lijst met subitems bevatten die eraan zijn gekoppeld. Door op een item te klikken, kan de gebruiker de bijbehorende lijst met subitems uitvouwen en samenvouwen.

Dit besturingselement (en daarom de CTreeCtrl klasse) is alleen beschikbaar voor programma's die worden uitgevoerd onder Windows 98 en Windows NT versie 4 en hoger.

Zie voor meer informatie over het gebruik CTreeCtrl:

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CTreeCtrl

Requirements

Rubriek:afxcmn.h

CTreeCtrl::Create

Als u het structuurbesturingselement opgeeft in een dialoogvenstersjabloon of als u dat gebruikt CTreeView, wordt uw structuurbesturingselement automatisch gemaakt wanneer het dialoogvenster of de weergave wordt gemaakt.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterwaarden

dwStyle
Hiermee geeft u de stijl van het besturingselement voor de structuurweergave op. Pas vensterstijlen toe, beschreven in CreateWindowen een combinatie van besturingsstijlen voor structuurweergaven , zoals beschreven in de Windows SDK.

rect
Hiermee geeft u de grootte en positie van het besturingselement voor de structuurweergave op. Het kan een CRect object of een RECT structuur zijn.

pParentWnd
Hiermee geeft u het bovenliggende venster van het structuurweergavebesturingselement, meestal een CDialog. Het mag niet zijn NULL.

nID
Hiermee geeft u de id van het besturingselement voor de structuurweergave op.

Retourwaarde

Niet-nul als initialisatie is geslaagd; anders 0.

Opmerkingen

Als u het structuurbesturingselement wilt maken als een onderliggend venster van een ander venster, gebruikt u de Create lidfunctie. Als u het structuurbesturingselement maakt met behulp van Create, moet u deze WS_VISIBLEdoorgeven , naast andere stijlen voor structuurweergaven.

U maakt een CTreeCtrl in twee stappen. Roep eerst de constructor aan en roep Createvervolgens het besturingselement voor de structuurweergave aan en koppelt deze aan het CTreeCtrl object.

Als u een structuurbesturingselement met uitgebreide vensterstijlen wilt maken, roept CreateEx u in plaats van Create.

Example

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

Roep deze functie aan om een besturingselement (een onderliggend venster) te maken en dit aan het CTreeCtrl object te koppelen.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterwaarden

dwExStyle
Hiermee geeft u de uitgebreide stijl van het besturingselement dat wordt gemaakt. Zie de dwExStyle parameter voor in de Windows SDK voor CreateWindowEx een lijst met uitgebreide Windows-stijlen.

dwStyle
Hiermee geeft u de stijl van het besturingselement voor de structuurweergave op. Pas vensterstijlen toe, beschreven in CreateWindowen een combinatie van besturingsstijlen voor structuurweergaven , zoals beschreven in de Windows SDK.

rect
Een verwijzing naar een RECT structuur die de grootte en positie van het venster beschrijft dat moet worden gemaakt, in clientcoördinaten van pParentWnd.

pParentWnd
Een aanwijzer naar het venster dat het bovenliggende besturingselement is.

nID
De id van het onderliggende venster van het besturingselement.

Retourwaarde

Nonzero als dit anders 0 lukt.

Opmerkingen

Gebruik CreateEx in plaats van Create uitgebreide Windows-stijlen toe te passen, die zijn opgegeven door het voorwoord WS_EX_voor de uitgebreide Stijl van Windows.

CTreeCtrl::CreateDragImage

Roep deze functie aan om een slepende bitmap te maken voor het opgegeven item in een structuurweergavebesturingselement, maak een afbeeldingslijst voor de bitmap en voeg de bitmap toe aan de lijst met afbeeldingen.

CImageList* CreateDragImage(HTREEITEM hItem);

Parameterwaarden

hItem
Greep van het structuuritem dat moet worden gesleept.

Retourwaarde

Wijs de lijst met afbeeldingen aan waaraan de slepende bitmap is toegevoegd, indien geslaagd; anders NULL.

Opmerkingen

Een toepassing gebruikt de functies voor de lijst met afbeeldingen om de afbeelding weer te geven wanneer het item wordt gesleept.

Het CImageList object is permanent en u moet het verwijderen wanneer u klaar bent. Voorbeeld:

HTREEITEM hItem = m_TreeCtrl.GetSelectedItem();

CImageList *pImageList = m_TreeCtrl.CreateDragImage(hItem);

// Do something with the image list.

delete pImageList;

CTreeCtrl::CTreeCtrl

Maakt een CTreeCtrl object.

CTreeCtrl();

CTreeCtrl::DeleteAllItems

Roep deze functie aan om alle items uit het besturingselement structuurweergave te verwijderen.

BOOL DeleteAllItems();

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

// The underlying Windows API always returns TRUE
VERIFY(m_TreeCtrl.DeleteAllItems());

CTreeCtrl::DeleteItem

Roep deze functie aan om een item te verwijderen uit het besturingselement voor de structuurweergave.

BOOL DeleteItem(HTREEITEM hItem);

Parameterwaarden

hItem
Greep van het structuuritem dat moet worden verwijderd. Als hitem de TVI_ROOT waarde is, worden alle items verwijderd uit het besturingselement structuurweergave.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

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

Roep deze functie aan om in-place bewerking van de tekst van het opgegeven item te starten.

CEdit* EditLabel(HTREEITEM hItem);

Parameterwaarden

hItem
Greep van het structuuritem dat moet worden bewerkt.

Retourwaarde

Als dit lukt, wijst u een aanwijzer naar het CEdit object dat wordt gebruikt om de itemtekst te bewerken; anders NULL.

Opmerkingen

Het bewerken wordt uitgevoerd door de tekst van het item te vervangen door een besturingselement voor bewerken met één regel dat de tekst bevat.

Example

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

Hiermee wordt de bewerking afgerond op het label van een item in de structuurweergave in het huidige besturingselement voor structuurweergave.

BOOL EndEditLabelNow(BOOL fCancelWithoutSave);

Parameterwaarden

fCancelWithoutSave
[in] TRUE als u wijzigingen in het item in de structuurweergave wilt negeren voordat u de bewerking voltooit of FALSE wijzigingen in het item structuurweergave wilt opslaan voordat u de bewerking voltooit.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het TVM_ENDEDITLABELNOW bericht verzonden, dat wordt beschreven in de Windows SDK.

CTreeCtrl::EnsureVisible

Roep deze functie aan om ervoor te zorgen dat een structuurweergave-item zichtbaar is.

BOOL EnsureVisible(HTREEITEM hItem);

Parameterwaarden

hItem
Greep van het structuuritem dat zichtbaar wordt gemaakt.

Retourwaarde

Retourneert TRUE als het systeem door de items in het besturingselement structuurweergave heeft geschoven om ervoor te zorgen dat het opgegeven item zichtbaar is. Anders is FALSEde retourwaarde .

Opmerkingen

Indien nodig vouwt de functie het bovenliggende item uit of schuift het besturingselement voor de structuurweergave zodat het item zichtbaar is.

Example

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

Roep deze functie aan om de lijst met onderliggende items, indien aanwezig, uit te vouwen of samen te vouwen die zijn gekoppeld aan het opgegeven bovenliggende item.

BOOL Expand(
    HTREEITEM hItem,
    UINT nCode);

Parameterwaarden

hItem
Greep van het structuuritem dat wordt uitgevouwen.

nCode
Een vlag die aangeeft welk type actie moet worden uitgevoerd. Deze vlag kan een van de volgende waarden hebben:

  • TVE_COLLAPSE Hiermee wordt de lijst samengevouwen.

  • TVE_COLLAPSERESET Hiermee wordt de lijst samengevouwen en worden de onderliggende items verwijderd. De TVIS_EXPANDEDONCE statusvlag wordt opnieuw ingesteld. Deze vlag moet worden gebruikt met de TVE_COLLAPSE vlag.

  • TVE_EXPAND Hiermee wordt de lijst uitgevouwen.

  • TVE_TOGGLE Hiermee wordt de lijst samengevouwen als deze momenteel is uitgevouwen of uitgevouwen als deze momenteel is samengevouwen.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

Zie het voorbeeld voor CTreeCtrl::EnsureVisible.

CTreeCtrl::GetBkColor

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_GETBKCOLOR, zoals beschreven in de Windows SDK.

COLORREF GetBkColor() const;

Retourwaarde

Een COLORREF waarde die de huidige achtergrondkleur van het venster voor het besturingselement vertegenwoordigt. Als deze waarde -1 is, gebruikt het besturingselement de kleur van het systeemvenster. In dit geval kunt u de ::GetSysColor(COLOR_WINDOW) huidige systeemkleur ophalen die het besturingselement gebruikt.

Example

Zie het voorbeeld voor CTreeCtrl::SetTextColor.

CTreeCtrl::GetCheck

Roep deze lidfunctie aan om de controlestatus van een item op te halen.

BOOL GetCheck(HTREEITEM hItem) const;

Parameterwaarden

hItem
Het HTREEITEM punt waarover de statusinformatie moet worden ontvangen.

Retourwaarde

Niet-nul als het boomstructuurbesturingselementitem is ingeschakeld; anders 0.

Example

Zie het voorbeeld voor CTreeCtrl::SetCheck.

CTreeCtrl::GetChildItem

Roep deze functie aan om het structuurweergave-item op te halen dat het onderliggende item is van het item dat is opgegeven door hItem.

HTREEITEM GetChildItem(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

De ingang van het onderliggende item als dit lukt; anders NULL.

Example

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

Roep deze functie aan om het aantal items in een structuurweergavebesturingselement op te halen.

UINT GetCount() const;

Retourwaarde

Het aantal items in het besturingselement structuurweergave.

Example

// Delete all of the items from the tree control.
m_TreeCtrl.DeleteAllItems();
ASSERT(m_TreeCtrl.GetCount() == 0);

CTreeCtrl::GetDropHilightItem

Roep deze functie aan om het item op te halen dat het doel is van een slepen-en-neerzetten-bewerking.

HTREEITEM GetDropHilightItem() const;

Retourwaarde

De ingang van het item is verwijderd als het lukt; anders NULL.

Example

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

Roep deze functie aan om de ingang op te halen van het bewerkingsbesturingselement dat wordt gebruikt om de tekst van een structuurweergave-item te bewerken.

CEdit* GetEditControl() const;

Retourwaarde

Een aanwijzer naar het besturingselement bewerken dat wordt gebruikt voor het bewerken van de itemtekst, indien geslaagd; anders NULL.

Example

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

Hiermee haalt u de uitgebreide stijlen op die door het huidige besturingselement voor structuurweergave worden gebruikt.

DWORD GetExtendedStyle() const;

Retourwaarde

Een waarde die een bitsgewijze combinatie (OR) van de uitgebreide stijlen van het huidige besturingselement voor structuurweergave bevat. Zie Tree-View Uitgebreide stijlen voor besturingselementen voor meer informatie.

Opmerkingen

Met deze methode wordt het TVM_GETEXTENDEDSTYLE bericht verzonden, dat wordt beschreven in de Windows SDK.

CTreeCtrl::GetFirstVisibleItem

Roep deze functie aan om het eerste zichtbare item van het besturingselement structuurweergave op te halen.

HTREEITEM GetFirstVisibleItem() const;

Retourwaarde

De ingang van het eerste zichtbare item; anders NULL.

Example

Zie het voorbeeld voor CTreeCtrl::SetCheck.

CTreeCtrl::GetImageList

Roep deze functie aan om de ingang op te halen van de normale afbeeldingslijst of de statusafbeeldingslijst die is gekoppeld aan het besturingselement voor de structuurweergave.

CImageList* GetImageList(UINT nImageList) const;

Parameterwaarden

nImageList
Het type afbeeldingslijst dat moet worden opgehaald. De lijst met afbeeldingen kan een van de volgende waarden zijn:

  • TVSIL_NORMAL Hiermee haalt u de normale lijst met afbeeldingen op, die de geselecteerde en niet-geselecteerde afbeeldingen voor het item in de structuurweergave bevat.

  • TVSIL_STATE Haalt de lijst met statusafbeeldingen op, die de afbeeldingen bevat voor items in de structuurweergave die een door de gebruiker gedefinieerde status hebben.

Retourwaarde

Wijs de afbeeldingslijst van het besturingselement aan als dit lukt; anders NULL.

Opmerkingen

Aan elk item in een besturingselement voor de structuurweergave kan een paar bitmapafbeeldingen zijn gekoppeld. De ene afbeelding wordt weergegeven wanneer het item is geselecteerd en de andere wordt weergegeven wanneer het item niet is geselecteerd. Een item kan bijvoorbeeld een geopende map weergeven wanneer deze is geselecteerd en een gesloten map wanneer het niet is geselecteerd.

Zie de CImageList klasse voor meer informatie over afbeeldingslijsten.

Example

ASSERT(m_TreeCtrl.GetImageList(TVSIL_NORMAL) == NULL);

m_TreeCtrl.SetImageList(&m_TreeImages, TVSIL_NORMAL);
ASSERT(m_TreeCtrl.GetImageList(TVSIL_NORMAL) == &m_TreeImages);

CTreeCtrl::GetIndent

Roep deze functie aan om de hoeveelheid in pixels op te halen die onderliggende items ten opzichte van hun bovenliggende items worden ingesprongen.

UINT GetIndent() const;

Retourwaarde

De hoeveelheid inspringing gemeten in pixels.

Example

// Double the indent.
UINT uIndent = m_TreeCtrl.GetIndent();
m_TreeCtrl.SetIndent(2 * uIndent);

CTreeCtrl::GetInsertMarkColor

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_GETINSERTMARKCOLOR, zoals beschreven in de Windows SDK.

COLORREF GetInsertMarkColor() const;

Retourwaarde

Een COLORREF waarde die de huidige kleur van de invoegmarkering bevat.

Example

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

Roep deze functie aan om de kenmerken van het opgegeven structuurweergave-item op te halen.

BOOL GetItem(TVITEM* pItem) const;

Parameterwaarden

pItem
Een aanwijzer naar een TVITEM structuur, zoals beschreven in de Windows SDK.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

Zie het voorbeeld voor CTreeCtrl::DeleteItem.

CTreeCtrl::GetItemData

Roep deze functie aan om de toepassingsspecifieke waarde op te halen die is gekoppeld aan het opgegeven item.

DWORD_PTR GetItemData(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van het item waarvan de gegevens moeten worden opgehaald.

Retourwaarde

Een toepassingsspecifieke waarde van de aanwijzer die is gekoppeld aan het item dat is opgegeven door hItem.

Example

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

Haalt de index van de afbeelding op die moet worden weergegeven wanneer het opgegeven item van het huidige besturingselement voor structuurweergave de uitgevouwen status heeft.

int GetItemExpandedImageIndex(HTREEITEM hItem)const;

Parameterwaarden

hItem
[in] Greep naar een besturingselementitem voor structuurweergave.

Retourwaarde

De index van de afbeelding die moet worden weergegeven wanneer het opgegeven item de uitgevouwen status heeft.

Opmerkingen

Met deze methode wordt het TVM_GETITEM bericht verzonden, dat wordt beschreven in de Windows SDK. Dit bericht retourneert de TVITEMEX structuur die het besturingselementitem voor structuurweergave beschrijft en vervolgens haalt deze methode het iExpandedImage lid op uit die structuur.

CTreeCtrl::GetItemHeight

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_GETITEMHEIGHT, zoals beschreven in de Windows SDK.

SHORT GetItemHeight() const;

Retourwaarde

De hoogte van het item, in pixels.

Example

// Double the height of the items.
SHORT sHeight = m_TreeCtrl.GetItemHeight();
m_TreeCtrl.SetItemHeight(2 * sHeight);

CTreeCtrl::GetItemImage

Aan elk item in een besturingselement voor de structuurweergave kan een paar bitmapafbeeldingen zijn gekoppeld.

BOOL GetItemImage(
    HTREEITEM hItem,
    int& nImage,
    int& nSelectedImage) const;

Parameterwaarden

hItem
De ingang van het item waarvan de afbeelding moet worden opgehaald.

nImage
Een geheel getal dat de index van de afbeelding van het item in de lijst met afbeeldingen van het structuurweergavebesturingselement ontvangt.

nSelectedImage
Een geheel getal dat de index van de geselecteerde afbeelding van het item in de lijst met afbeeldingen van het structuurweergavebesturingselement ontvangt.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

De afbeeldingen worden links van het label van een item weergegeven. De ene afbeelding wordt weergegeven wanneer het item is geselecteerd en de andere wordt weergegeven wanneer het item niet is geselecteerd. Een item kan bijvoorbeeld een geopende map weergeven wanneer deze is geselecteerd en een gesloten map wanneer het niet is geselecteerd.

Roep deze functie aan om de index van de afbeelding van het item en de geselecteerde afbeelding in de lijst met afbeeldingen van het structuurweergavebesturingselement op te halen.

Example

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

Hiermee wordt de begrenzingsrechthoek opgehaald voor een opgegeven deel van een opgegeven item in het huidige besturingselement voor structuurweergave.

BOOL GetItemPartRect(
    HTREEITEM hItem,
    int nPart,
    LPRECT lpRect)const;

Parameterwaarden

hItem
[in] Greep naar een besturingselementitem voor structuurweergave.

nPart
[in] Id voor het onderdeel. Moet worden ingesteld op TVGIPR_BUTTON.

lpRect
[uit] Wijs een RECT structuur aan. Als deze methode is geslaagd, ontvangt de structuur de rechthoekcoördinaten van het deel dat is opgegeven door hItem en nPart.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Elk item met structuurbeheer wordt gebonden door een grafische rechthoek. Wanneer op een punt in die rechthoek wordt geklikt, wordt gezegd dat het item wordt geraakt. Met deze methode wordt de grootste rechthoek geretourneerd, zodat wanneer er op een punt in de rechthoek wordt geklikt, het item dat door de hItem parameter wordt geïdentificeerd, wordt bereikt.

Met deze methode wordt het TVM_GETITEMPARTRECT bericht verzonden, dat wordt beschreven in de Windows SDK. Zie de TreeView_GetItemPartRect macro voor meer informatie.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_treeCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor structuurweergave. In het codevoorbeeld worden ook een niet-ondertekend geheel getal en verschillende HTREEITEM variabelen gedefinieerd. Deze variabelen worden gebruikt in het volgende voorbeeld.

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;

In het volgende codevoorbeeld wordt een toegankelijkheids-id en de CTreeCtrl::MapAccIdToItem methode gebruikt om een ingang op te halen voor het item in de hoofdstructuurweergave. Vervolgens wordt in het voorbeeld de greep en de CTreeCtrl::GetItemPartRect methode gebruikt om een 3D-rechthoek rond dat item te tekenen. In een eerdere sectie van het codevoorbeeld, dat niet wordt weergegeven, hebben we een structuurweergave gemaakt die bestaat uit een hoofd-land-/regioknooppunt voor de Verenigde Staten, subknooppunten voor de staten Pennsylvania en Washington, en structuuritems voor steden in die staten. We hebben de CTreeCtrl::MapItemToAccID methode gebruikt om het item hoofdstructuurweergave te koppelen aan een toegankelijkheids-id.

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

Roep deze functie aan om de begrenzingsrechthoek voor hItem op te halen en te bepalen of deze wel of niet zichtbaar is.

BOOL GetItemRect(
    HTREEITEM hItem,
    LPRECT lpRect,
    BOOL bTextOnly) const;

Parameterwaarden

hItem
De greep van een besturingselementitem voor de structuurweergave.

lpRect
Aanwijzer naar een RECT structuur die de begrenzingsrechthoek ontvangt. De coördinaten zijn relatief ten opzichte van de linkerbovenhoek van het besturingselement voor de structuurweergave.

bTextOnly
Als deze parameter niet-nul is, bevat de begrenzingsrechthoek alleen de tekst van het item. Anders bevat het de hele lijn die het item inneemt in het besturingselement voor de structuurweergave.

Retourwaarde

Niet-nul als het item zichtbaar is, met de begrenzingsrechthoek in lpRect. Anders, 0 met lpRect niet-geïnitialiseerd.

Example

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

Retourneert de status van het item dat is opgegeven door hItem.

UINT GetItemState(
    HTREEITEM hItem,
    UINT nStateMask) const;

Parameterwaarden

hItem
Greep van het item waarvan de status moet worden opgehaald.

nStateMask
Masker dat aangeeft dat een of meer statussen moeten worden opgehaald. Zie de discussie over de state en stateMask leden van de structuur in de TVITEM Windows SDK voor meer informatie over mogelijke waardennStateMask.

Retourwaarde

Een UINT die de C++ bitwise OR-operator (|) bevat van de waarden die zijn opgegeven door nStateMask. Zie CTreeCtrl::GetItemvoor meer informatie over mogelijke waarden. Als u de waarde voor een specifieke status wilt vinden, voert u een C++ bitwise AND-operator (&) f de statuswaarde en de retourwaarde uit, zoals wordt weergegeven in het volgende voorbeeld.

Example

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

Hiermee wordt de uitgebreide status van het opgegeven item opgehaald in het huidige besturingselement voor structuurweergave.

UINT GetItemStateEx(HTREEITEM hItem) const;

Parameterwaarden

hItem
[in] Greep naar een besturingselementitem voor structuurweergave.

Retourwaarde

De uitgebreide status van het item. Zie het uStateEx lid van de TVITEMEX structuur voor meer informatie.

Opmerkingen

Met deze methode wordt het TVM_GETITEM bericht verzonden, dat wordt beschreven in de Windows SDK. Dit bericht retourneert de TVITEMEX structuur die het besturingselementitem voor structuurweergave beschrijft en met deze methode wordt het uStateEx lid opgehaald uit die structuur.

CTreeCtrl::GetItemText

Retourneert de tekst van het item dat is opgegeven door hItem.

CString GetItemText(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van het item waarvan de tekst moet worden opgehaald.

Retourwaarde

Een CString object met de tekst van het item.

Example

Zie het voorbeeld voor CTreeCtrl::GetNextItem.

CTreeCtrl::GetLastVisibleItem

Hiermee wordt het laatste niet-uitgevouwen knooppuntitem opgehaald in het huidige besturingselement voor structuurweergave.

HTREEITEM GetLastVisibleItem() const;

Retourwaarde

De ingang naar het laatste niet-uitgevouwen knooppuntitem als de methode is geslaagd; anders, NULL.

Opmerkingen

Met deze methode wordt het TVM_GETNEXTITEM bericht verzonden, dat wordt beschreven in de Windows SDK. Zie de TVGN_LASTVISIBLE vlag in de flag parameter van dat bericht voor meer informatie.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_treeCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor structuurweergave. In het codevoorbeeld worden ook een niet-ondertekend geheel getal en verschillende HTREEITEM variabelen gedefinieerd. Een of meer van deze variabelen worden gebruikt in het volgende voorbeeld.

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;

In het volgende codevoorbeeld wordt een ingang opgehaald naar het laatste niet-uitgevouwen knooppuntitem met structuurweergave en wordt vervolgens een 3D-rechthoek rond dat item opgehaald. In een eerdere sectie van het codevoorbeeld, dat niet wordt weergegeven, hebben we een structuurweergave gemaakt die bestaat uit een hoofd-land-/regioknooppunt voor de Verenigde Staten, subknooppunten voor de staten Pennsylvania en Washington, en structuuritems voor steden in die staten.

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

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_GETLINECOLOR, zoals beschreven in de Windows SDK.

COLORREF GetLineColor() const;

Retourwaarde

De huidige lijnkleur.

Example

COLORREF cr = m_TreeCtrl.GetLineColor();

CTreeCtrl::GetNextItem

Roep deze functie aan om het structuurweergave-item met de opgegeven relatie, aangegeven door de nCode parameter, op te halen.hItem

HTREEITEM GetNextItem(
    HTREEITEM hItem,
    UINT nCode) const;

Parameterwaarden

hItem
Greep van een boomstructuuritem.

nCode
Een vlag die het type relatie aangeeft hItem. Deze vlag kan een van de volgende waarden zijn:

  • TVGN_CARET Hiermee wordt het geselecteerde item opgehaald.

  • TVGN_CHILD Hiermee wordt het eerste onderliggende item van het item opgehaald dat is opgegeven door de hItem parameter.

  • TVGN_DROPHILITE Hiermee haalt u het item op dat het doel is van een slepen-en-neerzetten-bewerking.

  • TVGN_FIRSTVISIBLE Hiermee wordt het eerste zichtbare item opgehaald.

  • TVGN_LASTVISIBLE Hiermee wordt het laatste uitgevouwen item in de structuur opgehaald. Hiermee wordt het laatste item niet opgehaald dat zichtbaar is in het structuurweergavevenster.

  • TVGN_NEXT Hiermee wordt het volgende item op hetzelfde niveau opgehaald.

  • TVGN_NEXTVISIBLE Hiermee wordt het volgende zichtbare item opgehaald dat volgt op het opgegeven item.

  • TVGN_PARENT Hiermee wordt het bovenliggende item van het opgegeven item opgehaald.

  • TVGN_PREVIOUS Hiermee haalt u het vorige item op hetzelfde niveau op.

  • TVGN_PREVIOUSVISIBLE Hiermee wordt het eerste zichtbare item opgehaald dat voorafgaat aan het opgegeven item.

  • TVGN_ROOT Hiermee wordt het eerste onderliggende item van het hoofditem opgehaald waarvan het opgegeven item deel uitmaakt.

Retourwaarde

De ingang van het volgende item als dit lukt; anders NULL.

Opmerkingen

Deze functie wordt geretourneerd NULL als het item dat wordt opgehaald het hoofdknooppunt van de structuur is. Als u dit bericht bijvoorbeeld gebruikt met de TVGN_PARENT vlag op een onderliggend onderliggend element van het hoofdknooppunt van de structuurweergave, wordt het bericht geretourneerd NULL.

Example

Zie voor een voorbeeld van het gebruik GetNextItem in een lus 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

Roep deze functie aan om het volgende niveau van hItem.

HTREEITEM GetNextSiblingItem(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

De ingang van het volgende item op hetzelfde niveau; anders NULL.

Example

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

Roep deze functie aan om het volgende zichtbare item van hItem.

HTREEITEM GetNextVisibleItem(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

De ingang van het volgende zichtbare item; anders NULL.

Example

Zie het voorbeeld voor CTreeCtrl::SetCheck.

CTreeCtrl::GetParentItem

Roep deze functie aan om het bovenliggende element van hItem.

HTREEITEM GetParentItem(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

De ingang van het bovenliggende item; anders NULL.

Opmerkingen

Deze functie wordt geretourneerd NULL als het bovenliggende item het hoofdknooppunt van de structuur is.

Example

Zie het voorbeeld voor CTreeCtrl::EnsureVisible.

CTreeCtrl::GetPrevSiblingItem

Roep deze functie aan om het vorige niveau van hItem.

HTREEITEM GetPrevSiblingItem(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

De ingang van het vorige niveau; anders NULL.

Example

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

Roep deze functie aan om het vorige zichtbare item van hItem.

HTREEITEM GetPrevVisibleItem(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

De ingang van het vorige zichtbare item; anders NULL.

Example

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

Roep deze functie aan om het hoofditem van het besturingselement structuurweergave op te halen.

HTREEITEM GetRootItem() const;

Retourwaarde

De ingang van het hoofditem; anders NULL.

Example

Zie het voorbeeld voor CTreeCtrl::EditLabel.

CTreeCtrl::GetScrollTime

Roep deze lidfunctie aan om de maximale schuiftijd voor het besturingselement structuurweergave op te halen.

UINT GetScrollTime() const;

Retourwaarde

De maximale schuiftijd, in milliseconden.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_GETSCROLLTIME, zoals beschreven in de Windows SDK.

CTreeCtrl::GetSelectedCount

Hiermee wordt het aantal geselecteerde items opgehaald in het huidige besturingselement voor structuurweergave.

UINT GetSelectedCount();

Retourwaarde

Het aantal geselecteerde items.

Opmerkingen

Met deze methode wordt het TVM_GETSELECTEDCOUNT bericht verzonden, dat wordt beschreven in de Windows SDK.

CTreeCtrl::GetSelectedItem

Roep deze functie aan om het geselecteerde item van het besturingselement structuurweergave op te halen.

HTREEITEM GetSelectedItem() const;

Retourwaarde

De ingang van het geselecteerde item; anders NULL.

Example

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

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_GETTEXTCOLOR, zoals beschreven in de Windows SDK.

COLORREF GetTextColor() const;

Retourwaarde

Een COLORREF waarde die de huidige tekstkleur vertegenwoordigt. Als deze waarde -1 is, gebruikt het besturingselement de systeemkleur voor de tekstkleur.

Example

Zie het voorbeeld voor CTreeCtrl::SetTextColor.

CTreeCtrl::GetToolTips

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_GETTOOLTIPS, zoals beschreven in de Windows SDK.

CToolTipCtrl* GetToolTips() const;

Retourwaarde

Een aanwijzer naar een CToolTipCtrl object dat moet worden gebruikt door het structuurbesturingselement. Als de Create lidfunctie de stijl TVS_NOTOOLTIPSgebruikt, worden er geen knopinfo gebruikt en NULL wordt deze geretourneerd.

Opmerkingen

De MFC-implementatie van GetToolTips retourneert een CToolTipCtrl object, dat wordt gebruikt door de structuurbesturingselement, in plaats van een ingang voor een besturingselement voor knopinfo.

Example

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

Roep deze functie aan om het aantal zichtbare items in een structuurweergavebesturingselement op te halen.

UINT GetVisibleCount() const;

Retourwaarde

Het aantal zichtbare items in het besturingselement structuurweergave; anders - 1.

Example

Zie het voorbeeld voor CTreeCtrl::SetCheck.

CTreeCtrl::HitTest

Roep deze functie aan om de locatie van het opgegeven punt te bepalen ten opzichte van het clientgebied van een structuurweergavebesturingselement.

HTREEITEM HitTest(
    CPoint pt,
    UINT* pFlags = NULL) const;

HTREEITEM HitTest(TVHITTESTINFO* pHitTestInfo) const;

Parameterwaarden

pt
Clientcoördinaten van het punt om te testen.

pFlags
Wijs een geheel getal aan dat informatie ontvangt over de resultaten van de hittest. Dit kan een of meer van de waarden zijn die worden vermeld onder het flags lid in de sectie Opmerkingen.

pHitTestInfo
Adres van een TVHITTESTINFO structuur die de positie bevat waarop de test moet worden bereikt en die informatie ontvangt over de resultaten van de hittest.

Retourwaarde

De ingang van het item van de structuurweergave dat het opgegeven punt in beslag neemt of NULL als er geen item het punt in beslag neemt.

Opmerkingen

Wanneer deze functie wordt aangeroepen, geeft de pt parameter de coördinaten op van het punt dat moet worden getest. De functie retourneert de ingang van het item op het opgegeven punt of NULL als er geen item het punt in beslag neemt. Bovendien bevat de pFlags parameter een waarde die de locatie van het opgegeven punt aangeeft. Mogelijke waarden zijn:

Waarde Description
TVHT_ABOVE Boven het clientgebied.
TVHT_BELOW Onder het clientgebied.
TVHT_NOWHERE In het clientgebied, maar onder het laatste item.
TVHT_ONITEM Op de bitmap of het label dat is gekoppeld aan een item.
TVHT_ONITEMBUTTON Op de knop die is gekoppeld aan een item.
TVHT_ONITEMICON Op de bitmap die aan een item is gekoppeld.
TVHT_ONITEMINDENT In de inspringing die is gekoppeld aan een item.
TVHT_ONITEMLABEL Op het label (tekenreeks) dat is gekoppeld aan een item.
TVHT_ONITEMRIGHT In het gebied rechts van een item.
TVHT_ONITEMSTATEICON Op het statuspictogram voor een item in de structuurweergave dat zich in een door de gebruiker gedefinieerde status bevindt.
TVHT_TOLEFT Links van het clientgebied.
TVHT_TORIGHT Rechts van het clientgebied.

Example

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

Roep deze functie aan om een nieuw item in te voegen in een structuurweergavebesturingselement.

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

Parameterwaarden

lpInsertStruct
Een aanwijzer naar een TVINSERTSTRUCT item met de kenmerken van het structuurweergave-item dat moet worden ingevoegd.

nMask
Geheel getal dat aangeeft welke kenmerken moeten worden ingesteld. Bekijk de TVITEM structuur in de Windows SDK.

lpszItem
Adres van een tekenreeks die de tekst van het item bevat.

nImage
Index van de afbeelding van het item in de lijst met afbeeldingen in de structuurweergave.

nSelectedImage
Index van de geselecteerde afbeelding van het item in de lijst met afbeeldingen van het besturingselement voor de structuurweergave.

nState
Hiermee geeft u waarden op voor de statussen van het item. Zie Statussen van besturingsitems in de Windows SDK voor een lijst met de juiste statussen.

nStateMask
Hiermee geeft u op welke statussen moeten worden ingesteld. Bekijk de TVITEM structuur in de Windows SDK.

lParam
Een toepassingsspecifieke waarde van de aanwijzer die aan het item is gekoppeld.

hParent
Ingang van het bovenliggende item van het ingevoegde item.

hInsertAfter
Greep van het item waarna het nieuwe item moet worden ingevoegd.

Retourwaarde

Afhandeling van het nieuwe item als dit lukt; anders NULL.

Opmerkingen

In het voorbeeld ziet u situaties waarin u mogelijk elke versie van de functie wilt gebruiken bij het invoegen van een structuurbesturingselementitem.

Example

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

Gebruik deze functie om te bepalen of het structuuritem dat is opgegeven door hItem onderliggende items bevat.

BOOL ItemHasChildren(HTREEITEM hItem) const;

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

Niet-nul als het structuuritem dat is opgegeven door hItem onderliggende items bevat; 0 als dat niet het geval is.

Opmerkingen

Zo ja, dan kunt u deze CTreeCtrl::GetChildItem onderliggende items ophalen.

Example

Zie het voorbeeld voor CTreeCtrl::GetSelectedItem.

CTreeCtrl::MapAccIdToItem

Hiermee wordt de opgegeven toegankelijkheids-id toegewezen aan de ingang van een item in de structuurweergave in het huidige besturingselement voor structuurweergave.

HTREEITEM MapAccIdToItem(UINT uAccId) const;

Parameterwaarden

uAccId
[in] Een toegankelijkheids-id voor een element in het structuurweergave-item.

Retourwaarde

De ingang naar een item in de structuurweergave (HTREEITEM) dat overeenkomt met de uAccId parameter. Zie het hItem lid van de TVITEMEX structuur voor meer informatie.

Opmerkingen

Toegankelijkheidshulpmiddelen zijn toepassingen die mensen met een handicap helpen computers te gebruiken. Een toegankelijkheids-id wordt door de IAccessible interface gebruikt om een element in een venster uniek op te geven. Zie Microsoft Active Accessibility voor meer informatie over de IAccessible API's.

Met deze methode wordt het TVM_MAPACCIDTOHTREEITEM bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_treeCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor structuurweergave. In het codevoorbeeld worden ook een niet-ondertekend geheel getal en verschillende HTREEITEM variabelen gedefinieerd. Deze variabelen worden gebruikt in het volgende voorbeeld.

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;

In het volgende codevoorbeeld wordt een toegankelijkheids-id en de CTreeCtrl::MapAccIdToItem methode gebruikt om een ingang op te halen voor het item in de hoofdstructuurweergave. In het voorbeeld worden de greep en de CTreeCtrl::GetItemPartRect methode gebruikt om een 3D-rechthoek rond dat item te tekenen. In een eerdere sectie van het codevoorbeeld, dat niet wordt weergegeven, hebben we een structuurweergave gemaakt die bestaat uit een hoofd-land-/regioknooppunt voor de Verenigde Staten, subknooppunten voor de staten Pennsylvania en Washington, en structuuritems voor steden in die staten. We hebben de CTreeCtrl::MapItemToAccID methode gebruikt om het item hoofdstructuurweergave te koppelen aan een toegankelijkheids-id.

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

Hiermee wijst u de opgegeven ingang van een item in de structuurweergave in het huidige besturingselement voor structuurweergave toe aan een toegankelijkheids-id.

UINT MapItemToAccID(HTREEITEM hItem) const;

Parameterwaarden

hItem
[in] Een greep van een item in de structuurweergave in het besturingselement. Zie het hItem lid van de TVITEMEX structuur voor meer informatie.

Retourwaarde

De toegankelijkheids-id die overeenkomt met de parameter hItem .

Opmerkingen

Toegankelijkheidshulpmiddelen zijn toepassingen die mensen met een handicap helpen computers te gebruiken. Een toegankelijkheids-id wordt door de IAccessible interface gebruikt om een element in een venster uniek op te geven. Zie Microsoft Active Accessibility voor meer informatie over de IAccessible API's.

Met deze methode wordt het TVM_MAPHTREEITEMTOACCID bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_treeCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor structuurweergave. In het codevoorbeeld worden ook een niet-ondertekend geheel getal en verschillende HTREEITEM variabelen gedefinieerd. Deze variabelen worden gebruikt in het volgende voorbeeld.

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;

In het volgende codevoorbeeld wordt een identificatienummer verkregen voor een besturingselementitem in de structuurweergave. In een eerdere sectie van het codevoorbeeld, dat niet wordt weergegeven, hebben we een structuurweergave gemaakt die bestaat uit een hoofd-land-/regioknooppunt voor de Verenigde Staten, subknooppunten voor de staten Pennsylvania en Washington, en structuuritems voor steden in die staten. In dit codevoorbeeld wordt een uniek identificatienummer opgehaald voor het hoofd-/regio-knooppunt.

// Map an accessibility identifier to the Pennsylvania node.
accIdUS = m_treeCtrl.MapItemToAccId(hCountry);

CTreeCtrl::Select

Roep deze functie aan om het opgegeven structuurweergave-item te selecteren, door het item naar de weergave te schuiven of het item opnieuw te tekenen in de stijl die wordt gebruikt om het doel van een slepen-en-neerzetten-bewerking aan te geven.

BOOL Select(
    HTREEITEM hItem,
    UINT nCode);

Parameterwaarden

hItem
Greep van een boomstructuuritem.

nCode
Het type actie dat moet worden uitgevoerd. Deze parameter kan een van de volgende waarden zijn:

  • TVGN_CARET Hiermee stelt u de selectie in op het opgegeven item.

  • TVGN_DROPHILITE Hiermee wordt het opgegeven item opnieuw getekend in de stijl die wordt gebruikt om het doel van een slepen-en-neerzetten-bewerking aan te geven.

  • TVGN_FIRSTVISIBLE Schuift de structuurweergave verticaal zodat het opgegeven item het eerste zichtbare item is.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Als nCode deze de waarde TVGN_CARETbevat, ontvangt het bovenliggende venster de TVN_SELCHANGING berichten en TVN_SELCHANGED meldingen. Als het opgegeven item het onderliggende item is van een samengevouwen bovenliggend item, wordt de lijst met onderliggende items van het bovenliggende item uitgebreid om het opgegeven item weer te geven. In dit geval ontvangt het bovenliggende venster de TVN_ITEMEXPANDING berichten en TVN_ITEMEXPANDED meldingen.

Example

Zie het voorbeeld voor CTreeCtrl::HitTest.

CTreeCtrl::SelectDropTarget

Roep deze functie aan om het item opnieuw te tekenen in de stijl die wordt gebruikt om het doel van een slepen-en-neerzetten-bewerking aan te geven.

BOOL SelectDropTarget(HTREEITEM hItem);

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

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

Roep deze functie aan om het opgegeven structuurweergave-item te selecteren.

BOOL SelectItem(HTREEITEM hItem);

Parameterwaarden

hItem
Greep van een boomstructuuritem.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Als hItem dat het is NULL, selecteert deze functie geen item.

Example

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

Roep deze functie aan om verticaal door de structuurweergave te schuiven, zodat het opgegeven item het eerste zichtbare item is.

BOOL SelectSetFirstVisible(HTREEITEM hItem);

Parameterwaarden

hItem
Greep van het structuuritem dat moet worden ingesteld als het eerste zichtbare item.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

De functie verzendt een bericht naar het venster met de TVM_SELECTITEM parameters en TVGN_FIRSTVISIBLE berichten.

Example

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

Hiermee stelt u de automatische inschrijvingssnelheid van het huidige besturingselement voor structuurweergave in.

BOOL SetAutoscrollInfo(
    UINT uPixelsPerSec,
    UINT uUpdateTime);

Parameterwaarden

uPixelsPerSec
[in] Het aantal pixels per seconde om te schuiven.

uUpdateTime
[in] Het tijdsinterval tussen updates van het besturingselement.

Retourwaarde

Retourneert altijd TRUE.

Opmerkingen

De parameters voor automatisch inschrijven worden gebruikt om te schuiven naar een item dat momenteel niet zichtbaar is. Het besturingselement voor structuurweergave moet de TVS_EX_AUTOHSCROLL uitgebreide stijl hebben, die wordt beschreven in Tree-View Uitgebreide stijlen voor besturingselementen.

Met deze methode wordt het TVM_SETAUTOSCROLLINFO bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_treeCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor structuurweergave. In het codevoorbeeld worden ook een niet-ondertekend geheel getal en verschillende HTREEITEM variabelen gedefinieerd. Deze variabelen worden gebruikt in het volgende voorbeeld.

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;

In het volgende codevoorbeeld wordt het gedrag van automatisch inschrijven van het huidige besturingselement voor structuurweergave ingesteld. In een eerdere sectie van het codevoorbeeld, dat niet wordt weergegeven, hebben we een structuurweergave gemaakt die bestaat uit een hoofd-land-/regioknooppunt voor de Verenigde Staten, subknooppunten voor de staten Pennsylvania en Washington, en structuuritems voor steden in die staten. We hebben het besturingselement voor de structuurweergave opzettelijk beperkt gemaakt, zodat het automatisch moet schuiven om het structuuritem weer te geven dat de focus heeft. In het codevoorbeeld wordt het besturingselement voor structuurweergave ingesteld om elke 5 seconden automatisch 30 pixels per seconde te schuiven totdat het structuuritem in weergave is.

// Scroll 30 pixels/sec and redraw every 5 seconds.
m_treeCtrl.SetAutoscrollInfo(30, 5);

CTreeCtrl::SetBkColor

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_SETBKCOLOR, zoals beschreven in de Windows SDK.

COLORREF SetBkColor(COLORREF clr);

Parameterwaarden

clr
Een COLORREF waarde die de nieuwe achtergrondkleur bevat. Als deze waarde -1 is, wordt het besturingselement teruggezet naar het gebruik van de systeemkleur voor de achtergrondkleur.

Retourwaarde

Een COLORREF waarde die de huidige tekstkleur vertegenwoordigt. Als deze waarde -1 is, gebruikt het besturingselement de systeemkleur voor de tekstkleur.

Example

Zie het voorbeeld voor CTreeCtrl::SetTextColor.

CTreeCtrl::SetCheck

Roep deze lidfunctie aan om de controlestatus voor een boomstructuuritem in te stellen.

BOOL SetCheck(
    HTREEITEM hItem,
    BOOL fCheck = TRUE);

Parameterwaarden

hItem
De HTREEITEM statuswijziging van de controle wordt ontvangen.

fCheck
Hiermee wordt aangegeven of het item van het structuurbeheer moet worden gecontroleerd of uitgeschakeld. SetCheck Standaard stelt u in dat het item moet worden gecontroleerd.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Wanneer het item van het structuurbeheer is ingeschakeld (fCheck ingesteld op TRUE), wordt het item weergegeven met een aangrenzend vinkje.

Example

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

Als u selectievakjes wilt gebruiken, stelt u in TVS_CHECKBOXES voordat u het structuurbesturingselement invult.

m_TreeCtrl.ModifyStyle(0, TVS_CHECKBOXES);

HTREEITEM aItem = m_TreeCtrl.InsertItem(_T("AAA"));
m_TreeCtrl.SetCheck(aItem);

CTreeCtrl::SetExtendedStyle

Hiermee stelt u de uitgebreide stijlen voor het huidige besturingselement voor structuurweergave in.

DWORD SetExtendedStyle(
    DWORD dwExMask,
    DWORD dwExStyles);

Parameterwaarden

dwExMask
[in] Een bitmasker dat aangeeft welke stijlen in het huidige besturingselement voor structuurweergave worden beïnvloed door deze methode. Als deze parameter nul is, wordt deze genegeerd en wordt de waarde van de dwExStyles parameter toegewezen aan het besturingselement structuurweergave. Geef nul of een bitsgewijze combinatie (OR) op van stijlen die worden beschreven in Tree-View Uitgebreide stijlen beheren.

dwExStyles
[in] Een bitmasker dat aangeeft welke stijlen in het huidige besturingselement voor de structuurweergave moeten worden ingesteld of gewist. Als u een combinatie van stijlen wilt instellen, geeft u een bitwise combinatie (OR) op van stijlen die worden beschreven in Tree-View Uitgebreide stijlen beheren. Als u een reeks stijlen wilt wissen, geeft u nul op.

Retourwaarde

Een waarde die de vorige uitgebreide besturingsstijlen bevat.

Opmerkingen

Met deze methode worden de stijlen gewist die zijn opgegeven in de dwExMask parameter en worden de stijlen ingesteld die zijn opgegeven in de dwExStyles parameter. Alleen de uitgebreide stijlen die overeenkomen met de bits die worden dwExMask gewijzigd.

Met deze methode wordt het TVM_SETEXTENDEDSTYLE bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_treeCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor structuurweergave. In het codevoorbeeld worden ook een niet-ondertekend geheel getal en verschillende HTREEITEM variabelen gedefinieerd. Deze variabelen worden gebruikt in het volgende voorbeeld.

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;

In het volgende codevoorbeeld wordt de TVS_EX_AUTOHSCROLL uitgebreide stijl toegevoegd aan het huidige besturingselement voor structuurweergave. In een eerdere sectie van het codevoorbeeld, dat niet wordt weergegeven, hebben we een structuurweergave gemaakt die bestaat uit een hoofd-land-/regioknooppunt voor de Verenigde Staten, subknooppunten voor de staten Pennsylvania en Washington, en structuuritems voor steden in die staten. We hebben het besturingselement voor de structuurweergave opzettelijk beperkt gemaakt, zodat het automatisch moet schuiven om het structuuritem weer te geven dat de focus heeft.

m_treeCtrl.SetExtendedStyle(TVS_EX_AUTOHSCROLL, TVS_EX_AUTOHSCROLL);

CTreeCtrl::SetImageList

Roep deze functie aan om de lijst met normale of statusafbeeldingen in te stellen voor een structuurweergavebesturingselement en het besturingselement opnieuw te tekenen met behulp van de nieuwe afbeeldingen.

CImageList* SetImageList(
    CImageList* pImageList,
    int nImageListType);

Parameterwaarden

pImageList
Aanwijzer naar de lijst met afbeeldingen die u wilt toewijzen. Als pImageList dat het is NULL, worden alle afbeeldingen verwijderd uit het besturingselement voor de structuurweergave.

nImageListType
Het type afbeeldingslijst dat moet worden ingesteld. De lijst met afbeeldingen kan een van de volgende waarden zijn:

  • TVSIL_NORMAL Hiermee stelt u de normale lijst met afbeeldingen in, die de geselecteerde en niet-geselecteerde afbeeldingen voor het item in de structuurweergave bevat. U moet deze status gebruiken voor overlayafbeeldingen.

  • TVSIL_STATE Hiermee stelt u de lijst met statusafbeeldingen in, die de afbeeldingen bevat voor items in de structuurweergave die een door de gebruiker gedefinieerde status hebben.

Retourwaarde

Wijs de vorige afbeeldingslijst aan, indien van toepassing; anders NULL.

Example

Zie het voorbeeld voor CTreeCtrl::GetImageList.

CTreeCtrl::SetIndent

Roep deze functie aan om de breedte van inspringing voor een structuurweergavebesturingselement in te stellen en het besturingselement opnieuw te tekenen om de nieuwe breedte weer te geven.

void SetIndent(UINT nIndent);

Parameterwaarden

nIndent
Breedte, in pixels, van de inspringing. Als nIndent de door het systeem gedefinieerde minimumbreedte kleiner is, wordt de nieuwe breedte ingesteld op het door het systeem gedefinieerde minimum.

Example

Zie het voorbeeld voor CTreeCtrl::GetIndent.

CTreeCtrl::SetInsertMark

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_SETINSERTMARK, zoals beschreven in de Windows SDK.

BOOL SetInsertMark(
    HTREEITEM hItem,
    BOOL fAfter = TRUE);

Parameterwaarden

hItem
HTREEITEM waarmee wordt aangegeven op welk item de invoegmarkering wordt geplaatst. Als dit argument NULL is, wordt de invoegmarkering verwijderd.

fAfter
BOOL-waarde die aangeeft of de invoegmarkering vóór of na het opgegeven item wordt geplaatst. Als dit argument niet-nul is, wordt de invoegmarkering na het item geplaatst. Als dit argument nul is, wordt de invoegmarkering vóór het item geplaatst.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

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

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_SETINSERTMARKCOLOR, zoals beschreven in de Windows SDK.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parameterwaarden

clrNew
Een COLORREF waarde die de nieuwe kleur van de invoegmarkering bevat.

Retourwaarde

Een COLORREF waarde die de vorige kleur van de invoegmarkering bevat.

Example

Zie het voorbeeld voor CTreeCtrl::GetInsertMarkColor.

CTreeCtrl::SetItem

Roep deze functie aan om de kenmerken van het opgegeven structuurweergave-item in te stellen.

BOOL SetItem(TVITEM* pItem);

BOOL SetItem(
    HTREEITEM hItem,
    UINT nMask,
    LPCTSTR lpszItem,
    int nImage,
    int nSelectedImage,
    UINT nState,
    UINT nStateMask,
    LPARAM lParam);

Parameterwaarden

pItem
Een aanwijzer naar een TVITEM structuur die de nieuwe itemkenmerken bevat, zoals beschreven in de Windows SDK.

hItem
Greep van het item waarvan de kenmerken moeten worden ingesteld. Bekijk het hItem lid van de TVITEM structuur in de Windows SDK.

nMask
Geheel getal dat aangeeft welke kenmerken moeten worden ingesteld. Zie het mask lid van de TVITEM structuur.

lpszItem
Adres van een tekenreeks die de tekst van het item bevat.

nImage
Index van de afbeelding van het item in de lijst met afbeeldingen in de structuurweergave. Zie het iImage lid van de TVITEM structuur.

nSelectedImage
Index van de geselecteerde afbeelding van het item in de lijst met afbeeldingen van het besturingselement voor de structuurweergave. Zie het iSelectedImage lid van de TVITEM structuur.

nState
Hiermee geeft u waarden op voor de statussen van het item. Zie het State lid van de TVITEM structuur.

nStateMask
Hiermee geeft u op welke statussen moeten worden ingesteld. Zie het stateMask lid van de TVITEM structuur.

lParam
Een toepassingsspecifieke waarde van de aanwijzer die aan het item is gekoppeld.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

In de TVITEM structuur identificeert het hItem lid het item en het mask lid geeft aan welke kenmerken moeten worden ingesteld.

Als het mask lid of de nMask parameter de TVIF_TEXT waarde opgeeft, wordt het pszText lid of het lpszItem adres van een door null beëindigde tekenreeks genegeerd en wordt het cchTextMax lid genegeerd. Als mask (ofnMask) de TVIF_STATE waarde opgeeft, geeft het stateMask lid of de nStateMask parameter aan welke itemstatussen moeten worden gewijzigd en bevat het lid of nState de state parameter de waarden voor die statussen.

Example

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

Roep deze functie aan om de toepassingsspecifieke waarde in te stellen die is gekoppeld aan het opgegeven item.

BOOL SetItemData(
    HTREEITEM hItem,
    DWORD_PTR dwData);

Parameterwaarden

hItem
Greep van het item waarvan de gegevens moeten worden opgehaald.

dwData
Een toepassingsspecifieke waarde van de aanwijzer die is gekoppeld aan het item dat is opgegeven door hItem.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

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

Hiermee stelt u de index van de afbeelding in die moet worden weergegeven wanneer het opgegeven item van het huidige besturingselement voor structuurweergave de uitgevouwen status heeft.

BOOL SetItemExpandedImageIndex(
    HTREEITEM hItem,
    int iExpandedImage);

Parameterwaarden

hItem
[in] Greep naar een besturingselementitem voor structuurweergave.

iExpandedImage
[in] De index van de afbeelding die moet worden weergegeven wanneer het opgegeven item de uitgevouwen status heeft.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het TVM_SETITEM bericht verzonden, dat wordt beschreven in de Windows SDK. Met deze methode wordt de iExpandedImage parameter toegewezen aan het iExpandedImage lid van een TVITEMEX structuur en wordt die structuur vervolgens in het bericht gebruikt.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_treeCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor structuurweergave. In het codevoorbeeld worden ook een niet-ondertekend geheel getal en verschillende HTREEITEM variabelen gedefinieerd. Deze variabelen worden gebruikt in het volgende voorbeeld.

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;

Het volgende codevoorbeeld is een triviale test om te bepalen of de CTreeCtrl::GetItemExpandedImageIndex methode de waarde retourneert die door de CTreeCtrl::SetItemExpandedImageIndex methode is ingesteld. In een eerdere sectie van het codevoorbeeld, dat niet wordt weergegeven, hebben we een structuurweergave gemaakt die bestaat uit een hoofd-land-/regioknooppunt voor de Verenigde Staten, subknooppunten voor de staten Pennsylvania en Washington, en structuuritems voor steden in die staten.

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

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_SETITEMHEIGHT, zoals beschreven in de Windows SDK.

SHORT SetItemHeight(SHORT cyHeight);

Parameterwaarden

cyHeight
Hiermee geeft u de nieuwe hoogte van elk item in de structuurweergave, in pixels. Als dit argument kleiner is dan de hoogte van de afbeeldingen, wordt dit ingesteld op de hoogte van de afbeeldingen. Als dit argument niet eens is, wordt het naar beneden afgerond op de dichtstbijzijnde even waarde. Als dit argument -1 is, wordt de standaarditemhoogte van het besturingselement weer gebruikt.

Retourwaarde

De vorige hoogte van de items, in pixels.

Example

Zie het voorbeeld voor CTreeCtrl::GetItemHeight.

CTreeCtrl::SetItemImage

Hiermee koppelt u afbeeldingen aan een item.

BOOL SetItemImage(
    HTREEITEM hItem,
    int nImage,
    int nSelectedImage);

Parameterwaarden

hItem
Greep van het item waarvan de afbeelding moet worden ingesteld.

nImage
Index van de afbeelding van het item in de lijst met afbeeldingen in de structuurweergave.

nSelectedImage
Index van de geselecteerde afbeelding van het item in de lijst met afbeeldingen van het besturingselement voor de structuurweergave.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Aan elk item in een besturingselement voor de structuurweergave kan een paar bitmapafbeeldingen zijn gekoppeld. De afbeeldingen worden links van het label van een item weergegeven. De ene afbeelding wordt weergegeven wanneer het item is geselecteerd en de andere wordt weergegeven wanneer het item niet is geselecteerd. Een item kan bijvoorbeeld een geopende map weergeven wanneer deze is geselecteerd en een gesloten map wanneer het niet is geselecteerd.

Roep deze functie aan om de index van de afbeelding van het item en de geselecteerde afbeelding in de lijst met afbeeldingen van het structuurweergavebesturingselement in te stellen.

Zie voor meer informatie over afbeeldingen CImageList.

Example

Zie het voorbeeld voor CTreeCtrl::GetItemImage.

CTreeCtrl::SetItemState

Hiermee stelt u de status van het item in dat is opgegeven door hItem.

BOOL SetItemState(
    HTREEITEM hItem,
    UINT nState,
    UINT nStateMask);

Parameterwaarden

hItem
Greep van het item waarvan de status moet worden ingesteld.

nState
Hiermee geeft u nieuwe statussen voor het item op.

nStateMask
Hiermee geeft u op welke statussen moeten worden gewijzigd.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Zie voor meer informatie over statussen CTreeCtrl::GetItem.

Example

Zie het voorbeeld voor CTreeCtrl::GetItemState.

CTreeCtrl::SetItemStateEx

Hiermee stelt u de uitgebreide status van het opgegeven item in het huidige besturingselement voor structuurweergave in.

BOOL SetItemStateEx(
    HTREEITEM hItem,
    UINT uStateEx);

Parameterwaarden

hItem
[in] Greep naar een besturingselementitem voor structuurweergave.

uStateEx
[in] De uitgebreide status van het item. Zie het uStateEx lid van de TVITEMEX structuur voor meer informatie.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het TVM_SETITEM bericht verzonden, dat wordt beschreven in de Windows SDK. Met deze methode wordt de uStateEx parameter toegewezen aan het uStateEx lid van een TVITEMEX structuur en wordt die structuur vervolgens in het bericht gebruikt.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_treeCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor structuurweergave. In het codevoorbeeld worden ook een niet-ondertekend geheel getal en verschillende HTREEITEM variabelen gedefinieerd. Deze variabelen worden gebruikt in het volgende voorbeeld.

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;

In het volgende codevoorbeeld wordt een item in de structuurweergave ingesteld op de status Uitgeschakeld. In een eerdere sectie van het codevoorbeeld, dat niet wordt weergegeven, hebben we een structuurweergave gemaakt die bestaat uit een hoofd-land-/regioknooppunt voor de Verenigde Staten, subknooppunten voor de staten Pennsylvania en Washington, en structuuritems voor steden in die staten. In dit codevoorbeeld wordt het knooppunt Pennsylvania ingesteld op de status Uitgeschakeld.

// Disable the Pennsylvania node.
m_treeCtrl.SetItemStateEx(hPA, TVIS_EX_DISABLED);

CTreeCtrl::SetItemText

Hiermee stelt u de tekst van het item in dat is opgegeven door hItem.

BOOL SetItemText(
    HTREEITEM hItem,
    LPCTSTR lpszItem);

Parameterwaarden

hItem
Greep van het item waarvan de tekst moet worden ingesteld.

lpszItem
Adres van een tekenreeks met de nieuwe tekst voor het item

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

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

Roep deze lidfunctie aan om de huidige lijnkleur voor het besturingselement structuurweergave in te stellen.

COLORREF SetLineColor(COLORREF clrNew = CLR_DEFAULT);

Parameterwaarden

clrNew
De nieuwe lijnkleur.

Retourwaarde

De vorige lijnkleur.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_SETLINECOLOR, zoals beschreven in de Windows SDK.

Example

COLORREF clrPrev = m_TreeCtrl.SetLineColor(RGB(255, 0, 0));

CTreeCtrl::SetScrollTime

Roep deze lidfunctie aan om de maximale schuiftijd voor het besturingselement structuurweergave in te stellen.

UINT SetScrollTime(UINT uScrollTime);

Parameterwaarden

uScrollTime
De nieuwe maximale schuiftijd, in milliseconden. Als deze waarde kleiner is dan 100, wordt deze afgerond op 100.

Retourwaarde

De vorige maximale schuiftijd, in milliseconden.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_SETSCROLLTIME, zoals beschreven in de Windows SDK.

CTreeCtrl::SetTextColor

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_SETTEXTCOLOR, zoals beschreven in de Windows SDK.

COLORREF SetTextColor(COLORREF clr);

Parameterwaarden

clr
Een COLORREF waarde die de nieuwe tekstkleur bevat. Als dit argument -1 is, wordt het besturingselement teruggezet naar het gebruik van de systeemkleur voor de tekstkleur.

Retourwaarde

Een COLORREF waarde die de vorige tekstkleur vertegenwoordigt. Als deze waarde -1 is, gebruikte het besturingselement de systeemkleur voor de tekstkleur.

Example

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

Deze lidfunctie implementeert het gedrag van het Win32-bericht TVM_SETTOOLTIPS, zoals beschreven in de Windows SDK.

CToolTipCtrl* SetToolTips(CToolTipCtrl* pWndTip);

Parameterwaarden

pWndTip
Een aanwijzer naar een CToolTipCtrl object dat door het structuurbesturingselement wordt gebruikt.

Retourwaarde

Een aanwijzer naar een CToolTipCtrl object met de knopinfo die eerder door het besturingselement is gebruikt, of NULL als er eerder geen knopinfo is gebruikt.

Opmerkingen

Als u knopinfo wilt gebruiken, geeft u de TVS_NOTOOLTIPS stijl aan wanneer u het CTreeCtrl object maakt.

Example

Zie het voorbeeld voor CTreeCtrl::GetToolTips.

CTreeCtrl::ShowInfoTip

Geeft de infotip weer voor het opgegeven item in het huidige besturingselement voor de structuurweergave.

void ShowInfoTip(HTREEITEM hItem);

Parameterwaarden

hItem
[in] Een ingang naar een item in de structuurweergave in het besturingselement. Zie het hItem lid van de TVITEMEX structuur voor meer informatie.

Opmerkingen

Zie Knopinfo en Infotips voor meer informatie over het verschil tussen knopinfo en infotips.

Met deze methode wordt het TVM_SHOWINFOTIP bericht verzonden, dat wordt beschreven in de Windows SDK.

CTreeCtrl::SortChildren

Roep deze functie aan om de onderliggende items van het opgegeven bovenliggende item alfabetisch te sorteren in een structuurweergavebesturingselement.

BOOL SortChildren(HTREEITEM hItem);

Parameterwaarden

hItem
Greep van het bovenliggende item waarvan de onderliggende items moeten worden gesorteerd. Als hItem dat het is NULL, wordt sorteren voortgezet vanaf de hoofdmap van de boom.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

SortChildren zal niet door de boom reurseren; alleen de directe kinderen van hItem zullen worden gesorteerd.

Example

// Sort all of the items in the tree control.
m_TreeCtrl.SortChildren(TVI_ROOT);

CTreeCtrl::SortChildrenCB

Roep deze functie aan om items in de structuurweergave te sorteren met behulp van een door de toepassing gedefinieerde callback-functie waarmee de items worden vergeleken.

BOOL SortChildrenCB(LPTVSORTCB pSort);

Parameterwaarden

pSort
Wijs een TVSORTCB structuur aan.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

De vergelijkingsfunctie van de structuur, lpfnComparemoet een negatieve waarde retourneren als het eerste item moet voorafgaan aan het tweede, een positieve waarde als het eerste item de tweede moet volgen of nul als de twee items gelijkwaardig zijn.

De lParam1 parameters lParam2 komen overeen met het lParam lid van de TVITEM structuur voor de twee items die worden vergeleken. De lParamSort parameter komt overeen met het lParam lid van de TV_SORTCB structuur.

Example

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

Zie ook

MFC-voorbeeld CMNCTRL1
CWnd klasse
Hiërarchiegrafiek
CImageList klasse