Sets the elevation required state for a specified button or command link to display an elevated icon. Send this message explicitly or by using the Button_SetElevationRequiredState macro.
Syntax
To send this message, call the
SendMessage
function as follows.
lResult = SendMessage( // returns LRESULT in lResult
hWndControl, // (HWND) handle to destination control
BCM_SETSHIELD, // (UINT) message ID
wParam, // = 0; not used, must be zero
lParam // = (LPARAM)(BOOL) fRequired;
);
Parameters
- wParam
-
Must be zero.
- fRequired
-
[in] TRUE to draw an elevated icon, or FALSE otherwise.
Return Value
Returns 1 if successful, or an error code otherwise.
Remarks
An application must be manifested to use comctl32.dll version 6 to gain this functionality.
Message Information
| Header | Declared in Commctrl.h |
|---|
| Minimum operating systems |
Windows Vista |
|---|