Function Reference


_GUICtrlEdit_GetCueBanner

Gets the cue banner text displayed in the edit control

#include <GuiEdit.au3>
_GUICtrlEdit_GetCueBanner ( $hWnd )

Parameters

$hWnd Control ID/Handle to the control

Return Value

Success: the cue banner text.
Failure: an empty string "".

Remarks

The cue banner is text that is displayed in the edit control when there is no selection.

Windows Vista or later.

Related

_GUICtrlEdit_SetCueBanner

Example

#include <GUIConstantsEx.au3>
#include <GuiEdit.au3>
#include <MsgBoxConstants.au3>

Example()

Func Example()
        Local $hGUI = GUICreate('Example', 300, 150)
        GUISetFont(9, 400, 0, 'Segoe UI')

        Local $idUsername = GUICtrlCreateInput('', 10, 10, 125, 25)
        _GUICtrlEdit_SetCueBanner($idUsername, "Search folder")

        Local $idPassword = GUICtrlCreateInput('', 10, 40, 125, 25)
        _GUICtrlEdit_SetCueBanner($idPassword, "Search...")

        Local $idButton_Close = GUICtrlCreateButton("Close", 210, 120, 85, 25)
        ControlFocus($hGUI, "", $idButton_Close)

        GUISetState(@SW_SHOW, $hGUI)

        MsgBox($MB_SYSTEMMODAL, "", _GUICtrlEdit_GetCueBanner($idPassword))

        While 1
                Switch GUIGetMsg()
                        Case $GUI_EVENT_CLOSE, $idButton_Close
                                ExitLoop

                EndSwitch
        WEnd

        GUIDelete($hGUI)
EndFunc   ;==>Example