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 desLegend- 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.

Achtung

Das UI-ElementDateNavigatorLegend ist obsolet. Verwenden Sie stattdessen das UI-ElementLegend.

Für die Anzeige im DateNavigator stehen Ihnen folgende Darstellungsformate zur Verfügung:

Gregorianisch
Islamisch
Japanisch
Hinweis
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:

Rufen Sie die TransaktionSU3 auf oder wählen Sie System → Benutzervorgaben → Eigene Daten.
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.

Hinweis

Um die Entwicklungbarrierefreier 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
id	STRING	(automatisch)	nein
accessibilityDescription	Übersetzbarer Text		ja
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
enabled	WDY_BOOLEAN	true	ja
firstDayOfWeek	WDUI_DAY_OF_WEEK	auto	ja
firstSelectedDate	D		ja
lastSelectedDate	D		ja
legendId	WDY_MD_UI_ELEMENT_REFERENCE		ja
monthsPerColumn	I	1	ja
monthsPerRow	I	3	ja
selectionMode	WDUI_DATE_SELECTION_MODE	single	ja
startsWith	D		ja
styleClassName	STRING		ja
tooltip	Übersetzbarer Text		ja
visible	WDUI_VISIBILITY	visible	ja

Aggregationen im View Designer

Name	Kardinalität	Typ
Legende	0..1	DateNavigatorLegend
Markierung	0..1	DateNavigatorMarking

Events im View Designer

Name
onDaySelect
onMonthSelect
onStartDateChanged
onWeekSelect

Hinweis

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
accessibilityDescription	ACCESSIBILITY_DESCR	WDY_MD_TRANSLATABLE_TEXT
contextMenuBehaviour	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
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
enabled	ENABLED	WDY_BOOLEAN
firstDayOfWeek	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
firstSelectedDate	FIRST_SELECTED_DATE	D
lastSelectedDate	LAST_SELECTED_DATE	D
legendId	LEGEND_ID	WDY_MD_UI_ELEMENT_REFERENCE
monthsPerColumn	MONTHS_PER_COLUMN	I
monthsPerRow	MONTHS_PER_ROW	I
selectionMode	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
startsWith	STARTS_WITH	D
styleClassName	STYLE_CLASS_NAME	STRING
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	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
onDaySelect	ON_DAY_SELECT
onMonthSelect	ON_MONTH_SELECT
onStartDateChanged	ON_START_DATE_CHANGED
onWeekSelect	ON_WEEK_SELECT

Dynamische Programmierung der Aggregationen

View Designer Name	Laufzeitname	Kardinalität
Legende	LEGEND	0..1
Markierung	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.