# Function Reference

# _GUICtrlButton_SetShield

Sets the elevation required state for a specified button or command link to display an elevated icon

#include <GuiButton.au3>
_GUICtrlButton_SetShield ( $hWnd [, $bRequired = True] )

## Parameters

$hWnd | Control ID/Handle to the control
$bRequired | [optional] True to draw an elevated icon, or False otherwise

## Return Value

Success: | True.
Failure: | False.

## Remarks

Windows Vista or later.

## See Also

Search BCM_SETSHIELD in MSDN Library.

## Example

    #include <GuiButton.au3>
    #include <GUIConstantsEx.au3>

    ; Note the controlID from these buttons can NOT be read with GUICtrlRead

    Example()

    Func Example()
        Local $hGUI, $hBtn, $hBtn2

        $hGUI = GUICreate("Buttons", 400, 400)

        $hBtn = _GUICtrlButton_Create($hGUI, "Button1", 10, 10, 90, 30)
        _GUICtrlButton_SetShield($hBtn)

        $hBtn2 = _GUICtrlButton_Create($hGUI, "Button2", 10, 60, 90, 30, $BS_SPLITBUTTON)
        _GUICtrlButton_SetShield($hBtn2)

        GUISetState(@SW_SHOW)

        While 1
            Switch GUIGetMsg()
                Case $GUI_EVENT_CLOSE
                    ExitLoop
            EndSwitch
        WEnd

        Exit
    EndFunc   ;==>Example