DateNavigator 

Das DateNavigator-Oberflächenelement unterstützt die Anzeige und Eingabe eines Datums. Unter anderem ermöglicht es das Navigieren innerhalb eines Kalenders sowie die Auswahl eines Tages, Monats, Jahres oder Datumsbereichs. In erster Linie soll das Oberflächenelement jedoch dem Benutzer bei der Eingabe eines Datums dienen und das Datum in einem entsprechenden Format eintragen.

Mit Hilfe des DateNavigatorLegend– 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.

Beispiel für die visuelle Darstellung

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

Weitere Eigenschaften, die über Vererbung zur Verfügung stehen, sind in den dazugehörigen übergeordneten Klassen definiert. Die dazugehörigen Oberflächenelemente sind:

·         UIElement

·         ContextMenuProvider

·         ViewElement

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