Applies to AQtime 8.71, last modified on December 5, 2018

Creating Actions

The list of existing actions is displayed in the Triggers and Actions pane of the Setup panel. To create a new action, use the Add Action dialog. To call the dialog, perform one of the following steps:

  • Select Add Action from the context menu of the Setup panel or from the Setup toolbar.

  • Select Project > Add Actions from AQtime’s main menu.

  • Right-click an action in the Setup panel and then choose Edit from the context menu.

In the Add Action dialog, you can specify the following action properties:

  • In the Name field, specify the name of the action to be created.

  • In the Action Type section, specify an operation to be performed by the action: Enable Profiling, Disable Profiling, Get Results or Clear Results.

    Note: The Allocation profiler supports only the Get Results and Clear Results actions.
  • In the Execute Type field, specify when the action will be performed: On Enter or On Exit.

Once you close the dialog, the newly created action will be displayed in the Triggers and Actions pane and will be marked with an appropriate icon:

Actions executed upon entering the routine  Actions executed upon exiting the routine
- "Enable Profiling" action - "Enable Profiling" action
- "Disable Profiling" action - "Disable Profiling" action
- "Get Results" action - "Get Results" action
- "Clear Results" action - "Clear Results" action

Adding Elements to Actions

Once you have created an action, you can add routines to it. You can do this in the same manner as you add elements to profiling areas and triggers: by dragging the needed routines from the tree view in the Modules pane to the needed action. See also Adding Code to Areas and Creating, Editing and Deleting Triggers. You can also select the needed element in the tree view (you can use Shift and Ctrl for multiselection) and then choose Add Selected to Action > <action_name> from the context menu.

Some notes about adding elements to actions:

  • Adding a routine to an action is an analogue to adding a routine to a profiling area and profiling it with trigger settings that correspond to the action type. Below, are two examples:

    • Suppose that you have added a routine to an action of the Enable Profiling type (an analogue to an on-trigger), the action is performed upon entering the routine, and the routine is added to a routine-level area. In this case, AQtime will profile the routine at the routine level, and you will see the routine results in the Report panel.

      If the routine was added to a line-level area, AQtime would profile it at the line level. If the routine was not added to any area, AQtime would profile it at the routine level.

      Furthermore, if the action has the described settings, AQtime will profile the routine even if it is added to an excluding profiling area.

    • In the second scenerio, suppose that you have added a routine to the action of the Disable Profiling type (an analogue to an off-trigger), and the action is performed upon entering the routine. Regardless of whether the routine is added to any profiling area, the routine will not be profiled as AQtime disables profiling when the routine starts being executed.

    In other words, adding a routine to an action ignores the “area” settings for the routine, but does not ignore the “trigger” settings.

Modifying Action Properties

To check or change properties of an existing action, right-click this action in the Setup panel and select Edit from the context menu. This will call the Edit Action dialog where you can modify action properties.

The action settings are stored in the AQtime project file (.aqt).

Deleting Actions

To delete an action:

  • Right-click the action you want to delete and select Remove from the context menu.

  • AQtime will display a message box asking you if you want to delete the selected action. Click Yes to delete the action, or No to cancel the deletion.

See Also

Controlling What to Profile
About Actions
About Triggers

Highlight search results