Compartilhar via

Marca FindWindow

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

A marca de <FindWindow> consiste em uma lista de elementos filho que representam uma sequência de operações correspondentes, todas que precisam de êxito para que a janela de destino seja considerada encontrada.

O trecho do código a seguir mostra como vários elementos de <FindWindow> são usados para localizar a janela de destino:

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

elementos da marca <FindWindow>

A tabela a seguir descreve os vários elementos da marca <FindWindow>:

Elemento

Descrição

ControlId

Janela com ID.

Caption

Texto de legenda da janela.

CaptionStartsWith

A legenda começa com texto.

CaptionEndsWith

A legenda termina com texto.

CaptionContains

A legenda contém o texto.

Class

Janela com nome da classe.

ClassStartsWith

Nome da classe começa com texto.

ClassEndsWith

Nome da classe termina com texto.

ClassContains

A classe contém o texto.

Find

Pesquisas da janela como especificada no elemento Class ou Caption.

Desktop

Define o ponto de pesquisa para a área de trabalho.

Application

Define o ponto de pesquisa à janela de nível superior de aplicativos.

Owner

Janela com proprietário especificado.

RelaxProcessIdRestriction

Inclui janelas com diferentes IDs do processo na pesquisa. Por padrão, todas as janelas pertencem à mesma ID de processo.

RelaxThreadIdRestriction

Inclui janelas com diferentes IDs de thread do processo da pesquisa. Por padrão, todas as janelas pertencem à mesma ID de thread.

O seguinte XML mostra a definição de controle usando a marca <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>

No XML anterior, os elementos têm as seguintes definições:

  • <Application/> – Define a janela do contexto na janela de nível superior do aplicativo. Por padrão, o contexto é inicializado na janela de nível superior antes do primeiro nó secundário <FindWindow/>.

  • <Desktop/> – Define a janela do contexto na janela de área de trabalho do nível raiz.

  • <Caption match="1">Font</Caption> – Pesquisa a hierarquia da janela, começando na janela de contexto atual e indo para baixo na hierarquia, para a primeira janela com o texto de legenda que corresponde ao texto fornecido. Se match="2", ele pesquisa a segunda janela com texto de legenda que corresponde ao texto fornecido. Se nenhum atributo match for fornecido, o match="1" é o padrão. A comparação de texto é uma correspondência da subcadeia de caracteres de texto de legenda. Se o texto fornecido puder ser encontrado como uma subcadeia de caracteres na legenda da janela de assunto, ele será considerado uma correspondência. A janela compatível com êxito se torna a nova janela de contexto. Se nenhuma correspondência for encontrada, a pesquisa falhará. Por padrão, somente janelas pertencentes à mesma ProcessId e ThreadId são consideradas uma correspondência.

  • <Class>#32770</Class> – Pesquisa a hierarquia da janela, pela primeira janela com texto de classe que corresponde ao texto fornecido. Todos os outros detalhes comportamentais são idênticos a <Caption/>.

  • <ControlId>7d</ControlId> – Pesquisa a hierarquia da janela, pela primeira janela com um ID de controle que corresponde ao valor fornecido. Deve ser uma correspondência exata. Todos os outros detalhes comportamentais são idênticos a <Caption/>.

O seguinte XML pesquisa a janela com a legenda OK na primeira janela com a legenda Fonte e a ID de classes 32770, começando na área de trabalho.

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

O seguinte XML procura a janela com a ID de controle 7D, começando na janela de nível superior do aplicativo.

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

O seguinte XML pesquisa a (primeira) janela com o nome de classe Notepad, começando na área de trabalho.

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

Confira Também

WinDDA
Use adaptadores orientados a dados (DDAs)

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais