Date
Date(name~aliasName, flags, x, y, w)
Parameter | Beschreibung | |
---|---|---|
name | * | Identifikator oder KLASSE::ausdr |
aliasName | ein zusätzlicher Identifikator | |
flags | Flags | |
x | * | Position X (in Minicells) |
y | * | Position Y (in Minicells) |
w | * | Breite (in Minicells) |
- - Pflichtparameter
Das Tupel (Klasse, Zugriffsausdruck) definiert eine Abbildung auf Modelldaten (siehe FillWindow, DrainWindow).
Das Eingabefeld für ein Datum konvertiert die Eingabe in ein Objekt der Klasse CX_DATE.
Mit der Funktion SetDateLimit kann der Wertebereich dieses Eingabefeldes eingeschränkt werden. Der Wertebereich ersetzt den des Systems (SetDateLimit von SystemObject). Es ist nicht möglich, die festen Grenzen zu umgehen (s. CX_DATE).
Flag | Beschreibung |
---|---|
DF_ALLOW_ZERO_DATE |
Erlaubt es, ein leeres Datum zu speichern. Anderenfalls erhält man den folgenden Fehler :
|
HIDDEN | Das Windowobjekt ist solange unsichtbar, bis Anweisung Show es auf dem Bildschirm erschienen lässt. |
VIEW_ONLY | Das Eingabefeld kann nur Daten anzeigen, aber man kann interaktiv keine Zeichen eingeben. |
LOCKED | Das Widget ist gesperrt. Dieser Zustand kann durch Unlock wieder aufgehoben werden. |
NON_SELECTABLE | Man kann das Eingabefeld weder mit Maus noch mit Tastatur anwählen und demzufolge auch keine Zeichen eingeben. Daten werden grau dargestellt. |
JUSTIFY_RIGHT | Die eingegebene Zeichenfolge erscheint rechtsbündig im Eingabefeld. |
JUSTIFY_CENTER | Die eingegebene Zeichenfolge erscheint im Eingabefeld zentriert. |
FONT(k) | k = 0, 1, ..., 9 wählt einen Eintrag in der Font-Tabelle. Der dort eingetragene Font wird benutzt. Fonts werden mit PMFonts in die Tabelle eingetragen. Für 0, 1 und 2 existieren vordefinierte Fonts. Der Font-Index kann später mit SetFont verändert werden. |
MIN_HEIGHT(h) | Höhe des Widgets fällt in keinem Falle unter den Wert h (Angabe in Minicells). Dies ist vor allem in Kombination mit Attachments von Nutzen. |
MIN_WIDTH(w) | Breite des Widgets fällt in keinem Falle unter den Wert w (Angabe in Minicells). Dies ist vor allem in Kombination mit Attachments von Nutzen. |
NO_DRAIN | Das Eingabefeld wird zwar von FillWindow gefüllt, aber von DrainWindow ignoriert. |
NO_CLEAR | Das Eingabefeld wird von ClearWindow nicht gelöscht. |
TOOLTIP(mlString) | Der angegebene String wird als Hinweistext (Tooltip) eingeblendet, oder, falls ein Event TOOLTIP ebenfalls definiert ist, an diesen übergeben. Das Erscheinen des Tooltips wird vom System automatisch nach eine bestimmten Zeit des Verharrens des Maus-Cursors über dem Windowobjekt ausgelöst. Der String kann mehrsprachig sein. An das Event wird der jeweils zur eingestellten Sprache aktuelle übergeben. |
CONTEXTMENU(identifikator) |
Der Identifikator ist ein Bezeichner eines Items innerhalb einer Menu- oder ContextMenuList-Deklaration. Das unter diesem Item hängende Untermenu wird automatisch beim betätigen der rechten Maustaste eingeblendet. Wird daraufhin ein Menupunkt ausgewählt wird wie zu Item beschrieben die jeweilige Aktion gestartet, in gleicher Weise, als wäre der Menueintrag aus dem Hauptmenu heraus aufgerufen worden. Soll ein ContextMenu nicht automatisch erscheinen, so kann es (nach Gestaltungsrichtlinie sollte dies als Reaktion auf die rechte Maustaste, also innerhalb MOUSE_CLICK_R erfolgen) mittels PopupMenu auch aus InstantView® heraus aufgerufen werden. In diesem Fall sollte auf die Angabe des Flags CONTEXTMENU verzichtet werden, da sonst das Menu zweimal (einmal automatisch, einmal gesteuert) erscheint. |
OVERWRITE | Anweisung DrainWindow schreibt in das mit dem Windowobjekt verbundene Datenfeld wie Put(..., OVERWRITE). Dieses Flag ist nur wirksam, wenn DrainWindow für eine Objekt der Klasse CX_OVERWIRTING_REF (oder einer davon abgeleiteten) ausgeführt wird. |
VOLATILE, VOLATILE(identifikator) |
Das Eingabefeld soll nur dann sichtbar sein, wenn das darzustellende Datum auch existiert, andernfalls wird es von FillWindow automatisch ausgeblendet. Wann fehlen Daten in einem Objekt? Das ist der Fall
Mit einer Funktion kann man z.B. an beliebiger Stelle im Zugriffsaufdrucks entscheiden, ob dieser weiterverfolgt werden soll oder nicht. Oft sollen noch andere Windowobjekte - z.B. der zum Eingabefeld gehörende Prompt - ebenfalls mit ein- und ausgeblendet werden. Für diese Objekte gibt man das VOLATILE-Flag mit dem gleichen Identifikator an, der hier eine Gruppe logisch zusammengehöriger Windowobjekte kennzeichnet. |
DF_US_FORMAT | Monat/Tag/Jahr |
DF_EUROPEAN_FORMAT | Format TT.MM.JJ - dies ist die Standardannahme |
DF_JAPANESE_FORMAT | Format JJ.MM.TT |
DF_ASIAN_FORMAT | wie DF_JAPANESE_FORMAT |
DF_MILITARY_FORMAT | Militärisches Datumsformat der US Airforce: Hier gibt es zwei Standards. Die Datumsausgabe erfolgt entweder mit ausgeschriebenem Monat und viertstelliger Jahresangabe, z.B. 5 Juli 1996, oder in Kombination mit (DF_SHORT_YEAR und DF_SHORT_MONTH) mit abgekürztem Monat und zweistelliger Jahresangabe, also z.B. 5 Jul 96. |
DF_DASH | Trennzeichen bei der Ausgabe ist - |
DF_SLASH | Trennzeichen bei der Ausgabe ist / |
DF_ALPHA_MONTH | bei der Ausgabe erschient der Monatsname (als Text) |
DF_DAY_OF_WEEK | bei der Ausgabe erscheint der Name des Wochentags (als Text) |
DF_UPPER_CASE | Vorhande Buchstaben werden als Großbuchstaben ausgegeben |
DF_SHORT_YEAR | Jahr immer 2-stellig ausgeben |
DF_SHORT_MONTH | Kurze Form der Monatsnamen |
DF_SHORT_DAY | Kurze Form der Namen der Wochentage |
DF_ZERO_FILL | bei der Ausgabe mit 0 auffüllen |
DF_SYSTEM | Leereingabe wird als das aktuelle Systemdatum interpretiert |
DF_ALLOW_4DIGIT_INPUT | Das Datum kann mit 4 aufeinander folgenden Ziffern eingegeben werden (ohne Trennzeichen). Das aktuelle Jahr wird automatisch ergänzt. Diese Flag darf nicht zusammen mit DF_JAPANESE_FORMAT (Format JJ.MM.TT) angegeben werden. |
DF_ALLOW_2DIGIT_INPUT | Das Datum kann mit 2 aufeinander folgenden Ziffern eingegeben werden (ohne Trennzeichen). Der aktuelle Monat und das aktuelle Jahr werden automatisch ergänzt. Diese Flag darf nicht zusammen mit DF_JAPANESE_FORMAT (Format JJ.MM.TT) oder DF_US_FORMAT (Format MM.TT.JJ) angegeben werden. |
HELP(anchor) Help("file#anchor") |
verbindet das Windowobjekt mit Online-Hilfe im HTML-Format. Wenn kein Filename angegeben wurde, gilt die im Modul festgelegte HTML-Datei. |
HELP(n) |
Möchte man lieber das Help-System der Plattform (OS/2 PM, MS Windows) benutzten, so ist eine ganze Zahl n anzugeben, die auf das entsprechende Hilfe-Fenster verweist. Dabei muss n < 40000 sein. Hinweis: Als Online-Hilfe für InstantView® Applikation wird aus Gründen der Portabilität HTML empfohlen. |