Événements WebDDA
L’adaptateur WebDDA fournit un ensemble d’événements qui peuvent être utilisés dans les automatisations. Les événements peuvent être divisés en événements de page et événements de contrôle. Ils correspondent aux mêmes noms d’événements que ceux utilisés dans le DOM. Pour plus d’informations sur les événements, voir Événements
Lors de l’enregistrement d’une action pour les événements de page, le paramètre de contrôle de l’activité RegisterActionForEvent est ignoré. (Pour plus d’informations, voir Automatiser les applications hébergées à l’aide des activités d’automatisation HAT). Pour les événements de contrôle, le paramètre ControlName doit contenir le nom de contrôle spécifié dans les liaisons.
Certains événements fournissent également des données supplémentaires sur l’événement. Ces données sont accessibles via l’activité GetActionData. (Pour plus d’informations, voir Automatiser les applications hébergées à l’aide des activités d’automatisation HAT) L’exemple suivant indique le format dans lequel ils sont fournies.
<EventArgs[flags] [frame] [headers ] [navigationcontext] [postdata] [url] [urlcontext] [cancel] [type] [key][button]>
Les arguments fournissent des options supplémentaires pour les événements :
| Argument | Description |
|---|---|
flags |
Constante ou valeur qui spécifie une combinaison des valeurs définies par l’énumération BrowserNavConstants. |
frame |
Expression de chaîne respectant la casse qui utilise le nom du cadre pour afficher la ressource. Elle a la valeur NULL si aucun cadre nommé n’est ciblé pour la ressource. |
headers |
Chaîne contenant des en-têtes HTTP supplémentaires à envoyer au serveur. Ces en-têtes sont ajoutés au navigateur web. Ce paramètre est ignoré si l’URL n’est pas une URL HTTP. |
navigationcontext |
Balises utilisées lors de l’ouverture d’une nouvelle fenêtre. Ces valeurs sont utilisées pour décider si une fenêtre indépendante doit être affichée. |
postdata |
Données envoyées au serveur dans le cadre d’une transaction HTTPPOST. Une transaction POST est généralement utilisée pour envoyer les données collectées par un formulaire HTML. Si ce paramètre ne spécifie aucune donnée de publication, cette méthode déclenche une transaction HTTPGET. Ce paramètre est ignoré si l’URL n’est pas une URL HTTP. |
url |
URL de la page vers laquelle l’événement accédait. |
urlcontext |
URL de la page qui ouvre la nouvelle fenêtre. Ce paramètre fait partie de l’événement NewWindow du navigateur web. |
cancel |
La création de la page a été annulée (True) ou est terminée (False). |
type |
Type d’événement, qui est généralement identique à l’événement lui-même. |
key |
Bouton de la souris qui a été actionné lors de l’événement (1=gauche, 2=droit, etc.). |
button |
Code du bouton actionné (par exemple, le code de la touche Entrée est 13). |
Événements de contrôle
Les événements de contrôle sont les événements associés à un contrôle.
Le tableau suivant répertorie les événements de contrôle disponibles avec les paramètres respectifs :
| Élément | Description |
|---|---|
| BeforeNavigate |
flags, frame, headers, navigationcontext, postdata, url |
| onblur | type |
| onchange | type |
| onclick | type, bouton |
| ondblclick | type, bouton |
| onfocus | type |
| onkeydown | type, touche |
| onmousedown | type, bouton |
| onreset | type |
| onsubmit | type |
Événements de page
Lors de l’enregistrement d’actions pour les événements de page, le paramètre de contrôle de l’activité RegisterActionForEvent est ignoré. (Pour plus d’informations, voir Automatiser les applications hébergées à l’aide des activités d’automatisation HAT)
Le tableau suivant répertorie les événements de page disponibles avec les paramètres respectifs :
| Élément | Description |
|---|---|
| BeforeNavigate |
flags, frame, headers, navigationcontext, postdata, url |
| BeforeNewWindow |
flags, url, urlcontext |
| DocumentCompleted |
Notification, flag, url |
| DownloadStarted |
Notification, flag, url |
| DownloadCompleted |
Notification, flag, url |
| NewWindow2 | Cancel |
| NewWindow3 |
flags, url, urlcontext, cancel |