19.13 Das »TreeView«-Steuerelement 

Wenn Sie den Microsoft Explorer öffnen, werden Sie in dessen Clientbereich drei Steuerelemente wieder finden, mit denen wir uns in diesem und den folgenden Abschnitten beschäftigen wollen. Im linken Teil des Fensters werden in einer hierarchischen Struktur alle verfügbaren Laufwerke aufgeführt, die sich bei einem Klick auf das »+«-Zeichen öffnen und die darin enthaltene Ordnerstruktur preisgeben. Dieses Verhalten wird durch ein TreeView-Steuerelement, das auch als Strukturansicht bezeichnet wird, bereitgestellt. Von einem Ordner werden Dateien verwaltet, die wahlweise in verschiedenen Ansichten im rechten Teil des Explorers ausgegeben werden. .NET bietet uns zu diesem Zweck das Steuerelement ListView an.

Die beiden durch ein TreeView- und ein ListView-Objekt gebildeten Teilfenster haben keine statische Breite, sondern können vom Anwender je nach Bedarf unter Beibehaltung der Breite des Fensters mit der Maus vergrößert oder verkleinert werden. Für diese Änderung ist das Steuerelement Splitter zuständig.

19.13.1 Knotenpunkte im »TreeView« definieren 

Zunächst widmen wir uns dem TreeView-Control, das sich nicht nur zur Anzeige der Laufwerke und deren untergeordneten Verzeichnissen eignet, sondern auch zur Darstellung beliebiger hierarchischer Strukturen wie beispielsweise die einer Datenbank.

Betrachten Sie zunächst die folgende Abbildung, in der in einem TreeView-Steuerelement die fünf Erdteile unterhalb des Stammknotens Erde ausgegeben werden.

Hier klicken, um das Bild zu vergrößern

Abbildung 19.17   Einfache Anzeige in einem »TreeView«-Steuerelement

In einem TreeView-Objekt, das auch als Strukturansicht bezeichnet wird, spielt noch eine weitere Klasse eine ganz maßgebliche Rolle: TreeNode. Ein Objekt vom Typ TreeNode entspricht einem Knoten in der Strukturansicht – unabhängig von der Position innerhalb der hierarchischen Struktur. In Abbildung 19.17 haben wir es demnach mit sechs TreeNode-Objekten zu tun: Erde, Amerika, Asien, Afrika, Australien und Europa.

Das TreeView und jeder darin angezeigte Knoten kann selbst wieder Ausgangspunkt einer Reihe weiterer untergeordneter Knoten sein. Jeder einzelne Knoten verwaltet die ihm untergeordneten Knoten in einer eigenen Auflistung vom Typ TreeNodeCollection. Das Strukturansicht-Steuerelement in der Abbildung 19.17 enthält in seiner eigenen Auflistung nur ein TreeNode-Objekt, nämlich Erde. Dieser Knoten wird von der TreeNodeCollection des Controls verwaltet, während die Elemente Amerika, Asien usw. in der TreeNodeCollection des Knotens Erde enthalten sind.

Der Referenz auf die Auflistung liefert die Eigenschaft Nodes:

So wie alle anderen Auflistungen enthält auch dieser Typ Methoden, um auf die verwalteten TreeNode-Objekte zuzugreifen, neue hinzuzufügen oder verwaltete zu löschen.

Jetzt kennen Sie die wichtigsten Grundlagen, und wir können uns den Programmcode ansehen, der zu der Ausgabe in Abbildung 19.17 führt.

Nach der Instanziierung mit

sowie der Positionierung und Größenfestlegung wird das Stammelement Erde hinzugefügt, indem zu der TreeNodeCollection der Strukturansicht ein TreeNode-Objekt hinzugefügt wird:

Erde ist das erste Element in der Auflistung und hat den Index 0. Es wird auch als Stammelement bezeichnet. Sie können anstelle einer Zeichenfolge auch die Referenz auf ein TreeNode-Objekt übergeben.

Weil auch das TreeNodeCollection-Objekt, wie die meisten anderen Auflistungen, einen Indexer bereitstellt, kann man sich unter der Angabe des Index die Referenz auf ein Element besorgen und über dessen Eigenschaft Nodes wiederum die Referenz auf dessen TreeNodeCollection. Darauf lässt sich erneut die Add-Methode aufrufen, z.B.:

