Boomstructuurbediening gebruiken

Normaal gebruik van een structuurbesturingselement (CTreeCtrl) volgt het onderstaande patroon:

• Het besturingselement wordt gemaakt. Als het besturingselement is opgegeven in een dialoogvenstersjabloon of als je CTreeView gebruikt, wordt het automatisch aangemaakt wanneer het dialoogvenster of de weergave wordt gemaakt. Als u het structuurbesturingselement wilt maken als een onderliggend venster van een ander venster, gebruikt u de functie Lid maken .

• Als u wilt dat uw structuurbesturingselement afbeeldingen gebruikt, stelt u een lijst met afbeeldingen in door SetImageList aan te roepen. U kunt de inspringing ook wijzigen door SetIndent aan te roepen. Een goed moment om dit te doen, is in OnInitDialog (voor besturingselementen in dialoogvensters) of OnInitialUpdate (voor weergaven).

• Plaats gegevens in het besturingselement door de CTreeCtrlfunctie InsertItem eenmaal aan te roepen voor elk gegevensitem. InsertItem retourneert een referentie naar het item waarnaar u later kunt verwijzen, bijvoorbeeld bij het toevoegen van onderliggende items. Een goed moment om de gegevens te initialiseren is in OnInitDialog (voor bedieningselementen in dialoogvensters) of OnInitialUpdate (voor weergaven).

• Wanneer de gebruiker met het besturingselement communiceert, worden er verschillende meldingsberichten verzonden. U kunt een functie opgeven om elk van de berichten te verwerken die u wilt verwerken door een ON_NOTIFY_REFLECT macro toe te voegen aan de berichtkaart van het besturingselementvenster of door een ON_NOTIFY macro toe te voegen aan de berichtkaart van het bovenliggende venster. Zie later in dit onderwerp Tree Control Notification Messages voor een lijst met mogelijke meldingen.

• Roep de verschillende setlidfuncties aan om waarden voor het besturingselement in te stellen. Wijzigingen die u kunt aanbrengen, zijn onder andere het instellen van de inspringing en het wijzigen van de tekst, afbeelding of gegevens die aan een item zijn gekoppeld.

• Gebruik de verschillende Get-functies om de inhoud van het besturingselement te onderzoeken. U kunt de inhoud van de boomstructuur ook doorlopen met functies waarmee u verwijzingen kunt ophalen naar ouders, kinderen en broeders en zusters van een opgegeven item. U kunt zelfs de kindknopen van een specifiek knooppunt sorteren.

• Wanneer u klaar bent met de controle, zorg ervoor dat het goed wordt vernietigd. Als het structuurbesturingselement zich in een dialoogvenster bevindt of als het een weergave is, wordt het CTreeCtrl object automatisch vernietigd. Zo niet, dan moet u ervoor zorgen dat zowel het besturingselement als het CTreeCtrl object correct worden vernietigd.

Zie ook

CTreeCtrl gebruiken
Besturingselementen