Side panes windows ID macros

wSplitChildrenIDs
This macro gets the window IDs of both side panes of a splitpane.
Syntax:
ULONG wSplitChildrenIDs(HWND hwnd);
Parameters:
HWND hwnd:splitpane window handle.
Return value:
ULONG:left/top pane window ID in the lower 16 bits,
right/top pane window ID in the higher 16 bits.
Remarks:
Use the LOUSHORT() and HIUSHORT() macros, defined in OS2def.h (just include os2.h) to separate the two IDs.
See the example below for more details.
Example:
ULONG temp, id1, id2; temp = wSplitChildrenIDs(hwndSplitPane); id1 = LOUSHORT(temp); id2 = HIUSHORT(temp); ...

dSplitChildrenIDs
This macro gets the window IDs of both side panes of a splitpane.
Syntax:
ULONG dSplitChildrenIDs(HWND hwndDlg, ULONG id);
Parameters:
HWND hwndDlg:dialog window handle.
ULONG idsplitpane window id.
Return value:
ULONG:left/top pane window ID in the lower 16 bits,
right/top pane window ID in the higher 16 bits.
Remarks:
Use the LOUSHORT() and HIUSHORT() macros, defined in OS2def.h (just include os2.h) to separate the two IDs.
See the example below for more details.
Example:
ULONG temp, id1, id2; temp = dSplitChildrenIDs(hwndDlg, ID_SPLITPANE); id1 = LOUSHORT(temp); id2 = HIUSHORT(temp); ...

wSplitSetChildren
This macro sets both side panes of a splitpane by their window IDs.
Syntax:
BOOL wSplitSetChildren(HWND hwnd, ULONG idPane1, ULONG idPane2);
Parameters:
HWND hwnd:splitpane window handle.
ULONG idPane1:window ID of the left/top pane.
ULONG idPane2:window ID of the right/bottom pane.
Return value:
BOOL:TRUE if the operation was successful,
FALSE in case of error.
Remarks:
This macro is typically used when handling the WM_CREATE message of client windows and must be called after both the splitpane and its side panes have been succesfully created.
Example:
case WM_CREATE: ... // assume all the needed windows have already been created rc = wSplitSetChildren(hwndSplitPane, ID_PANE_1, ID_PANE_2); ...

dSplitSetChildren
This macro sets both side panes of a splitpane by their window IDs.
Syntax:
BOOL dSplitChildrenIDs(HWND hwndDlg, ULONG id, ULONG idPane1, ULONG idPane2);
Parameters:
HWND hwndDlg:dialog window handle.
ULONG idsplitpane window id.
ULONG idPane1:window ID of the left/top pane.
ULONG idPane2:window ID of the right/bottom pane.
Return value:
BOOL:TRUE if the operation was successful,
FALSE in case of error.
Remarks:
This macro is typically used during the WM_INITDLG message of a dialog window.
Example:
case WM_INITDLG: ... // assume all the needed windows have already been created rc = dSplitSetChildren(hwndDlg, ID_SPLITPANE, ID_PANE_1, ID_PANE_2); ...