Gx6021Panel (pnHandle, hwndParent, nMode, phwndPanel, pnStatus)
Name |
Type |
Comments |
nHandle |
PSHORT |
Handle to a GX6021 board. This number may be zero if the board is to be initialized by the panel window. |
hwndParent |
HWND |
Sets the panel parent window handle. A value of 0 sets the desktop as the parent window. |
nMode |
SHORT |
The mode in which the panel main window is created. 0 for modeless and 1 for modal window. |
phwndPanel |
LPHWND |
Returned window handle for the panel (for modeless panel only). |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The function is used to create the virtual panel. The panel window may be opened as a modal or a modeless window, depending on the nMode parameters.
If the mode is set to modal dialog (nMode=1), the panel will disable the parent window (hwndParent) and the function will return only after the window is closed by the user. In that case the pnHandle returns the handle created by the user using the panel Initialize dialog. This handle then may be used when calling other GX6021 functions.
If a modeless dialog was created (nMode=0), the function returns immediately after creating the panel window, returning the window handle to the panel - phwndPanel. It is the responsibility of the calling program to dispatch window messages to this window, so that the window can respond to messages.
The following example opens the panel in modal mode:
HWND hwndPanel;
SHORT nHandle=0, nStatus;
...
Gx6021Panel (&nHandle, 0, 1, &hwndPanel, &nStatus);