ActionControl
The ActionControl control displays a button that users click to open a panel with actions. Users trigger an action by clicking an action item, and you can specify what the action is (for example, JavaScript, which opens a new dialog box). You use the ActionControl control to give users quick access to a set of actions that are useful in the context that they are in.
The panel is similar to a “ribbon,” and you can organize the panel in columns and groups. Users can mark actions as favorites by clicking the “star” icon that the ActionControl always displays next to the action items. SPEAK displays favorites as buttons to the left of the button that opens the panel. Users can remove a favorite by clicking the star icon again. Favorites are stored for the current page in each user profile.
You cannot add actions to an ActionControl “on-the-fly” (from PageCode or other code) because ActionControls are created and rendered on the server.
Properties
|
Name |
Description |
Default |
|---|---|---|
|
Behaviors | ||
|
DataSource |
Specify the ActionControl item you use to define the content of the ActionControl panel. | |
|
Menu | ||
|
Text |
Specifies the text on the button. | |
|
Data | ||
|
Data |
Specify data that an action can use when it is clicked. |
True |
|
State | ||
|
IsStateDiscarded |
If true, user selections (such as favorites) do not persist across page loads. |
False |
Configuration
You can create a configuration item for an ActionControl by creating an item based on the ActionControl Parameters template.
The configuration item has these specific fields:
-
Text - this field corresponds to the Text property and you use the field to make it easier to translate UI texts.
-
Menu
It inherits these fields:
-
IsEnabled
-
IsVisible
-
AccessKey
-
Tooltip
-
Behaviors
-
Id