| 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 id | splitpane 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 id | splitpane 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); ... | |