Ações de automação da interface do usuário

Importante

Para evitar o acesso não autorizado, o Power Automate precisa ser executado com privilégios iguais ou superiores aos aplicativos que automatiza. Para usar as ações de automação da interface do usuário (exceto para a ação Usar área de trabalho) para interagir com aplicativos executados com privilégios elevados, execute o Power Automate como administrador. Para encontrar mais informações sobre a execução do Power Automate como administrador, acesse Executar o Power Automate com direitos elevados.

O Power Automate fornece várias ações de automação de IU para permitir que os usuários interajam com o Windows e os aplicativos da área de trabalho. Algumas ações de automação da interface do usuário exigem que você defina os elementos da interface do usuário em suas propriedades para indicar o elemento que deseja manipular.

Para adicionar um novo elemento de interface do usuário, selecione Adicionar elemento da Interface do Usuário por meio da ação de automação da Interface do Usuário implantada ou do painel Elementos da Interface do Usuário do designer de fluxo.

Todos os elementos da IU consistem em seletores que indicam a estrutura hierárquica dos componentes. Os seletores usam a notação > para indicar que cada elemento está contido no elemento à sua esquerda.

Quando você cria um elemento de interface do usuário de uma janela de aplicativo, seu seletor sempre tem um elemento raiz chamado :desktop.

Se você criar um elemento de interface do usuário que aponta um componente dentro de uma janela do aplicativo, dois elementos de interface do usuário serão criados automaticamente. O elemento de interface do usuário pai aponta a janela do aplicativo, enquanto o filho mostra a estrutura hierárquica do componente específico dentro da janela.

Embora os seletores sejam criados automaticamente, ao adicionar elementos de interface do usuário, alguns cenários específicos precisam de seletores criados manualmente. Quando um seletor personalizado é necessário, é possível editar um seletor existente ou criar um do zero.

Para desenvolver fluxos mais dinâmicos, substitua os operadores Igual a por outros operadores ou expressões regulares. Além disso, caso o valor do atributo de um seletor dependa de cálculos dos resultados de ações anteriores, use variáveis em vez do valor embutido em código.

Para muitas ações de automação de UI existem dois modos de execução de ações: físico e simulado. No modo físico, a ferramenta assume o controle do mouse e do teclado da máquina para realizar a ação fisicamente. No modo simulado, a ação é executada de forma programada sem assumir o controle do mouse e do teclado e sem exigir que a tela do elemento da interface do usuário seja trazida para o primeiro plano. É importante observar que a opção simulada pode não ser aplicável a todos os elementos da UI. Para realizar uma ação por simulação, habilite o parâmetro Simular ação em algumas ações ou desative o parâmetro Trazer para frente em outras ações.

Observação

Para encontrar mais informações sobre o desenvolvimento de fluxos de automação da interface do usuário e a criação de seletores personalizados, acesse Automatizar fluxos da área de trabalho e Criar um seletor personalizado, respectivamente.

Obter detalhes da janela

Obtém uma propriedade de uma janela como o título ou o texto de origem.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Janela	Não	Elemento da interface do usuário		A janela da qual os detalhes serão obtidos
Propriedade da janela	N/D	Obter título da janela, Obter texto da janela, Obter localização e tamanho da janela, Obter nome do processo	Obter título da janela	Escolha qual propriedade da janela deseja extrair
Trazer para a frente	N/A	Valor booliano	Verdadeiro	Especifique se a janela que contém o elemento UI será trazida para frente durante a execução. Se esta opção estiver desabilitada, a ação será executada em segundo plano. Observe que nem todos os elementos da IU são compatíveis com a opção desativada. Além disso, se a execução da ação exigir rolagem, a desativação dessa opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
WindowProperty	Valor geral	As informações recuperadas da janela

Exceções

Exceção	Descrição
Falha ao recuperar propriedade da janela	Indica um problema ao recuperar a propriedade da janela

Obter detalhes de um elemento da interface do usuário na janela

Obtém o valor do atributo de um elemento da interface do usuário em uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Elemento da interface do usuário	Não	Elemento da interface do usuário		O elemento da interface do usuário do qual obter detalhes
Nome do atributo	Sim	Valor do texto	Próprio Texto	O atributo cujo valor será recuperado
Trazer para a frente	N/A	Valor booliano	Verdadeiro	Especifique se a janela que contém o elemento UI será trazida para frente durante a execução. Se esta opção estiver desabilitada, a ação será executada em segundo plano. Observe que nem todos os elementos da IU são compatíveis com a opção desativada. Além disso, se a execução da ação exigir rolagem, a desativação dessa opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
AttributeValue	Valor do texto	O valor do texto do elemento de interface do usuário

Exceções

Exceção	Descrição
Falha ao recuperar o atributo do elemento de interface do usuário	Indica um problema ao recuperar o atributo do elemento de interface do usuário

Obter caixas de seleção marcadas em uma janela

Recupera os nomes das caixas de seleção marcadas em um grupo da caixa de seleção ou o estado de uma caixa de seleção específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Elemento da interface do usuário	Não	Elemento da interface do usuário		A caixa de seleção ou grupo da caixa de seleção
Operação	N/D	Obter nomes das caixas de seleção marcadas no grupo, Obter estado da caixa de seleção	Obter nomes de caixas de seleção marcadas no grupo	Especifique se deseja recuperar o estado de várias caixas de seleção marcadas ou de apenas uma
Trazer para a frente	N/A	Valor booliano	Verdadeiro	Especifique se a janela que contém o elemento UI deve ser trazida para frente durante a execução. Se esta opção estiver desabilitada, a ação será executada em segundo plano. Observe que nem todos os elementos da IU podem ser compatíveis com a opção desativada. Além disso, se a execução da ação exigir rolagem, a desativação dessa opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
IsChecked	Valor booliano	O estado da caixa de seleção marcada
SelectedCheckboxes	Lista de Valores do texto	Os nomes das caixas de seleção marcadas dentro do grupo da caixa de seleção especificado

Exceções

Exceção	Descrição
Falha ao recuperar o(s) estado(s) da caixa de seleção	Indica um problema ao recuperar os estados da caixa de seleção especificada

Obter botão de opção selecionado na janela

Recupera os nomes do botão de opção selecionado em um grupo de botões de opção ou o estado de um botão de opção específico.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Elemento da interface do usuário	Não	Elemento da interface do usuário		O botão de opção ou grupo de botões de opção
Operação	N/D	Obter o nome do botão de opção selecionado no grupo, Obter estado do botão de opção	Obter nome do botão de opção no grupo	Especifique se deseja recuperar o nome do botão de opção selecionado dentro de um grupo de botões de opção ou apenas o estado de um único botão de opção
Trazer para a frente	N/A	Valor booliano	Verdadeiro	Especifique se a janela que contém o elemento UI será trazida para frente durante a execução. Se esta opção estiver desabilitada, a ação será executada em segundo plano. Observe que nem todos os elementos da IU são compatíveis com a opção desativada. Além disso, se a execução da ação exigir rolagem, a desativação dessa opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
IsSelected	Valor booliano	O estado do botão de opção selecionado
SelectedRadiobutton	Valor do texto	O botão de opção selecionado dentro do grupo de opção especificado

Exceções

Exceção	Descrição
Falha ao recuperar o estado do botão de opção	Indica um problema ao recuperar o estado do botão de opção

Extrair dados da janela

Extrai dados de partes específicas de uma janela na forma de valores únicos, listas ou tabelas.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Janela	Não	Elemento da interface do usuário		A janela da qual dados serão extraídos
Armazenar dados extraídos em	N/D	uma planilha do Excel, Uma variável	uma planilha do Excel	Especifique onde os dados extraídos serão armazenados
Trazer para a frente	N/A	Valor booliano	Verdadeiro	Especifique se a janela que contém o elemento UI será trazida para frente durante a execução. Se esta opção estiver desabilitada, a ação será executada em segundo plano. Observe que nem todos os elementos da IU são compatíveis com a opção desativada. Além disso, se a execução da ação exigir rolagem, a desativação dessa opção poderá não extrair todos os elementos.

Variáveis produzidas

Argumento	Tipo	Descrição
ExcelInstance	Excel instance	A instância do Excel com os dados extraídos. Use esta instância para manipular a planilha (ou salvá-la e fechá-la) usando as ações dedicadas do Excel.
DataFromWindow	Valor geral	Os dados extraídos na forma de uma tabela de dados

Exceções

Exceção	Descrição
Falha na extração	Indica um problema para extrair dados da janela especificada

Tirar captura de tela do elemento da interface do usuário

