Vcl.ActnMan.TActionManager

From RAD Studio API Documentation
Jump to: navigation, search

Vcl.ActnMan.TCustomActionManagerVcl.ActnList.TCustomActionListSystem.Actions.TContainedActionListSystem.Classes.TComponentSystem.Classes.TPersistentSystem.TObjectTActionManager

Delphi

TActionManager = class(TCustomActionManager)

C++

class PASCALIMPLEMENTATION TActionManager : public TCustomActionManager

Properties

Type Visibility Source Unit Parent
class public
Vcl.ActnMan.pas
Vcl.ActnMan.hpp
Vcl.ActnMan Vcl.ActnMan

Description

TActionManager provides a mechanism to manage and display all actions contained in an application.

The action manager component allows you to specify layout information for custom user-defined actions and standard actions that are contained in an application and a set of controls that can "render" this information as UI elements.

The action manager allows you to add any of the standard actions to your application and drag and drop any action in your application to an action band, where it will automatically render as a UI element.

The action manager contains all of the layout information necessary to create menus, toolbars, and Navigation bars (Outlook bars) automatically. The layout information includes:

  • Order of appearance
  • Reference to an action, which includes the action's Caption, ShortCut, Visible, and so on.
  • Color
  • Background

The action manager stores this information in a streamable object (TActionClientItem) that can be written to disk, as a text or binary file. The action manager then uses this information to reconstruct the UI elements when the application is started again and displays them on an action band component. Because the action manager is able to maintain state information, it also adds the ability to allow the user of the application to customize the UI elements that are displayed on the action bands. This is easily done by dragging the standard action, TCustomizeActionBars, from the Action Manager editor and dropping it on an action band.

Additionally, the action manager maintains usage data about the items. This allows you to automatically hide infrequently used items in the UI (User Interface), making for a cleaner, more effective UI.

See Also