Verwenden von Struktursteuerelementen
Typische Verwendungen einer Strukturansicht (CTreeCtrl) entspricht dem Muster unten:
Das Steuerelement wird erstellt. Wenn das Steuerelement in einer Dialogfeldvorlage angegeben ist, oder wenn Sie CTreeView verwenden, ist die Erstellung automatisch, wenn das Dialogfeld oder Ansicht erstellt wird. Wenn Sie in der Strukturansicht als untergeordnetes Fenster eines anderen Fensters erstellen möchten, verwenden Sie die Erstellen-Memberfunktion.
Wenn Sie das Struktursteuerelement Bilder verwenden, legen Sie eine Bildliste fest, indem Sie SetImageList aufrufen. Sie können den Einzug ändern, indem Sie SetIndent aufrufen. Eine gute Zeit, hierzu ist in OnInitDialog (für Steuerelemente in Dialogfeldern) oder OnInitialUpdate (für Ansichten).
Fügen Sie Daten in das Steuerelement, indem Sie sie einmal die Funktion CTreeCtrlInsertItem für jedes Datenelement aufrufen. InsertItem gibt ein Handle für das Element, das Sie verwenden können, um es später zu verweisen, wie zurück, wenn es untergeordneten Elemente hinzufügt. Eine gute Zeit, die Daten zu initialisieren ist in OnInitDialog (für Steuerelemente in Dialogfeldern) oder OnInitialUpdate (für Ansichten).
Wenn der Benutzer das Steuerelement verwendet, sendet es verschiedene Benachrichtigungsmeldungen. Sie können eine Funktion angeben, um alle der Meldungen zu bearbeiten, die Sie bearbeiten möchten, indem Sie einen ON_NOTIFY_REFLECT-Makro in der Meldungszuordnung des Steuerfensters hinzufügen oder ein ON_NOTIFY-Makro zur Meldungszuordnung des übergeordneten Fensters hinzufügen. Siehe Strukturansicht-Steuerelement-Benachrichtigungsmeldungen weiter unten in diesem Thema für eine Liste möglicher Benachrichtigungen.
Rufen Sie die verschiedenen Funktionen des festgelegten Members zum Festlegen von Werten für das Steuerelement auf. Ändert, dass Sie die Include ausführen können, das den Einzug festgelegt und der Text, das Bild oder die Daten zugeordnet werden mit einem Element ändert.
Verwenden Sie die verschiedenen Funktionen abrufen, um den Inhalt des Steuerelements sicherzustellen. Sie können den Inhalt des Strukturansicht-Steuerelements mit Funktionen auch durchlaufen, die es ermöglichen, Handles zu übergeordneten Elementen, zu untergeordneten Elementen und den Geschwistern eines bestimmten Elements abzurufen. Sie können die untergeordneten Elemente eines bestimmten Knotens sogar sortieren.
Wenn Sie mit dem Steuerelement verwenden, stellen Sie sicher, dass er ordnungsgemäß gelöscht wird. Wenn dem Tree-Steuerelement in einem Dialogfeld ist, oder wenn es eine Ansicht ist, werden diese und das CTreeCtrl-Objekt automatisch zerstört. Falls nicht, müssen Sie sicherstellen, dass das Steuerelement und das CTreeCtrl-Objekt ordnungsgemäß gelöscht werden.