This topic has not yet been rated - Rate this topic

Button_SetElevationRequiredState macro

Applies to: desktop apps only

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

hwnd [in]

Type: HWND

A handle to the button control.

fRequired [in]

Type: BOOL

TRUE to draw an elevated icon, or FALSE otherwise.

Return value

Returns 1 if successful, or an error code otherwise.

Remarks

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

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Commctrl.h

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