Action List editor

From RAD Studio
Jump to: navigation, search

Go Up to Property Editors Index


Use the Action List editor at design time to add actions to either a Vcl.ActnList.TActionList or an FMX.ActnList.TActionList component. You can also use this editor to edit other lists of items, such as TTetheringAppProfile.Actions or TTetheringAppProfile.Resources.

Opening the Action List Editor

  1. Select the TActionList object in either the Form Designer or the Structure View.
  2. Do either of the following:
    • Double-click the TActionList object.
    • Right-click the TActionList object and select Action List Editor from the context menu.

Toolbar

At the top of the Action List editor, there is a toolbar containing 4 buttons:

Button When Clicked

New Action

Inserts a new action into the list. Click the drop-down arrow next to the button to choose whether to add:

  • New Action--a new action that you define.
  • New Standard Action--a standard (predefined) action. If you choose New Standard Action, you will be presented with the Standard Action Classes dialog box, where you can choose the predefined action.

Delete

Deletes the action currently selected in the list boxes.

Up and Down Arrow buttons

Moves the currently selected action up or down to change its position in the list.

Toolbar's Context Menu

Right-click the toolbar to display the toolbar context menu. This menu contains one item:

Command When Clicked

Text Labels

Displays or hides the labels on the buttons in the toolbar.

Categories and Actions Panes

On the actions tab, the Categories and Actions panes list the actions in the action list being edited.

The Categories pane shows hierarchical tree of the names of the Actions.TContainedAction.Category properties of the actions in the action list. You can change the Category property of an action by selecting the action in the Actions pane and changing the Category property value in the Object Inspector. Notice that in the Object Inspector you can create a sub-category. For example, in the Categories pane of the Action List Editor, select the category File. In the Object Inspector, the Category property shows File. After File, type a dot and Export. As a result, Category shows File.Export. Here Export is the sub-category of the category File. You can add several actions into the Export sub-category. In the Categories pane, the Categories tree will show two levels of branches. The first level category File contains the second level Export sub-category containing several actions.

The Actions pane shows the Names of the actions in the Category selected in the left list. You can change the Name value by selecting the action and changing the value of the Name property in the Object Inspector.

Action List Editor's Context Menu

Right-click the lower portion of the Action List editor to display the context menu. This menu contains the following commands:

Command When Clicked

New Action

Adds a new (not predefined) action into the action list being edited in the Action List editor. You can then use the Object Inspector to edit its properties.

New Standard Action

Displays the Standard Action Classes dialog box, where you can select a predefined action.

Move Up

Moves the currently selected action toward the beginning of the list.

Move Down

Moves the currently selected action toward the end of the list.

Cut

Cuts the currently selected action from the clipboard, removing it from the action list.

Copy

Copies the currently selected action to the clipboard, without removing it from the action list.

Paste

Pastes actions from the clipboard, inserting them into the action list.

Delete

Deletes the currently selected actions from the action list.

Select All

Selects all actions in the Category selected in the Category pane.

Change Multiple Actions

Commands shown in Change Multiple Actions sub-menu depend on whether the context menu is activated in the Actions or in the Categories pane, as follows:

  • When activated in the Actions pane, commands in this sub-menu work on all actions selected in the pane. The Change Multiple Actions sub-menu shows the following commands:
    • Hide All Selected Actions
    • Show All Selected Actions
    • Disable All Selected Actions
    • Enable All Selected Actions
  • When activated in the Categories pane, commands in this sub-menu work on all actions in the selected category and in all its sub-categories. The sub-menu shows the following commands:
    • Hide All Actions in Selected Category
    • Show All Actions in Selected Category
    • Disable All Actions in Selected Category
    • Enable All Actions in Selected Category

Panel Descriptions

Displays or hides the titles of the left and right list boxes.

Toolbar

Displays or hides the toolbar.

See Also