16 filereq (Filerequestor)

{ export | reexport } { model } filereq { <Bezeichner> }
{
  <Objektspezifische Attribute>
}

Ereignisse

extevent

Kinder

keine

Vater

dialog

module

Menü

keins

16.1 Attribute

.bgc

.changedir

.class

.control

.cursor

.cut_pending

.cut_pending_changed

.dialog

.directory

.extension

.external

.external[integer]

.fgc

.firstrecord

.font

.groupbox

.help

.label

.lastrecord

.model

.module

multisel

.mustexist

.navigable

.notepage

options[enum]

.parent

.pattern

.record[integer]

.recordcount

.scope

.self

startsel

.statushelp

.style

.text[enum]

.title

.userdata

value

.value[integer]

.window

16.2 Spezifische Attribute

Bitte beachten Sie auch die folgenden Kapitel, insbesondere das Kapitel „Beschreibung des filereq-Objekt“.

16.3 Beschreibung des filereq-Objekt

Das Dateiauswahlfenster wird in der Regelsprache mit Hilfe der eingebauten Funktion querybox() bzw. von der Applikationsseite über die Funktion DM_QueryBox() bzw. DMcob_QueryBox() geöffnet. Das Attribut .visible ist für dieses Objekt nicht verfügbar.

Durch Angabe des Parent-Parameters kann die Anfangsposition des Dateiauswahlfensters beeinflusst werden. Siehe dazu die Tabelle am Ende dieses Kapitels.

Während der Auswahl sind alle weiteren Eingabemöglichkeiten der Anwendung gesperrt. Der Anwender kann im Verzeichnisbaum navigieren und eine Datei mittels Maus oder Tastatur auswählen. Auf die Bestätigung der Auswahl durch den OK-Button bzw. durch Doppelklick, erhält man als Rückgabewert:

• button_ok

  wenn der Anwender eine Datei ausgewählt hat. Der ausgewählte Dateiname steht dann als vollständige Pfadangabe im Attribut value bzw. .value[integer] bei einer Mehrfachselektion. Wenn das Attribut .changedir den Wert true besitzt, erhält das Attribut .directory den Pfad des Verzeichnisses, aus dem die Datei / das Verzeichnis ausgewählt wurde.

• button_cancel

  wenn der Anwender die Auswahl abgebrochen hat

• nobutton

  wenn ein Fehler aufgetreten ist, der das Öffnen des Auswahlfensters verhinderte.

Die Auswahlmöglichkeit kann durch Angabe eines initialen Verzeichnisses (Attribut .directory) und durch ein Muster (.pattern), das auf die angezeigten, auswählbaren Dateien angewandt wird, konfiguriert werden. Bei Angabe eines Dateisuffix im Attribut .extension wird dieser an den ausgewählten Namen, wenn noch kein Suffix vorhanden, angehängt.

Das Auswahlfenster präsentiert sich je nach Modus (Attribut .style) und Fenstersystem in folgender Form:

Einige Attribute (options[enum], .multisel, .text[enum]) erlauben systemspezifische Funktionen zu nutzen, bieten Zusatzfunktionen oder konfigurieren die Auswahl, und sind nicht auf allen Plattformen verfügbar oder zeigen eine Wirkung.

Die Anfangsposition des Auswahlfensters ist vom Fenstersystem abhängig. Die folgende Tabelle zeigt die Wirkung des Parent-Parameters beim querybox-Aufruf auf die Position.

16.4 Hinweise

Das filereq-Objekt wird auf die vom System angebotenen Datei-/Verzeichnis-Auswahlmöglichkeiten abgebildet. Insofern ergibt sich ein unterschiedliches Erscheinungsbild und Funktionsumfang auf den verschiedenen Systemen. Bei Verbesserungen der Auswahlmöglichkeit profitiert man automatisch davon.

Die auf allen Systemen angebotene Möglichkeit, einen Hilfe-Button anzubieten, wird momentan nicht unterstützt.

Das momentane Arbeitsverzeichnis, in dem sich die Anwendung befindet, wird vom filereq-Objekt nicht beeinflusst.