Gera uma captura de tela de um elemento da interface do usuário na janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Elemento de interface do usuário	Não	Elemento da interface do usuário		O elemento da interface do usuário na janela para gerar a captura de tela
Modo de salvamento	N/D	Área de transferência, Arquivo	Área de transferência	Especifique se você quer salvar a imagem em arquivo ou armazená-la na área de transferência
Caminho do arquivo de imagem	Não	Arquivo		Defina o caminho completo do arquivo a ser salvo
Formato do arquivo	N/D	BMP, EMF, EXIF, GIF, JPG, PNG, TIFF, WMF	BMP	O formato do arquivo de imagem

Variáveis produzidas

Argumento	Type	Description
ImageFile	Arquivo	O caminho do arquivo de imagem da captura de tela gerada

Exceções

Exceção	Descrição
Falha ao recuperar o elemento da interface do usuário	Indica um problema ao recuperar o elemento de interface do usuário
Falha ao salvar a imagem	Indica um problema ao salvar a captura de tela tirada
Falha ao criar a captura de tela do elemento da interface do usuário	Indica um problema ai tirar a captura de tela de um elemento de interface do usuário

Focalizar campo de texto na janela

Define o foco em uma caixa de texto de uma janela e a exibe.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Campo de texto	Não	Elemento da interface do usuário		A caixa de texto a ser focalizada

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Falha ao definir o foco de entrada na caixa de texto da janela	Indica um problema ao configurar o foco no campo de texto especificado da página da web

Preencher campo de texto na janela

Preenche uma caixa de texto em uma janela com o texto especificado.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Caixa de texto	Não	Elemento da interface do usuário		A caixa de texto a ser preenchida
Texto para preencher	Não	Entrada direta criptografada ou Valor do texto		O texto que preencherá o campo de texto
Simular ação	N/A	Valor booliano	False	Simula os pressionamentos de tecla de forma programática ao preencher texto para elementos de campo de texto da interface do usuário. Esta opção não requer que a janela do elemento da interface do usuário esteja focada, isso não o trará automaticamente para o primeiro plano. Observe que esta opção pode ser aplicada apenas à ação de clique com o botão esquerdo e pode não ser aplicável a todos os elementos da Interface do Usuário.
Se o campo não estiver em branco	Sim	Substituir texto, acrescentar texto	Substituir texto	Especifique se o conteúdo existente deve ser substituído ou acrescentado.
Clique antes de preencher	Sim	Clique com o botão esquerdo, clique duplo, não	Clique com o botão esquerdo do mouse	Especifique se um clique com o botão esquerdo do mouse é executado antes de preencher ou não o campo de texto.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Falha ao gravar na caixa de texto	Indica um problema ao preencher o campo de texto especificado

Pressionar botão na janela

Pressiona um botão da janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Elemento da interface do usuário	Não	Elemento da interface do usuário		O botão a ser pressionado

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Falha ao pressionar o botão	Indica um problema ao pressionar o botão especificado

Selecionar botão de opção na janela

Seleciona um botão de opção em uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Botão de opção	Não	Elemento da interface do usuário		O botão de opção a ser selecionado

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Falha ao selecionar elemento de interface do usuário do botão de opção	Indica um problema ao selecionar o elemento de interface do usuário do botão de opção especificado

Definir estado da caixa de seleção na janela

Marca ou desmarca uma caixa de seleção em um formulário de janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Caixa de seleção	Não	Elemento da interface do usuário		A caixa de seleção cujo estado será definido
Definir o estado da caixa de seleção como	N/D	Marcada, Desmarcada	Marcados	Especifique se a caixa de seleção será marcada ou desmarcada

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Falha ao definir o estado da caixa de seleção	Indica um problema ao definir o estado da caixa de seleção especificada

Definir valor de lista suspensa na janela

Define ou limpa as opções selecionadas de uma lista suspensa em um formulário de janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Lista suspensa	Não	Elemento da interface do usuário		A lista suspensa cujo valor deve ser definido
Operation	N/A	Limpar opções selecionadas, Selecionar opções por nome, Selecionar opções por índice	Limpar opções selecionadas	Especifique se deseja selecionar um valor por nome ou por posição ordinal (1 2 3...) ou limpe o valor selecionado na lista suspensa
Nomes da opção	Não	Lista de Valores do texto		Insira uma opção ou uma lista de opções a serem selecionadas na lista suspensa. Múltiplas opções só fazem sentido ao trabalhar com listas de seleção múltipla. Se a lista for de seleção única, apenas a primeira opção da lista especificada será usada.
Usar expressões regulares	N/A	Valor booliano	Falso	Especifique se os valores de nomes de opção devem ser interpretados como uma expressão regular
Índices de opções	Não	Lista de Valores numéricos		Insira um índice ou uma lista de índices a serem selecionados na lista suspensa. Múltiplas opções só fazem sentido ao trabalhar com listas de seleção múltipla. Se a lista for de seleção única, apenas a primeira opção da lista especificada será usada.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Falha ao selecionar as opções especificadas na lista suspensa	Indica um problema ao selecionar as opções especificadas na lista suspensa

Obter janela

Obtém uma janela em execução, para automatizar aplicativos da área de trabalho.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Obter janela	N/D	Janela específica, janela de primeiro plano	Janela específica	Especifique se deseja procurar usando um seletor na janela em primeiro plano
Elemento da interface do usuário	Não	Elemento da interface do usuário		O seletor da janela a ser obtida
Trazer a janela para a frente	N/D	Valor booliano	Falso	Especifique se deseja colocar a janela em primeiro plano automaticamente após a aquisição
Falha se a janela não for encontrada	N/D	Valor booliano	Verdadeiro	Especifique se é necessário esperar indefinidamente a caixa a ser exibida ou falhar se a janela não aparecer em um período de tempo definido
Timeout	Não	Valor numérico		O tempo limite de espera em segundos

Variáveis produzidas

Argumento	Tipo	Description
WindowTitle	Valor do texto	O título da janela em primeiro plano
AutomationWindow	Instância da janela	A instância específica da janela para uso com ações posteriores da Automação da interface do usuário

Exceções

Exceção	Descrição
Falha ao obter janela	Indica um problema ao obter a janela

Janela de foco

Ativa e coloca em primeiro plano uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de interface do usuário da janela	Especifique se deseja procurar a janela usando um elemento de interface do usuário ou uma combinação de título/classe da janela
Janela	Não	Elemento da interface do usuário		O elemento de interface do usuário da janela
Título da janela	Sim	Valor do texto		O título da janela. Curingas podem ser usados, como "?" ou "*".
Instância da janela	Não	Valor numérico		A instância ou o identificador da janela a ser focalizada
Classe da janela	Sim	Valor do texto		Se houver duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Nesse caso, insira a classe da janela a ser usada.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
A janela não foi encontrada	Indica que a janela especificada não foi encontrada
Não é possível focalizar a janela	Indica um problema ao focalizar a janela especificada
Não é possível executar a ação relacionada à janela no modo não interativo	Indica um problema ao executar uma ação relacionada à janela no modo não interativo

Definir estado da janela

Restaura, maximiza ou minimiza uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de interface do usuário da janela	Especifique se deseja procurar a janela usando um elemento de interface do usuário ou uma combinação de título/classe da janela
Janela	Não	Elemento da interface do usuário		O elemento de interface do usuário da janela
Título da janela	Sim	Valor do texto		O título da janela. Curingas podem ser usados, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela para definir o estado de
Classe da janela	Sim	Valor do texto		Se houver duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Nesse caso, insira a classe da janela a ser usada.
Estado da janela	N/D	Restaurado, Maximizado, Minimizado	Restaurado	Escolha em qual estado deseja exibir a janela

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
A janela não foi encontrada	Indica que a janela especificada não foi encontrada
Can't set window state	Indica um problema ao definir o estado da janela especificada
Não é possível executar a ação relacionada à janela no modo não interativo	Indica um problema ao executar uma ação relacionada à janela no modo não interativo

Definir visibilidade da janela

Mostra uma janela oculta ou oculta uma janela visível.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de interface do usuário da janela	Especifique se deseja procurar a janela usando um elemento de interface do usuário ou uma combinação de título/classe da janela
Janela	Não	Elemento da interface do usuário		O elemento de interface do usuário da janela
Título da janela	Sim	Valor do texto		O título da janela. Curingas podem ser usados, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela cuja visibilidade será definida
Window class	Sim	Valor do texto		Se houver duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Nesse caso, insira a classe da janela a ser usada.
Visibility	N/D	Visível, Oculto	Oculto	Escolha em qual estado deseja definir a visibilidade a janela

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
A janela não foi encontrada	Indica que a janela especificada não foi encontrada
Can't set window visibility	Indica um problema ao definir a visibilidade da janela especificada
Não é possível executar a ação relacionada à janela no modo não interativo	Indica um problema ao executar uma ação relacionada à janela no modo não interativo

Mover janela

