Function Reference


_GUICtrlStatusBar_SetText

Sets the text in the specified part of a status window

#include <GuiStatusBar.au3>
_GUICtrlStatusBar_SetText ( $hWnd [, $sText = "" [, $iPart = 0 [, $iUFlag = 0]]] )

Parameters

$hWnd Handle to the control
$sText [optional] The text to display in the part
$iPart [optional] The part to hold the text
$iUFlag [optional] Type of drawing operation. The type can be one of the following values:
    0 - The text is drawn with a border to appear lower than the plane of the window
    $SBT_NOBORDERS - The text is drawn without borders
    $SBT_OWNERDRAW - The text is drawn by the parent window
    $SBT_POPOUT - The text is drawn with a border to appear higher than the plane of the window
    $SBT_RTLREADING - The text will be displayed in the opposite direction to the text in the parent window

Return Value

Success: True.
Failure: False.

Remarks

Set $iPart to $SB_SIMPLEID for simple statusbar.

Related

_GUICtrlStatusBar_GetText

Example

Example 1 use with icon handle

#include <GUIConstantsEx.au3>
#include <GuiStatusBar.au3>
#include <WinAPIIcons.au3>
#include <WindowsConstants.au3>

Global $g_idMemo

Example()

Func Example()
        ; Create GUI
        Local $hGUI = GUICreate("StatusBar Get/Set Text (v" & @AutoItVersion & ")", 400, 300)
        Local $hStatus = _GUICtrlStatusBar_Create($hGUI)

        ; Create memo control
        $g_idMemo = GUICtrlCreateEdit("", 2, 2, 396, 274, $WS_VSCROLL)
        GUICtrlSetFont($g_idMemo, 9, 400, 0, "Courier New")
        GUISetState(@SW_SHOW)

        ; Set parts
        Local $aParts[4] = [75, 150, 300, 400]
        _GUICtrlStatusBar_SetParts($hStatus, $aParts)
        _GUICtrlStatusBar_SetText($hStatus, "Part 0")
        _GUICtrlStatusBar_SetText($hStatus, "Part 1", 1)
        _GUICtrlStatusBar_SetText($hStatus, "Part 2", 2)
        _GUICtrlStatusBar_SetText($hStatus, "Part 3", 3)
        Local $iWrongSetText = _GUICtrlStatusBar_SetText($hStatus, "Wrong Part", 4)

        ; Set icons
        Local $ahIcons[2]
        $ahIcons[0] = _WinAPI_LoadShell32Icon(23)
        $ahIcons[1] = _WinAPI_LoadShell32Icon(40)
        _GUICtrlStatusBar_SetIcon($hStatus, 0, $ahIcons[0])
        _GUICtrlStatusBar_SetIcon($hStatus, 1, $ahIcons[1])

        ; Show part text
        MemoWrite("Part 0 text ........: " & _GUICtrlStatusBar_GetText($hStatus, 0))
        MemoWrite("Part 1 text ........: " & _GUICtrlStatusBar_GetText($hStatus, 1))

        ; Show icon handles
        MemoWrite("Part 0 icon handle .: 0x" & Hex(_GUICtrlStatusBar_GetIcon($hStatus, 0)))
        MemoWrite("Part 1 icon handle .: 0x" & Hex(_GUICtrlStatusBar_GetIcon($hStatus, 1)))

        MemoWrite("Wrong Part SetText .: " & $iWrongSetText)

        ; Loop until the user exits.
        Do
        Until GUIGetMsg() = $GUI_EVENT_CLOSE
        ; Free icons
        _WinAPI_DestroyIcon($ahIcons[0])
        _WinAPI_DestroyIcon($ahIcons[1])
        GUIDelete()
EndFunc   ;==>Example

; Write message to memo
Func MemoWrite($sMessage = "")
        GUICtrlSetData($g_idMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite

Example 2 direct use with icon file

#include <GUIConstantsEx.au3>
#include <GuiStatusBar.au3>
#include <WindowsConstants.au3>

Global $g_idMemo

Example()

Func Example()
        ; Create GUI
        Local $hGUI = GUICreate("StatusBar Get/Set Text (v" & @AutoItVersion & ")", 400, 300)
        Local $hStatus = _GUICtrlStatusBar_Create($hGUI)

        ; Create memo control
        $g_idMemo = GUICtrlCreateEdit("", 2, 2, 396, 274, $WS_VSCROLL)
        GUICtrlSetFont($g_idMemo, 9, 400, 0, "Courier New")
        GUISetState(@SW_SHOW)

        ; Set parts
        Local $aParts[4] = [75, 150, 300, 400]
        _GUICtrlStatusBar_SetParts($hStatus, $aParts)
        _GUICtrlStatusBar_SetText($hStatus, "Part 0")
        _GUICtrlStatusBar_SetText($hStatus, "Part 1", 1)
        _GUICtrlStatusBar_SetText($hStatus, "Part 2", 2)
        _GUICtrlStatusBar_SetText($hStatus, "Part 3", 3)

        ; Set icons
        _GUICtrlStatusBar_SetIcon($hStatus, 0, 23, "shell32.dll")
        _GUICtrlStatusBar_SetIcon($hStatus, 1, 40, "shell32.dll")

        ; Show part text
        MemoWrite("Part 0 text ........: " & _GUICtrlStatusBar_GetText($hStatus, 0))
        MemoWrite("Part 1 text ........: " & _GUICtrlStatusBar_GetText($hStatus, 1))

        ; Show icon handles
        MemoWrite("Part 0 icon handle .: 0x" & Hex(_GUICtrlStatusBar_GetIcon($hStatus, 0)))
        MemoWrite("Part 1 icon handle .: 0x" & Hex(_GUICtrlStatusBar_GetIcon($hStatus, 1)))

        ; Loop until the user exits.
        Do
        Until GUIGetMsg() = $GUI_EVENT_CLOSE
        GUIDelete()
EndFunc   ;==>Example

; Write message to memo
Func MemoWrite($sMessage = "")
        GUICtrlSetData($g_idMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite