Événements de widget

onMouseClick

void onMouseClick (me, eventInfo)

Cet événement est disponible uniquement pour les boutons et il se produit lorsque le bouton est enfoncé et relâché rapidement.

Paramètre Description
me Objet déclencheur de l'événement
eventInfo Détails sur l'événement déclenché

function buttonStd1_onMouseClick(me, eventInfo) {

//do something…

}

onMouseHold

void onMouseHold (me, eventInfo)

Cet événement est disponible uniquement pour les boutons et il se produit lorsque le bouton est enfoncé et relâché après le nombre de secondes défini comme temps de maintien dans les propriétés du widget.

Paramètre Description
me Objet déclencheur de l'événement
eventInfo Détails sur l'événement déclenché

function buttonStd1_onMouseHold(me, eventInfo) {

//do something…

}

onMousePress

void onMousePress(me, eventInfo)

Cet événement n'est disponible que pour les boutons et il se produit lorsque vous appuyez sur le bouton.

Paramètre Description
me Objet déclencheur de l'événement
eventInfo Détails sur l'événement déclenché

function buttonStd1_onMousePress(me, eventInfo) {

//do something…

}

onMouseRelease

void onMouseRelease (me, eventInfo)

Cet événement est disponible uniquement pour les boutons et il se produit lorsque l’on relâche le bouton.

Paramètre Description
me Objet déclencheur de l'événement
eventInfo Détails sur l'événement déclenché

function buttonStd1_onMouseRelease(me, eventInfo) {

//do something…

}

LorsMiseàJourDonnées

boolean onDataUpdate (me, eventInfo)

Cet événement se produit lorsque les données associées au widget changent.

Paramètre Description
me Objet déclencheur de l'événement
eventInfo

Un objet avec les champs indiqués ci-dessous (vous pouvez vous référer aux champs en utilisant “.” notation point)

oldValue = Valeur du widget avant le changement

newValue = Valeur qui sera actualisée vers le widget

attrName = Attribut sur lequel l'événement est généré

index = Index d'attribut entier, le cas échéant, par défaut = 0

mode = W lorsque l'utilisateur est en train d'écrire vers le widget. R dans tous les autres statuts.

L'événement est déclenché avant que la valeur ne soit transmise au widget. Un code JavaScript peut intercepter l'événement et décider d'éviter de mettre à jour le widget en retournant la valeur réelle.

Remarque : s'il y a d'autres macros associées à l'événement, toutes les macros seront exécutées quelle que soit la valeur de retour utilisée dans le code JavaScript.

function buttonStd1_onDataUpdate(me, eventInfo) {
if ( eventInfo.newValue > 100) {
   //do something...
   return true;  // To avoid to continue and update 
                 // the widget (e.g. not update the linked tag)
}
   return false; // To continue and update the widget 
                 // (e.g. update the linked tag)
}