FindWindow-tag

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

De <FindWindow>-code bestaat uit een lijst met onderliggende elementen die een aantal opeenvolgende matchbewerkingen vertegenwoordigen, die allemaal succesvol moeten zijn, wil het doel als gevonden worden beschouwd.

Het volgende codestukje toont hoe de verschillende <FindWindow>-elementen worden gebruikt om het doelvenster te zoeken:

# 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>-code-elementen

De volgende tabel beschrijft de verschillende elementen van de <FindWindow>-code:

Element

Beschrijving

ControlId

Venster met ID.

Caption

Tekst venstertitel.

CaptionStartsWith

Bijschrift begint met tekst.

CaptionEndsWith

Bijschrift eindigt met tekst.

CaptionContains

Bijschrift bevat tekst.

Class

Venster met klassenaam.

ClassStartsWith

Klassenaam begint met text.

ClassEndsWith

Klassenaam eindigt met tekst.

ClassContains

Klasse bevat tekst.

Find

Zoekt naar venster zoals opgegeven met het element Class of Caption.

Desktop

Stelt het zoekpunt in op het bureaublad.

Application

Stelt het zoekpunt in op het venster van het hoogste niveau van de toepassing.

Owner

Venster met opgegeven eigenaar.

RelaxProcessIdRestriction

Neemt vensters met verschillende proces-id's op in zoekopdracht. Standaard behoren alle vensters tot dezelfde proces-id.

RelaxThreadIdRestriction

Neemt vensters met verschillende thread-id's op in het zoekproces. Standaard behoren alle vensters tot dezelfde thread-id.

De volgende XML toont een besturingselementdefinitie met de code <FindWindow>.

<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>

In het voorafgaande XML-voorbeeld hebben de elementen de volgende definities:

  • <Application/> - Stelt het contextvenster in op het venster van het hoogste niveau van de toepassing. Standaard wordt de context geïnitialiseerd op het venster van het hoogste niveau vóór het eerste onderliggende knooppunt in <FindWindow/>.

  • -<Desktop/> - Stelt het contextvenster in op het bureaubladvenster op het hoofdniveau.

  • <Caption match="1">Font</Caption> - Doorzoekt de vensterhiërarchie, te beginnen bij het huidige contextvenster en verder omlaag in de hiërarchie, op het eerste venster met bijschrifttekst die overeenkomt met de opgegeven tekst. Indien match="2", wordt gezocht naar het tweede venster met bijschrifttekst die overeenkomt met de opgegeven tekst. Als geen match-kenmerk wordt opgegeven, is match="1" de standaard. De tekstvergelijking is een subtekenreeksmatch met de bijschrifttekst. Als de opgegeven tekst kan worden gevonden als een subtekenreeks in het bijschrift van het venster, wordt dit als een match beschouwd. Het venster dat een succesvolle match oplevert, wordt het nieuwe contextvenster. Als geen overeenkomst wordt gevonden, mislukt de zoekactie. Standaard worden alleen vensters die tot dezelfde ProcessId en ThreadId behoren, als een match beschouwd.

  • <Class>#32770</Class> - Doorzoekt de vensterhiërarchie op het eerste venster met klassetekst die overeenkomt met de opgegeven tekst. Alle andere gedragsdetails zijn identiek aan <Caption/>.

  • <ControlId>7d</ControlId> - Doorzoekt de vensterhiërarchie op het eerste venster met een besturingselement-id die overeenkomt met de opgegeven waarde. Dit moet een exacte match zijn. Alle andere gedragsdetails zijn identiek aan <Caption/>.

De volgende XML zoekt het venster met het bijschrift OK in het eerste venster met het bijschrift Font en de klasse-id 32770, te beginnen op het bureaublad.

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

De volgende XML zoekt het venster met besturingselement-id 7D, te beginnen met het venster van het hoogste niveau van de toepassing.

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

De volgende XML zoekt het (eerste) venster met de klassenaam Notepad, te beginnen op het bureaublad.

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

Zie ook

WinDDA
Data-Driven Adapters (DDA's) gebruiken

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht