Métodos do emulador BlueZone

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura

    • Os métodos do emulador BlueZone permitem automatizar tarefas no emulador BlueZone. Por exemplo, você pode capturar texto da tela do emulador na forma de uma tabela e inserir o texto em uma planilha do Excel.

    Métodos de nível de tela

    GetFieldText

    Retorna o texto da linha e da coluna que você especificar.
    Tabela 1. Parâmetros do método GetFieldText
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Linha Número da linha na tela do emulador. Dados em Inteiro Nenhum Sim
    Coluna Número da coluna na tela do emulador. Dados em Inteiro Nenhum Sim
    Retornar Retorna o texto da linha e da coluna. Dados esgotados Cadeia de caracteres N/D N/D

    GetTextFromRect

    Retorna o texto de um intervalo especificado de linhas e colunas que existem em uma área retângulo na tela do emulador. A imagem mostra uma área quadrada na tela e as linhas e colunas iniciais e finais.

    Área Retangular em uma tela.

    Tabela 2. Parâmetros do método GetTextFromRect
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    LinhaInicial O número da linha que existe no início da área quadrada. Dados em Inteiro N/D Sim
    StartCol O número da coluna que existe no início da área quadrada. Dados em Inteiro N/D Sim
    LinhaFim O número da linha que existe no final da área quadrada. Dados em Inteiro N/D Sim
    EndCol O número da coluna que existe no final da área quadrada. Dados em Inteiro N/D Sim
    Retornar Retorna o texto. Dados esgotados Cadeia de caracteres N/D N/D

    Foi criado

    Verifica se a tela do emulador está ativa.
    Tabela 3. Parâmetros do método IsCreated
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Corresponder a todos os secundários Parâmetro que permite que o método encontre a tela do emulador correspondendo seus elementos secundários. Dados em Booleano Falso Sim
    Aviso:
    O uso desta opção pode atrasar a execução do método.
    Retornar Retorna o valor booliano, dependendo se o método em que a tela está ativo. Dados esgotados Booleano N/D N/D

    SearchText

    Retorna a coluna e a linha que contêm o texto especificado.
    Tabela 4. Parâmetros do método SearchText
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Texto Texto que o método pesquisa. Dados em Cadeia de caracteres N/D Sim O texto especificado faz distinção entre maiúsculas e minúsculas.
    Linha Número da linha na qual reside o texto especificado. Dados esgotados Inteiro N/D N/D Se o texto especificado ocorrer em várias linhas e colunas, o método retornará a primeira linha e coluna que contém o texto.
    Coluna Número da coluna na qual reside o texto especificado. Dados esgotados Inteiro N/D N/D Se o texto especificado ocorrer em várias linhas e colunas, o método retornará a primeira linha e coluna que contém o texto.

    SendKeys

    Insere pressionamentos de tecla que você insere no teclado do emulador.

    Nota:
    Use o método SetCursorPosition antes de usar este método.
    Tabela 5. Parâmetros do método SendKeys
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chaves Pressionamentos de teclas que você insere no teclado. Dados em Cadeia de caracteres Nenhum Sim

    SendKeysSecure

    Envia chaves criptografadas para a posição do cursor especificada na tela do emulador.

    Nota:
    Use o método SetCursorPosition antes de usar este método.
    Tabela 6. Parâmetros do método SendKeys
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chaves Pressionamentos de teclas que você insere no teclado. Dados em Cadeia de caracteres protegida Nenhum Sim
    Dica:
    Para saber mais sobre as teclas digitadas para o emulador BlueZone, consulte https://www3.rocketsoftware.com/bluezone/help/v50/en/bz/DISPLAY/OPTIONS/MF/MF_Key_Mapping.htm.

    Definir posição do cursor

    Define o cursor na linha e coluna especificadas na tela do emulador.
    Tabela 7. Parâmetros do método SetCursorPosition
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Linha Opção para fornecer o número da linha na qual o método define o cursor. Dados em Inteiro N/D N/D
    Coluna Opção para fornecer o número da coluna na qual o método define o cursor. Dados em Inteiro N/D N/D

    Definir texto do campo

    Define o texto na linha e na coluna especificadas.
    Tabela 8. Parâmetros do método SetCursorPosition
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Linha Número da linha em que você deseja definir o texto. Dados em Inteiro Nenhum Sim O método substitui o texto existente, se houver.
    Coluna Número da coluna em que você deseja definir o texto. Dados em Inteiro Nenhum Sim O método substitui o texto existente, se houver.

    AguardarCriação

    Aguarda a tela do emulador ficar disponível.
    Tabela 9. Parâmetros do método WaitForCreate
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    timeoutInSeconds A operação do método expira após a duração especificada. Dados em Inteiro 30 segundos Sim
    Corresponder a todos os secundários Corresponde aos elementos da tela que você capturou, se houver. Dados em Booleano Falso Sim
    Aviso:
    O uso desta opção pode atrasar a execução do método.
    Retornar Retorna o valor booliano que indica se a tela do emulador está disponível. Dados esgotados Booleano N/D N/D

    Métodos de nível de elemento

    Obter como tabela

    Retorna o texto no elemento que você capturou em uma tabela.
    Tabela 10. Parâmetros do método GetAsTable
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Retornar Retorna o texto no elemento em uma tabela. Dados esgotados Tabela de dados N/D N/D

    Obter texto

    Retorna o texto no elemento que você capturou.
    Tabela 11. Parâmetros do método GetText
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Retornar Retorna o texto no elemento. Dados esgotados Cadeia de caracteres N/D N/D

    Foi criado

    Retorna o valor booliano que indica se o elemento está disponível.
    Tabela 12. Parâmetros do método IsCreated
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Retornar Retorna o valor booliano que indica se o elemento está disponível. Dados esgotados Booleano N/D N/D

    Definir texto

    Define o texto que você especifica para o elemento.
    Tabela 13. Parâmetros do método IsCreated
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Texto Texto que o método define para o elemento. Dados em Cadeia de caracteres Nenhum Sim O método substitui o texto existente, se houver.

    AguardarCriação

    Aguarda o elemento ficar disponível.
    Tabela 14. Parâmetros do método WaitForCreate
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    timeoutInSeconds A operação do método expira após a duração especificada. Dados em Inteiro 30 segundos Sim
    Retornar Retorna o valor booliano que indica se o elemento está disponível. Dados esgotados Booleano N/D N/D