Control settings

Return to Introduction  Previous page  Next page

Each control type has it's own prompts. This chapter describes each control type.

 

Choose a control type from the droplist in the template.

 

ctrltpl_Control

 

Available control types:

Bullet Button

Bullet CheckButton

Bullet RadioButton

Bullet MimicButton

Bullet DropButton

Bullet DropCombo

Bullet Entry

Bullet Text

Bullet Separator

Bullet Spacer

 

Most controls has an Actions-tab.

 

Button

The button control is a simple toolbar button. When the button is clicked, the selected action is executed.

 

 

ctrltpl_Button_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Text

Control visible text. You can specify a variable by prefixing it with '!'. Eg. !MyVariable

If you put an & in front of a character, the character will be the hotkey for this control. Pressing Alt+<hotkey> will execute the control action.

If you want a & to appear in the text, use double ampersands (&&).

 

Icon

An icon for the control

 

DisabledIcon

Icon to use when control is disabled.

If you leave this prompt empty, the toolbar will create a temporary gray scaled version of the control icon, which will be used when the control is disabled.

 

Tooltip

Tooltip for the control

 

Disable

If this option is checked, the control is initially disabled

 

Hide

If this option is checked, the control is initially hidden

 

Width

You can use this option to set a width for the control (in pixels).

 

 

CheckButton

A checkbutton is a button that can be set to checked. If a button is checked, it will be drawn highlighted.

 

ctrltpl_Checkbox_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Text

Control visible text. You can specify a variable by prefixing it with '!'. Eg. !MyVariable

If you put an & in front of a character, the character will be the hotkey for this control. Pressing Alt+<hotkey> will execute the control action.

If you want a & to appear in the text, use double ampersands (&&).

 

Icon

An icon for the control

 

DisabledIcon

Icon to use when control is disabled.

If you leave this prompt empty, the toolbar will create a temporary gray scaled version of the control icon, which will be used when the control is disabled.

 

Tooltip

Tooltip for the control

 

Disable

If this option is checked, the control is initially disabled

 

Hide

If this option is checked, the control is initially hidden

 

Checked

If this option is checked, the control will be initially checked.

 

Width

You can use this option to set a width for the control (in pixels).

 

RadioButton

A radiobutton is a button that can be set to checked. If a button is checked, it will be drawn highlighted.

When a radio becomes checked, it will uncheck all radios next to it, on both sides.

 

ctrltpl_Radio_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Text

Control visible text. You can specify a variable by prefixing it with '!'. Eg. !MyVariable

If you put an & in front of a character, the character will be the hotkey for this control. Pressing Alt+<hotkey> will execute the control action.

If you want a & to appear in the text, use double ampersands (&&).

 

Icon

An icon for the control

 

DisabledIcon

Icon to use when control is disabled.

If you leave this prompt empty, the toolbar will create a temporary gray scaled version of the control icon, which will be used when the control is disabled.

 

Tooltip

Tooltip for the control

 

Disable

If this option is checked, the control is initially disabled

 

Hide

If this option is checked, the control is initially hidden

 

Checked

If this option is checked, the control will be initially checked.

 

Width

You can use this option to set a width for the control (in pixels).

 

DropCombo

 

ctrltpl_DropCombo_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Text

Control visible text. You can specify a variable by prefixing it with '!'. Eg. !MyVariable

 

Prompt

Optional text to show in front of the DropCombo.

 

Disable

If this option is checked, the control is initially disabled

 

Hide

If this option is checked, the control is initially hidden

 

Readonly

Control is read-only, and can not be edited by the user.

 

Resize

Resize the control to maximum available width

 

Width

You can use this option to set a width for the control (in pixels).

 

Items

ctrltpl_DropEntry_Item

 

Text

Display text for this item

 

ItemID

A numeric ID to use for the item. If you leave this field empty, items will be enumerated, starting with ID=1.

You can specify a variable by prefixing it with '!' (eg. !MyVariable)

 

Actions

DropCombo controls has no item actions

 

Text

The Text control is a static control with no actions. It's only intended to add descriptive text to the toolbar.

 

ctrltpl_Text_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Text

Control visible text. You can specify a variable by prefixing it with '!'. Eg. !MyVariable

 

Hide

If this option is checked, the control is initially hidden

 

Width

You can use this option to set a width for the control (in pixels).

 

 

Separator

The separator control draws a vertical bar.

 

ctrltpl_Separator_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Hide

If this option is checked, the control is initially hidden

 

 

DropButton

A DropButton is a button that opens a drop-list with multiple items to choose from. A drop-button can also be split into a button-area, and a drop-area.

 

ctrltpl_DropButton_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Text

Control visible text. You can specify a variable by prefixing it with '!'. Eg. !MyVariable

If you put an & in front of a character, the character will be the hotkey for this control. Pressing Alt+<hotkey> will execute the control action.

If you want a & to appear in the text, use double ampersands (&&).

 

Icon

An icon for the drop button.

 

DisabledIcon

Icon to use when control is disabled.

If you leave this prompt empty, the toolbar will create a temporary gray scaled version of the control icon, which will be used when the control is disabled.

 

Tooltip

Tooltip for the control

 

Disable

If this option is checked, the control is initially disabled

 

Hide

If this option is checked, the control is initially hidden

 

Split

Indicates that this is a split-button. Split buttons can have actions for both the button and any drop-items.

 

Width

You can use this option to set a width for the control (in pixels).

 

Items

DropButton_Items_Icons

 

Text

Display text for this item.  To add a separator just use a single dash/hyphen: "-"

 

ItemID

A numeric ID to use for the item. If you leave this field empty, items will be enumerated, starting with ID=1.

You can specify a variable by prefixing it with '!' (eg. !MyVariable)

 

Icon

You can specify an icon for the menu items in the drop menu. 

 

Actions

The settings for DropCombo item actions is the same as for control actions.

 

Entry

The entry control provides the user a possibility to write text in the toolbar.

 

ctrltpl_Entry_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Text

Control visible text. You can specify a variable by prefixing it with '!'. Eg. !MyVariable

 

Prompt

Optional text to show in front of the DropCombo.

 

Disable

If this option is checked, the control is initially disabled

 

Hide

If this option is checked, the control is initially hidden

 

Readonly

Control is read-only, and can not be edited by the user.

 

Resize

Resize the control to maximum available width

 

Width

You can use this option to set a width for the control (in pixels).

 

 

Spacer

Spacers are invisible controls used to add space between other controls.

 

ctrltpl_Spacer_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Resize

Resize the control to maximum available width

 

Width

You can use this option to set a width for the control (in pixels).

 

 

MimicButton

A mimicbutton is a button mimicing a Clarion button. The mimicbutton can get it's text, icon and tooltip from the mimiced button. A mimicbutton also follows the enabled/disabled state of the mimiced button. When the mimicbutton is clicked, an EVENT:Accepted is posted to the mimiced button.

 

ctrltpl_MimicButton_Settings

 

Name

This is a descriptive name for the control.

 

ID

The ID equate label for the control.

 

Button

The label of the button you want to mimic.

 

Text

If this option is checked, the MimicButton will get it's text from the button

 

Icon

If this option is checked, the MimicButton will get it's icon from the button

 

Tooltip

If this option is checked, the MimicButton will get it's tooltip from the button

 

Hide

If this option is checked, the control is initially hidden

 

Width

You can use this option to set a width for the control (in pixels).

 



Direct link to this page on our website: http://www.icetips.com/manuals/powertoolbar/controlsettings.htm