Métodos do emulador IBM PCOMM

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

    • Os métodos do emulador IBM PCOMM permitem automatizar tarefas no emulador IBM PCOMM. 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 todo o texto de um campo depois de identificá-lo com base no número de linha e coluna que você especificou. A linha e a coluna são partes do campo. A imagem mostra que, embora você especifique a linha e o número da coluna da letra A, o método retorna o texto AMD64 porque ele faz parte do campo.

    Campo na tela.

    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 no campo da tela do terminal com base no qual o método identifica o campo. Dados em Inteiro N/D Sim
    Coluna Número da coluna no campo da tela do terminal com base no qual o método identifica o campo. Dados em Inteiro N/D Sim
    Retornar Retorna o texto completo no campo. Dados esgotados Cadeia de caracteres. N/D N/D

    GetTextFromRect

    Retorna o texto de uma área Retangular calculista na tela. Você especifica a área quadrada fornecendo os números de linha e coluna iniciais e finais. 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 no início da área quadrada. Dados em Inteiro N/D Sim
    StartCol O número da coluna no início da área quadrada. Dados em Inteiro N/D Sim
    LinhaFim O número da linha no final da área retângulo. Dados em Inteiro N/D Sim
    EndCol O número da coluna no final da área quadrada. Dados em Inteiro N/D Sim
    Retornar Retorna todo o texto da área Retangular calculável. 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 Opção para habilitar o método para encontrar a tela do emulador correspondendo seus elementos secundários. Dados em Booleano Falso Sim
    Aviso:
    O uso desta opção pode tornar o método mais lento.
    Retornar Retorna o valor booliano, dependendo se a tela do emulador está ativa. Dados esgotados Booleano N/D N/D

    SearchText

    Retorna os números da linha e da coluna que contêm o primeiro caractere do texto especificado. Por exemplo, se você especificar o emuladorde cadeia de caracteres , o método retornará os números de linha e coluna do caractere e
    Nota:
    Se você fornecer texto que abrange vários campos, as portas Linha e Coluna retornarão 0 porque o método oferece suporte a texto somente de um único campo.
    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 que tem o primeiro caractere do 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 que tem o primeiro caractere do 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

    Simula o pressionamento de teclas na posição do dispositivo do mouse na tela do emulador que você insere no teclado. Por exemplo, você pode simular o pressionamento da tecla Enter na tela.

    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
    Dica:
    Para saber mais sobre as teclas digitadas para o emulador IBM PCOMM, consulte https://www.ibm.com/docs/SSEQ5Y_6.0.0/com.ibm.pcomm.doc/books/pdf/emulator_referenceV60.pdf.

    SendKeysSecure

    Simula pressionamentos de teclas criptografados na posição do dispositivo do mouse 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 IBM PCOMM, consulte https://www.ibm.com/docs/SSEQ5Y_6.0.0/com.ibm.pcomm.doc/books/pdf/emulator_referenceV60.pdf.

    Definir posição do cursor

    Define o dispositivo do mouse 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 dispositivo do mouse na tela. Dados em Inteiro N/D N/D
    Coluna Opção para fornecer o número da coluna na qual o método define o dispositivo do mouse na tela. Dados em Inteiro N/D N/D

    AguardarCriação

    Aguarda a tela do emulador ficar ativa pelo tempo especificado.
    Tabela 8. 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 Número de segundos após o qual o método expira. Dados em Inteiro 30 Sim
    Corresponder a todos os secundários Opção para habilitar o método para aguardar a tela do emulador se tornar ativa, correspondendo aos elementos da tela. 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 a tela do emulador se tornou ativa. Dados esgotados Booleano N/D N/D

    Métodos no nível de campo

    Para acessar os métodos no nível de campo, clique duas vezes no campo ou na tabela que você capturou. Os métodos aparecem no painel Pesquisador de objetos.

    Métodos no nível de campo.

    Obter como tabela

    Retorna o texto capturado da tela do terminal em formato tabular. O ideal é usar este método ao capturar dados de uma tela como uma tabela. No entanto, você também pode usar isso para dados capturados como um campo. Para aprender a capturar dados como uma tabela, consulte IBM Emulador de PCOMM.
    Tabela 9. 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 capturado da tela do terminal em formato tabular. Dados esgotados Tabela de dados N/D N/D Para exibir a tabela, clique com o botão direito do mouse no parâmetro e selecione Visualizar dados.

    Obter texto

    Retorna o texto que você capturou da tela do emulador. O ideal é usar este método ao capturar dados de uma tela como um campo.
    Nota:
    Se você usar este método para uma tabela que você capturou, ele retornará o texto no primeiro campo da área Retangular calculável.
    Tabela 10. 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 do campo capturado. Dados esgotados Cadeia de caracteres N/D N/D Para exibir a tabela, clique com o botão direito do mouse no parâmetro e selecione Visualizar dados.

    Foi criado

    Verifica se o elemento está ativo.
    Tabela 11. 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, dependendo se o elemento está ativo. Dados esgotados Booleano N/D N/D

    Definir texto

    Define o texto personalizado no campo ou na tabela. O texto personalizado substitui o texto existente, se houver.
    Tabela 12. Parâmetros do método SetText
    Parâmetro Descrição Tipo de entrada de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Texto Texto que você deseja definir no campo ou na tabela. Dados em Cadeia de caracteres N/D Sim

    AguardarCriação

    Aguarda o elemento se tornar ativo pelo tempo especificado.
    Tabela 13. 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 Número de segundos após o qual o método expira. Dados em Inteiro 30 Sim
    Retornar Retorna o valor booliano, dependendo se o elemento se torna ativo. Dados esgotados Booleano N/D N/D