IBM Métodos do emulador de comunicações pessoais

Use os métodos do emulador IBM de Comunicações pessoais para executar várias tarefas de automação no emulador IBM de Comunicações pessoais.

Métodos no nível da tela

Use métodos no nível da tela para executar as tarefas de automação na tela do emulador. Por exemplo, você pode simular um comando na tela ou obter texto da tela.

ObterTextoCampo

Retorna o texto que um campo contém depois de identificar o campo pelo número de linha e coluna especificado. A linha e a coluna especificadas são o ponto de partida do campo. O método identifica o campo inteiro e retorna o texto no campo. No exemplo a seguir, H é a primeira letra e o ponto de partida no campo e SO do host : é o texto completo no campo.

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 do campo que identifica o campo.	Entrada de dados	Inteiro	N/D	Sim
Coluna	Número da coluna de campo que identifica o campo.	Entrada de dados	Inteiro	N/D	Sim
Retornar	Retorna o texto no campo.	Saída de dados	Cadeia de caracteres	N/D	N/D

ObterTextoDeRetorno

Retorna o texto em todos os campos de uma área retangular que você define na tela. Você define uma área fornecendo as linhas e os números das colunas iniciais e finais. O método localiza e identifica o primeiro e o último campo e retorna todo o texto em todos os campos dessa área. O exemplo a seguir mostra a área que você definiu.

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
LinhaInício	Número de linha que indica o primeiro caractere do primeiro campo na área retangular.	Entrada de dados	Inteiro	N/D	Sim
StartCol	Número da coluna que contém o primeiro caractere do primeiro campo na área retangular.	Entrada de dados	Inteiro	N/D	Sim
EndRow	Número da linha que contém o último caractere do último campo na área retangular.	Entrada de dados	Inteiro	N/D	Sim
EndCol	Número da coluna que contém o último caractere do último campo na área retangular.	Entrada de dados	Inteiro	N/D	Sim
Retornar	Retorna o texto de todos os campos dentro da área retangular.	Saída de dados	Cadeia de caracteres	N/D	N/D

É criado

Verifica se a tela do emulador existe com base na regra de correspondência de tela e pode aceitar entradas do usuário. Após a verificação, o método retorna o valor booliano apropriado.

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
CorresponderTodos os Filhos	Opção para encontrar a tela do emulador correspondendo aos elementos secundários que você capturou.	Entrada de dados	Booliano	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 existe com base na regra de correspondência de tela e pode aceitar entradas do usuário.	Saída de dados	Booliano	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 ponto de partida do emulador de palavras, que é e.

Nota:

Se você fornecer o texto que abrange vários campos, as portas Linha e Coluna retornarão 0 porque o método oferece suporte ao 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.	Entrada de dados	Cadeia de caracteres	N/D	Sim	O texto especificado pode fazer a distinção entre maiúsculas e minúsculas, dependendo do emulador usado.
Linha	Número da linha que tem o primeiro caractere do texto especificado.	Saída de dados	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.	Saída de dados	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 os pressionamentos de tecla que você insere no teclado na posição do dispositivo do mouse na tela do emulador. Por exemplo, você pode simular o pressionamento de tecla [enter] na tela.

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 tecla que você insere no teclado.	Entrada de dados	Cadeia de caracteres	Nenhum(a)	Sim	Dica: Para saber mais sobre os pressionamentos de tecla, consulte a respectiva documentação do emulador de terminal.

SendKeysSecure

Simula os pressionamentos de tecla que é uma cadeia de caracteres protegida na posição do dispositivo do mouse na tela do emulador.

Tabela 6. Parâmetros do método SendKeysSecure

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório	Anotações
Chaves	Pressionamentos de tecla que você insere como uma cadeia de caracteres protegida.	Entrada de dados	Cadeia de caracteres protegida	Nenhum(a)	Sim	Dica: Para saber mais sobre os pressionamentos de tecla, consulte a respectiva documentação do emulador de terminal.

DefinirCursorPosition

Tenta definir o dispositivo do mouse no número de linha e coluna que você especificar.

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 com base na qual o método tenta definir o dispositivo do mouse na tela.	Entrada de dados	Inteiro	N/D	N/D	O número da linha deve ser positivo e estar dentro do tamanho da tela do emulador. Por exemplo, se o tamanho da tela for 24X80, o valor máximo que você pode fornecer para uma linha é 24.
Coluna	Opção para fornecer o número da linha com base na qual o método tenta definir o dispositivo do mouse na tela.	Entrada de dados	Inteiro	N/D	N/D	O número da coluna deve ser positivo e estar dentro do tamanho da tela do emulador. Por exemplo, se o tamanho da tela for 24X80, o valor máximo que você pode fornecer para uma coluna será 80.

AguardarCriação

Aguarda a duração especificada enquanto o conector usa a regra de correspondência de tela para descobrir se a tela existe.

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	Opção para fornecer o número de segundos que o método espera enquanto o conector usa a regra de correspondência de tela para descobrir se a tela existe.	Entrada de dados	Inteiro	30	Sim
CorresponderTodos os Filhos	Opção para corresponder a todos os elementos de tela que você capturou para descobrir se a tela existe.	Entrada de dados	Booliano	Falso	Sim	Aviso: O uso desta opção pode atrasar a execução do método.
Retornar	Retorna o valor booliano com base em se a tela do emulador foi encontrada.	Saída de dados	Booliano	N/D	N/D

Métodos no nível do elemento

Os métodos em nível de elemento executam tarefas de automação nos elementos de tela do emulador que você adiciona na tela do Conector de terminal. Você pode adicionar um elemento de tela como um campo ou uma tabela.

ObtercomoTabela

Retorna o texto que você capturou como um objeto de tabela de dados. Use este método ao capturar os dados de uma tela como uma tabela. No entanto, você também pode usar o método para os dados capturados como um campo. Para saber como capturar os dados como uma tabela, consulte Configurar o emulador de comunicações pessoais IBM.

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 como um objeto de tabela de dados.	Saída de dados	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.

ObterTexto

Retorna o texto no campo que você capturou da tela do emulador. Se você usar este método para uma tabela capturada, ele retornará o texto no primeiro campo do retângulo.

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.	Saída de dados	Cadeia de caracteres	N/D	N/D

É criado

Corresponde às regras e verifica se o elemento capturado existe.

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 com base no fato de o elemento estar ativo.	Saída de dados	Booliano	N/D	N/D

Definir texto

Tenta definir o texto para o campo.

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	Opção para especificar o texto que o método tenta definir no campo.	Entrada de dados	Cadeia de caracteres	N/D	Sim	Você não pode usar este método em telas protegidas do emulador.

AguardarCriação

Aguarda a duração especificada enquanto o conector usa a regra de correspondência para descobrir se o elemento existe.

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	Opção para fornecer o número de segundos que o método espera enquanto o conector usa a regra de correspondência para descobrir se o elemento existe.	Entrada de dados	Inteiro	30	Sim
Retornar	Retorna o valor booliano dependendo se o elemento foi encontrado.	Saída de dados	Booliano	N/D	N/D