Set layout properties
- Last UpdatedDec 05, 2024
- 6 minute read
Layout properties define the overall visual characteristics and runtime behavior of a layout. For information about pane properties, see About pane properties.
You can show layout properties from the Layout Editor by clicking or tapping outside of the displayed layout.
The following table shows the default values of layout properties. When no pane or divider is selected, layout properties show the properties of the overall layout.
Other property fields appear when some layout properties are assigned specific values. The following table lists any prerequisite property values in the Prerequisite Property Values column.
The following table lists all layout properties. The properties are organized into the categories shown in the Properties window of the Layout Editor. You can also view layout properties in alphabetical order by selecting the Show Alphabetical icon next to the Search field.
You type values or select values from drop-down lists to assign values to layout properties. A red background appears when you enter an invalid property value.
Short descriptions of the properties appear at the bottom of the Properties window for each selected property.
|
Property Category |
Property |
Default Property Value |
Prerequisite Property Values |
Description |
|
General |
||||
|
Title |
<Empty> |
None |
Text shown in the title bar of the layout's window during runtime. |
|
|
Title Mode |
IncludeDefault PaneContent |
None |
Options specify whether the name of the default content shown in the default pane is appended to the title of the layout or not. TitleOnly: Shows only the title assigned to the layout. IncludeDefaultPaneContent: The name of the content placed in the default pane is appended to the title of the layout window. |
|
|
Content Type |
<Empty> |
None |
Specifies the type of content represented by a layout. Select the arrow at the right of the Content Type field to show a drop-down list of content types. One or more content types can be selected from the list. |
|
|
Target |
||||
|
Target |
Unassigned |
None |
Specifies if the layout is intended for a screen, a pane of another layout, a pop-up, or is unassigned. |
|
|
Screen Profile |
N/A |
Target=Screen |
Name of the screen profile containing a screen that the layout is intended to be displayed on. For more information about associating a screen profile to a layout, see Select a screen profile layout property. |
|
|
Screen |
N/A |
Target=Screen |
Name of the screen within a Screen Profile that the layout is designed to be displayed on. |
|
|
Layout |
N/A |
Target=Pane |
Name of the layout containing the target pane that this layout is designed to be hosted in. |
|
|
Pane |
N/A |
Target=Pane |
Name of the pane within the selected layout that this layout is designed to be hosted in. |
|
|
Orientation |
N/A |
Target=Screen or Target=Pane or Target=Popup |
Orientation of the layout(Portrait or Landscape) determined by the selected screen profile screen or pane. Read only. |
|
|
Width |
N/A |
None |
Width of the layout in pixels. |
|
|
Height |
N/A |
None |
Height of the layout in pixels. |
|
|
Aspect Ratio |
1.91:1 |
None |
Calculated aspect ratio of the width to height size of a layout. |
|
|
Behavior |
||||
|
Kiosk Mode |
False |
None |
When set to True, the System Menu, and Window Controls (Maximize/Restore, Minimize and Close) buttons and their underlying functions are inaccessible during runtime. |
|
|
Initial State |
Maximized |
Kiosk Mode=False |
Initial state of a layout's window during runtime. The initial state of the layout window can be one of the following: Maximized Full Screen Normal Minimized |
|
|
|
Has Title Bar |
True |
Kiosk Mode=False |
When set to True, a title bar appears at the top of the layout's window, which is 33 pixels in height. As a result, the height of a layout designed for a screen resolution of 1920 x 1080 is adjusted to 1047 pixels to accommodate the height of the title bar. |
|
IsResponsive |
False |
Kiosk Mode=False |
When set to True, the Layout editor enters responsive layout mode. For more information about Responsive Layouts, see About the responsive layout mode. See the following table for a set of layout properties that are unique to responsive layouts and only appear when the IsResponsive property is set to True. |
|
|
|
Can Resize |
True |
Kiosk Mode=False |
When set to True, the user can resize the running View Application window by dragging the horizontal or vertical border. Also, selecting either the Minimize or Maximize Windows can be selected to resize the layout. |
|
|
Can Toggle Full Screen |
True |
Kiosk Mode=False |
When set to True, the user can press the F11 key to toggle the running View Application window in and out of full screen mode. |
|
|
Display In Taskbar |
True |
None |
When set to True, the layout's window will appear in the Windows taskbar. |
|
Appearance |
||||
|
Background |
#FFE4E4E4 |
None |
Background color of a layout or a pane. Select the arrow at the right of the property field to show a color picker to set a background color. |
|
|
Background Image |
<Empty> |
Valid image file types / extensions: |
Image file used as the background of a layout. The image spans all panes of a layout. Select the file picker button to open a file browser window, then navigate to an image file and select Open to set the background image. To remove a background image, select the X that appears next to the image name. |
|
|
Sizing |
Stretch |
Sets the method for resizing the Background Image file to fit the layout. Stretch: matches the height and width of the image file with the layout size. This can skew the image aspect ratio. Horizontal: matches the width of the image file to the width of the layout. This preserves the image aspect ratio, but can result in empty space above and below the image (letter-boxing), or clipping the top and bottom of the image. Vertical: matches the height of the specified image file to the height of the layout. This preserves the image aspect ratio, but can result in empty space to the right and left of the image (letter-boxing), or clipping the sides of the image. Tile: preserves the original height and width of the specified image file, but tiles (repeats) it to fill the entire layout. If any blank space appears around the image due to letter-boxing, the background color of the layout is shown. |
||
The following table shows layout properties that apply only to responsive layouts. The IsResponsive property must be set to True to show these properties.
|
Property Category |
Property |
Default Property Value |
Prerequisite Property Values |
Description |
|
Extra Small |
||||
|
Column Span Extra Small |
12 |
IsResponsive=True |
Number of columns a pane can span when a responsive layout is displayed on an extra small screen. |
|
|
Column Push Extra Small |
0 |
IsResponsive=True |
Number of columns to push a responsive layout pane when displayed on an extra small screen. |
|
|
Column Pull Extra Small |
0 |
IsResponsive=True |
Number of columns to pull a responsive layout pane when displayed on an extra small screen. |
|
|
Pane Offset Small |
0 |
IsResponsive=True |
Number of columns to offset a responsive layout pane when displayed on a small screen. |
|
|
Pane Offset Extra Small |
0 |
IsResponsive=True |
Number of columns to offset a responsive layout pane when displayed on an extra small screen. |
|
|
Small |
||||
|
Column Span Small |
0 |
IsResponsive= True |
Number of columns a pane can span when a responsive layout is displayed on a small screen. |
|
|
Column Push Small |
0 |
IsResponsive= True |
Number of columns to push a responsive layout pane when displayed on a small screen. |
|
|
Column Pull Small |
0 |
IsResponsive= True |
Number of columns to pull a responsive layout pane when displayed on a small screen. |
|
|
Show Pane Small |
True |
IsResponsive= True |
When set to True, a pane can be shown on a small screen. |
|
|
Pane Offset Small |
0 |
IsResponsive= True |
Number of columns to offset a responsive layout pane when displayed on a small screen. |
|
|
Medium |
||||
|
Column Span Medium |
0 |
IsResponsive= True |
Number of columns a pane can span when a responsive layout is displayed on a medium screen. |
|
|
Column Push Medium |
0 |
IsResponsive= True |
Number of columns to push a responsive layout pane when displayed on a medium screen. |
|
|
Column Pull Medium |
0 |
IsResponsive= True |
Number of columns to pull a responsive layout pane when displayed on a medium screen. |
|
|
Show Pane Medium |
True |
IsResponsive= True |
When set to True, a pane can be shown on a medium screen. |
|
|
Pane Offset Medium |
0 |
IsResponsive= True |
Number of columns to offset a responsive layout pane when displayed on a medium screen. |
|
|
Large |
||||
|
Column Span Large |
0 |
IsResponsive= True |
Number of columns a pane can span when a responsive layout is displayed on a large screen. |
|
|
Column Push Large |
0 |
IsResponsive= True |
Number of columns to push a responsive layout pane when displayed on a large screen. |
|
|
Column Pull Large |
0 |
IsResponsive= True |
Number of columns to pull a responsive layout pane when displayed on a large screen. |
|
|
Show Pane Large |
True |
IsResponsive= True |
When set to True, a pane can be shown on a large screen. |
|
|
Pane Offset Large |
0 |
IsResponsive=True |
Number of columns to offset a responsive layout pane when displayed on a large screen. |
|
|
Navigation |
||||
|
Enable Hierarchy Navigation |
True |
IsResponsive= True |
When set to True, a responsive layout pane supports Natural Navigation by touch gestures or graphic buttons. |
|
|
Show Navigation Buttons |
False |
IsResponsive= True |
When set to True, a responsive layout pane shows graphic buttons for Natural Navigation. |
|