dev_open_file_dialogdev_open_file_dialogDevOpenFileDialogDevOpenFileDialogdev_open_file_dialog (Operator)
Name
dev_open_file_dialogdev_open_file_dialogDevOpenFileDialogDevOpenFileDialogdev_open_file_dialog — Öffnet den Dateiauswahldialog.
Signatur
def dev_open_file_dialog(filter: str, mode: str, path: str) -> Sequence[str]
def dev_open_file_dialog_s(filter: str, mode: str, path: str) -> str
Beschreibung
dev_open_file_dialogdev_open_file_dialogDevOpenFileDialogDevOpenFileDialogDevOpenFileDialogdev_open_file_dialog öffnet den Dateiauswahldialog zum
Lesen von einer Datei (ModeModeModeModemodemode = 'read'"read""read""read""read""read"), zum Lesen von
einer oder mehrerer Dateien (ModeModeModeModemodemode = 'read_multi'"read_multi""read_multi""read_multi""read_multi""read_multi"),
zum Schreiben (ModeModeModeModemodemode = 'write'"write""write""write""write""write") einer Datei oder zur
Auswahl eines Verzeichnisses (ModeModeModeModemodemode = 'dir'"dir""dir""dir""dir""dir").
Wird ModeModeModeModemodemode auf 'default'"default""default""default""default""default" gesetzt und für den FilterFilterFilterFilterfilterfilter
ein HALCON Operator eingesetzt, dann wird die Auswahldialog passend zum
Operator verwendet.
.
Der FilterFilterFilterFilterfilterfilter kann verwendet werden um die Dateitypen zu selektieren, welche
zum Lesen oder Schreiben ausgewählt werden sollten. FilterFilterFilterFilterfilterfilter kann auf einen
HALCON Operator gesetzt werden, zum Beispiel read_imageread_imageReadImageReadImageReadImageread_image, welcher die ausgwählte
Datei dann zum Lesen oder Schreiben verwenden sollte.
Wird ein HALCON Operator verwendet, dann wird der Filter passend für diesen Operator
gesetzt.
Um Bilder vom Typ JPG und TIFF auszuwählen, könnnte der Filter so aussehen
'Bilder (*.jpg *.tiff *.tif)'"Bilder (*.jpg *.tiff *.tif)""Bilder (*.jpg *.tiff *.tif)""Bilder (*.jpg *.tiff *.tif)""Bilder (*.jpg *.tiff *.tif)""Bilder (*.jpg *.tiff *.tif)"
oder so 'JPEG Files (*.jpg);;TIFF Files (*.tiff *.tif)'"JPEG Files (*.jpg);;TIFF Files (*.tiff *.tif)""JPEG Files (*.jpg);;TIFF Files (*.tiff *.tif)""JPEG Files (*.jpg);;TIFF Files (*.tiff *.tif)""JPEG Files (*.jpg);;TIFF Files (*.tiff *.tif)""JPEG Files (*.jpg);;TIFF Files (*.tiff *.tif)".
Im ersten Fall werden alle unterstützten Bilder gleichzeitig aufgelistet,
im zweiten Fall ist es möglich zwischen JPEG Files und TIFF Files zu wählen.
Beim Filter wird nicht zwischen Groß- und Kleinschreibung unterschieden,
somit liefert 'JPEG Files (*.jpg)'"JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)" und 'JPEG Files (*.JPG)'"JPEG Files (*.JPG)""JPEG Files (*.JPG)""JPEG Files (*.JPG)""JPEG Files (*.JPG)""JPEG Files (*.JPG)"
das gleiche Ergebnis.
Der Filter wird mit dem Eintrag 'All Files (*)'"All Files (*)""All Files (*)""All Files (*)""All Files (*)""All Files (*)" ergänzt.
Mehrer Filter müssen mit ';;'";;"";;"";;"";;"";;" kombiniert werden.
Beispiele:
Der Filter 'Bilder (*.jpg *.tiff *.tif)'"Bilder (*.jpg *.tiff *.tif)""Bilder (*.jpg *.tiff *.tif)""Bilder (*.jpg *.tiff *.tif)""Bilder (*.jpg *.tiff *.tif)""Bilder (*.jpg *.tiff *.tif)" listet alle Dateien mit
der Endung jpg,tiff und tif.
Der Filter 'JPEG Files (*.jpg)'"JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)" listet alle Dateien mit der
Endung jpg
Kombination von 3 Filtern:
'Bilder (*.jpg *.tiff *.tif);;JPEG Files (*.jpg);;
TIFF Files (*.tiff *.tif)'"Bilder (*.jpg *.tiff *.tif);;JPEG Files (*.jpg);;
TIFF Files (*.tiff *.tif)""Bilder (*.jpg *.tiff *.tif);;JPEG Files (*.jpg);;
TIFF Files (*.tiff *.tif)""Bilder (*.jpg *.tiff *.tif);;JPEG Files (*.jpg);;
TIFF Files (*.tiff *.tif)""Bilder (*.jpg *.tiff *.tif);;JPEG Files (*.jpg);;
TIFF Files (*.tiff *.tif)""Bilder (*.jpg *.tiff *.tif);;JPEG Files (*.jpg);;
TIFF Files (*.tiff *.tif)"
Der Parameter PathPathPathPathpathpath kann verwendet werden um das Arbeitsverzeichnis
zu wählen. Falls PathPathPathPathpathpath auf 'default'"default""default""default""default""default" gesetzt wird, verwendet
der Dialog das für diesen ModeModeModeModemodemode zuletzt verwendete
Arbeitsverzeichnis.
Nach der erfolgreichen Ausführung enthält SelectionSelectionSelectionSelectionselectionselection die selektierte
Datei, bzw. das Verzeichnis, oder die selektierten Dateien.
Achtung
Dieser Operator wird beim Codeexport ignoriert.
Parameter
FilterFilterFilterFilterfilterfilter (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Auswahl der Dateitypen.
ModeModeModeModemodemode (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Modus der Dateiauswahldialogs.
Defaultwert:
'default'
"default"
"default"
"default"
"default"
"default"
Werteliste: 'default'"default""default""default""default""default", 'dir'"dir""dir""dir""dir""dir", 'read'"read""read""read""read""read", 'read_multi'"read_multi""read_multi""read_multi""read_multi""read_multi", 'write'"write""write""write""write""write"
PathPathPathPathpathpath (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Arbeitsverzeichnis.
Defaultwert:
'default'
"default"
"default"
"default"
"default"
"default"
SelectionSelectionSelectionSelectionselectionselection (output_control) string(-array) → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Selektierte Dateinamen oder Verzeichnis.
Defaultwert:
'default'
"default"
"default"
"default"
"default"
"default"
Beispiel (HDevelop)
dev_open_file_dialog ('read_image', 'default','c:/',Selection)
read_image(ToolId, Selection)
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
dev_update_pcdev_update_pcDevUpdatePcDevUpdatePcDevUpdatePcdev_update_pc den Wert TRUE.
Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode
zurückgeliefert.
Alternativen
dev_open_dialogdev_open_dialogDevOpenDialogDevOpenDialogDevOpenDialogdev_open_dialog
Siehe auch
dev_open_dialogdev_open_dialogDevOpenDialogDevOpenDialogDevOpenDialogdev_open_dialog
Modul
Foundation