Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
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:
Verwijzing naar besturingselement voor structuurweergave in de Windows SDK.
Overnamehiërarchie
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_COLLAPSEHiermee wordt de lijst samengevouwen.TVE_COLLAPSERESETHiermee wordt de lijst samengevouwen en worden de onderliggende items verwijderd. DeTVIS_EXPANDEDONCEstatusvlag wordt opnieuw ingesteld. Deze vlag moet worden gebruikt met deTVE_COLLAPSEvlag.TVE_EXPANDHiermee wordt de lijst uitgevouwen.TVE_TOGGLEHiermee 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_NORMALHiermee haalt u de normale lijst met afbeeldingen op, die de geselecteerde en niet-geselecteerde afbeeldingen voor het item in de structuurweergave bevat.TVSIL_STATEHaalt 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_CARETHiermee wordt het geselecteerde item opgehaald.TVGN_CHILDHiermee wordt het eerste onderliggende item van het item opgehaald dat is opgegeven door dehItemparameter.TVGN_DROPHILITEHiermee haalt u het item op dat het doel is van een slepen-en-neerzetten-bewerking.TVGN_FIRSTVISIBLEHiermee wordt het eerste zichtbare item opgehaald.TVGN_LASTVISIBLEHiermee wordt het laatste uitgevouwen item in de structuur opgehaald. Hiermee wordt het laatste item niet opgehaald dat zichtbaar is in het structuurweergavevenster.TVGN_NEXTHiermee wordt het volgende item op hetzelfde niveau opgehaald.TVGN_NEXTVISIBLEHiermee wordt het volgende zichtbare item opgehaald dat volgt op het opgegeven item.TVGN_PARENTHiermee wordt het bovenliggende item van het opgegeven item opgehaald.TVGN_PREVIOUSHiermee haalt u het vorige item op hetzelfde niveau op.TVGN_PREVIOUSVISIBLEHiermee wordt het eerste zichtbare item opgehaald dat voorafgaat aan het opgegeven item.TVGN_ROOTHiermee 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_CARETHiermee stelt u de selectie in op het opgegeven item.TVGN_DROPHILITEHiermee 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_FIRSTVISIBLESchuift 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_NORMALHiermee 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_STATEHiermee 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