Alle Elemente unterhalb der Stammelemente werden als untergeordnete Elemente bezeichnet. Ein solches ist demnach auch Amerika. In gleicher Weise lassen sich auch die anderen Erdteile der Auflistung hinzufügen.

Alternativ bietet sich auch die AddRange-Methode an, die ein Array vom Typ TreeNode entgegennimmt.

Ausnahmslos jedes in einer Strukturansicht angezeigte Element wird als TreeNode-Objekt betrachtet, das über eine eigene Auflistung ihm untergeordneter TreeNode-Objekte verfügt, die nur dann leer ist, wenn das Element das letzte in der Hierarchie ist. Mit dieser Erkenntnis können wir unser Beispiel auch beliebig tiefer strukturieren und jedem Erdteil Staaten zuordnen, die dann selbst wieder in ihrer eigenen Auflistung Städte enthalten.

Das erste Beispiel zum TreeView-Steuerelement wird jetzt in diesem Sinn ergänzt: Es werden ein paar Staaten Amerikas und Europas ergänzt, zusätzlich Städte in Deutschland und den USA.

Falls alle Knoten geöffnet werden, wird das Programm zu einer Anzeige wie in Abbildung 19.18 gezeigt führen. Beachten Sie, dass das TreeView-Objekt standardmäßig eine Bildlaufleiste einblendet, sobald die Länge der Liste die Höhe des Steuerelements überschreitet.

Deutlich ist am Programmcode zu erkennen, dass, je tiefer die Hierarchiestruktur geht, der Code immer unübersichtlicher wird. Zur besseren Lesbarkeit wird deshalb eine interne TreeNode-Referenz benutzt, die einen Knoten im Innern der Hierarchie referenziert.

Hier klicken, um das Bild zu vergrößern

Abbildung 19.18   Tiefer strukturiertes »TreeView«-Steuerelement

Die Referenz europa verweist hier auf den fünften Knoten des Stammelements, also erde. Damit reduziert sich der Code, um einen europäischen Staat hinzuzufügen, auf:

Ansonsten hätte die Anweisung

lauten müssen.

Beispielprogramm mit »TreeView«

Wir wollen das Erlernte auch sofort in einem kleinen Beispiel umsetzen. Aufgabe soll sein, in einem TreeView-Control sämtliche Steuerelemente der aktuellen Form anzuzeigen. Dabei soll die interne Struktur aller Containersteuerelemente ersichtlich sein. In der Strukturansicht soll jeder Elementeintrag durch ein steuerelementspezifisches Bildchen ergänzt werden, und der Beschriftungstext soll Objektname und Typ enthalten. In Abbildung 19.19 sehen Sie die Ausgabe des Beispielprogramms.

Hier klicken, um das Bild zu vergrößern

Abbildung 19.19   Die Ausgabe des Beispiels »ShowControlsOnForm«

btnShowControls ist hier der Ereignishandler der Schaltfläche mit der Beschriftung Anzeigen. Hier wird zuerst der Stammknoten erzeugt, der die Form beschreibt. Die Form ist bekanntermaßen ein Container für Steuerelemente. Aus der ControlCollection, deren Referenz uns die Eigenschaft Controls der Form liefert, ermitteln wir die Anzahl der verwalteten Steuerelemente und erzeugen ein passend großes TreeNode-Array.

Solange in der Form keine weiteren Containersteuerelemente enthalten sind, ist die Sache sehr einfach, denn dann werden automatisch alle Controls erfasst. Sollte allerdings, wie auch in unserem Beispiel., sich darunter mindestens ein Control befinden, das in einer eigenen ControlCollection die ihm zugeordneten Steuerelemente verwaltet, müssen wir auch diese Steuerelementauflistungen durchlaufen. Dazu dient die Methode GetControls, die sogar rekursiv aufgerufen werden muss, um auch eine etwaige tiefere Strukturierung zu erfassen.

SetImage hat die Aufgabe, den Typ des gefundenen Steuerelements zu ermitteln und aus der ImageList das passende Symbol festzulegen. Wir müssen wohl darauf achten, dass keine Symbolumschaltung erfolgt, wenn sich der Zustand eines Strukturelementes ändert. Daher wird in SetImage mit

