Built-in controls and properties

The table is organized into these types:

  • Built-in controls: Controls that are available to all types of mashups.
  • Application controls: Controls that are available from the Application tab on the Properties pane of the design window. These are further organized by type of application. Only applications used at your site are available for selection.
  • Advanced properties: Properties that are available to any, or most, controls and are available from any settings dialog box by expanding the Advanced button.
Control Description Location Properties specific to this control
Button Add a toggle, enable or disable, option to your mashup. Buttons
  • Content: Use to type the text that appears on the label.
  • Is Cancel: Users can cancel a change they just made by pressing ESC.
  • Is Default: Users can activate this control by pressing the Enter key.
CheckBox Add a control that can be selected and cleared by the user. Buttons
  • Content: Use to type the text that appears on the label.

    Is Checked: The option is enabled.

ComboBox A box that allows for a drop-down list for single selections. Selections
  • Selected Index: Use this option to indicate the index of the child that should be the default. Zero 0 is the index of the first child in the list.
  • ComboBoxItem: Click Add to add items that will be available for your user to select.
DockPanel A panel control in which child elements are added to the panel relative to the position of other elements.

In general, a DockPanel needs more space than a StackPanel.

Panels Last Child Fill: specify if you want the last child control added to the DockPanel to always fill the remaining space regardless of any other value that you set on the last child control. This ensures that controls are aligned visually on the panel.
Expander Adds an arrow that, when clicked by a user, shows the control. Grouping Is Expanded: If enabled, the control name is visible under the expander.
Grid

A type of panel control that opens a new grid panel control, in the current grid. You can then add other controls to the new grid.

Grid panels have the most flexibility because items that you add are aligned along a horizontal or vertical grid.

Panels Specify the column width and row height for controls on this grid.
GridSplitter Split the screen into two horizontal or vertical segments. The user can scroll within the segments. Panels Select the type of splitter you want to use:
  • Horizontal
  • Vertical
  • Horizontal (Only Handle): Horizontally oriented splitter with no handle lines
  • Vertical (Only Handle): Vertically oriented splitter with no handle lines
GroupBox Draws a box around another element. Grouping On this settings window, select options for the border and for the child that will be contained within it.

Click the Create button to add a child element. You will be prompted to select the type of control to add. This can be any available control. The name you specify for new child control in the Name setting will automatically display next to the type.

Configure other settings for the control as needed.

Image Add and format a graphic.
Note: See the Microsoft Developer's Network (msdn.com) for additional information.
Other
  • Source: Browse for the location of the graphic
  • Stretch: Determines how the image should be stretched to fill its container.

    Options are:

    • Uniform: The image is scaled so that it fits completely within the output area. The image's aspect ratio is preserved.
    • Uniform to Fill: The image is scaled so that it completely fills the output area while preserving the image's original aspect ratio.
    • Fill: The image is scaled to fit the output area. Because the image height and width are scaled independently, the original aspect ratio of the image might not be preserved. That is, the image might be warped in order to completely fill the output container.
    • None: The image is not stretched to fill the output area. If the image is larger than the output area, the image is drawn to the output area. What does not fit is clipped.

    StretchDimensions: Determines how the image is scaled. Options are Both, UpOnly, DownOnly. In general, use Both for a small image, DownOnly for a large image.

Label Add a label to an item on the screen. Input
  • Content: Type the text that appears on the screen.
  • Is Header: If enabled, this label will be formatted as a header.
ListBox Add a list of options, multiple selections typically allowed. Selections Selected Index: Use this option to indicate the index of the child that should be the default. Zero 0 is the index of the first child in the list.

Click Add to add a ListBoxItem, an item for the list you are adding.

ListBoxItem Selections Specify the name of the item that will be available for your user to select.
Menu Add a menu structure to launch from the toolbar of your mashup.

Double-click the menu to add items.

Selections Separator: Add a line to separate this menu from others.
Menu Item Add individual items to a menu. These are the items that branch out from a menu and activate when a user mouses over them. Selections
  • Header: Add the name of the menu
  • Separator: Add a line to separate menu items
PasswordBox Add an input box for users to type passwords. Input
  • Text: Type the text that appears on the password box.

    Max Length: Maximum number of password characters.

RadioButton Add a single-choice-from-several-choices control in the round radio button format. Buttons
  • Content: Use to type the text that appears on the label.
  • Is Checked: The option is enabled.
  • GroupName: The name of the group that this option is associated with.
ScrollViewer A Scroll View enables content to be displayed in a smaller area than its actual size.

When the content of the Scroll Viewer is not entirely visible, the Scroll Viewer displays scroll bars that the user can use to move the content areas that is visible.

Grouping For each type of Scroll View that you are using, Horizontal or Vertical, select Scroll Viewer visibility:
  • Auto: Scroll bars are visible if needed.
  • Visible: Scrolbars are always visible.
  • Hidden: Scroll bars are always hidden.
  • Disabled: Scrolling is disabled.
Note: 1) The Infor Smart Office Design System does not recommend using horizontal scroll viewers. You can use the Hidden or Disabled properties to make sure a type of scroll viewer does not display in a mashup.

2) The Microsoft Developer's Network web site (msdn.com) has additional information about scroll viewers

Separator Control that is used to separate items in items controls. Other Use Horizontal: By default, separators are vertical. If this option is enabled, the separator is horizontal.
StackPanel A type of panel in which controls are added in the same direction, either vertical or horizontal.

When the size of the panel is a concern, a StackPanel can be a good choice.

Panels Orientation: Horizontal or vertical
Tab control A tab control is for adding a tab to a mashup.

After the tab is added, you can then add any control as a child of the tab. To add a child control to the tab, highlight an option from either the Application or Built-in tabs and then click the Add button. The new control is considered a child of the tab control.

To move a child up or down on the tab control, click it and then use the arrow icons to change position.

Selections Configure the tab that should be selected by default. This tab should be 0. 0 is the first option, 1 is the second and so on.
  • Selected Index:

    Selected Value Path:

  • Tab Strip Placement: Determines where on the grid the tab should be aligned. Choices are: Left, Top, Right or Bottom.
  • Hidden: Enable if you want the table to be hidden when not in use.
TextBlock Add an input box for short textual information. Input Text: Type the text that appears on the TextBlock.
TextBox Add an input box for users to add textual information. Typically, this would be for longer input. Word wrapping options are available. Input
  • Text: Type the text that appears on the TextBox.
  • Max Length: Maximum number of characters.
  • Min Length: Minimum required characters of user input.
  • Min Lines: Minimum required lines of user input.
  • Max Lines: Maximum allowed lines of user input.
  • Text Wrapping: Options for controlling text wrapping:
    • NoWrapping: Text that is too long will be truncated.
    • Wrap: Text is allowed to wrap.
    • WrapwithOverflow: Text is allowed to wrap and any text that does not fit in the TextBox is hidden but available through scrolling.
WrapPanel A panel control that positions child elements in sequential positions from left to right. Panels
  • Orientation: Horizontal or vertical
  • Item Width: Width of controls added to the panel. Specify Auto or a number in pixels.
  • Item Height: Height of controls added to the panel. Specify Auto or a number in pixels.