Appearance Preferences for Controls

Set the preferences for the appearance of the Device Application Designer controls.

Control	Preferences
Label	Wrap to multiple lines – select to truncate and wrap text that is too long to fit on one line to multiple lines. Style – select the label style from the drop-down menu. Span Horizontal – select the number of columns the widget will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the widget will occupy. Alignment Horizontal Inheritance – the control inherits the properties that are set for the container in which it is contained. If it is not in a container, it inherits the properties set in the Display. Left – left-justified alignment. Center – centered alignment. Right – right-justified alignment. Vertical Top – positions the control at the top of the span. Center– positions the control in the center of the span. Bottom – positions the control at the bottom of the span.
Edit Box	Show border – select to show the edit box border on the device. Empty string means null – when this option is selected a null value is passed to the server if the user leaves the input field empty. Some backend systems require this behavior. Note: This option is enabled only for the STRING data type. Style – select the edit box style. Span Horizontal – select the number of columns the edit box will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the edit box will occupy.
Choice	Empty string means null – when this option is selected a null value is passed to the server if the user leaves the input field empty. Some backend systems require this behavior. Note: This option is enabled only for the STRING data type. Style – select the style for the choice widget. Span Horizontal – select the number of columns the choice widget will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the choice widget will occupy.
Hyperlink	Text equals value – select so that, by default, the text entered in the Hyperlink text edit box is treated as the hyperlink value. Focus style – select the style for the hyperlink when it is the object of focus. Unfocus style – select the style for the hyperlink when it is not the object of focus. Span Horizontal – select the number of columns the hyperlink will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the hyperlink will occupy. Alignment Horizontal Inheritance – the control inherits whatever properties are set for the container in which it is contained. If it is not in a container, it inherits the properties set in the Display. Left – left-justified alignment. Center – centered alignment. Right – right-justified alignment. Vertical Top – positions the control at the top of the span. Center– positions the control in the center of the span. Bottom – positions the control at the bottom of the span.
Checkbox/Switch	Style – select the style for the checkbox or switch. Span Horizontal – select the number of columns the checkbox or radio button will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the checkbox or radio button will occupy. Alignment Horizontal Inheritance – the control inherits the properties that are set for the container in which it is contained. If it is not in a container, it inherits the properties set in the Display. Left – left-justified alignment. Center – centered alignment. Right – right-justified alignment. Vertical Top – positions the control at the top of the span. Center – positions the control in the center of the span. Bottom – positions the control at the bottom of the span.
Radio Button/Segment	Text equals value – select so that, by default, the text entered in the Radio Button/Segment text edit box is treated as the Radio Button/Segment value. Span Horizontal – select the number of columns the checkbox or radio button will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the checkbox or radio button will occupy. Alignment Horizontal Inheritance – the control inherits the properties that are set for the container in which it is contained. If it is not in a container, it inherits the properties set in the Display. Left – left-justified alignment. Center – centered alignment. Right – right-justified alignment. Vertical Top – positions the control at the top of the span. Center – positions the control in the center of the span. Bottom – positions the control at the bottom of the span.
List Item	Focus style – select the style for the list item when it is the object in focus. Unfocus style – select the style for the list item when it is not the object of focus.
Button	Focus style – select the style for the button when it is in focus. Unfocus style – select the style for the button when it is not in focus. Span Horizontal – select the number of columns the button will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the button will occupy. Alignment Horizontal Inheritance – the control inherits whatever properties are set for the container in which it is contained. If it is not in a container, it inherits the properties set in the Display. Left – left-justified alignment. Center – centered alignment. Right – right-justified alignment. Vertical Top – positions the control at the top of the span. Center– positions the control in the center of the span. Bottom – positions the control at the bottom of the span.
Image Spacer	Show spacing occupied – select if you want the image or spacer to completely fill the region of the display it occupies. Span Horizontal – select the number of columns the image or spacer will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number or rows the image or spacer will occupy.
Separator	Separator thickness – select the thickness of the separator line, in pixels. Style – select the style for the separator. Horizontal span – select the number of columns the separator will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display.
Grid Table	Select styles for: Header style Odd row style Even row style Pending style Border style Focus style Support sorting – select for the ability to sort on columns in the table and enter a name for the sort menu label. Support paging – select to enable paging on the record data in the column. Start paging record number – enter the number of records the table should contain before it starts paging. The minimum number for paging records is 25, the maximum is 10000. Paging record size – enter the number of records to store in the table page. The minimum number for paging records is 25, the maximum is 10000. Number of pages to cache – enter the number of table pages to cache in memory. The minimum number for paging records is 2, the maximum is 10.
Cell Table	Focus style – select the style for the cell when it is in focus. Unfocus style – select the style for the cell when it is not in focus. Number of columns – select the number of columns the cell table will have. Assign percentages – the width of each column in the cell table, in percentages. The defaults are 33% for the first column, 34% for the second column, and 33% for the third column. Support sorting – select for the ability to sort on columns in the table and enter a name for the sort menu label. Support paging – select to enable paging on the record data in the column. Start paging record number – enter the number of records the table should contain before it starts paging. The minimum number for paging records is 25, the maximum is 10000. Paging record size – enter the number of records to store in the table page. The minimum number for paging records is 25, the maximum is 10000. Number of pages to cache – enter the number of table pages to cache in memory. The minimum number for paging records is 2, the maximum is 10.
Cell Label	Wrap to multiple lines – select to truncate and wrap text that is too long to fit on one line to multiple lines. Focus style – select the style for the cell label when it is in focus. Unfocus style – select the style for the cell label when it is not in focus. Span Horizontal – select the number of columns the cell label will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the cell label will occupy. Alignment Horizontal: Inheritance – the control inherits whatever properties are set for the container in which it is contained. If it is not in a container, it inherits the properties set in the Display. Left – left-justified alignment. Center – centered alignment. Right – right-justified alignment. Vertical: Top – positions the control at the top of the span. Center– positions the control in the center of the span. Bottom – positions the control at the bottom of the span.
Cell Image	Scale proportionally – large images will be scaled to fit. Selecting this option preserves the width and height ratio. Span Horizontal – select the number of columns the cell image will occupy. The number must be greater than zero, and less than or equal to the number of columns in the screen display. Select All to set the horizontal span across the display. Vertical – enter the number of rows the cell image will occupy. Alignment Horizontal: Inheritance – the control inherits whatever properties are set for the container in which it is contained. If it is not in a container, it inherits the properties set in the Display. Left – left-justified alignment. Center – centered alignment. Right – right-justified alignment. Vertical: Top – positions the control at the top of the span. Center– positions the control in the center of the span. Bottom – positions the control at the bottom of the span.
List Detail	Select the styles for: Odd row style Even row style Pending style Border style Focus style Assign percentages – the width of each column in the list detail, in percentages. The defaults are 50% for the first column and 50% for the second column Horizontal alignment – choose the horizontal alignment for the columns: Inheritance – the control inherits whatever properties are set for the container in which it is contained. If it is not in a container, it inherits the properties set in the Display. Left – left-justified alignment. Center – centered alignment. Right – right-justified alignment. Use hot keys – select to allow users to customize hot keys for Previous and Next operations. You can select hot keys from characters a through z. The defaults are p and n, for Previous and Next, respectively. Show previous and next options in menu – display Previous and Next operations in the device menu. By default this option is selected. These menu options display dynamically at runtime on the device. Previous menu label – the label of the Previous menu. The menu label appears only when the Previous menu is shown dynamically at runtime on the device. Next menu label – the label of the Next menu. The menu label appears only when the Next menu is shown dynamically at runtime on the device
Navigation Bar	Show back button – select if you want the back button to display on the navigation bar. If the screen is the first screen, this button is not available to device users. Style – select the navigation bar style. Border style – select the navigation bar border style.