Objects have the general properties described in the following sections. These are grouped in two tabs that are available for all object types. (The specific tabs and properties differ for other object properties depending on the object type.)
General Properties Tab
Properties
This tab provides the fields that are needed to modify the object selected in the Window Objects pane.
A typical set of fields that can be modified are as follows:
| Property | Description |
|---|---|
| Object Title | This field shows the word or phrase that appears in the bar above the pane. See Note. |
| Object Left, Object Top | These fields set the position of the upper left corner of the pane within the window. See Note. |
| Object Right, Object Bottom | These fields set the position of the bottom right corner of the pane within the window. See Note. |
| Object Width | This field shows the width of the pane. See Note. |
| Object Height | This field shows the height of the pane. See Note. |
| Tab Index | This field sets the order in which the "focus" in the window moves from pane to pane. It is recommended that this be used only by AgileAssets personnel. |
| Custom Help | This field shows the Help information that is displayed when the Enable Custom Help check box on the Window Properties tab is selected and the icon is clicked. You cannot edit or enter text in this field directly. Instead, you should right-click the field to display a shortcut menu and then select the Edit Custom Help command. This command displays a rich-text editor that you may use to compose Help information. |
Typically, these fields are not edited directly. Instead, the size of the pane is adjusted by dragging the edges of the pane to the desired size.
Actions
When the User Control Properties dialog box is launched when record view is active (that is a window that shows only a single record and the columns appear as fields), command buttons are added to the General Properties tab for CSS file manipulation. These command buttons are described below:
| Action | Description |
|---|---|
| Get CSS | This command button sends the default format to a CSS file in a folder selected by you. This allows you to modify this CSS file (using third-party software) supplying the desired format. |
| Put CSS | This command button allows you to identify the CSS file (that now contains the desired formatting) that the application acquires and uses to format the pane. |
| Delete CSS | This command button removes the user-created CSS file that is formatting the pane and returns the pane to the default record view formatting. |
Menu Tab
Some windows objects do not have a user interface. These objects to not appear in the right click actions menu and will not display a Menu tab.
Properties
The Menu tab allows you to configure what commands appear in the right click actions menu (and in what order) that is displayed by right-clicking in the selected object. This tab provides the following properties:
| Property | Description |
|---|---|
| Menu Item ID | This column shows the internal identifier of the command. (To discover the actual label for the command that appears in the shortcut menu, look up the menu item ID in the Action Rights window.) |
| Order | This column sets the order of the commands in the shortcut menu (1 is the topmost position in the shortcut menu). |
| Right to See | This column sets the security level for the command. Only users with a security level equal to or greater than the value configured in this column will be able to see the command. |
| Confirm Required | When this check box is selected, the system will prompt the user to confirm actions (such as delete) before proceeding with the action. |
| Password Required | When this check box is selected, the system will prompt the user to enter his or her password before proceeding. |
| Show on Tool Bar | This creates a button at the top of the grid object for the action. |
| Action Handler Groovy Script | You may create a custom command that executes a groovy script when it is selected. This column lists the available groovy scripts, which are created by AgileAssets staff and stored in the database itself. Note: When you create a custom command, you must first create a menu item ID for the command in the Action Rights window and also request that AgileAssets create the Java script for the command's action. This is necessary because when you insert a new record in this tab, the system will ask you for the ID of the command. Similarly, in the new record, the Java script must be stored in the database so you can select it from the drop-down list in this column. |
| Action Handler JS Script | You may create a custom command that executes a Java script when it is selected. This column lists the available Java scripts, which are created by AgileAssets staff and stored in the database itself. (The Java scripts cannot be created or modified from within the application.) Note: When you create a custom command, you must first create a menu item ID for the command in the Action Rights window and also request that AgileAssets create the Java script for the command's action. This is necessary because when you insert a new record in this tab, the system will ask you for the ID of the command. Similarly, in the new record, the Java script must be stored in the database so you can select it from the drop-down list in this column. |
| BeforeOpen Script | This column contains a drop-down list of BeforeOpenMenu-type Groovy scripts, which are configured in the Groovy Scripts window. These scripts affect the display of the command in the shortcut menu (not the action of the command itself). For example, you could select the Groovy script that hides the command when a user displays the shortcut menu. |
| Custom Help | This field shows the Help information that is displayed when the Enable Custom Help check box on the Window Properties tab is selected and the icon is clicked. You cannot edit or enter text in this field directly. Instead, you should right-click the field to display a shortcut menu and then select the Edit Custom Help command. This command displays a rich-text editor that you may use to compose Help information. |
