PropSheet_SetCurSel macro (prsht.h)

Activates the specified page in a property sheet. You can use this macro or send the PSM_SETCURSEL message explicitly.

Syntax

BOOL PropSheet_SetCurSel(
   HWND           hDlg,
   HPROPSHEETPAGE hpage,
   UINT           index
);

Parameters

hDlg

Type: HWND

Handle to the property sheet.

hpage

Type: HPROPSHEETPAGE

Handle to the page to activate. An application can specify the index or the handle, or both. If both are specified, hpage takes precedence.

index

Type: UINT

Zero-based index of the page. An application can specify the index or the handle, or both. If both are specified, hpage takes precedence.

Return value

Type: BOOL

Returns TRUE if successful, or FALSE otherwise.

Remarks

The window that is losing the activation receives the PSN_KILLACTIVE notification code, and the window that is gaining the activation receives the PSN_SETACTIVE notification code.

Requirements