Define a posição de uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de interface do usuário da janela	Especifique se deseja procurar a janela usando um elemento de interface do usuário ou uma combinação de título/classe da janela
Janela	Não	Elemento da interface do usuário		O elemento de interface do usuário da janela
Título da janela	Sim	Valor do texto		O título da janela. Curingas podem ser usados, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela a ser movido
Window class	Sim	Valor do texto		Se você tiver duas janelas com o mesmo título, a Classe da Janela pode ajudar a diferenciá-las. Nesse caso, insira a classe da janela a ser usada.
Position X	Não	Valor numérico		A posição X da janela
Position Y	Não	Valor numérico		A posição Y da janela

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
A janela não foi encontrada	Indica que a janela especificada não foi encontrada
Can't move window	Indica um problema ao mover a janela especificada
Não é possível executar a ação relacionada à janela no modo não interativo	Indica um problema ao executar uma ação relacionada à janela no modo não interativo

Redimensionar janela

Define o tamanho de uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de interface do usuário da janela	Especifique se deseja procurar a janela usando um elemento de interface do usuário ou uma combinação de título/classe da janela
Janela	Não	Elemento da interface do usuário		O elemento de interface do usuário da janela
Título da janela	Sim	Valor do texto		O título da janela. Curingas podem ser usados, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela a ser redimensionada
Window class	Sim	Valor do texto		Se houver duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Nesse caso, insira a classe da janela a ser usada
Width	Não	Valor numérico		A nova largura, em pixels
Height	Não	Valor numérico		A nova altura, em pixels.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
A janela não foi encontrada	Indica que a janela especificada não foi encontrada
Can't resize window	Indica um problema ao redimensionar a janela especificada
Não é possível executar a ação relacionada à janela no modo não interativo	Indica um problema ao executar uma ação relacionada à janela no modo não interativo

Fechar janela

Fecha uma janela específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Find window mode	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de interface do usuário da janela	Especifique se deseja procurar a janela usando um elemento de interface do usuário ou uma combinação de título/classe da janela
Janela	Não	Elemento da interface do usuário		O elemento de interface do usuário da janela
Título da janela	Sim	Valor do texto		O título da janela. Curingas podem ser usados, como "?" ou "*".
Window instance	Não	Valor numérico		A instância ou o identificador da janela a ser fechada
Window class	Sim	Valor do texto		Se houver duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Nesse caso, insira a classe da janela a ser usada.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
A janela não foi encontrada	Indica que a janela especificada não foi encontrada
Can't close window	Indica um problema ao fechar a janela especificada
Não é possível executar a ação relacionada à janela no modo não interativo	Indica um problema ao executar uma ação relacionada à janela no modo não interativo

Se a janela contiver

Marca o início de um bloco condicional de ações dependendo se um trecho de texto ou elemento da interface do usuário específico existe em uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Check if window	N/D	Contém elemento de IU, Não contém elemento de IU, Contém texto, Não contém texto	Contém elemento da interface do usuário	Verifique se um texto ou elemento de interface do usuário específico existe em uma janela
Check UI element state	N/D	Valor booliano	False	Verifique se um elemento de interface do usuário específico será habilitado ou desabilitado
Texto	Não	Valor do texto		O texto a ser verificado
Elemento da interface do usuário	Não	Elemento da interface do usuário		O elemento de interface do usuário que deve ser verificado
Janela	Não	Elemento da interface do usuário		A janela a ser verificada se o texto existir
Estado	N/D	Habilitado, Desabilitado	Habilitadas	O estado elemento de interface do usuário que deve ser verificado

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Aguardar o conteúdo da janela

Suspende a execução da automação até que uma parte específica do texto ou elemento de interface do usuário apareça ou desapareça da janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Wait until window	N/D	Contém elemento de IU, Não contém elemento de IU, Contém texto, Não contém texto	Contém elemento da interface do usuário	Se deseja aguardar um texto ou elemento de interface do usuário específico aparecer em uma janela
Check UI element state	N/D	Valor booliano	False	Verifique se um elemento de interface do usuário específico será habilitado ou desabilitado
Texto	Não	Valor do texto		O texto a ser verificado
Elemento da interface do usuário	Não	Elemento da interface do usuário		O elemento de interface do usuário que deve ser verificado
Janela	Não	Elemento da interface do usuário		A janela a ser verificada se o texto existir
Estado	N/D	Habilitado, Desabilitado	Habilitadas	O estado elemento de interface do usuário que deve ser verificado

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Wait for window content failed	Indica falha na operação de espera

Se a imagem

