Condividi tramite

Tag FindWindow

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Il tag <FindWindow> è costituito da un elenco di elementi figlio che rappresentano una sequenza di operazioni di corrispondenza le quali devono tutte avere esito positivo per considerare trovata la finestra di destinazione.

I seguenti frammenti di codice mostrano come i vari elementi <FindWindow> vengono utilizzati per trovare la finestra di destinazione:

# 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 }*
}
}

Elementi del tag <FindWindow>

Nella tabella seguente sono descritti i diversi elementi del tag <FindWindow>.

Elemento

Descrizione

ControlId

Finestra con ID.

Caption

Testo della didascalia della finestra.

CaptionStartsWith

La didascalia inizia con il testo.

CaptionEndsWith

La didascalia termina con il testo.

CaptionContains

La didascalia contiene il testo.

Class

Finestra con nome di classe.

ClassStartsWith

Il nome di classe inizia con il testo.

ClassEndsWith

Il nome di classe termina con il testo.

ClassContains

La classe contiene il testo.

Find

Cerca una finestra come specificato tramite l'elemento Caption o Class.

Desktop

Imposta il punto di ricerca sul desktop.

Application

Imposta il punto di ricerca sulla finestra di primo livello dell'applicazione.

Owner

Finestra con il proprietario specificato.

RelaxProcessIdRestriction

Include nella ricerca le finestre con un diverso ID processo. Per impostazione predefinita, tutte le finestre appartengono allo stesso ID processo.

RelaxThreadIdRestriction

Include nel processo di ricerca le finestre con un diverso ID thread. Per impostazione predefinita, tutte le finestre appartengono allo stesso ID thread.

Il seguente XML mostra la definizione del controllo utilizzando il tag <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>

Nell'XML di esempio precedente, gli elementi hanno le seguenti definizioni:

  • <Application/>: imposta la finestra di contesto sulla finestra di primo livello dell'applicazione. Per impostazione predefinita, il contesto è inizializzato sulla finestra di primo livello prima del primo nodo figlio in <FindWindow/>.

  • <Desktop/>: imposta la finestra di contesto sulla finestra del desktop a livello di radice.

  • <Caption match="1">Font</Caption>: cerca nella gerarchia delle finestre, a partire dalla finestra di contesto corrente, la prima finestra con il testo della didascalia corrispondente al testo fornito. Se match="2", cerca la seconda finestra con il testo della didascalia corrispondente al testo fornito. Se nessun attributo match viene indicato, match="1" è l'impostazione predefinita. Il confronto del testo è la corrispondenza di una sottostringa al testo della didascalia. Quando il testo fornito viene trovato come sottostringa nella didascalia della finestra dell'oggetto, viene considerata una corrispondenza. La finestra corrispondente diventa la nuova finestra di contesto. Se non viene trovata alcuna corrispondenza, la ricerca ha esito negativo. Per impostazione predefinita, solo le finestre che appartengono allo stesso ProcessId e ThreadId sono considerate una corrispondenza.

  • <Class>#32770</Class>: cerca nella gerarchia delle finestre la prima finestra con il testo della classe corrispondente al testo fornito. Tutti gli altri dettagli di comportamento sono identici a <Caption/>..

  • <ControlId>7d</ControlId>: cerca nella gerarchia delle finestre la prima finestra con un ID controllo corrispondente al valore fornito. Deve essere una corrispondenza esatta. Tutti gli altri dettagli di comportamento sono identici a <Caption/>.

Il seguente XML esegue la ricerca della finestra con la didascalia OK nella prima finestra con la didascalia Font e l'ID classe 32770, a partire dal desktop.

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

Il seguente XML esegue la ricerca dalla finestra con ID controllo 7D, a partire dalla finestra di primo livello dell'applicazione.

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

Il seguente XML esegue la ricerca della (prima) finestra con il nome di classe Notepad, a partire dal desktop.

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

Vedere anche

WinDDA
Utilizzare adapter guidati dai dati (DDA)

Unified Service Desk 2.0

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright

  • Last updated on