PropSheet_SetCurSel macro

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           hPropSheetDlg,
   HPROPSHEETPAGE hpage,
   UINT           index
);

Parameters

hPropSheetDlg

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

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Prsht.h

 

 

Show: