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

Use o. IBM Métodos do emulador de Comunicações pessoais para executar várias tarefas de automação no IBM Emulador 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.

GetFieldText

Retorna o texto que um campo contém depois de identificar o campo pelo número de linha e coluna que você especificar. 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, . é 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(a)	Anotações
Linha	Número da linha do campo que identifica o campo.	Dados em	Inteiro	N/D	Sim
Coluna	Número da coluna do campo que identifica o campo.	Dados em	Inteiro	N/D	Sim
Retornar	Retorna o texto no campo.	Saída de dados	Cadeia de caracteres	N/D	N/D

GetTextFromRect

Retorna o texto em todos os campos de uma área retangular que você define na tela. Você define uma área fornecendo as linhas iniciais e finais e os números das colunas. O método localiza e identifica o primeiro e o último campos e retorna todo o texto em todos os campos dentro 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(a)	Anotações
Iniciar	Número da linha que indica o primeiro caractere do primeiro campo na área retangular.	Dados em	Inteiro	N/D	Sim
Coluna inicial	Número da coluna que contém o primeiro caractere do primeiro campo na área retangular.	Dados em	Inteiro	N/D	Sim
Linha de término	Número da linha que contém o último caractere do último campo na área retangular.	Dados em	Inteiro	N/D	Sim
EndCol	Número da coluna que contém o último caractere do último campo na área retangular.	Dados em	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 de método criados

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
JunteTodos os Filhos	Opção para encontrar a tela do emulador combinando os elementos secundários que você capturou.	Dados em	Booliano	Falso(a)	Sim	Aviso: Usar esta 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 que você especificar. Por exemplo, se você especificar a cadeia de caracteres emulador , o método retorna os números de linha e coluna do ponto inicial da palavra emulador 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(a)	Anotações
Texto	Texto pesquisado pelo método.	Dados em	Cadeia de caracteres	N/D	Sim	O texto especificado pode diferenciar maiúsculas de 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 que você especificar.	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.

Chaves de envio

Simula os pressionamentos de tecla inseridos no teclado na posição do dispositivo do mouse na tela do emulador. Por exemplo, você pode simular o. [inserir] pressionamento de tecla na tela.

Tabela 5. Parâmetros do método de chaves de envio

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

EnviarKeySecure

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

Tabela 6. Parâmetros do método SendKeyKeySecure

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

PosiçãoCursorPosition

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(a)	Anotações
Linha	Opção para fornecer o número da linha com base na qual o método tenta definir o dispositivo de mouse na tela.	Dados em	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 será 24.
Coluna	Opção para fornecer o número da linha com base na qual o método tenta definir o dispositivo de mouse na tela.	Dados em	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.

WaitForCriar

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

Tabela 8. WaitForCriar parâmetros de método

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
TimeoutinSeconds	Opção para fornecer o número de segundos pelos quais o método aguarda enquanto o conector usa a regra de correspondência de tela para descobrir se a tela existe.	Dados em	Inteiro	30	Sim
JunteTodos os Filhos	Opção para corresponder a todos os elementos da tela que você capturou para descobrir se a tela existe.	Dados em	Booliano	Falso(a)	Sim	Aviso: O uso desta opção pode atrasar a execução do método.
Retornar	Retorna o valor booliano com base no fato de a tela do emulador ter sido encontrada.	Saída de dados	Booliano	N/D	N/D

Métodos no nível do elemento

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

GetAsTable

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 que captura como um campo. Para saber como capturar os dados como uma tabela, consulte Configure o. IBM Emulador de Comunicações pessoais.

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(a)	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 .

Gettext

Retorna o texto no campo que você capturou na 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 de método criados

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Retornar	Retorna o valor booliano com base se o elemento está ativo.	Saída de dados	Booliano	N/D	N/D

SetText

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(a)	Anotações
Texto	Opção para especificar o texto que o método tenta definir no campo.	Dados em	Cadeia de caracteres	N/D	Sim	Você não pode usar este método em telas de emulador protegidas.

WaitForCriar

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

Tabela 13. WaitForCriar parâmetros de método

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
TimeoutinSeconds	Opção para fornecer o número de segundos pelos quais o método aguarda enquanto o conector usa a regra de correspondência para descobrir se o elemento existe.	Dados em	Inteiro	30	Sim
Retornar	Retorna o valor booliano, dependendo se o elemento foi encontrado.	Saída de dados	Booliano	N/D	N/D