der Index des ausgewählten Zustands gleich dem des nicht ausgewählten gesetzt.

19.13.2 Eigenschaften des »TreeView«-Steuerelements 

In der »normalen« Ansicht werden geschlossene Knotenpunkte durch ein »+«-Symbol gekennzeichnet, geöffnete durch »-«. Der aktuelle markierte Knoten wird farblich invertiert dargestellt. Von vielen Installationsroutinen her wissen Sie, dass Strukturansichten mit Auswahlfeldern bestückt sind, aus denen der Anwender auswählen kann. Diese können Sie auch anbieten, indem Sie die Eigenschaft CheckBoxes=true festlegen. Die Einzugsbreite der untergeordneten Knoten ist per Vorgabe 19 Pixel. Verkleinern oder vergrößern können Sie diese Angabe mit der Eigenschaft Indent.

Beabsichtigen Sie, die Darstellung optisch auch ein wenig netter zu gestalten, sollten Sie für die Knoten Bildchen in Betracht ziehen. Die Gesamtverwaltung aller Knotensymbole obliegt dem TreeView, nicht den einzelnen Knoten selbst. Verwaltet werden die Symbole von einem ImageList-Objekt, die Sie vorher der Form hinzufügen müssen und der gleichnamigen Eigenschaft des TreeView im Eigenschaftsfenster angeben. Da eine ImageList nicht sehr intuitiv ist, sollten Sie bei der Zusammenstellung der Symbole sofort berücksichtigen, dass ausgewählte und nicht ausgewählte Elemente in der Strukturansicht üblicherweise mit unterschiedlichen Bildchen gekennzeichnet werden, die alle in dieser ImageList enthalten sein müssen. Besser wäre es sicherlich gewesen, wenn uns Microsoft für jeden Zustand je eine Bildauflistung spendiert hätte.

Im TreeView können Sie auch einstellen, welches Bildchen standardmäßig für bei einem ausgewählten bzw. nicht ausgewählten Knoten angezeigt werden soll. Dazu dienen die Eigenschaften ImageIndex/IndexKey (nicht ausgewählt) und SelectedImageIndex/SelectedImageKey (ausgewählt). Die Einstellungen kommen nur in dem Fall zum Tragen, wenn einem Knoten kein spezielles Symbol zugeordnet wird.

Unter StateImageList dürfen Sie auch eine zweite ImageList angeben. Hier tragen Sie nur zwei Bildchen ein, die in den Auswahlkästchen für den Zustand »ausgewählt« und »nicht ausgewählt« stehen. Das erste Symbol kennzeichnet hier den nicht ausgewählten Zustand, das zweite den ausgewählten. Sie dürfen dieser ImageList natürlich auch noch mehr Symbole hinzufügen, um für jeden Knoten ein ganz individuelles Bildchen im Kontrollkästchen zuzuordnen. Trotzdem würde ich davon abraten, weil zu viele Symbole beim Benutzer nur zu Irritationen führen.

Das aktuell markierte Element in der Strukturansicht wird farblich in einer Breite hervorgehoben, die der Breite der Beschriftung entspricht. Sie können die farbliche Hervorhebung aber auch über die gesamte Breite der Strukturansicht spannen. Dazu dient die Eigenschaft FullRowSelect=true. Allerdings wirkt sich diese Einstellung nur dann aus, wenn ShowLines=false ist. Mit ShowLines werden die Linien zwischen den neben- und untergeordneten Elementen dargestellt, mit LineColor wird deren Farbe festgelegt.

Wenn Sorted auf true festgelegt ist, werden die TreeNode-Objekte in alphabetischer Reihenfolge nach den Werten ihrer Text-Eigenschaft sortiert. Hier muss allerdings auch darauf hingewiesen werden, dass bei einer großen Anzahl von Elementen immer die Methoden BeginUpdate und EndUpdate aufgerufen werden sollten, um Leistungseinbußen zu verhindern. Haben Sie zudem LabelEdit=true eingestellt, kann der Benutzer zur Laufzeit den Beschriftungstext ändern. Sie müssen dann die Methode Sort aufrufen, um die Elemente neu zu sortieren.

