- Vytvoril D2000 Dev Team na okt 13, 2017
OPEN action
grObjIdent | in | Reference to an object of Graph, Picture or Composition type. |
procIdent | in | Identifier of a Process type object (Human Interface). |
instanceExprInt | in | Expression of Int type, that specifies the object instance number . |
_xIdent | in | Int type - x coordinate of the opened object on the desktop of process D2000 HI. |
_yIdent | in | Int type - y coordinate of the opened object on the desktop of process D2000 HI. |
knlID | in | D2000 Server number in the multikernel system. |
Action with DIRECT clause is enabled in case of an active picture. A picture opened by this means (on identical process D2000 HI) is to be opened as a subpicture - there is to be executed copying INOUT variables (local variables of the picture) between pictures.
If the key word SYNC is used, the action will be terminated after the picture is opened. If the keyword SYNC is followed by the keyword END, the action will be terminated after closing the picture.
The USE_MDD parameter allows D2000 HI process to open a picture, without a link to picture location, from which the picture is opened. For example, if HI is in a multidisplay mode (uses multiple monitors) and the picture that used the OPEN ... DIRECT call (without the USE_MDD parameter) is on the monitor No.2, the picture being opened will be placed on monitor No.2. If the USE_MDD parameter is used, then opening proceeds according to the configuration in mdd.ini file and according to picture parameters.
The action allows to adjust (using a keyword OM_*) picture window type after opening by redefining the standard setting:
Window type | Keyword |
Normal | OM_NORMAL |
Dialog | OM_DLG |
Dialog-modal | OM_MODAL |
popup picture | OM_POPUP |
info picture | OM_INFO |
The keyword OM_POPUP can be only used along with the keyword DIRECT. Opening the picture as a popup requires definition of another parameters _xIdent and _yIdent, which defines the position of the window after opening it. The position is given in coordinates in regard to the picture, from which it is opened. Values are available in e.g. the active picture event OnMouseDown. If the parameters _xIdent and _yIdent are set to -1 and -1, the given window will be opened on the position of the mouse pointer.
This description is also applied for key word OM_INFO.
Picture opening as popup window - picture is opened like dialog active picture without title (it takes a focus of the active picture of process). If you click out of picture, it will be closed.
Picture opening as info window - picture is opened like dialog inactive picture with tight frame and without title. Picture is inactive (it does not take a focus of the active picture of process) if it contains only the graphic objects and window elements. Another nested objects can activate this picture. As the picture does not contain the title bar, it should have implemented an own closing mechanism.
Notice: OPEN action can failed if the picture has been opened in HI or if it is blocked in another HI (the application modal pictures).
Related pages:
Pridať komentár