dev_open_file_dialog
— Öffnet den Dateiauswahldialog.
dev_open_file_dialog
öffnet den Dateiauswahldialog zum
Lesen von einer Datei (Mode
= 'read' ), zum Lesen von
einer oder mehrerer Dateien (Mode
= 'read_multi' ),
zum Schreiben (Mode
= 'write' ) einer Datei oder zur
Auswahl eines Verzeichnisses (Mode
= 'dir' ).
Wird Mode
auf 'default' gesetzt und für den Filter
ein HALCON Operator eingesetzt, dann wird die Auswahldialog passend zum
Operator verwendet.
.
Der Filter
kann verwendet werden um die Dateitypen zu selektieren, welche
zum Lesen oder Schreiben ausgewählt werden sollten. Filter
kann auf einen
HALCON Operator gesetzt werden, zum Beispiel read_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)'
oder so '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)' und 'JPEG Files (*.JPG)'
das gleiche Ergebnis.
Der Filter wird mit dem Eintrag 'All Files (*)' ergänzt.
Mehrer Filter müssen mit ';;' kombiniert werden.
Beispiele:
Der Filter 'Bilder (*.jpg *.tiff *.tif)' listet alle Dateien mit der Endung jpg,tiff und tif.
Der Filter '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)'
Der Paramter Path
kann verwendet werden um das Arbeitzverzeichnis
zu wählen. Falls Path
auf 'default' gesetzt wird, verwendet
der Dialog das für diesen Mode
zuletzt verwendete
Arbeitsverzeichnis.
Nach der erfolgreichen Ausführung enthält Selection
die selektierte
Datei, bzw. das Verzeichnis, oder die selektierten Dateien.
Dieser Operator wird beim Codeexport ignoriert.
Filter
(input_control) string →
(string)
Auswahl der Dateitypen.
Mode
(input_control) string →
(string)
Modus der Dateiauswahldialogs.
Defaultwert: 'default'
Werteliste: 'default' , 'dir' , 'read' , 'read_multi' , 'write'
Path
(input_control) string →
(string)
Arbeitsverzeichnis.
Defaultwert: 'default'
Selection
(output_control) string(-array) →
(string)
Selektierte Dateinamen oder Verzeichnis.
Defaultwert: 'default'
dev_open_file_dialog ('read_image', 'default','c:/',Selection) read_image(ToolId, Selection)
Sind die Parameterwerte korrekt, dann liefert
dev_update_pc
den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode
zurückgeliefert.
Foundation