Verwenden von Struktursteuerelementen
Die typische Verwendung eines Struktursteuerelements (CTreeCtrl) folgt dem folgenden Muster:
Das Steuerelement wird erstellt. Wenn das Steuerelement in einer Dialogfeldvorlage angegeben wird oder Sie verwenden
CTreeView, wird die Erstellung automatisch ausgeführt, wenn das Dialogfeld oder die Ansicht erstellt wird. Wenn Sie das Struktursteuerelement als untergeordnetes Fenster eines anderen Fensters erstellen möchten, verwenden Sie die Funktion "Member erstellen ".Wenn Ihr Struktursteuerelement Bilder verwenden soll, legen Sie eine Bildliste durch Aufrufen von SetImageList fest. Sie können den Einzug auch ändern, indem Sie SetIndent aufrufen. Ein guter Zeitpunkt hierfür ist onInitDialog (für Steuerelemente in Dialogfeldern) oder OnInitialUpdate (für Ansichten).
Fügen Sie Daten in das Steuerelement ein, indem Sie die
CTreeCtrlInsertItem-Funktion einmal für jedes Datenelement aufrufen.InsertItemgibt ein Handle an das Element zurück, mit dem Sie später darauf verweisen können, z. B. beim Hinzufügen untergeordneter Elemente. Ein guter Zeitpunkt für die Initialisierung der Daten istOnInitDialog(für Steuerelemente in Dialogfeldern) oderOnInitialUpdate(für Ansichten).Wenn der Benutzer mit dem Steuerelement interagiert, sendet er verschiedene Benachrichtigungen. Sie können eine Funktion angeben, mit der jede der Nachrichten behandelt werden soll, die Sie behandeln möchten, indem Sie ein ON_NOTIFY_REFLECT Makro in der Nachrichtenzuordnung Ihres Steuerelementfensters hinzufügen oder der Nachrichtenzuordnung des übergeordneten Fensters ein ON_NOTIFY Makro hinzufügen. Eine Liste möglicher Benachrichtigungen finden Sie weiter unten in diesem Thema unter Struktursteuerungsbenachrichtigungen .
Rufen Sie die verschiedenen Set-Memberfunktionen auf, um Werte für das Steuerelement festzulegen. Änderungen, die Sie vornehmen können, umfassen das Festlegen des Einzugs und ändern den Text, das Bild oder die Daten, die einem Element zugeordnet sind.
Verwenden Sie die verschiedenen Get-Funktionen, um den Inhalt des Steuerelements zu untersuchen. Sie können auch den Inhalt des Struktursteuerelements mit Funktionen durchlaufen, mit denen Sie Handles für Eltern, untergeordnete Elemente und gleichgeordnete Elemente eines angegebenen Elements abrufen können. Sie können sogar die untergeordneten Elemente eines bestimmten Knotens sortieren.
Wenn Sie mit dem Steuerelement fertig sind, stellen Sie sicher, dass es ordnungsgemäß zerstört ist. Wenn sich das Struktursteuerelement in einem Dialogfeld befindet oder es sich um eine Ansicht handelt, wird es
CTreeCtrlautomatisch zerstört. Andernfalls müssen Sie sicherstellen, dass sowohl das Steuerelement als auch dasCTreeCtrlObjekt ordnungsgemäß zerstört werden.