Aide:GUICtrlCreateDate.txt

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

Document original V3.3.6.1 :

###Function###
GUICtrlCreateDate

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

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


###Parameters###
@@ParamTable@@
text
	The preselected date (always as "yyyy/mm/dd").
left
	The left side of the control. If -1 is used then left will be computed according to <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode</a>.
top
	The top of the control. If -1 is used then top will be computed according to <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode</a>.
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#Date">GUI Control Styles Appendix</a>.
	
	default (-1) : $DTS_LONGDATEFORMAT
	forced style : $WS_TABSTOP
exStyle
	[optional] Defines the extended style of the control. See <a href="../appendix/GUIStyles.htm#Extended">Extended Style Table</a>.
	default (-1) : WS_EX_CLIENTEDGE
@@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>.

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

To Format the date/time see example 3 to understand how to use a GuiCtrlSendMsg with a $DTM_SETFORMAT.

To use the values specified above you must #include &lt;DateTimeConstants.au3&gt; in your script.

Default resizing is $GUI_DOCKHEIGHT.


###Related###
GUICoordMode (Option), GUICtrlSetState, GUIGetMsg, GUICtrlRead


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


Document traduit V3.3.6.1 :

###Function###
GUICtrlCreateDate

###Description###
Crée un contrôle date pour l'interface graphique.

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


###Parameters###
@@ParamTable@@
text
	La date présélectionnée (toujours au format "aaaa/mm/dd").
left
	La position en partant de gauche de la commande. Si vous utilisez -1, la position sera calculé en fonction de <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode</a>.
top
	La position en partant du sommet de la commande. Si vous utilisez -1, la position sera calculé en fonction de <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode</a>.
width
	[optionnel] La largeur de la commande (par défaut est la largeur utilisée précédemment).
height
	[optionnel] La hauteur de la commande (par défaut est la hauteur précédemment utilisé).
style
	[optionnel] Définit le style du contrôle. Voir l'<a href="../appendix/GUIStyles.htm#Date">annexe de styles de contrôle GUI</a>.
	
	défaut (-1) : $DTS_LONGDATEFORMAT
	style forcé : $WS_TABSTOP
exStyle
	[optionnel] Définit le style étendu du contrôle. Voir la <a href="../appendix/GUIStyles.htm#Extended">Table des styles étendus</a>.
	default (-1) : WS_EX_CLIENTEDGE
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:	Retourne l'identifiant (ID du contrôle) du nouveau contrôle.
Échec:	Retourne 0.
@@End@@


###Remarks###
Pour obtenir la valeur de la commande, voir <a href="GUICtrlRead.htm">GUICtrlRead</a>.
Pour définir ou modifier des informations dans le contrôle, voir <a href="GUICtrlUpdate Management.htm">GUICtrlUpdate...</a>.

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

Pour formater la date/heure voir exemple 3 pour comprendre comment utiliser un GuiCtrlSendMsg avec $DTM_SETFORMAT.

Pour utiliser les valeurs indiquées ci-dessus, vous devez inclure &lt;DateTimeConstants.au3&gt; dans votre script.

Redimensionnement par défaut est $GUI_DOCKHEIGHT.


###Related###
GUICoordMode (Option), GUICtrlSetState, GUIGetMsg, GUICtrlRead


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


Traducteur :TT22

Contributeurs (pour les modifications avant le Wiki) :