Areas are listed in the Code to Profile, Classes to Profile and Collect Stack Information panes of the Setup panel. By default, each project includes four predefined areas. Besides that, you can create a new area and include some needed elements in it. The following sections describe how you can create, modify and delete custom areas:
Creating New Areas
To create a new area, use the Add Area dialog. To call the dialog, perform one of the following actions:
Right-click somewhere within the Code to Profile, Classes to Profile or Collect Stack Information pane and select Add Area from the context menu.
Note: Depending on the selected profiler, the mentioned context menu item is called either Add Class-Level Area, Add Profiling Area or Add Stack Area.
Click Add Area on the Setup toolbar.
Note: Depending on the selected profiler, the mentioned button is called either Add Class-Level Area, Add Profiling Area or Add Stack Area.
- Select the appropriate subitem from the Add Selected to Setup item of the context menu in the Report panel.
- Select the New Area subitem from the appropriate Add Selected to Area item of the context menu in the Modules pane.
Note: Depending on the selected profiler, the mentioned context menu item is called either Add Selected to Class-Level Area, Add Selected to Profiling Area or Add Selected to Stack Area.
Select Project > Add Area from AQTime's main menu.
Note: Depending on the selected profiler, the mentioned menu item is called either Project > Add Class-Level Area, Project > Add Profiling Area or Project > Add Stack Area.
In the ensuing dialog, specify the area properties:
In the Name field, specify the name of the area to be created.
In the Type section, choose the area type: Including or Excluding.
For profiling and stack areas, you can specify a profiling level. Select the Collect info about lines check box if you want to profile code at line level. If you want to collect information on routines only, clear this check box.
Once you close the dialog, the new area will be displayed in the respective pane and it will be marked with the appropriate icon:
- Including class-level area
- Excluding class-level area
- Including profiling or stack area (routine level)
- Excluding profiling or stack area (routine level)
- Including profiling or stack area (line level)
Once the area is created, you can add elements to it (see Adding Code to Areas).
Editing Area Properties
To modify the properties of an existing area, double-click the desired area (or right-click it and choose Edit Area from the context menu). Then, modify the area name, type or profiling level in the subsequent dialog.
|Note:||Depending on the selected profiler, the mentioned context menu item is called either Edit Class-Level Area, Edit Profiling Area or Edit Stack Area.|
To delete an area from a project, do one of the following:
Right-click the area you want to delete and select Remove from the context menu.
Select the area you want to delete and press Delete
Drag the area you want to delete to the Modules pane.
AQTime will display a message asking you if you want to delete the selected area. Click Yes to delete the area, or No to cancel the deletion.
Auto-Converting of Areas
To simplify profiling of the same application part with multiple profilers, AQTime automatically converts profiling areas to stack areas in your projects. You can switch between different profilers and your custom areas will be automatically converted to the area of the appropriate type. Converted areas include all the elements that were added to the area before the conversion. For more information, see Auto-Converting of Areas.