Esta ação marca o início de um bloco condicional de ações, dependendo se uma imagem selecionada for encontrada na tela ou não.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
If image	N/D	existe, não existe	existe	Se deseja verificar a existência ou ausência da imagem selecionada
Imagem	Não	Lista de Imagens		A imagem que a ação verificará se existe
Pesquisar imagem em	N/D	Tela inteira, Somente janela em primeiro plano	Tela inteira	Especifica se a imagem especificada deve ser pesquisada somente na janela em primeiro plano ou em toda a tela visível. Nenhuma escolha encontrará a imagem se ela não estiver claramente visível na tela
Search mode	N/D	Pesquisar na tela inteira ou na janela em primeiro plano, Pesquisar na sub-região especificada da tela ou na janela em primeiro plano	Pesquisar tela inteira ou janela em primeiro plano	Se toda a tela (ou janela) será verificada para encontrar o texto fornecido ou somente uma sub-região reduzida dela
Find all images in the list	N/D	Valor booliano	False	Verificar se todas as imagens na lista existem ou não
X1	Sim	Valor numérico		A coordenada X inicial da sub-região a ser verificada para o texto fornecido
X2	Sim	Valor numérico		A coordenada X final da sub-região a ser verificada para o texto fornecido
Y1	Sim	Valor numérico		A coordenada Y inicial da sub-região a ser verificada para o texto fornecido
Y2	Sim	Valor numérico		A coordenada Y final da sub-região a ser verificada para o texto fornecido
Tolerance	Sim	Valor numérico	10	Especificar o quanto as imagens pesquisadas podem ser diferentes da imagem escolhida originalmente
Algoritmo de correspondência de imagens	N/A	Básico, Avançado	Básico	Qual algoritmo de imagem usar ao pesquisar por imagem

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Não é possível verificar a imagem no modo não interativo	Indica que uma imagem não pode ser identificada no modo não interativo
Invalid subregion coordinates	Indica que as coordenadas da sub-região determinada eram inválidas

Usar a área de trabalho

Executa operações relacionadas à área de trabalho e à barra de tarefas.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Elemento da interface do usuário	Não	Elemento da interface do usuário		O elemento da IU que será clicado
Click type	N/A	Clique com o botão esquerdo do mouse, Clique com o botão direito do mouse, Clique duplo	Clique com o botão esquerdo do mouse	O tipo de clique a ser executado
Launch new application when left-clicking on the taskbar	N/D	Valor booliano	Verdadeiro	Quando esse parâmetro é definido como "verdadeiro", isso garante que uma nova janela de um aplicativo será criada ao clicar com o botão esquerdo no ícone na barra de "início rápido", também conhecida como barra de tarefas do Windows 7 ou superior. Desmarque esta opção para trazer uma instância já em execução do aplicativo para o primeiro plano.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Taskbar operation failed	Indica falha na operação da barra de tarefas

Selecionar guia na janela

Seleciona uma guia de um grupo de guias.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Tabulação	Não	Elemento da interface do usuário		A guia a ser selecionada

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Selecting tab failed	Indica um problema ao selecionar a guia especificada

Aguardar a imagem

Esta ação aguarda até que uma imagem específica apareça na tela ou na janela em primeiro plano.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Wait for image to	N/D	Aparecer, Desaparecer	Aparecer	Verifique se deseja aguardar a imagem aparecer ou desaparecer
Imagem a ser aguardada	Não	Lista de Imagens		A imagem que a ação verificará se existe
Pesquisar imagem em	N/D	Tela inteira, Somente janela em primeiro plano	Tela inteira	Especifica se a imagem especificada deve ser pesquisada somente na janela em primeiro plano ou em toda a tela visível. Nenhuma escolha encontrará a imagem se ela não estiver claramente visível na tela
Search mode	N/D	Pesquisar na tela inteira ou na janela em primeiro plano, Pesquisar na sub-região especificada da tela ou na janela em primeiro plano	Pesquisar tela inteira ou janela em primeiro plano	Se toda a tela (ou janela) será verificada para encontrar o texto fornecido ou somente uma sub-região reduzida dela
Wait for all images	N/D	Valor booliano	False	Se deseja aguardar todas as imagens ou apenas uma imagem na lista aparecer (desaparecer)
X1	Sim	Valor numérico		A coordenada X inicial da sub-região a ser verificada para o texto fornecido
X2	Sim	Valor numérico		A coordenada X final da sub-região a ser verificada para o texto fornecido
Y1	Sim	Valor numérico		A coordenada Y inicial da sub-região a ser verificada para o texto fornecido
Y2	Sim	Valor numérico		A coordenada Y final da sub-região a ser verificada para o texto fornecido
Tolerance	Sim	Valor numérico	10	Especificar o quanto as imagens pesquisadas podem ser diferentes da imagem escolhida originalmente
Algoritmo de correspondência de imagens	N/A	Básico, Avançado	Básico	Qual algoritmo de imagem usar ao pesquisar por imagem
Falha com erro de tempo limite	N/A	Valor booliano	False	Especificar se você deseja que a ação aguarde indefinidamente ou haja falha após um período definido

