Aide:GUICtrlCreateList.txt

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

Document original V3.3.6.1 :

###Function###
GUICtrlCreateList

###Description###
Creates a List control for the GUI.

###Syntax###
GUICtrlCreateList ( "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 is the previously used width).
height
	[optional] The height of the control (default is the previously used height).
style
	[optional] Defines the style of the control. See <a href="../appendix/GUIStyles.htm#List">GUI Control Styles Appendix</a>.
	
	default ( -1) : $LBS_SORT, $WS_BORDER, $WS_VSCROLL
	forced styles : $WS_TABSTOP, $LBS_NOTIFY
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 obtain the value of the control see <a href="GUICtrlRead.htm">GUICtrlRead</a>.
To set or change information in the control see <a href="GUICtrlUpdate Management.htm">GUICtrlUpdate...</a>.

The different list entries that can be selected can be set with <a href="GUICtrlSetData.htm">GUICtrlSetData</a>

To limit horizontal scrolling use <a href="GUICtrlSetLimit.htm">GUICtrlSetLimit</a>

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

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

Default resizing is $GUI_DOCKAUTO size and position will occur.


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


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


Document traduit V3.3.6.1 :

###Function###
GUICtrlCreateList

###Description###
Crée un contrôle liste pour une interface graphique.

###Syntax###
GUICtrlCreateList ( "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 (la largeur par défaut est utilisée précédemment).
height
	[optionnel] La hauteur du contrôle (la hauteur par défaut est utilisée précédemment).
style
	[optionnel] Définit le style du contrôle. Voir <a href="../appendix/GUIStyles.htm#List">GUI Control Styles Appendix</a>.
	
	défaut ( -1) : $LBS_SORT, $WS_BORDER, $WS_VSCROLL
	Styles forcés : $WS_TABSTOP, $LBS_NOTIFY
exStyle
	[optionnel] Définit le style étendu du contrôle. Voir <a href="../appendix/GUIStyles.htm#Extended">Extended Style Table</a>.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Retourne l'identifiant (controlID) du nouveau contrôle.
Failure:	Retourne 0.
@@End@@


###Remarks###
Pour obtenir la valeur du contrôle voir <a href="GUICtrlRead.htm">GUICtrlRead</a>.
Pour régler ou changer l'information dans le contrôle voir <a href="GUICtrlUpdate Management.htm">GUICtrlUpdate...</a>.

Les différentes entrées de liste qui peuvent être sélectionnées peuvent être réglées avec <a href="GUICtrlSetData.htm">GUICtrlSetData</a>

Pour limiter l'utilisation de défilement horizontal <a href="GUICtrlSetLimit.htm">GUICtrlSetLimit</a>

Pour combiner les styles avec l'utilisation de style par défaut <b>BitOr</b>($GUI_SS_DEFAULT_LIST, newstyle,...).

Pour utiliser les valeurs spécifiées ci-dessus, vous devez inclure #include <ListBoxConstants.au3> dans votre script.

Redimensionnement  par défaut est $GUI_DOCKAUTO , la taille et la position seront modifiés.


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


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


Traducteur : ZOTHOP

Contributeurs (pour les modifications avant le Wiki) :