Benutzer-Werkzeuge

Webseiten-Werkzeuge


k6:k6.9:k6.9.3:start

6.9.3 DirChooser

Das Steuerelement DirChooser (gb.form) erlaubt dem Benutzer die Auswahl eines Verzeichnisses. Es besteht zusätzlich die Möglichkeit, auch den Inhalt eines ausgewählten Verzeichnisses anzuzeigen.

Das Steuerelement kann erzeugt werden:

Dim hDirChooser As DirChooser

hDirChooser = New DirChooser ( Parent As Container )  As "EventName"

Intern werden die Steuerelemente DirView und FileView (optional) verwendet.

6.9.3.1 Eigenschaften

Die Klasse DirChooser verfügt über diese ausgewählten Eigenschaften:

EigenschaftDatentypBeschreibung
DirView DirViewGibt das DirView-Steuerelement zurück, das intern vom DirChooser verwendet wird.
FileView FileViewGibt das FileView-Steuerelement zurück, das intern vom DirChooser verwendet wird.
Icon PictureGibt das Symbol für die Anzeige einer Datei oder eines Verzeichnisses zurück oder setzt es. Verwenden Sie diese Eigenschaft, um auf das Icon-Ereignis zu reagieren.
PicturePictureGibt das für das Root-Verzeichnis verwendete Bild zurück oder setzt es.
SelectedPath StringGibt den ausgewählten Verzeichns-Pfad zurück.
ValueStringSynonym für die SelectedPath-Eigenschaft.
ShowBookmarkBooleanGibt den Wahrheitswert zurück oder setzt den Wahrheitswert, ob das Lesezeichenfeld sichtbar ist oder nicht.
ShowDetailedBooleanGibt den Wahrheitswert zurück oder setzt den Wahrheitswert, ob die Dateien mit einer Detailansicht oder mit Symbolen angezeigt werden oder nicht.
ShowFileBooleanGibt den Wahrheitswert zurück oder setzt den Wahrheitswert, ob das Panel, das den Inhalt des Verzeichnisses anzeigt, ein- oder ausgeblendet wird.
ShowHiddenBooleanGibt den Wahrheitswert zurück oder setzt den Wahrheitswert, ob die versteckten Dateien oder Verzeichnisse angezeigt oder versteckt werden.
ShowPreviewBooleanGibt den Wahrheitswert zurück oder setzt den Wahrheitswert, ob die Miniaturbilder angezeigt werden oder nicht.
ShowSplitterBooleanGibt den Wahrheitswert zurück oder setzt den Wahrheitswert, ob der Splitter-Button sichtbar ist.

Tabelle 6.9.3.1.1 : Eigenschaften der Klasse DirChooser

Hinweise:

  • Projektweiten Zugriff auf das ausgewählte Verzeichnis bekommen Sie über den Wert der Eigenschaft DirChooser.SelectedPath, den Sie zum Beispiel auch in einer (Public-)Variable sDirPath speichern.
  • Es macht bei der Auswahl eines Verzeichnisses durchaus Sinn, wenn Sie den Inhalt des ausgewählten Verzeichnisses erkennen. Setzen Sie zum Beispiel zuerst im Quelltext die Eigenschaften ShowFile und dann zusätzlich ShowHidden, ShowPreview oder ShowDetailed auf True.
  • Alternativ können Sie auch die Eigenschaft DirChooser.ShowSplitter auf True setzen. Auch dann haben Sie die Möglichkeit, weitere Anzeige-Optionen über das Kontext-Menü festzulegen.
  • Beachten Sie, dass Sie für die Laufzeit des Programms im Kontext-Menü Lesezeichen definieren können, wenn Sie die Eigenschaft DirChooser.ShowBookmark auf True gesetzt haben.
  • Eine ausführliche Beschreibung der Verwendung von Lesezeichen finden Sie in dem Kapitel, welches das Steuerelement FileChooser beschreibt.

6.9.3.2 Methoden

Die Klasse DirChooser verfügt mit Reload( ) nur über eine relevante Methode. Sie lädt den Inhalt der Ansicht neu – so, als hätten Sie auf die Schaltfläche „Aktualisieren“ im Kontext-Menü geklickt.

6.9.3.3 Ereignisse

Die Klasse DirChooser besitzt u.a. diese ausgewählten Ereignisse:

EreignisBeschreibung
Activate( )Das Ereignis wird ausgelöst, wenn ein Benutzer doppelt auf ein Verzeichnis klickt.
Change( )Dieses Ereignis wird ausgelöst, wenn sich das aktuelle Verzeichnis ändert.
Icon( Path As String )Dieses Ereignis wird ausgelöst, wenn auf die Änderung des Symbols für eine bestimmte Datei oder ein bestimmtes Verzeichnis des Steuerelementes reagiert werden soll. Der Parameter „Path“ ist der Dateipfad zum Icon.

Tabelle 6.9.3.3.1 : Ausgewählte Ereignisse der Klasse DirChooser

Hinweise:

Neue Verzeichnisse können Sie über das Kontext-Menü anlegen oder die Erzeugung über folgenden Quelltext auslösen:

Public Sub btnCreateNewFolder_Click()
  DirChooser1.DirView.NewFolder()
End

Den Namen eines bestehenden Verzeichnisses ändern Sie über das Kontext-Menü oder über folgenden Quelltext, der die Änderung anschiebt:

Public Sub btnRenameFolder_Click()
  DirChooser1.DirView.Rename()
End

Die folgenden Hinweise zum Layout des Programm-Fensters und zur Basis-Konfiguration des Steuerelementes DirChoosers haben sich für die den praktischen Einsatz als günstig erwiesen:

Public Sub Form_Open()
 
  FMain.Resizable = True
  FMain.Utility = True ' Minimum window size as defined in the IDE
 
  DirChooser1.Root = User.Home ' Default-Folder
  DirChooser1.ShowSplitter = True
  DirChooser1.ShowBookmark = True
  ...
 
End

B1

Abbildung 6.9.3.3.1: DirChooser mit Basis-Konfiguration

Wenn Sie den Splitter einschalten, dann sehen Sie auch den Inhalt des ausgewählten Verzeichnisses in der internen FileView. Außerdem füllt sich die ToolBar mit weiteren Button und Steuerelementen wie einem Slider zur Änderung der Anzeigegröße der Vorschau-Bilder.

B2

Abbildung 6.9.3.3.2: DirChooser mit erweiterter Konfiguration

Auch über das verfügbare Kontext-Menü der internen FileView können Sie weitere Einstellungen oder Aktionen vornehmen. Ein verschachteltes Kontext-Menü unterstützt Sie bei der Arbeit mit dem Steuerelement DirChooser:

B3

Abbildung 6.9.3.3.3: Kontext-Menü

Download

Die Website verwendet zwei temporäre Session-Cookies. Diese technisch notwendigen Cookies werden gelöscht, wenn der Web-Browser geschlossen wird! Informationen zu Cookies erhalten Sie in der Datenschutzerklärung.
k6/k6.9/k6.9.3/start.txt · Zuletzt geändert: 24.09.2018 (Externe Bearbeitung)

Seiten-Werkzeuge