Splitter

Das Splitter-UI-Element ist ein vertikaler oder horizontaler Balken, durch den ein Container in zwei Bereiche unterteilt wird: ein linker und rechter Bereich oder ein oberer und unterer Bereich. Es ist möglich, die Größe der beiden Bereiche durch Bewegen der Trennleiste (Sash) zu verändern. Wenn ein Bereich vergrößert wird, wird dadurch automatisch der andere Bereich kleiner. Die Funktionalität der Größenveränderung kann auch deaktiviert werden. Die initiale Position der Trennleiste kann festgelegt werden, entweder durch absolute Angaben (z.B. 200px von links, 100px von rechts) oder Prozentangaben (z.B. 30% entspricht 30%-70%). Bei Bedarf kann auch einer der beiden Bereiche zusammengeklappt werden. In einem Splitter kann ein weiterer Splitter eingebettet werden. Wir empfehlen jedoch, von zu tiefen Verschachtelungen abzusehen.

Beispiele für die visuelle Darstellung:

(Splitter)

Hinweis Hinweis

Beachten Sie bei Splitter.enabled=none, dass in diesem Fall alles nicht eingabebereit ist, also ist auch der komplette Container nicht eingabebereit.

Ende des Hinweises.

Einschränkungen

Es ist nicht zulässig, in einen Splitter aktive UI-Elemente einzubetten. Siehe auch SAP Hinweis 1156163.
Ein Splitter muss in einen Container eingebettet werden, der eine der folgenden Bedingungen erfüllt:
- Der Container hat als Höhe 100% und verticalSizing=FILL.
- Der Container hat eine feste voreingestellte Höhe.
Siehe auch SAP Hinweise 1266588 und 1451443.
Ein Splitter darf nicht in einen ScrollContainer eingebettet werden.
Splitterbereiche können nicht automatisch gescrollt werden. Dies ist nur möglich, wenn transparente Container als oberste UI-Elemente eingefügt werden, welche dann die eigentlichen Splitterelemente beinhalten.

Implementierungsdetails

Laufzeit-Klasse

CL_WD_SPLITTER

Eigenschaften im View-Designer
Name	Typ	Anfangswert	Bindbar
id	`STRING`	(automatisch)	nein
border	`WDUI_SPLITTER_BORDER`	`none`	ja
collapseDirection	`WDUI_SPLITTER_COLLAPSE_DIRECT`	`none`	ja
contextMenuBehaviour	`WDUI_CONTEXT_MENU_BEHAVIOUR`	`inherit`	nein
contextMenuId	`WDY_MD_UI_ELEMENT_REFERENCE`		nein
enabled	`WDY_BOOLEAN`	`true`	ja
height	`STRING`		ja
orientation	`WDUI_SASH_ORIENTATION`	`vertical`	ja
sashDesign	`WDUI_SASH_DESIGN`	`standard`	ja
sashPosition	`I`	`50`	ja
sashPositionMode	`WDUI_SASH_POSITION_MODE`	`percent`	ja
sashType	`WDUI_SASH_TYPE`	`interactive`	ja
tooltip	Übersetzbarer Text		ja
visible	`WDUI_VISIBILITY`	`visible`	ja
width	`STRING`		ja

Aggregationen im View Designer
Name	Kardinalität	Typ
FIRST	`0..1`	UIElement
SECOND	`0..1`	UIElement

Events im View Designer
Name
onResize

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
border	`BORDER`	`WDUI_SPLITTER_BORDER`
`border: areadivider`	`CL_WD_SPLITTER=>E_BORDER-AREADIVIDER`
`border: closure`	`CL_WD_SPLITTER=>E_BORDER-CLOSURE`
`border: closureLight`	`CL_WD_SPLITTER=>E_BORDER-CLOSURELIGHT`
`border: none`	`CL_WD_SPLITTER=>E_BORDER-NONE`
`border: subareaDivider`	`CL_WD_SPLITTER=>E_BORDER-SUBAREADIVIDER`
contextMenuBehaviour	`CONTEXT_MENU_BEHAVIOUR`	`WDUI_CONTEXT_MENU_BEHAVIOUR`
`contextMenuBehaviour: inherit`	`CL_WD_SPLITTER=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT`
`contextMenuBehaviour: provide`	`CL_WD_SPLITTER=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE`
`contextMenuBehaviour: suppress`	`CL_WD_SPLITTER=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS`
collapseDirection	`COLLAPSE_DIRECTION`	`WDUI_SPLITTER_COLLAPSE_DIRECT`
`collapseDirection: none`	`CL_WD_SPLITTER=>E_COLLAPSE_DIRECTION-NONE`
`collapseDirection: toBegin`	`CL_WD_SPLITTER=>E_COLLAPSE_DIRECTION-TO_BEGIN`
`collapseDirection: toEnd`	`CL_WD_SPLITTER=>E_COLLAPSE_DIRECTION-TO_END`
contextMenuId	`CONTEXT_MENU_ID`	`WDY_MD_UI_ELEMENT_REFERENCE`
enabled	`ENABLED`	`WDY_BOOLEAN`
height	`HEIGHT`	`STRING`
orientation	`ORIENTATION`	`WDUI_SASH_ORIENTATION`
`orientation: horizontal`	`CL_WD_SPLITTER=>E_ORIENTATION-HORIZONTAL`
`orientation: vertical`	`CL_WD_SPLITTER=>E_ORIENTATION-VERTICAL`
sashDesign	`SASH_DESIGN`	`WDUI_SASH_DESIGN`
`sashDesign: contour`	`CL_WD_SPLITTER=>E_SASH_DESIGN-CONTOUR`
`sashDesign: standard`	`CL_WD_SPLITTER=>E_SASH_DESIGN-STANDARD`
sashPosition	`SASH_POSITION`	`I`
sashPositionMode	`SASH_POSITION_MODE`	`WDUI_SASH_POSITION_MODE`
`sashPositionMode: absoluteFromBegin`	`CL_WD_SPLITTER=>E_SASH_POSITION_MODE-ABSOLUTE_FROM_BEGIN`
`sashPositionMode: absoluteFromEnd`	`CL_WD_SPLITTER=>E_SASH_POSITION_MODE-ABSOLUTE_FROM_END`
`sashPositionMode: percent`	`CL_WD_SPLITTER=>E_SASH_POSITION_MODE-PERCENT`
sashType	`SASH_TYPE`	`WDUI_SASH_TYPE`
`sashType: fixed`	`CL_WD_SPLITTER=>E_SASH_TYPE-FIXED`
`sashType: interactive`	`CL_WD_SPLITTER=>E_SASH_TYPE-INTERACTIVE`
`sashType: invisible`	`CL_WD_SPLITTER=>E_SASH_TYPE-INVISIBLE`
tooltip	`TOOLTIP`	`WDY_MD_TRANSLATABLE_TEXT`
visible	`VISIBLE`	`WDUI_VISIBILITY`
`visible: none`	`CL_WD_SPLITTER=>E_VISIBLE-NONE`
`visible: visible`	`CL_WD_SPLITTER=>E_VISIBLE-VISIBLE`
width	`WIDTH`	`STRING`

Dynamische Programmierung der Aggregationen
View-Designer Name	Laufzeitname	Kardinalität
FIRST	`FIRST`	`0..1`
SECOND	`SECOND`	`0..1`

Beispiel

Sie finden ein Test-Beispiel für dieses Oberflächenelement im System in der Component WDR_TEST_UI_ELEMENTS.