Web Dynpro MatrixLayout API – IWDMatrixLayout 

Definition

The matrix layout arranges the UI elements in a grid structure. It uses predefined cell classes that guarantee appropriate distances between cells in the grid. The vGutter property lets you specify additional horizontal distances easily. You can set these additional distances (known as gutters) with or without separators. In addition, the matrix layout can include horizontal separators to separate the rows further, represented by the HorizontalGutter UI element. The distance for each cell is specified by assigning a specific enumeration value of the class WDLayoutCellSeparator of the matrix data object. This type of layout is preferable to the Grid-Layout, since it makes the layout structure in a container more consistent. Using the interface IWDMatrixHeadData, you can specify the UI element that appears at the start of each new line.

You should avoid using nested matrix layouts. Instead, use row layouts wherever possible. The row layout differs from the matrix layout in that the content is not organized in table cells. That is, the individual elements are not aligned vertically with each other. When the row layout is implemented in an application, performance is better than if a matrix layout were used, but the layout flexibility is not compromised. For this reason, you should structure the view and container in horizontal areas as early as possible, using the row layout. You should only use the matrix layout if you need to display a table and align the elements vertically.

Description of the UI Element Properties

·        stretchedHorizontally
Specifies whether UI elements aligned using this layout are adapted horizontally to the container size, so that the container is completely filled horizontally.

·        stretchedVertically
Specifies whether UI elements aligned using this layout are adapted vertically to the container size, so that the container is completely filled vertically.

Overview of Inherited and Additional Properties

Name	Interface	Type	Initial Value	Bindable	Value Required
stretchedHorizontally	IWDMatrixLayout	boolean	true	not_bindable	No
stretchedVertically	IWDMatrixLayout	boolean	true	not_bindable	No

Methods in the Web Dynpro IWDMatrixLayout API

getStretchedHorizontally		boolean	Returns the value of the stretchedHorizontally property.
getStretchedVertically		boolean	Returns the value of the stretchedVertically property.
setStretchedHorizontally	(boolean stretchedHorizontally)	void	Sets the value of the stretchedHorizontally property.
setStretchedVertically	(boolean stretchedVertically)	void	Sets the value of the stretchedVertically property.

Additional methods described in the following APIs are available using inheritance:

IWDLayout, IWDViewElement.

For detailed documentation of all inherited methods, see the documentation for the relevant APIs.