Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Button_SetElevationRequiredState macro (commctrl.h)

Sets the elevation required state for a specified button or command link to display an elevated icon. Use this macro or send the BCM_SETSHIELD message explicitly.

Syntax

LRESULT Button_SetElevationRequiredState(
 [in] HWND hwnd,
 [in] BOOL fRequired
);

Parameters

[in] hwnd

Type: HWND

A handle to the button control.

[in] fRequired

Type: BOOL

TRUE to draw an elevated icon, or FALSE otherwise.

Return value

Type: LRESULT

Returns 1 if successful, or an error code otherwise.

Remarks

An application must use comctl32.dll version 6 to gain this functionality.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header commctrl.h

Feedback

Was this page helpful?

Additional resources

  • Last updated on