Supercharge your Proficy solution! Download a free trial of Proficy Operations Hub, CSense analytics, and more. Explore our Proficy 2024 releases!

Home
Forms and User Displays
Designer Panels
Designer: Control Toolbox
The Designer supports native .NET 4.5 controls and containers, third party .NET 4.5 controls, and has many of its own .NET controls available. The Designer does not support Silverlight controls or 2D shapes or drawing capabilities.
Common Controls
Workflow provides a series of common controls to use in forms and user display authoring.
Masked Text Box
A Masked Text Box control uses a mask to distinguish between proper and improper user input.

Workflow IPI
Get Started
Tutorials
Orientation
Configure Your Environment
Security
Resource Information and Configuration
Data Administration
Forms and User Displays
- Forms Introduction
- Designer Panels
  - Designer Panels
    The Designer workspace is comprised of a number of panels that are used for designing your forms and user displays. Each panel performs a different function and may or may not be required for your design purposes.
  - Designer: Project Panel
    The Project panel in the Designer allows you to view the project structure and provides the ability to create new XAML and library (DLL) files, open existing files, and add new folders and/or classes to your project. You can also choose to build or build and run your project. These tasks can all be performed from the right-click menu.
  - Designer: Document Tree
    The Document Tree panel contains the document tree that corresponds to the XAML document you are currently editing. The document tree is a hierarchal visual representation of all the elements in your workspace.
  - Designer: Control Toolbox
    The Designer supports native .NET 4.5 controls and containers, third party .NET 4.5 controls, and has many of its own .NET controls available. The Designer does not support Silverlight controls or 2D shapes or drawing capabilities.
    - Add a control
    - Configure control properties
    - Set up control layout
      This information applies to both the WPF and Silverlight Designers. In the WPF Designer, some .NET Winforms controls (and controls written for other technologies) have the same names, but have different properties, methods, and events exposed than their WPF counterparts.
    - Batch Controls
      Batch controls cause multiple events to occur.
    - Button Controls
      A button is a control that causes an event to occur each time it is pressed and released.
    - Common Controls
      Workflow provides a series of common controls to use in forms and user display authoring.
      - Add content to an Expander control
        The Expander control is used with a Panel or Grid control.
      - Add an image
      - Button
        A Button is a control you can click to provide input to an application. A button's appearance can change by adjusting its background, foreground, or size, but its behavior can also change if adjustments are made to the actions connected to the click event.
      - Calendar
        The Calendar control is a Silverlight control that allows you to select a date by using a visual calendar display.
      - Check Box
        Check Box controls are used for groups of non-exclusive items, where more than one item in the group can be selected at the same time.
      - Expander
        An Expander is a control that organizes objects by providing a heading and the ability to expand or collapse the contents.
      - Hyperlink
        The Hyperlink is a Silverlight control that allows you to add a link to navigate to a web page or other Silverlight object.
      - Image
        An Image control allows you to add pre-designed graphic images or pictures to your form.
      - Label
        A Label control is used for labeling objects in your form.
      - Masked Text Box
        A Masked Text Box control uses a mask to distinguish between proper and improper user input.
      - Password Box
        A Password Box control is a type of text box used specifically to create a password control.
      - Progress Bar
        The Progress Bar is a control with built-in, looped animation and is used to show that an operation is in progress. An animated progress bar indicates that a user must wait before performing another task.
      - Radio Button Item [add]
        Radio Button controls are used to select a single option from a group of choices when paired with other radio buttons. Unlike check boxes, radio buttons are used for groups where an operator must make an either/or choice from a group of mutually exclusive options. Within the group, no two radio buttons can be selected at one time.
      - Repeat Button
        The Repeat Button triggers its click event repeatedly while it is pressed.
      - Rich Text Box
        A Rich Text Box is an enhanced text box control that provides advanced formatting features.
      - Scroll Bar
        The Scroll Bar control is used to facilitate scrolling; for example, through a list of items or a document with substantial content. Scroll bars can have either horizontal or vertical orientation.
      - Slider
        The Slider control enables you to select a value from a range of values, usually from a minimum to a maximum, along a continuum. For example, the volume on a stereo. The left-hand side usually represents minimum value and the right-hand side usually represents high (the maximum) value, with a range of values in between.
      - Text Block
        The Text Block control is used for entering and editing blocks of text. This control has properties for multi-line text wrapping and alignment, which makes it effective for the layout of larger sections of text.
      - Text Box
        The Text Box control is used for entering and editing alphanumeric text. This is a very basic control as it accepts only text as content.
      - Toggle Button
        The Toggle Button control differs from Button or Repeat Button controls in that it toggles on and off.
      - Validating Text Box
        The Validating Text Box control allows you to add a text box to your project that requires a valid entry. The validating text box displays a colored border until a valid value is entered.
    - Container Controls
      Container controls can contain a single child control that is manipulated by the parent control.
    - Date and Time Controls
      Date and time controls allow you to add clocks and interactive calendars to a display.
    - Gauge Controls
      Gauge controls are data-bound controls that allow you to view quantitative information in a visual format.
    - Grids and Panels
      Workflow provides a series of grids and panels to use in forms and user display authoring.
    - Indicator Controls
      Indicator controls are used to graphically display states and values. A standard indicator has an on and off state and is not dependent on a numeric value. A level indicator displays the state associated with the value assigned to the control.
    - Input Controls
      Input controls are used to input data to write to a server.
    - Items Controls
      Items controls display collections of child controls. These controls have inherent behaviors that manage the appearance of their child controls.
    - Label Controls
      Label controls are used to display text and/or numeric values for real-time data.
    - Language Switching
      The Designer provides a language switching control that allows you to change the text in a form or user display from one language to another during run time.
    - LED Controls
      LED controls have on, off, and pulse abilities and, when grouped, can display alphabetical, numerical, or symbolic characters.
    - Media Controls
      The media of a communications session is the form in which the data is transmitted. Media controls allow an application to recognize a variety of media types and adjust aspects of the media stream, such as the volume of voice transmission.
    - Miscellaneous Controls
      The Miscellaneous controls group contains controls that would otherwise be ungrouped.
    - Motor and Fan Controls
      Motors controls are graphical representations of motors, fans, and pumps, and rotary controls.
    - Pipe and Tank Controls
      Pipe controls are used to display the directional movement of vapors, liquids, or semi-solids. Tank controls display the level of the tank content relative to the top or bottom, and as a percent of the total tank capacity level.
    - Custom Controls
      The Designer provides the following group of custom controls.
    - Scrolling Controls
      Scrolling controls provide the ability to display text in a scrolling manner.
    - Shapes
      Shapes, such as the rectangle, ellipse, line, and path, are an important foundation for creating drawings and graphic designs. Shapes are normally used on a canvas, but can be used in other containers as well.
    - Slider Controls
      Sliders allow you to graphically manipulate the value of the control within a finite range by moving a thumb or value indicator along a track.
    - Viewer Controls
      The Designer provides the following group of custom viewer controls.
  - Designer: Resources
    The Resources tab contains images that you can use in your forms or user displays.
  - Designer: Properties Panel
    Each control available in the Toolbox has properties that you can configure. These properties can be used to change the appearance of the control, as well as certain functionality.
  - Navigate URI
    The Navigate URI dialog box is used throughout the Designer to select source files to use within a form or user display.
  - Designer: Parameters Panel
    The Parameters panel allows you to configure input and output parameters that you can use to bind control properties to.
  - Designer: Data Items Panel
    The Data Items panel allows you to configure data items that you can use to bind control properties to.
  - Designer: Form Events Panel
    The Form Events panel allows you to configure events that can be raised from this form. The form events you configure are available to workflows using this form.
  - Designer: Server Methods
    The Server Methods panel allows you to configure service interfaces that can be called from the current form or user display. The server methods available are also used to configure call methods in workflows.
  - Designer: Client Methods
    The Client Methods panel allows you to configure client-specific methods that can be called from the current form or user display.
  - Server and Client Methods Events
    Each method exposes event triggers that you can use to further configure your form or display.
  - Designer: Test Panel
    The Test panel allows you to view the results of a form or user display when you build and run in the Designer.
  - Designer: Default Properties
    The Default Properties panel allows you to configure default drawing properties for the control currently set as the active layer.
  - Designer: Preview Panel
    The Preview panel allows you to view the form or user display before you build it.
- Display and Group Duplication
- Form Templates
- Basic Forms and Displays
- Web-Based Forms and Displays
- Existing Assembly Options
- Form Development in Visual Studio
- Form Development in Silverlight
Building and Configuring Workflows
eSOP
ActiveX Task Controls
Service Interfaces
Operator Task List in the Workflow Client
Best Practices

Masked Text Box

A Masked Text Box control uses a mask to distinguish between proper and improper user input.

Using a masked text box, you can specify the following input without writing any custom validation:

Required input characters.
Optional input characters.
The type of input expected at a given position in the mask; for example, a digit, or an alphabetic or alphanumeric character.
Mask literals, or characters that should appear directly in the MaskedTextBox control; for example, the hyphens (-) in a phone number, or the currency symbol in a price.
Special processing for input characters; for example, to convert alphabetic characters to uppercase.

See Common Controls to view the usage and description of the properties for this control.