16.4.1 Motif

Die Darstellung (Schrift, Farben, Texte) wird normalerweise vom Window-Manager definiert. Nur Texte und Font sind vom Anwendungsprogrammierer überdefinierbar.

Die Selektion einer Datei kann durch den OK-Button oder durch einen Doppelklick geschehen.

Es handelt sich, unabhängig vom Modus des Filerequestor-Objektes, um die gleiche Art von Dateiauswahlfenster. Man muss also den Sinn über den Titel oder die Texte vermitteln.

Die Überprüfung, ob eine Datei oder ein Verzeichnis existiert, sowie das Anhängen eines Dateisuffixes wenn noch keiner existiert, werden vom IDM übernommen.

Zusätzlich ist es unter Motif möglich, die Beschriftung von Dialogelementen eines Filerequestor-Objektes mit Hilfe des Attributs .text[enum] vorzunehmen.

Bitte beachten Sie in Bezug auf die Anordnung eines Filerequestors vor oder hinter anderen Fenstern und Dialogfeldern auf dem Bildschirm (Z-Ordnung) den Hinweis in Kapitel „Z-Ordnung von Fenstern und Dialogfeldern“.

16.4.2 Microsoft Windows

Bitte beachten Sie, dass die Darstellung (Schrift, Farben, Texte) bis auf den Titel durch die Einstellungen ihres MS-Windows-Systems definiert wird.

Auch hier ist die Selektion durch den OK-Button oder durch einen Doppelklick möglich. MS-Windows bietet eine Mehrfachselektion bei der Auswahl/Eingabe von Dateien an. In Kombination mit der Shift- oder Strg-Taste erlaubt es eine Bereichsselektion oder das Umschalten des Aktivierungszustandes.

Die Verzeichnisauswahl ist, im Gegensatz zur Motif-Implementierung, beschränkt auf die Auswahl eines vorhandenen Verzeichnisses und bietet nicht die Möglichkeit, mit einem Muster zu arbeiten. Außerdem ist, in den Dialog Manager Versionen vor A.05.01.e, bei Angabe eines initialen Verzeichnisses die Verzeichnisauswahl beschränkt auf die Verzeichnisse die darunter liegen. Ab der Version A.05.01.e entfällt diese Beschränkung. Näheres hierzu siehe in der „Attributreferenz“ zum Attribut .directory.

Ein zusätzliches Feature von MS-Windows sind außerdem die Nachfragedialoge, ob eine Datei angelegt bzw. wirklich überschrieben werden soll.

16.4.3 Portabilitätshinweise

Um größtmögliche Konsistenz bei Funktion und Aussehen zu erhalten, sollten folgenden Punkte beherzigt werden:

• Mehrfachselektion nicht verwenden.
• Attribut .title auf jeden Fall so setzen, dass die Aktion daraus (Laden/Speichern/Selektieren) klar wird.
• Um Konsistenz in der Sprache zu erhalten, muss die im System eingestellte Sprache mit ihren Texten korrespondieren.
• Verschiedene Muster (Attribut .pattern) verwenden. Muster für die Verzeichnisauswahl vermeiden.
• Verzeichnisauswahl ohne initiales Startverzeichnis benutzen.
• UNIX und MS-Windows besitzen unterschiedliche Pfad-Zeichen. Dies ist bei der Verarbeitung von Pfadangaben zu beachten.
• Zur Abfrage des Systems kann das Attribut .opsys_type am Setup-Objekt verwendet werden.

16.5 Beispiel

Das Öffnen eines Dateiauswahlfensters kann wie folgt aussehen:

!! Beispiel fuer Microsoft Windows
filereq Fr
{
  .style fr_load;
  .title "Zeige GIF-Bild an";
  .directory "c:\";  /* Motif: "/" */
  .pattern "GIF-Datei\t*.gif\tAlle\t*.*";  /* Motif: "*.gif"; */
  .extension "gif";
}
rule void OpenFile()
{
  if button_ok = querybox(Fr) then
    ViewGif(Fr.value);
  endif
}