DioPanelEx

Applies To

GC5050, GX5050, GX5055, GX5150, GX5280, GX5290, GX5290e, GX5295

Purpose

Opens the GTDIO Panel window. Passing a master handle will open the panel window already initialized displaying the associated master board settings skipping the Initialize step.

Syntax

DioPanelEx (pnHandle, dwHwndParent, dMode, pdwHwndPane, pnStatusl)

Parameters

Name	Type	Comments
pnHandle	PSHORT	Master board handle. Passing 0 will open the panel in an initialized state.
dwHwndParent	DWORD	Parent window handle. Used when creating the panel window.
nMode	SHORT	The mode in which the panel main window is created. 0 Modeless window. 1 Modal window.
pdwHwndPanel	PDWORD	Returns panel window handle. Returns 0 on error.
pnStatus	PSHORT	Returned status: 0 on success, negative number on failure.

Comments

The function is used to create the panel window. The panel window may be open 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 was closed by the user. In that case, the pnHandle may return the handle created by the user using the panel Initialize dialog. This handle may be used when calling other DIO 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 calling program to dispatch windows messages to this window so that the window can respond to messages.

Example

The following example calls the Panel:

DWORD hwndPanel;

SHORT nStatus, nMasterHandle;

DioInitialize (1, &nMasterHandle, &nStatus);

DioPanelEx(&nMasterHandle, NULL, GTDIO_PANEL_MODELESS, &hwndPanel, &nStatus);