Freigeben über

FindWindow-Tag

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Das Tag <FindWindow> besteht aus einer Liste mit untergeordneten Elementen, die eine Folge von Zuordnungsvorgängen darstellen, die alle erfolgreich sein müssen, damit das zu berücksichtigende Zielfenster gefunden werden kann.

Die folgenden Codeausschnitte zeigen, wie die verschiedenen <FindWindow>-Elemente verwendet werden, um das Zielfenster zu finden:

# RELAX NG XML grammar for FindWindow
# http://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 Find { Caption & Class }*
& element Desktop { empty }*
& element Application { empty }*
& element Owner { empty }*
& element RelaxProcessIdRestriction { empty }*
& element RelaxThreadIdRestriction  { empty }*
}
}

<FindWindow> Tagelemente

Die folgende Tabelle beschreibt die verschiedenen Elemente des <FindWindow>-Tags:

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.

Find

Sucht nach einem Fenster wie über das Class- oder Caption-Element angegeben.

Desktop

Legt den Suchpunkt auf dem Desktop fest.

Application

Legt den Suchpunkt auf das Anwendungsfenster der obersten Ebene fest.

Owner

Fenster mit angegebenem Besitzer.

RelaxProcessIdRestriction

Schließt Fenster mit anderen Prozess-IDs in die Suche ein. Standardmäßig gehören alle Fenster zu derselben Prozess-ID.

RelaxThreadIdRestriction

Schließt Fenster mit anderen Thread-IDs in den Suchvorgang ein. Standardmäßig gehören alle Fenster zu derselben Thread-ID.

Das folgende XML zeigt Steuerelementdefinition unter Verwendung des <FindWindow>-Tags.

<FindWindow>
<Desktop/>
<Caption match="1">Font</Caption>
<Class>#32770</Class>
<Caption>OK</Caption>
</FindWindow>
<FindWindow>
<Application/>
<ControlId>7d</ControlId>
</FindWindow>
<FindWindow>
<Desktop/>
<Class>Notepad</Class>
</FindWindow>

Im vorangehenden XML-Beispiel besitzen die Elemente folgende Definitionen:

  • <Application/> – legt das Kontextfenster auf das Fenster der obersten Ebene der Anwendung fest. Standardmäßig wird der Kontext auf dem Fenster der oberster Ebene vor dem ersten Knoten in <FindWindow/>Datei <FindWindow/> initialisiert.

  • <Desktop/> - legt das Kontextfenster auf das Desktopfenster der Stammebene fest.

  • <Caption match="1">Font</Caption> - durchsucht die Fensterhierarchie, beginnend beim aktuellen Kontextfenster und dann die Hierarchie abwärts nach dem ersten Fenster mit einem Beschriftungstext, der dem bereitgestellten Text entspricht. Wenn match="2", sucht es nach dem zweiten Fenster mit Beschriftungstext, der dem bereitgestellten Text entspricht. Wenn kein match-Attribut bereitgestellt wird, ist match="1" Standard. Der Textvergleich ist eine Teilzeichenfolgenübereinstimmung mit dem Beschriftungstext. Wenn der bereitgestellte Text als Teilzeichenfolge in der Beschriftung des Fensters efunden werden kann, wird er als Übereinstimmung betrachtet. Das erfolgreich übereinstimmende Fenster wird das neue Kontextfenster. Wenn keine Übereinstimmung gefunden wird, schlägt die Suche fehl. Standardmäßig gelten nur Windows, die zu demselben ProcessId und ThreadId gehören, als Übereinstimmung.

  • <Class>#32770</Class> - durchsicht die Fensterhierarchie nach dem ersten Fenster mit Klassentext, der dem zur Verfügung gestellten Text entspricht. Alle anderen Verhaltensdetails sind identisch mit <Caption/>..

  • <ControlId>7d</ControlId> - durchsicht die Fensterhierarchie nach dem ersten Fenster mit einer Kontroll-ID, der dem zur Verfügung gestellten Wert entspricht. Hier ist eine exakte Übereinstimmung erforderlich. Alle anderen Verhaltensdetails sind identisch mit <Caption/>.

Das folgende XML sucht nach dem Fenster mit der Beschriftung OK im ersten Fenster mit der Beschriftung Schriftart und der Klassen-ID 32770, beginnend am Desktop.

<FindWindow>
<Desktop/>
<Caption match="1">Font</Caption>
<Class>#32770</Class>
<Caption>OK</Caption>
</FindWindow>

Das folgende XML sucht nach dem enster mit der Steuerelement-ID 7D und beginnt am Fenster der obersten Ebene der Anwendung.

<FindWindow>
<Application/>
<ControlId>7d</ControlId>
</FindWindow>

Folgende XML sucht nach dem (ersten) Fenster mit dem Klassennamen Notepad, beginnend beim Desktop.

<FindWindow>
<Desktop/>
<Class>Notepad</Class>
</FindWindow>

Siehe auch

WinDDA
Verwenden von datengesteuerten Adaptern (DDAs)

Unified Service Desk 2.0

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright