Input Object

Here are the object's settings as they appear in the properties pane:

Object

Name

The name that is used to identify this object.

Text

The text that you want to display in the input object.

Font

The font that you want to use for the text. Click the edit button to open the Font dialog where you can edit all of the font settings.

Tip: You can set the default font for this object type by configuring its settings on the Objects tab in Edit > Preferences.

FontFamily

The font family that you want to use.

FontSize

The font size, in points.

FontBold

Make the text bolded.

FontItalic

Make the text appear in italics.

TextColor

The color to display user input text.

Tip: You can click the select button to bring up a color chooser. Clicking the "More Colors..." button on the color menu allows you to choose either a standard color/custom color, or use the eyedropper to pick a color from somewhere within the AutoPlay application window.

Alignment

The alignment to use. Choose from:

Left

Left-align the text within the input object, like so:

This text is left-aligned

Center

Center the text within the input object, like so:

This text is centered

Right

Right-align the text within the input object, like so:

This text is right-aligned

Options

MultilineEnabled

True if this object will be multi-lined, false if it will not be.

VerticalScrollbar

Include a vertical scroll bar for the object. Choose from:

True

Include a vertical scroll bar.

False

Don't include a vertical scroll bar.

HorizontalScrollbar

Include a horizontal scroll bar for the object. Choose from:

True

Include a horizontal scroll bar.

False

Don't include a horizontal scroll bar.

InputStyle

The display style of the text in the input object. Choose from:

Standard

Display the input text normally.

Password

Hide any text that the user types by displaying asterisks (****).

Note: The password feature is not available for the Multi Line style.

Input Mask

Control the text the user inputs into the object.

InputMask

The input mask you want to use to control the data the user inputs into the object. Input masks let you pre-format the user's response a bit with "guide" characters, and help prevent errors by performing keystroke validation.

One of the sample input masks available is a telephone number. It appears in the list as (###) ###-####. The "#" character in the input mask is a special digit placeholder (0-9). For every # in the input mask, the user will only be able to enter a digit between 0 and 9. At runtime, the user will only be able to enter 10 numeric characters and will appear as a formatted telephone number such as (204) 946-0263.

You can also include alphabetic characters in an input mask. For example, one of the sample input masks is ?#? #?# used to represent a Canadian postal code. The "?" character in the input mask is a special alphabetic placeholder (a-Z). For every ? in the input mask, the user will only be able to enter a letter from a to Z. For example, R3B 0R3 is one valid postal code that the user could enter. The mask would prevent the user from entering two sequential alphabetic characters or numbers.

PlaceholderCharacter

Single character used as a placeholder for the input mask. This can be used as sample input until the user fills the input mask. For the telephone number input mask mentioned in the above example, you could include a sample digit as the placeholder such as 9. At runtime it would appear as (999) 999-9999 until the user replaced these digits with their own.

Note: This field accepts a single character only. If the Placeholder is set to '_' in the example above, at runtime it would appear as (___) ___-____.  Likewise, if the placeholder is set to '?' at runtime it would appear as (???) ???-????.

InputMaskReturn

The input text to return. Choose from:

Formatted

Return only the text the user typed. This does not include any Input Mask characters.

As Typed

Return all text displayed in the input object. This includes any text displayed by the Input Mask.

Special

BorderMode

The border style to display around the input object. Choose from:

None

Don't display any border around the object.

Flat

Display a thin black border around the object.

Sunken

The object will have a "sunken" appearance on the page or dialog.

ReadOrder

The order the text will display when typed into the object. Choose from:

Standard

Display the text normally, from left to right.

Right to Left

If the shell language is Hebrew, Arabic, or another language that supports reading-order alignment, the text is displayed using right-to-left reading-order properties. For other languages, this style is ignored.

BackgroundColor

The background color to use for the object.

ReadOnly

Make the text in the object read-only so the user cannot type into it. Choose from:

True

Any text displayed in the object will be read-only. This means the user can copy the text, but cannot modify it.

False

Any text displayed in the object can be modified.

Attributes

TooltipText

A short string of text that will appear after the mouse hovers over this object for a moment.

Tip: You can choose from several tooltip styles for all tooltips in your project, Standard, Balloon and Extended. This setting can be found on the Appearance tab of the Project > Settings.

Tip: If you want a newline in your tooltip text, use "\r\n". For example, for an Extended tooltip, "My First Line\r\nMy Second Line|My Title". Newlines are not supported in the Title text for Balloon or Extended styles.

Tip: If you want a "&" character in the text, you must enter "&&&".

Enabled

Enable the object so it responds to user interaction. Choose from:

True

The object will respond to mouse overs and clicks and perform any actions assigned to its events.

False

The object will not respond to any mouse overs or clicks and will not perform any actions until it is enabled.

Note: You can use the Input.SetEnabled action to enable this object.

Visible

Set the object's initial visibility. Choose from:

True

The object will be visible when the page or dialog is displayed.

False

The object will be invisible when the page or dialog is displayed.

Note: You can use the Input.SetVisible action to make the object visible or invisible at run time.

Position

Left

The distance in pixels from the left edge of the object to the left edge of the page or dialog.

Tip: You can also change the position of an object by dragging it.

Top

The distance in pixels from the top edge of the object to the top edge of the page or dialog.

Width

The width of the object in pixels.

Tip: You can also resize an object by dragging one of the resize handles on its bounding box.

Height

The height of the object in pixels.

Auto-Resize

ResizeLeft

Whether the left side of the object will move when resized. Choose from:

True

The left side of the object will move when the application is resized.

False

Don't move the left side of the object when the application is resized.

ResizeRight

Whether the right side of the object will move when resized. Choose from:

True

The right side of the object will move when the application is resized.

False

Don't move the right side of the object when the application is resized.

ResizeTop

Whether the top of the object will move when resized. Choose from:

True

The top of the object will move when the application is resized.

False

Don't move the top of the object when the application is resized.

ResizeBottom

Whether the bottom of the object will move when resized. Choose from:

True

The bottom of the object will move when the application is resized.

False

Don't move the bottom of the object when the application is resized.

Actions

On Key

The actions that will be performed whenever the cursor is inside the input object and the user presses a key. Click the edit button to open the script editor.

On Focus

The actions that will be performed whenever the input object is given focus. For example, it will be given focus if the user clicks inside the object. Click the edit button to open the script editor.

On Char

The actions that will be performed whenever the cursor is inside the input object and receives the WM_CHAR windows message. This event will occur after the On Key event is fired, but will not necessarily be fired after each key stroke. This event is similar to the On Key event, except instead of being fired each time a key is pressed, On Char is fired when a keystroke (or a combination of keystrokes) translates to a character. Click the edit button to open the script editor.