Nicht üblich ist es, in einer Strukturansicht auf die Plus-/Minusschaltflächen zu verzichten. Dennoch, wenn Sie das anstreben, können Sie diesen Effekt mit ShowPlusMinus=false erreichen. ShowRootLines steuert letztendlich die Anzeige von Linien zwischen den Stammknoten.

Damit sind noch nicht alle Möglichkeiten des TreeView erschöpft.

Wenn die HotTracking-Eigenschaft auf true festgelegt ist, wird jede Strukturknotenbezeichnung als Hyperlink dargestellt, während der Mauszeiger darüber bewegt wird. Dabei wird die Schrift unterstrichen und in Blau festgelegt. Die Darstellung wird nicht durch die Interneteinstellungen im Betriebssystem des Benutzers gesteuert, Sie können sie also nicht beeinflussen.

Manchmal muss der markierte Knoten abgerufen oder ein bestimmter Knoten ausgewählt werden. Hier hilft die Eigenschaft SelectedNode weiter, welche die Referenz des TreeNode-Objekts zurückliefert oder entgegennimmt:

Der Eigenschaft PathSeparator eines TreeView-Objekts kommt im Zusammenhang mit der Eigenschaft FullPath eines TreeNode-Objekts besondere Bedeutung zu. FullPath liefert für jeden Knoten eine Zeichenfolge zurück, in welcher der Bezeichner des Knotens mit allen seinen zum Ursprung zurückführenden Knoten verbunden wird. PathSeparator legt das Trennzeichen fest, das standardmäßig ein Backslash ist.

Damit haben Sie jetzt eine Menge Eigenschaften kennen gelernt, um die Darstellung des TreeView und der darin angezeigten Knoten zu beeinflussen. Das TreeView wartet mit noch einigen weiteren spezifischen Eigenschaften auf, denen wir uns aber erst weiter unten widmen. Fassen wir die bisherigen zunächst einmal in einer Tabelle zusammen.

19.13.3 Die Unterstützung der Entwicklungsumgebung 

Weiter oben habe ich Ihnen gezeigt, wie Sie mit Programmcode die Knotenstruktur eines Steuerelements festlegen können. Baut sich die Struktur erst zur Laufzeit aufgrund bestimmter Bedingungen dynamisch auf, werden Sie um die Hardcodierung nicht herumkommen. Sollten Sie aber zur Entwicklungszeit bereits zumindest einen Teil der Knoten kennen, können Sie auf die Tools der Entwicklungsumgebung zurückgreifen, um schneller ans Ziel zu kommen.

Nachdem Sie aus der Toolbox ein TreeView-Steuerelement in die Form gezogen haben, öffnen Sie dessen Eigenschaftsfenster und markieren die Eigenschaft Nodes. Über die Schaltfläche in der Wertespalte gelangt man zu dem in der Abbildung 19.20 gezeigten Assistenten.

Hier klicken, um das Bild zu vergrößern

Abbildung 19.20   Der Assistent zum Hinzufügen von »TreeNode«-Objekten

Über die Schaltfläche Stamm hinzufügen erstellt man grundsätzlich immer einen Knoten, welcher der Auflistung TreeNodeCollection des TreeView-Steuerelements zugeordnet wird. Markiert man ein beliebiges Element im Anzeigebereich und klickt auf die Schaltfläche Unterordner hinzufügen, wird zu dem ausgewählten Knoten ein neuer, untergeordneter Knoten erzeugt.

Entscheidend für den Benutzer ist die Beschriftung der Knoten. Legen Sie diese in der Eigenschaft Text fest. Sie sollten auch nicht vergessen, den TreeNode-Objekten passende Namen zu geben. Eine gute Idee der Microsoft-Entwickler war, dass Sie den Schriftstil der Beschriftung jedes einzelnen Knotens mit NodeFont beeinflussen können. Das hilft optisch bei der Orientierung in komplexen Strukturen.

Wird über die Eigenschaft ImageList des TreeView-Objekts eine Bildliste referenziert, kann vor jedem Knoten ein Symbol angegeben werden, das immer dann angezeigt wird, wenn das Element nicht ausgewählt ist. Das Bild für den ausgewählten Zustand wird unter SelectedImageIndex oder SelectedIndexKey eingestellt. Haben die beiden Eigenschaften keine individuellen Einträge, werden die Standardeinstellungen der übergeordneten TreeView übernommen. Analog stellen Sie das Bildchen für den nicht ausgewählten Zustand unter ImageIndex oder ImageKey ein.

