From AutoIt Wiki
Revision as of 00:12, 3 August 2013 by Jaberwocky6669 (talk | contribs) (Added more description and cleaned up wikitext.)
Jump to navigation Jump to search

A label is a GUI control whose purpose is to display often simple and plain text. A label is often used to display a short, simple description of some aspect of the program's current state or a control's intended purpose among other reasons.

The function for creating a label is GuiCtrlCreateLabel. The text of the label can be changed using GuiCtrlSetData and read using the GuiCtrlRead function. The foreground can be changed with GuiCtrlSetColor. The background color can be changed with GuiCtrlSetBKColor. The function to change the font face and font size is GUICtrlSetFont.

The following example demonstrates the creation of a label.

 #include <GUIConstantsEx.au3>

 Opt("MustDeclareVars", 1)


 Func Main()
     GUICreate("My GUI") ; will create a dialog box that when displayed is centered

     GUISetHelp("Notepad.exe") ; will run notepad if F1 is typed

     Opt("GUICoordMode", 2)

     Local Const $widthCell = 70

     GUICtrlCreateLabel("Line 1 Cell 1", 10, 30, $widthCell) ; first cell 70 width
     GUICtrlCreateLabel("Line 2 Cell 1", -1, 0)              ; next line
     GUICtrlCreateLabel("Line 3 Cell 2", 0, 0)               ; next line and next cell
     GUICtrlCreateLabel("Line 3 Cell 3", 0, -1)              ; next cell same line
     GUICtrlCreateLabel("Line 4 Cell 1", -3 * $widthCell, 0) ; next line Cell1

     GUISetState(@SW_SHOWNORMAL) ; will display an empty dialog box

     ; Run the GUI until the dialog is closed
     Until GUIGetMsg() = $GUI_EVENT_CLOSE
 EndFunc   ;==>Example