Etiqueta de ruta de búsqueda de FindWindow en Unified Service Desk
La etiqueta <FindWindow> contiene una lista de elementos que coincidan que se ejecuten en el orden de la lista en la etiqueta. En este tema se describen los elementos <FindWindow> con código de ejemplo.
Elementos de <FindWindow>
El fragmento de código siguiente muestra los elementos en una etiqueta <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 }*
}
}
En la siguiente tabla se describen los elementos de <FindWinow>.
| Elemento | Descripción |
|---|---|
ControlId |
Ventana con Id |
Caption |
Texto del título de la ventana. |
CaptionStartsWith |
Título empieza por texto. |
CaptionEndsWith |
Título termina por texto. |
CaptionContains |
Título contiene texto. |
Class |
Ventana con nombre de clase |
ClassStartsWith |
Nombre de clase empieza por texto. |
ClassEndsWith |
Nombre de clase termina por texto. |
ClassContains |
La clase contiene texto. |
Position |
Busque una ventana en una posición especificada. La posición se define como la esquina superior izquierda de la ventana como coordenadas (x,y). La posición se calcula desde la <Application/> (predeterminada) o desde el <Desktop/>. Si se usa <Desktop/>, debe especificarse antes del elemento <Position>. |
| Find | Busque una ventana especificada mediante el elemento Class o Caption. Los mismos elementos que para FindWindow puede usar aquí (Caption, CaptionStartsWith, CaptionEndsWith, CaptionContains, Class, ClassStartsWith, ClassEndsWith, o ClassContains). |
Desktop |
Establece el punto de búsqueda al escritorio |
Application |
Establece el punto de búsqueda en la ventana de nivel superior de la aplicación. |
Owner |
Ventana con un propietario especificado. |
RelaxProcessIdRestriction |
Incluye las ventanas con identificadores del proceso diferentes en la búsqueda. De forma predeterminada, todas las ventanas pertenecen al mismo identificador del proceso. |
RelaxThreadIdRestriction |
Incluye las ventanas con identificadores del subproceso diferentes en el proceso de búsqueda. De forma predeterminada, todas las ventanas pertenecen al mismo identificador de subproceso. |
Código de ejemplo
El siguiente conjunto de ejemplos muestra cómo se usan los diferentes atributos.
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>