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