Zum Schluss bliebe noch zu erwähnen, dass der Zustand der optionalen Kontrollkästchen mit Checked festgelegt wird.

19.13.4 Die Ereignisse des »TreeView«-Steuerelements 

Die wichtigsten objektspezifischen Ereignisse hängen mit dem Aufklappen und Schließen eines Knotenpunkts zusammen. Für jede der genannten Benutzeraktionen löst das TreeView-Steuerelement jeweils zwei Ereignisse aus: eins, das auftritt, bevor die damit verbundene, sichtbare Reaktion des Knotens erfolgt (BeforeExpand bzw. BeforeCollapse), und eins zum Abschluss des Vorgangs (AfterExpand bzw. AfterCollapse).

In diesem Zusammenhang spielen auch noch drei weitere Ereignisse eine Rolle. Wird der angeklickte Knoten beim Öffnen oder Schließen gleichzeitig ausgewählt, haben wir es mit dem Ereignispaar BeforeSelect und AfterSelect zu tun. Jedoch unabhängig davon, ob ein Knotenelement beim Anklicken ausgewählt ist oder nicht, wird in jedem Fall NodeMouseClick ausgelöst.

BeforeExpand, BeforeSelect und BeforeCollapse übergeben dem Ereignishandler ein Objekt vom Typ TreeViewCancelEventArgs, die Ereignisse AfterExpand, AfterSelect und AfterCollapse ein Objekt vom Typ TreeViewEventArgs. Das zuerst aufgeführte Args-Objekt, dessen spezifische Eigenschaften wir uns nun in einer Tabelle ansehen wollen, unterscheidet sich nur dadurch, dass der eingeleitete Vorgang mit Cancel abgebrochen werden kann.

Die Action-Eigenschaft sollten wir uns noch einmal genauer ansehen. Sie ist vom Typ der Enumeration TreeViewAction und liefert uns einen Wert, aus dem die Ursache der Ereignisauslösung entnommen werden kann.

19.13.5 Weitere Eigenschaften und Methoden des »TreeView«-Objekts 

Die Ansicht des TreeView-Objekts wird jedes Mal aktualisiert, sobald ein Element hinzugefügt wird. Das kann zu Leistungseinbußen und zum Flackern der Anzeige führen, wenn beispielsweise in einer Schleife viele Strukturknoten hinzugefügt werden. Um das zu vermeiden, sollte man vor Beginn der Einfügeoperationen die Methode BeginUpdate aufrufen. Damit wird das Zeichnen des Steuerelements so lange unterbunden, bis die EndUpdate-Methode aufgerufen wird. Die gesamte Hierarchiestruktur des TreeView kann mit den Methoden ExpandAll und CollapseAll auch per Programmcode entweder erweitert oder reduziert werden.

Die Klasse TreeNode veröffentlicht ihrerseits Methoden, mit denen die untergeordnete Struktur eines bestimmten Knotens erweitert oder reduziert wird – ungeachtet der Tatsache, dass ein Klick des Benutzers auf das standardmäßige »+«- oder »-«-Zeichen dieselbe Reaktion des Knotens bewirkt.

In der folgenden Tabelle werden die in diesem Abschnitt aufgeführten Methoden noch einmal zusammengefasst.

19.13.6 Eigenschaften und Methoden des »TreeNode«-Objekts 

Bei einigen Operationen muss ein bestimmter Knoten zuerst identifiziert werden. Drei Eigenschaften unterstützen dies.

Viele Eigenschaften dienen der Navigation durch die Hierarchie. Mit Parent kann zum Beispiel der übergeordnete Knoten bestimmt werden, mit FirstNode, LastNode, PrevNode und NextNode kann zu den nebengeordneten Knoten auf gleicher Hierarchieebene bzw. zu den untergeordneten Knoten navigiert werden. Alle geben die Referenz auf das angesteuerte TreeNode-Objekt zurück.

Die TreeNode-Klasse veröffentlicht mit IsExpanded und IsSelected zwei Eigenschaften, mit denen im Programmcode festgestellt werden kann, ob ein Knoten aktuell reduziert, erweitert oder markiert ist.

Das Strukturansicht-Steuerelement unterstützt die Methoden ExpandAll und CollapseAll, um alle Knotenelemente zu erweitern oder zu reduzieren. Ein TreeNode-Objekt verfügt über ähnliche Methoden, allerdings beziehen sich diese immer auf den aktuellen Knoten.

Mit der Methode Toggle wechselt der Knoten in den entgegengesetzten Zustand, also entweder von erweitert nach reduziert oder von reduziert nach erweitert.

In der folgenden Tabelle 19.20 werden die Eigenschaften und Methoden eines Strukturknotens noch einmal zusammengefasst.

19.13.7 Beispiel zum Einlesen der Verzeichnisstruktur 

Wir wollen nun ein Beispiel entwickeln, das als Ergebnis die lokale Verzeichnisstruktur anzeigt. Nach dem Start sollen im TreeView-Steuerelement alle Laufwerke angezeigt werden. Dazu ist die Auflistung TreeNodeCollection des Steuerelements mit allen Laufwerksangaben zu füllen. Die erforderlichen Angaben liefert uns die statische Methode GetLogicalDrives der Klasse Directory als Zeichenfolge-Array.

Mit dieser Erkenntnis wäre ein Teil der Aufgabe schon gelöst, aber wir wollen schließlich im Strukturansicht-Steuerelement nicht nur die Laufwerksangaben sehen, sondern auch durch alle Unterverzeichnisse navigieren. Eine erste Idee könnte jetzt sein, sofort die Verzeichnisstruktur jedes Laufwerks der lokalen Maschine vollständig einzulesen. Denken Sie aber daran, wie lange die Suche nach einem bestimmten Ordner oder einer bestimmten Datei dauert. Wenn Sie Glück haben, wird das gesuchte Objekt schnell gefunden, mit etwas Pech warten Sie aber auch eine Zeitspanne, die sich im Bereich von Minuten bewegen kann. Ein ähnliches Problem hätten wir auch zu erwarten, wenn wir direkt nach dem Start die gesamte Verzeichnisstruktur in das TreeView-Objekt einlesen würden.

Das vollständige Einlesen der Verzeichnisstruktur ist also keine gute Lösung. Auf jedwedes Einlesen von Unterverzeichnissen zu verzichten, würde uns zwar die Laufwerke liefern, aber wir könnten nicht erkennen, ob diese ein untergeordnetes Verzeichnis haben, denn dann würde im reduzierten Zustand kein »+«-Zeichen auf die untergeordnete Ebene aufmerksam machen.

Wir benötigen eine Zwischenlösung, die einerseits die Informationen bereitstellt, dass ein Knoten weitere untergeordnete Knoten enthält, aber andererseits auch nicht unnötig viele Informationen einliest, die das Laufzeitverhalten negativ beeinflussen. Mit anderen Worten lesen wir optimalerweise gerade so viel von der Verzeichnisstruktur ein, dass zu jedem angezeigten Knoten gerade die ihm direkt untergeordnete Knotenebene bekannt ist.

Nach dem Anwendungsstart werden nur die Laufwerke angezeigt, nehmen wir an A:\ und C:\. Das »+«-Zeichen erscheint nur dann, wenn für diesen Knoten alle direkt untergeordneten Ordner bekannt sind, z.B. Dokumente und Einstellungen, Programme, WINNT usw. Diese Informationen müssen wir uns besorgen. Ein weitergehender Informationsstand ist in diesem Moment nicht erforderlich und würde nur zu Leistungseinbußen führen.

Expandiert der Benutzer einen Knoten durch Klicken auf das »+«-Zeichen, sind die Informationen der nachfolgend anzuzeigenden Hierarchieebene bereits eingelesen. Bevor die Strukturansicht aktualisiert wird, muss die der neu anzuzeigenden Ebene untergeordnete Hierarchieebene von der Festplatte gelesen und müssen die Informationen den entsprechenden Knoten zugeordnet werden, damit das informelle »+«-Zeichen, falls notwendig, erscheint. Auf diese Weise werden immer nur Teile der gesamten Verzeichnisstruktur eingelesen, was der Anwender im Normalfall nicht bemerkt. Dennoch wird er mit allen erforderlichen Informationen versorgt.