Variáveis produzidas

Argumento	Tipo	Descrição
X	Valor numérico	A coordenada X do ponto em que o texto foi encontrado na tela. Se o texto foi pesquisado na janela em primeiro plano, esse valor é relativo ao canto superior esquerdo da janela.
N	Valor numérico	A coordenada Y do ponto em que o texto foi encontrado na tela. Se o texto foi pesquisado na janela em primeiro plano, esse valor é relativo ao canto superior esquerdo da janela.

Exceções

Exceção	Descrição
Wait for image failed	Indica falha na operação de espera
Não é possível verificar a imagem no modo não interativo	Indica que uma imagem não pode ser identificada no modo não interativo
Invalid subregion coordinates	Indica que as coordenadas da sub-região determinada eram inválidas

Passe o mouse sobre o elemento da interface do usuário na janela

Passe o mouse sobre qualquer elemento de interface do usuário na janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Elemento da interface do usuário	Não	Elemento da interface do usuário		Selecione o elemento da interface do usuário na janela para passar o mouse

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Failed to hover over element	Indica que o passar do mouse sobre o elemento falhou

Clicar em um elemento da interface do usuário na janela

Clica em qualquer elemento de interface do usuário de uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Elemento da interface do usuário	Não	Elemento da interface do usuário		O elemento de interface do usuário que deve ser clicado
Tipo de clique	N/A	Clique com o botão esquerdo, Clique com o botão direito, Clique duplo, clique com o botão do meio, Botão esquerdo para baixo, Botão esquerdo para cima, Botão direito para baixo, Botão direito para cima	Clique com o botão esquerdo do mouse	O tipo de clique a ser executado
Simular ação	N/A	Valor booliano	False	Especifique se deve simular a movimentação do mouse sobre o elemento antes de clicar. Esta opção não requer que a janela do elemento da interface do usuário esteja focada, isso não o trará automaticamente para o primeiro plano. Observe que esta opção pode ser aplicada apenas à ação de clique com o botão esquerdo e pode não ser aplicável a todos os elementos da Interface do Usuário.
Mouse position relative to UI element	N/A	Superior esquerdo, Centro superior, Superior direito, Centro, Direita intermediária, Inferior esquerdo, Centro inferior, Inferior direito	Centro	Especifique para qual seção do elemento de interface do usuário o mouse será movido antes de clicar
Offset X	Sim	Valor do texto	0	Deslocar o mouse da posição em determinado número de pixels para a direita
Offset Y	Sim	Valor do texto	0	Deslocar o mouse da posição em determinado número de pixels para baixo

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Click failed	Indica falha no clique

Selecionar opção de menu na janela

Seleciona uma opção em um menu de uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Elemento da interface do usuário	Não	Elemento da interface do usuário		A opção de menu a ser selecionada

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Failed to select option	Indica um problema ao selecionar a opção de menu especificada

Arrastar e soltar elemento de interface do usuário na janela

Arrasta e solta um elemento de interface do usuário de uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Elemento de interface do usuário a ser arrastado	Não	Elemento da interface do usuário		O elemento de interface do usuário a ser arrastado
Elemento de interface do usuário a ser solto	Não	Elemento da interface do usuário		O elemento de interface do usuário a ser solto
Tipo de clique	N/A	Clique com o botão esquerdo, Clique com o botão direito	Clique com o botão esquerdo do mouse	Especifique qual botão do mouse deve ser usado para clicar e manter pressionado ao arrastar o elemento da interface do usuário até seu destino
Mouse down offset X	Sim	Valor do texto	0	Desloque o clique do mouse, que será usado para pressionar e arrastar o elemento de interface do usuário, por esse número de pixels para a direita.
Mouse down offset Y	Sim	Valor do texto	0	Desloque o clique do mouse para baixo, que será usado para pressionar e arrastar o elemento da interface do usuário, por esse número de pixels para baixo
Mouse down position relative to drag-target UI element	N/D	Superior esquerdo, Centro superior, Superior direito, Centro, Direita intermediária, Inferior esquerdo, Centro inferior, Inferior direito	Centro	Especifique para qual seção do elemento da interface do usuário o mouse será movido antes de clicar
Mouse up offset X	Sim	Valor do texto	0	Desloque o clique do mouse para cima, que será usado para pressionar e arrastar o elemento da interface do usuário, por esse número de pixels para a direita.
Mouse up offset Y	Sim	Valor do texto	0	Desloque o clique do mouse para cima, que será usado para pressionar e arrastar o elemento da interface do usuário, por esse número de pixels para baixo
Mouse up position relative to drop-target UI element	N/D	Superior esquerdo, Centro superior, Superior direito, Centro, Direita intermediária, Inferior esquerdo, Centro inferior, Inferior direito	Centro	Especifique para qual seção do elemento da interface do usuário arrastar o mouse após o clique

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
UI element to drag wasn't found	Indica que o elemento da interface do usuário a ser arrastado não foi encontrado
Drop target UI element wasn't found	Indica que o elemento de interface do usuário do destino ao arrastar não foi encontrado
Drag and drop failed	Indica um problema durante o recurso de arrastar e soltar do elemento de interface do usuário especificado

