Screen Design Page Properties

The Properties view shows properties for the main Hybrid App screen.

To display Screen Design page properties, click an empty area of the screen, so that no screen objects are selected.

General

Property Description
Name The name of the screen.
Key The key associated with the screen.
Background color The color value of the control background.

You can use the color picker, or manually enter the value. Valid values are color names (black, blue, brown, gray, green, orange, pink, purple, red, white, yellow) or strings in the format #rrggbb, where rr, gg and bb are the hexadecimal code values, in the range 0 to ff(255), for red, green, and blue.

Background image An optional image, selected using the Browse button. Default: no image.
Note: The image must be located in the project.
Background image repeat How the background image repeats within the control area. One of these values:
  • repeat – the image repeats.
  • no repeat – the image does not repeat.
  • inherit – the background image is inherited from the parent screen.
  • repeat-x – the background image repeats horizontally.
  • repeat-y – the background image repeats vertically.
OK action Select the action to perform when the user clicks OK on the screen.
Auto-arrange menus on iOS On iOS devices, automatically sorts menu items in the order specified in the screen design. If not selected, menu items are listed in alphabetical order.

Rulers & Grid

These properties enable you to customize the default layout of a screen design page in the Designer (when no objects on the Screen Design page are selected).

Property Description
Display
  • Show Ruler – Displays ruler units above and to the left of the page. Default: not shown.
  • Show Grid – Fills the page with a grid. Default: not shown.
  • Grid in Front – Displays the grid in front of screen objects. Default: the grid is in front. If unselected, the grid is behind objects.
Grid line
  • Color – A selected grid color, or a specified color code. Default: grey.
  • Style – A line style selected from the list. Default: Spaced Dot.
Measurement
  • Ruler Units – Available units: Inches (default), Centimeters, Pixels.
  • Grid Spacing – The space between grid lines, using your selected ruler units. Default: 0.125 inches, 0.318 cm, or 12 px.
Snap Automatically aligns objects that you relocate to specified locations on the screen.
  • Snap to Grid – Snaps objects to the grid lines on the canvas. Default: selected.
  • Snap to Shapes – Snaps objects to vertical and horizontal coordinates of the the edges of other objects.
Restore Defaults Sets the value of all ruler and grid properties to their default values, overwriting any customizations.

Keys

The Keys page lets you view and configure properties for keys that are associated with a screen. You can sort on any property in the table by clicking its column heading.

Property Description
Key name The name of the associated key.
Type The data type of the associated key, for example, string.
Data binding The data source (if any) to which the key is bound.

The view provides buttons to perform these operations on keys:

Parent topic: Screen Designs
Related tasks
Adding Images to the Project