| wSplitChildHandle | |
| This macro returns the handle of a virtual child of a WC_SPLITPANE control. | |
| Syntax: | |
| HWND wSplitChildHandle(HWND hwnd, ULONG childPos); | |
| Parameters: | |
| HWND hwnd: | splitpane window handle. |
| ULONG childPos: | identifies the pane whose window handle is required. It can be either SPLITMP_PANE1 (left/top pane) or SPLITMP_PANE2 (right/bottom pane). |
| Return value: | |
| HWND: | window handle of the requested side pane. |
| Example: | |
| hwndLeftPane = wSplitChildHandle(hwndSplitPane, SPLITMP_PANE1); ... | |
| dSplitChildHandle | |
| This macro returns the handle of a virtual child of a WC_SPLITPANE control. | |
| Syntax: | |
| HWND dSplitChildHandle(HWND hwndDlg, ULONG id, ULONG childPos); | |
| Parameters: | |
| HWND hwndDlg: | dialog window handle. |
| ULONG id: | splitpane window ID. |
| ULONG childPos: | identifies the pane whose window handle is required. It can be either SPLITMP_PANE1 (left/top pane) or SPLITMP_PANE2 (right/bottom pane). |
| Return value: | |
| HWND: | window handle of the requested side pane. |
| Example: | |
| hwndLeftPane = dSplitChildHandle(hwndDlg, ID_SPLITPANE, SPLITMP_PANE1); ... | |
| wSplitSetChildHandle | |
| This macro makes a window a new side pane of a splitpane. | |
| Syntax: | |
| wSplitSetChildHandle(HWND hwnd, ULONG childPos, HWND hwndNew); | |
| Parameters: | |
| HWND hwnd: | splitpane window handle. |
| ULONG childPos: | identifies which pane must be replaced by a new window. It can be either SPLITMP_PANE1 (left/top pane) or SPLITMP_PANE2 (right/bottom pane). |
| HWND hwndNew: | handle of the new window to be set as side pane. |
| Return value: | |
| HWND: | handle of the replaced pane. NULLHANDLE if there was no previous pane. |
| Remarks: | |
| The previous side pane, after having been replaced by the new window, must be hidden or destroyed. | |
| Example: | |
| hwndNew = WinCreateWindow(...); // parameters omitted hwndPrevPane = wSplitSetChildHandle(hwndSplitPane, SPLITMP_PANE1, hwndNew); WinDestroyWindow(hwndPrevPane); ... | |
| dSplitSetChildHandle | |
| This macro makes a window a new side pane of a splitpane. | |
| Syntax: | |
| dSplitSetChildHandle(HWND hwndDlg, ULONG id, ULONG childPos, HWND hwndNew); | |
| Parameters: | |
| HWND hwndDlg: | dialog window handle. |
| ULONG id: | splitpane window ID. |
| ULONG childPos: | identifies which pane must be replaced by a new window. It can be either SPLITMP_PANE1 (left/top pane) or SPLITMP_PANE2 (right/bottom pane). |
| HWND hwndNew: | handle of the new window to be set as side pane. |
| Return value: | |
| HWND: | handle of the replaced pane. NULLHANDLE if there was no previous pane. |
| Remarks: | |
| The previous side pane, after having been replaced by the new window, must be hidden or destroyed. | |
| Example: | |
| hwndNew = WinCreateWindow(...); // parameters omitted hwndPrevPane = dSplitSetChildHandle(hwndDlg, ID_SPLITPANE, SPLITMP_PANE1, hwndNew); WinDestroyWindow(hwndPrevPane); ... | |