GetOpenFileName

GetOpenFileName öffnet ein Dialogfeld, aus dem der Benutzer einen Dateinamen auswählen kann.

ssFileName = GetOpenFileName()

ssFileName = GetOpenFileName(ssDir)

ssFileName = GetOpenFileName(ssDir, ssFilter)

ssFileName = GetOpenFileName(ssDir, ssFilter, nFilterindex)

ssFileName = GetOpenFileName(ssDir, ssFilter, nFilterindex, bMultipleSelect)

ssFileName = GetOpenFileName(ssDir, ssFilter, nFilterindex, bMultipleSelect, ssTitle)

<ssFileName, nFilter> = GetOpenFileName()

<ssFileName, nFilter> = GetOpenFileName(ssDir)

<ssFileName, nFilter> = GetOpenFileName(ssDir, ssFilter)

<ssFileName, nFilter> = GetOpenFileName(ssDir, ssFilter, nFilterindex)

<ssFileName, nFilter> = GetOpenFileName(ssDir, ssFilter, nFilterindex, bMultipleSelect)

<ssFileName, nFilter> = GetOpenFileName(ssDir, ssFilter, nFilterindex, bMultipleSelect, ssTitle)

Returnwert

Die Funktion gibt entweder einen gültigen Dateinamen zurück (komplett mit Laufwerks- und Pfadangabe) oder einen leeren String, falls der Benutzer die Schaltfläche Abbrechen gewählt hat. Wird die Funktion mit vier Parametern aufgerufen und ist bMultipleSelect TRUE, kann der Benutzer mehrere Dateinamen auswählen. In diesem Fall gibt die Funktion einen String-Vektor mit den ausgewählten Dateinamen zurück. Wenn die Funktion mit zwei Rückgabeparametern aufgerufen wird, gibt sie in nFilter zurück welcher Filter selektiert wurde.

Parameter

ssDir

Mit dem Parameter ssDir kann ein Pfad vorgegeben werden. Beispiel: c:\Programme\UniPlot\Data. Falls ssDir einen vollständigen Dateinamen enthält, wird der Name zur Initialisierung der Textfeldes Dateinamen verwendet, falls die Datei existiert.

ssFilter

Der Filterstring ssFilter kann ein oder mehrere Formatangaben für die Liste der Dateiformate enthalten. Der Filterstring muss folgenden Aufbau haben, z. B.

"Alle Dateien (*.*)|*.*|"

Falls mehrere Formatangaben vorgegeben werden sollen, können sie hintereinander gehängt werden, z. B.:

"Text-Dateien (*.txt)|*.txt|Alle Dateien (*.*)|*.*|"

nFilterindex

Der Parameter legt fest, welcher Filter selektiert ist, wenn das Dialogfeld auf dem Monitor dargestellt wird. Die Nummerierung der Filter beginnt bei 1.

bMultipleSelect

Wenn bMultipleSelect den Wert TRUE (1) hat, kann der Benutzer mehrere Dateinamen auswählen.

ssTitle

Zeichenkette mit dem Dialogtitel.

Beispiel

GetOpenFileName() // liefert z. B.:
      d:/data/test.dat

ssFileName = GetOpenFileName("c:", ..
          "UniScript Files (*.ic)|*.ic|" + ..
          "All Files (*.*)|*.*|")
if (ssFileName != "") {
    // Load the file ssFileName.
}

Siehe auch

Überblick Dateien, Überblick Dialogboxen, GetSaveFileName, GetOpenFileName_Data, DialogBox, MessageBox

_id-139001