FindWindow Suchpfad-Tag in Unified Service Desk
<FindWindow> Tag enthält eine Liste von übereinstimmenden Elementen, die in der Reihenfolge ihrer Auflistung innerhalb des Tags ausgeführt werden. In diesem Thema werden die <FindWindow>-Elemente mit Beipielcode beschrieben.
<FindWindow> Elemente
Der folgende Codeausschnitt zeigt die Elemente in einem <FindWindow>-Tag
# 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 }*
}
}
In der folgenden Tabelle werden die <FindWinow>-Elemente beschrieben.
| Element | Beschreibung |
|---|---|
ControlId |
Fenster mit ID |
Caption |
Fensterbeschriftungstext. |
CaptionStartsWith |
Beschriftung beginnt mit Text |
CaptionEndsWith |
Beschriftung endet mit Text. |
CaptionContains |
Beschriftung enthält Text. |
Class |
Fenster mit Klassennamen |
ClassStartsWith |
Klassenname beginnt mit Text. |
ClassEndsWith |
Klassenname endet mit Text. |
ClassContains |
Klasse enthält Text. |
Position |
Suchen Sie ein Fenster in einer angegebenen Position. Die Position wird als die linke obere Ecke des Fensters als (x,y) Koordinaten definiert. Die Position wird entweder aus der <Anwendung/> (Standard) oder aus der <Desktop/> berechnet. Wenn <Desktop/> verwendet wird, muss es vor dem Element <Position> angegeben werden. |
| Sunden | Suche nach einem Fenster wird über das Class- oder Caption-Element angegeben. Hier können die gleichen Elemente wie für FindWindow verwendet werden (Caption, CaptionStartsWith, CaptionEndsWith, CaptionContains, Class, ClassStartsWith, ClassEndsWith oder ClassContains). |
Desktop |
Legt den Suchpunkt auf dem Desktop fest |
Application |
Legt den Suchpunkt auf das Fenster der obersten Ebene in der Anwendung fest. |
Owner |
Fenster mit einem angegebenen Besitzer. |
RelaxProcessIdRestriction |
Enthält Fenster mit verschiedenen Prozess-IDs in der Suche. Standardmäßig gehören alle Fenster zu derselben Prozess-ID. |
RelaxThreadIdRestriction |
Enthält Fenster mit verschiedenen Thread-IDs im Suchprozess. Standardmäßig gehören alle Fenster zu derselben Thread-ID. |
Beispielcode
Der folgenden Satz von Beispielen veranschaulicht, wie die verschiedenen Attribute verwendet werden.
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>