Aide:GUICtrlCreateLabel.txt

De Wiki AutoIt Français
Aller à : navigation, rechercher

Document original V3.3.6.1 :

###Function###
GUICtrlCreateLabel

###Description###
Creates a static Label control for the GUI.

###Syntax###
GUICtrlCreateLabel ( "text", left, top [, width [, height [, style [, exStyle]]]] )


###Parameters###
@@ParamTable@@
text
	The text of the control.
left
	The left side of the control. If -1 is used then left will be computed according to <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode.
top
	The top of the control. If -1 is used then top will be computed according to <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode.
width
	[optional] The width of the control (default text autofit in width).
height
	[optional] The height of the control (default text autofit in height).
style
	[optional] Defines the style of the control. See <a href="../appendix/GUIStyles.htm#Label">GUI Control Styles Appendix</a>.

	default ( -1) : none.
	forced styles : $SS_NOTIFY, $SS_LEFT
exStyle
	[optional] Defines the extended style of the control. See <a href="../appendix/GUIStyles.htm#Extended">Extended Style Table</a>.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns the identifier (controlID) of the new control.
Failure:	Returns 0.
@@End@@


###Remarks###
To set or change information in the control see <a href="GUICtrlUpdate Management.htm">GUICtrlUpdate...</a>.

To combine styles with the default style use <b>BitOr</b>($GUI_SS_DEFAULT_LABEL, newstyle,...).

To use the values specified above you must #include <StaticConstants.au3> in your script.

Default resizing is $GUI_DOCKAUTO size and position will occur.

The extended style $GUI_WS_EX_PARENTDRAG can be used to allow the dragging of the parent window for windows that don't have a titlebar (no $WS_CAPTION style in GUICreate).

To set the background to transparent, use GUICtrlSetBkColor(-1, $GUI_BKCOLOR_TRANSPARENT).

###Related###
GUICoordMode (Option), GUICtrlUpdate..., GUIGetMsg


###Example###
@@IncludeExample@@


Document traduit V3.3.6.1 :

###Function###
GUICtrlCreateLabel
 
###Description###
Crée un contrôle label pour une interface graphique.

###Syntax###
GUICtrlCreateLabel ( "text", left, top [, width [, height [, style [, exStyle]]]] )

###Parameters###
@@ParamTable@@
text
        Le texte du contrôle.
left
        La distance à gauche du contrôle. Si -1 est utilisé alors la valeur sera déterminée en accord avec<a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode.

top
        La distance en haut du contrôle. Si -1 est utilisé alors la valeur sera déterminée en accord avec <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode.

width
        [optionnel] La largeur du contrôle (le texte par défaut est ajusté en largeur).
height
        [optionnel] La hauteur du contrôle (le texte par défaut est ajusté en hauteur).
style
        [optionnel] Définit le style du contrôle. voir <a href="../appendix/GUIStyles.htm#Label">GUI Control Styles Appendix</a>.
 
        défaut ( -1) : aucun.
        Style forcé : $SS_NOTIFY, $SS_LEFT
exStyle
        [optionnel] Définit le style étendu du contrôle. voir <a href="../appendix/GUIStyles.htm#Extended">Extended Style Table</a>.
@@End@@


Pour définir ou modifier des informations dans le contrôle, voir <a href="GUICtrlUpdate Management.htm"> GUICtrlUpdate ... </ a>.
 
Pour combiner les styles avec le style par défaut, utilisez <b> bitOr </ b> ($GUI_SS_DEFAULT_LABEL, newstyle, ...).
 
Pour utiliser les valeurs indiquées ci-dessus, vous devez inclure #include <StaticConstants.au3> dans votre script.
 
Le redimensionnement par défaut est $GUI_DOCKAUTO, la taille et la position seront modifiée.
 
Le style étendu $GUI_WS_EX_PARENTDRAG peut être utilisé pour permettre le glissement de la fenêtre parente, pour les fenêtres qui n'ont pas de barre de titre (pas de style $WS_CAPTION  avec  GUICreate).
 
Pour définir la transparence, utiliser GUICtrlSetBkColor (-1, $GUI_BKCOLOR_TRANSPARENT).

###Related###
GUICoordMode (Option), GUICtrlUpdate..., GUIGetMsg


###Example###
@@IncludeExample@@


Traducteur :ZOTHOP

Contributeurs (pour les modifications avant le Wiki) :