DateNavigator
Das DateNavigator-Oberflächenelement unterstützt die Anzeige und Eingabe eines Datums. Es ermöglicht das Navigieren innerhalb eines Kalenders sowie die Auswahl eines Tages, Monats, Jahres oder Datumsbereichs.
Mit Hilfe des Legend– und des DateNavigatorMarking-Elements kann dem DateNavigator-Oberflächenelement eine Legende hinzugefügt werden, die der Beschreibung markierter Daten dient. Damit können Sie dem Benutzer zu bestimmten Daten, die einer Kategorie zugeordnet werden, Informationen weitergeben. Beispielsweise können verschiedene Veranstaltungen im Kalender farblich hervorgehoben und die Veranstaltung mit Thema, Uhrzeit und Ort beschrieben werden.
Das UI-Element DateNavigatorLegend ist obsolet. Verwenden Sie stattdessen das UI-Element Legend.
Für die Anzeige im DateNavigator stehen Ihnen folgende Darstellungsformate zur Verfügung:
· Gregorianisch
· Islamisch
· Japanisch
Das kleinste darstellbare Datum ist 01.01.1901, das größte darstellbare Datum ist 30.11.9999.
Beispiele für die visuelle Darstellung
|
Gregorianischer Kalender
Islamischer Kalender
Japanischer Kalender
|
Umstellen des Darstellungsformates
Gehen Sie folgendermaßen vor, um die Kalenderdarstellung auf ein anderes Format umzustellen:
1. Rufen Sie die Transaktion SU3 auf oder wählen Sie System à Benutzervorgaben à Eigene Daten.
2. Wählen Sie den Reiter Festwerte und stellen Sie im Aufklappmenü unter Datumsdarstellung das gewünschte Format ein.
Bei der Umstellung der Datumsdarstellung kommt es zu folgenden Einschränkungen:
· Beim islamischen Kalender sind die Nummern für die Markierung der Wochenzählung durch * ersetzt.
· Im islamischen und japanischen Kalender werden die Monate nicht mit ihrem Namen sondern mit einer Zahl angezeigt.
· Die Länge eines Jahres bzw. Monats im gregorianischen Kalender entspricht nicht der Länge in islamischer Zeitrechnung. Dadurch kommt es zu Unterschieden in der Darstellung von Zeiträumen. Zum Beispiel entspricht Monat 08/2005 (der Zeitraum vom 1. August bis zum 31. August 2005) im islamischen Kalender dem Ende des Monats 06/1426 und dem Anfang des Monats 07/1426.
Um die Entwicklung
barrierefreier
Anwendungen zu ermöglichen, wird im Rahmen des Syntaxchecks die Eigenschaft
accessibilityDescription überprüft, wenn die Eigenschaft tooltip nicht gesetzt
wurde.
Die Eigenschaft accessibilityDescription gilt für den gesamten DateNavigator und wird von Bildschirmausleseprogrammen vorgelesen, wenn der DateNavigator selbst fokussiert wird. Der Tooltip wird für jeden Tag angezeigt, es sei denn, dieser Tag hat eine Markierung und diese enthält einen gefüllten Tooltip.
Laufzeit-Klasse |
CL_WD_DATE_NAVIGATOR |
Eigenschaften im View Designer
Name |
Typ |
Anfangswert |
Bindbar |
STRING |
(automatisch) |
nein |
|
Übersetzbarer Text |
|
ja |
|
WDUI_CONTEXT_MENU_BEHAVIOUR |
inherit |
nein |
|
WDY_MD_UI_ELEMENT_REFERENCE |
|
nein |
|
WDY_BOOLEAN |
true |
ja |
|
WDUI_DAY_OF_WEEK |
auto |
ja |
|
D |
|
ja |
|
D |
|
ja |
|
WDY_MD_UI_ELEMENT_REFERENCE |
|
ja |
|
I |
1 |
ja |
|
I |
3 |
ja |
|
WDUI_DATE_SELECTION_MODE |
single |
ja |
|
D |
|
ja |
|
Übersetzbarer Text |
|
ja |
|
WDUI_VISIBILITY |
visible |
ja |
Aggregationen im View Designer
Name |
Kardinalität |
Typ |
0..1 |
||
0..1 |
Events im View Designer
Name |
Weitere Eigenschaften, die über Vererbung zur Verfügung stehen, sind in den dazugehörigen übergeordneten Klassen definiert. Die dazugehörigen Oberflächenelemente sind:
Dynamische Programmierung
Für die dynamische Programmierung stehen dieselben Eigenschaften, Ereignisse und Aggregationen zur Verfügung wie im View Designer. Beachten Sie dabei die unterschiedlichen Schreibweisen.
Dynamische Programmierung der Eigenschaften
View Designer Name |
Laufzeitname |
Typ |
ACCESSIBILITY_DESCR |
WDY_MD_TRANSLATABLE_TEXT |
|
CONTEXT_MENU_BEHAVIOUR |
WDUI_CONTEXT_MENU_BEHAVIOUR |
|
contextMenuBehaviour: inherit |
CL_WD_DATE_NAVIGATOR=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT |
|
contextMenuBehaviour: provide |
CL_WD_DATE_NAVIGATOR=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE |
|
contextMenuBehaviour: suppress |
CL_WD_DATE_NAVIGATOR=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS |
|
CONTEXT_MENU_ID |
WDY_MD_UI_ELEMENT_REFERENCE |
|
ENABLED |
WDY_BOOLEAN |
|
FIRST_DAY_OF_WEEK |
WDUI_DAY_OF_WEEK |
|
firstDayOfWeek: auto |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-AUTO |
|
firstDayOfWeek: friday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-FRIDAY |
|
firstDayOfWeek: monday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-MONDAY |
|
firstDayOfWeek: saturday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-SATURDAY |
|
firstDayOfWeek: sunday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-SUNDAY |
|
firstDayOfWeek: thursday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-THURSDAY |
|
firstDayOfWeek: tuesday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-TUESDAY |
|
firstDayOfWeek: wednesday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-WEDNESDAY |
|
FIRST_SELECTED_DATE |
D |
|
LAST_SELECTED_DATE |
D |
|
LEGEND_ID |
WDY_MD_UI_ELEMENT_REFERENCE |
|
MONTHS_PER_COLUMN |
I |
|
MONTHS_PER_ROW |
I |
|
SELECTION_MODE |
WDUI_DATE_SELECTION_MODE |
|
selectionMode: none |
CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-NONE |
|
selectionMode: range |
CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-RANGE |
|
selectionMode: single |
CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-SINGLE |
|
STARTS_WITH |
D |
|
TOOLTIP |
WDY_MD_TRANSLATABLE_TEXT |
|
VISIBLE |
WDUI_VISIBILITY |
|
visible: none |
CL_WD_DATE_NAVIGATOR=>E_VISIBLE-NONE |
|
visible: visible |
CL_WD_DATE_NAVIGATOR=>E_VISIBLE-VISIBLE |
|
Dynamische Programmierung der Ereignisse
View Designer Name |
Laufzeitname |
ON_DAY_SELECT |
|
ON_MONTH_SELECT |
|
ON_START_DATE_CHANGED |
|
ON_WEEK_SELECT |
Dynamische Programmierung der Aggregationen
View Designer Name |
Laufzeitname |
Kardinalität |
LEGEND |
0..1 |
|
MARKING |
0..1 |
Beispiel
Beispiele für dieses Oberflächenelement finden Sie im System in der Web-Dynpro-Applikation WDR_TEST_UI_ELEMENTS sowie in der Component WDR_TEST_EVENTS in der View DateNavigator.