Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Scout/Concepts/Layout"

(Layout properties)
(Form Field Properties)
Line 45: Line 45:
 
! Config method
 
! Config method
 
! Meaning
 
! Meaning
 +
! Default value
 
|-
 
|-
| getConfiguredGridX || desc
+
| getConfiguredGridX  
 +
| Configures the x position (horizontal) of this field in the logical grid of the surrounding group box.<br>
 +
If the value is set to -1, the property will be ignored. If the value is >= 0, it's considered as grid column. <br>
 +
It is not necessary to explicitly set a column count by <code>AbstractGroupBox#getConfiguredGridColumnCount()</code>.
 +
 
 +
This property only has an effect if every field inside the group box has a fix position which means every field
 +
inside the group box need to have x and y to be set which can be configured by <code>getConfiguredGridX()</code> and
 +
<code>getConfiguredGridY()</code>.
 +
{{note|This property is for static layout only and should only be used in spacial cases!}}
 +
|
 
|-
 
|-
| getConfiguredGridY || desc
+
| getConfiguredGridY  
 +
| Configures the y (vertical) position of this field in the logical grid of the surrounding group box.
 +
If the value is set to -1, the property will be ignored. If the value is >= 0, it's considered as grid row.
 +
This property only has an effect if every field inside the group box has a fix position which means every field
 +
inside the group box need to have x and y to be set which can be configured by </code>getConfiguredGridX()</code> and
 +
<code>getConfiguredGridY()</code>.
 +
{{note|This property is for static layout only and should only be used in spacial cases!}}
 +
|
 
|-
 
|-
| getConfiguredGridW || desc
+
| getConfiguredGridW  
 +
| desc
 +
|
 
|-
 
|-
| getConfiguredGridH || desc
+
| getConfiguredGridH  
 +
| desc
 +
|
 
|-
 
|-
| getConfiguredGridWeightX || desc
+
| getConfiguredGridWeightX  
 +
| desc
 +
|
 
|-
 
|-
| getConfiguredGridWeightY || desc
+
| getConfiguredGridWeightY  
 +
| desc
 +
|
 
|-
 
|-
| getConfiguredGridUseUiWidth || desc
+
| getConfiguredGridUseUiWidth  
 +
| desc
 +
|
 
|-
 
|-
| getConfiguredGridUseUiHeight || desc
+
| getConfiguredGridUseUiHeight  
 +
| desc
 +
|
 
|-
 
|-
 
|}
 
|}
  
 
== Layout Inspector==
 
== Layout Inspector==

Revision as of 10:51, 2 April 2014

The Scout documentation has been moved to https://eclipsescout.github.io/.

The Concepts pages define concepts and elements used in the Eclipse Scout Framework.

Abstract

Scout provides a generic layout on any composite fields as:

The layout is mainly related to a grid layout with some additional features as weight related resize behavior and some optimizations reducing the used space. There are currently a horizontal and a vertical implementation of the grid layout.

Layout properties

Groupbox Properties

The following group box properties affect the layout of the container. So the fields in the container getting layouted respecting the properties.

Config method Meaning Default value
getConfiguredBodyGrid The layout orientation vertical vs. horizontal. Scout provides two layout strategies:
  • Vertical(VerticalSmartGroupBoxBodyGrid) The fields are placed column first in the grid. (Field01 [x0,y0]; Field02 [x0,y1]...)
  • Horizontal (HorizontalGroupBoxBodyGrid) The fields are placed row first in the grid. (Field01 [x0,y0]; Field02 [x1,y0]...)
VerticalSmartGroupBoxBodyGrid.class
getConfiguredColumnCount Column count of the layout where child fields are placed in respective to their layout data. -1 Will be replaced with either the parent groupbox column count or if any of the parent group boxes has a grid column count 2.


Form Field Properties

The form field properties define how a certain form field has to be layout in its container.

Config method Meaning Default value
getConfiguredGridX Configures the x position (horizontal) of this field in the logical grid of the surrounding group box.

If the value is set to -1, the property will be ignored. If the value is >= 0, it's considered as grid column.
It is not necessary to explicitly set a column count by AbstractGroupBox#getConfiguredGridColumnCount().

This property only has an effect if every field inside the group box has a fix position which means every field inside the group box need to have x and y to be set which can be configured by getConfiguredGridX() and getConfiguredGridY().

Note.png
This property is for static layout only and should only be used in spacial cases!
getConfiguredGridY Configures the y (vertical) position of this field in the logical grid of the surrounding group box.

If the value is set to -1, the property will be ignored. If the value is >= 0, it's considered as grid row. This property only has an effect if every field inside the group box has a fix position which means every field inside the group box need to have x and y to be set which can be configured by </code>getConfiguredGridX()</code> and getConfiguredGridY().

Note.png
This property is for static layout only and should only be used in spacial cases!
getConfiguredGridW desc
getConfiguredGridH desc
getConfiguredGridWeightX desc
getConfiguredGridWeightY desc
getConfiguredGridUseUiWidth desc
getConfiguredGridUseUiHeight desc

Layout Inspector

Copyright © Eclipse Foundation, Inc. All Rights Reserved.