Functions > GUI > GUICtrlUpdate >

GUICtrlSetData

Modifie les données d'un contrôle.

GUICtrlSetData ( controlID, data [, default] )

Paramètres

controlID	L'ID du contrôle tel que retourné par une fonction GUICtrlCreate...(), ou -1 pour désigner le dernier contrôle créé.
data	Combo, Liste, ListView, ListViewItem : Le caractère Opt("GUIDataSeparatorChar",...) qui est utilisé comme séparateur. Progress : Le pourcentage. Slider : La valeur. Button, Checkbox, Combo, Edit, Group, Input, Label, List, Menu, MenuItem, Radio, TabItem, TreeViewItem: le texte. Date: La date ou l'heure selon le style du contrôle et des paramètres régionaux. Dummy: La valeur.
default	[optionnel] Combo, List : La valeur par défaut. Edit, Input: Si non vide (""), la chaîne est insérée au point d'insertion courant (caret).

Valeur de retour

Succès:	Retourne 1.
Échec:	Retourne 0. -1 En cas de données non valides

Remarques

Pour les contrôles Combo ou List :
Si la "donnée" correspond à une entrée déjà existante, elle est définie comme la valeur par défaut.
Si la "donnée" commence par GUIDataSeparatorChar ou est une chaîne vide "" la liste précédente est détruite.

Pour les contrôles ListView, ListViewItem :
Pour mettre à jour une colonne spécifique il suffit d'oublier les autres c'est-à-dire "||update" pour mettre à jour la 3ème colonne.
Si "update" est vide, la colonne/sous-item sera effacé. Par exemple "|" effacera la deuxième colonne/sous-item, "" effacera la première.

Pour les contrôles Monthcal:
Le format date de la "donnée" est "yyyy/mm/dd".

Pour les contrôles Date:
La date et l'heure est au format défini par les paramètres régionaux. GUICtrlRead() utilise le même format par défaut.

En relation

GUICtrlCreate..., GUICtrlRead, GUICtrlUpdate..., GUIDataSeparatorChar (Option)

Exemple

#include <GUIConstantsEx.au3>

Example()

Func Example()
    GUICreate("My GUI") ; Crée une GUI centré

    GUICtrlCreateCombo("", 10, 10)
    GUICtrlSetData(-1, "item1|item2|item3", "item3")

    GUISetState(@SW_SHOW) ; Affiche la GUI avec le focus sur le ComboBox

    ; Boucle jusqu'à ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example