Expandir/recolher nó de árvore na janela

Expande ou recolhe um nó de uma exibição de árvore em uma janela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Elemento da interface do usuário	Não	Elemento da interface do usuário		O nó de árvore para expandir/recolher
Caminho das pastas	Sim	Valor do texto		Um caminho separado por barra composto por nomes de pastas que levam até o nó de árvore para expandir ou recolher
Use regular expressions	N/D	Valor booliano	False	Especifique se deseja que o nome da pasta no caminho seja interpretado como uma expressão regular
Operation	N/D	Expandir, Recolher	Expandir	Especifique se deseja expandir ou recolher o nó de árvore

Observação

O mecanismo de expressão regular do Power Automate é o .NET. Para encontrar mais informações sobre expressões regulares, vá para Linguagem de Expressões Regulares – Referência Rápida.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Failed to set tree node to the specified state	Indica um problema ao configurar o nó de árvore para o estado especificado

Se a janela

Esta ação marca o início de um bloco condicional de ações, dependendo se uma janela é aberta ou não ou se uma janela é a janela (no primeiro plano) focalizada.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Obter janela	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de interface do usuário da janela	Especifique se deseja procurar a janela usando um elemento de interface do usuário ou uma combinação de título/classe da janela
Window title	Sim	Valor do texto		O título da janela. Curingas podem ser usados, como "?" ou "*".
Janela	Não	Elemento da interface do usuário		O elemento de interface do usuário da janela
Instância da janela	Não	Valor numérico		A instância ou o identificador da janela a ser verificada
Window class	Sim	Valor do texto		Se houver duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Nesse caso, insira a classe da janela a ser usada.
Check if window	N/D	Está aberto, Não está aberto, Está focado, Não está focado	Está aberto	O estado da janela a ser verificada

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Aguardar a janela

Suspende a execução ou o processo até que uma janela específica seja aberta, fechada ou perca o foco.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Localizar janela	N/D	Por elemento de IU da janela, Por instância/identificador de janela, Por título e/ou classe	Por elemento de interface do usuário da janela	Especifique se deseja procurar a janela usando um elemento de interface do usuário ou uma combinação de título/classe da janela
Window title	Sim	Valor do texto		O título da janela. Curingas podem ser usados, como "?" ou "*".
Janela	Não	Elemento da interface do usuário		O elemento de interface do usuário da janela
Instância da janela	Não	Valor numérico		A instância ou o identificador da janela a ser verificada
Window class	Sim	Valor do texto		Se houver duas janelas com o mesmo título, a classe da janela pode ajudar a diferenciá-las. Nesse caso, insira a classe da janela a ser usada
Wait for window to	N/D	Abrir, Fechar, Concentrar, Perder o foco	Aberta	Se deseja aguardar uma janela específica abrir, fechar, ficar focalizada (ou seja, se tornar a janela em primeiro plano) ou perder o foco (ou seja, deixar de ser a janela em primeiro plano).
Focus window after it opens	N/D	Valor booliano	False	Traga a janela para frente depois que ela abrir, para que as ações posteriores sejam direcionadas para esta janela

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Descrição
Não é possível focalizar a janela	Indica um problema ao focalizar a janela especificada
Wait for window failed	Indica falha na operação de espera
Não é possível executar a ação relacionada à janela no modo não interativo	Indica um problema ao executar uma ação relacionada à janela no modo não interativo