Balise de chemin de recherche FindWindow dans Unified Service Desk
La balise <FindWindow> contient une liste d’éléments correspondants qui sont exécutés dans l’ordre de leur affichage dans la balise. Cette rubrique décrit les éléments <FindWindow> avec un exemple de code.
Éléments de <FindWindow>
L’extrait de code suivant montre les éléments d’une balise <FindWindow>.
# RELAX NG XML grammar for FindWindow
# https://relaxng.org/compact-tutorial-20030326.html
#
Grammar
{
start = FindWindow FindWindow = element
FindWindow
{
element ControlId { attribute match { xsd:integer }?, text }*
& element Caption { attribute match { xsd:integer }?, text }*
& element CaptionStartsWith { same as Caption }*
& element CaptionEndsWith { same as Caption }*
& element CaptionContains { same as Caption }*
& element Class { attribute match { xsd:integer }?, text }*
& element ClassStartsWith { same as Class }*
& element ClassEndsWith { same as Class }*
& element ClassContains { same as Class }*
& element Position { xsd:integer, xsd:integer } *
& element Find { Caption & Class }*
& element Desktop { empty }*
& element Application { empty }*
& element Owner { empty }*
& element RelaxProcessIdRestriction { empty }*
& element RelaxThreadIdRestriction { empty }*
}
}
Le tableau suivant décrit les éléments <FindWinow>.
| Élément | Description |
|---|---|
ControlId |
Fenêtre avec ID |
Caption |
Texte de la légende de la fenêtre. |
CaptionStartsWith |
La légende commence par du texte |
CaptionEndsWith |
La légende se termine par du texte. |
CaptionContains |
La légende contient du texte. |
Class |
Fenêtre avec le nom de la classe |
ClassStartsWith |
Le nom de la classe commence par du texte. |
ClassEndsWith |
Le nom de la classe se termine par du texte. |
ClassContains |
La classe contient du texte. |
Position |
Recherche une fenêtre à une position spécifiée. La position est définie comme étant l’angle supérieur gauche de la fenêtre sous la forme de coordonnées (x, y). La position est calculée à partir de <Application/> (par défaut) ou de <Desktop/>. Si l’élément <Desktop/> est utilisé, il doit être spécifié avant l’élément <Position>. |
| Trouver | Recherche une fenêtre comme spécifié via l’élément Class ou Caption. Les mêmes éléments que pour FindWindow peuvent être utilisés ici (Caption, CaptionStartsWith, CaptionEndsWith, CaptionContains, Class, ClassStartsWith, ClassEndsWith ou ClassContains). |
Desktop |
Définit le point de recherche sur le bureau |
Application |
Définit le point de recherche sur la fenêtre de niveau supérieur de l’application. |
Owner |
Fenêtre avec un propriétaire spécifié. |
RelaxProcessIdRestriction |
Inclut les fenêtres avec différents ID de processus dans la recherche. Par défaut, toutes les fenêtres appartiennent au même ID de processus. |
RelaxThreadIdRestriction |
Inclut les fenêtres avec différents ID de thread dans le processus de recherche. Par défaut, toutes les fenêtres appartiennent au même ID de thread. |
Exemple de code
L’ensemble d’exemples suivant indique comment les différents attributs sont utilisés.
The following sample searches for a window with the control ID 1003.
<FindWindow>
<ControlID>1003</ControlID>
</FindWindow>
The following sample searches for a window with the class name SunAWTFrame.
<FindWindow>
<Class>SunAWTFrame</Class>
</FindWindow>
The following sample searches for a window at desktop position x200 y400.
<FindWindow>
<Desktop/>
<Position>200,400</Position>
</FindWindow>
The following sample searches for the second application with the caption CurrencyConv that is not within the same process as the DDA loaded application.
<FindWindow>
<RelaxProcessIdRestriction/>
<Caption match="2">CurrencyConv</Caption>
</FindWindow>