Hier klicken, um das Bild zu vergrößern

Abbildung 19.21   Das Ausgabefenster des Beispiels »Verzeichnisstruktur«

Sehen wir uns nun den Code zur Lösung der Aufgabenstellung an.

Die Methode AllSubDirectories bildet das Kernelement des Beispielprogramms und hat die Aufgabe, die übergebene TreeNode-Referenz auf untergeordnete Elemente hin zu untersuchen. Dazu wird uns die Methode GetDirectories, die auf ein DirectoryInfo-Objekt aufgerufen wird, alle notwendigen Informationen liefern. Beim Start der Anwendung müssen wir uns nur noch alle aktuell verfügbaren Laufwerke besorgen. Das passiert direkt im Anschluss an InitializeComponent im Konstruktor mit:

Wenn alle Laufwerke zur Verfügung stehen, sollen »+«-Zeichen auf die erste Ordnerebene hinweisen. Dabei ist allerdings eine Hürde zu meistern. Das für Diskettenlaufwerke reservierte Laufwerk »A:\« sowie auch verschiedene weitere Laufwerke (zum Beispiel das für CDs) könnten bei der Suche kein Medium enthalten. Es wird dann von GetDirectories eine IOException ausgelöst, die behandelt werden muss. Handelt es sich um das Diskettenlaufwerk, wird vor der Ausnahme vom System außerdem auch noch ein Meldungsfenster angezeigt, das mit Abbrechen oder Weiter geschlossen werden kann. Dieses Meldungsfenster sollten wir beim Start der Anwendung unbedingt vermeiden, da es zu Irritationen führt.

Nachdem wir alle logischen Laufwerke im Konstruktor eingelesen haben, werden deren Ordner eingelesen. Nur das Diskettenlaufwerk ist davon ausgeschlossen. Allerdings weisen wir diesem Laufwerk ein anderes Symbol für den ausgewählten und nicht ausgewählten Zustand zu.

In AllSubDirectories ist uns die Eigenschaft FullPath des TreeNode-Objekts behilflich, den kompletten Pfad vom Stammknoten bis zum aktuellen Strukturknoten zu beschreiben. Mit

besorgen wir uns auf Basis der Pfadangabe ein Verzeichnisobjekt vom Typ Directory. Dieses liefert unter Aufruf der Methode GetDirectories alle Unterverzeichnisse als String-Array:

Wir müssen diese Anweisung allerdings durch eine Ausnahmebehandlung absichern, denn wenn beispielsweise im Diskettenlaufwerk keine Diskette eingelegt ist, wird eine Exception ausgelöst, die behandelt werden muss.

Mit

wird schließlich jedes Verzeichnis des Arrays arrDirInfo durchlaufen und der TreeNodeCollection des Knotens, also des Verzeichnisses, hinzugefügt, der als Parameter dem Methodenaufruf übergeben worden ist.

Damit ist die Methode AddSubDirectories fertig. Sie ist dabei so universell, dass sie nicht nur aus dem Konstruktor der Form heraus aufgerufen wird, sondern jedes Mal, bevor der Anwender einen Verzeichniseintrag öffnet, also im Ereignis BeforeExpand.

Zum Schluss müssen wir noch sicherstellen, dass bei einem Klick auf das Symbol eines logischen Laufwerks auch dann die Methode AllSubDirectories ausgeführt wird, wenn kein Zeichen zum Expandieren des Strukturknotens vorhanden ist. Das ist der Fall, wenn beim Start der Anwendung kein Medium eingelegt ist. Der Ereignishandler von BeforeExpand wird dann nicht ausgelöst, weil es nichts zu expandieren gibt. Aus diesem Grund wird das Ereignis AfterSelect behandelt, das auftritt, wenn ein Strukturknoten angeklickt wird. Um nicht bei jedem expansionsfähigen Knoten die Routine unnötigerweise doppelt auszuführen, wird im Ereignishandler der ereignisauslösende Knoten daraufhin untersucht, ob seine Auflistung leer ist. Nur wenn die Auflistung leer ist, wird AllSubDirectories ausgeführt.