Action class for edit functions: open a project, open a page with a name, open a page with a device name and open a page with name and set the cursor at x y coordinates.
Parameter | Description |
---|---|
PROJECTNAME |
Project name with full path (optional). If not entered, the selected project is used when the action is called from GUI (like from a script or the ribbon bar). If called from the windows command line, the PROJECTNAME must be set or the ProjectAction must be used first (see also "ProjectAction"), otherwise an exception is thrown (see also "System.ArgumentException"). |
PAGENAME |
Name of the page to be opened(optional). Required if X, Y have been specified as parameters. |
DEVICENAME |
Name of an item (optional). |
X |
X coordinate (optional). Parameter is only valid if the PAGENAME parameter is available. |
Y |
Y coordinate (optional). Parameter is only valid if the PAGENAME parameter is available. |
INSTALLATIONSPACE |
Name of the installation space too be opened (optional). not possible to use with PAGENAME |
DEVICENAME3D |
Name of an item inside of an installation space (optional). |
IGNOREWHENOPEN |
if set to true or 1, action calling is ignored when a project is already open |
The current action checks the parameters and execute the corresponding operation. One of the following operation will be done. The operation n° 1 has a highest priority and the operation n° 5 has the lowest priority. For example if a page name and device name are set, so the operation n° 1 will be executed. Otherwise it checks if it is possible to execute the remaining operations. If at all no parameter was set, soonly the project will be opened (operation n° 5). 1: Open a page with name and a device name. The device will be selected. If the given device was not found on the page, so the page will be opened and no element will be selected. In this case an error message will be inserted into message system. 2: Open a page with a name, X and Y coordinates. 3: Open a page only with a name. 4: Open a page which holds the first device name found. 5: Open a project. When an error occurs during an edit operation, a "BaseException" is thrown.