Del via

FindWindow-mærke

 

Udgivet: november 2016

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Mærket <FindWindow>, der består af en liste over underordnede elementer, der repræsenterer en række matchhandlinger, der alle skal fuldføres, for at målvinduet betragtes som fundet.

Følgende kodestykke viser, hvordan de forskellige <FindWindow>-elementer bruges til at finde målvinduet:

# 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>-mærkeelementer

I følgende tabel beskrives de forskellige elementer i <FindWindow>-mærket:

Element

Beskrivelse

ControlId

Vindue med ID.

Caption

Vinduets billedtekst.

CaptionStartsWith

Billedtekst starter med tekst.

CaptionEndsWith

Billedtekst slutter med tekst.

CaptionContains

Billedteksten indeholder tekst.

Class

Vindue med klassenavn.

ClassStartsWith

Klassenavn starter med tekst.

ClassEndsWith

Klassenavn slutter med tekst.

ClassContains

Klasse indeholder tekst.

Find

Søger efter vindue, som er angivet via Class- eller Caption-element.

Desktop

Indstiller søgepunktet til skrivebordet.

Application

Indstiller søgepunktet til programmets vindue på øverste niveau.

Owner

Vindue med angivet ejer.

RelaxProcessIdRestriction

Indeholder vinduer med forskellige proces-id'er i søgningen. Som standard tilhører alle vinduer det samme proces-id.

RelaxThreadIdRestriction

Indeholder vinduer med forskellige tråd-id'er i søgeprocessen. Som standard tilhører alle vinduer det samme tråd-id.

Følgende XML viser kontrolelementdefinition ved hjælp af <FindWindow>-mærket.

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

I det foregående XML-eksempel har elementerne følgende definitioner:

  • <Application/>– Indstiller kontekstvinduet til vinduet på øverste niveau i programmet. Som standard, initialiseres konteksten til det øverste vindue før den første underordnede node i <FindWindow/>.

  • <Desktop/> – Indstiller kontekstvinduet til skrivebordsvinduet på rodniveau.

  • <Caption match="1">Font</Caption> – Søger i vindueshierarkiet. Starter med det aktuelle kontekstvindue og søger nedefter i hierarkiet efter det første vindue med billedtekst, der svarer til den angivne tekst. Hvis match="2", søges der efter det andet vindue med billedtekst, der svarer til den angivne tekst. Hvis ingen match-attribut er angivet, er match="1" standard. Tekstsammenligningen er en understreng-match i forhold til titelteksten. Hvis den angivne tekst findes som en understreng i emnevinduets titel, betragtes den som et match. Det matchende vindue bliver det nye kontekstvindue. Hvis der ikke findes et match, er søgningen mislykkedes. Som standard betragtes kun vinduer, der tilhører det samme ProcessId og ThreadId som et match.

  • <Class>#32770</Class> – Søger i vindueshierarkiet efter det første vindue med klassetekst, der svarer til den angivne tekst. Alle øvrige funktionsmæssige detaljer er identiske med <Caption/>.

  • <ControlId>7d</ControlId> – Søger i vindueshierarkiet efter det første vindue med et kontrolelement-id, der svarer til den angivne værdi. Det skal være et nøjagtigt match. Alle øvrige funktionsmæssige detaljer er identiske med <Caption/>.

Følgende XML søger i vinduet med billedteksten OK i det første vindue med billedteksten Skrifttype og klasse-id 32770 med start på skrivebordet.

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

Følgende XML søger efter vinduet med kontrol-id 7D og starter med programmets øverste vindue.

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

Følgende XML søger efter det (første) vindue med klassenavnet Notesblok, med start på skrivebordet.

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

Se også

WinDDA
Brug af datastyrede kort (DDA'er)

Unified Service Desk 2.0

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret

  • Last updated on