GetDigits
Início  Anterior  Próximo



Inicia a espera de uma seqüência de dígitos.

Declarações:
 
Delphi:  
function GetDigits(Port, MaxDigits: Smallint; const                    TermDigits: WideString; DigitsTimeOut, InterDigitsTimeOut: Integer): Smallint;  
 
 
Visual Basic:  
Function GetDigits(Port As Integer, MaxDigits As Integer, TermDigits As String, DigitsTimeOut As Long,                InterDigitsTimeOut As Long) As Integer  
 
Descrição:

O método GetDigits permite iniciar a espera de um conjunto de digitos, por um determinado tempo ou até receber um digito finalizador.

Como a VoicerLib tem um processamento assíncrono, após a execução de GetDigits, é necessário tratar o resultado no evento OnDigitsReceived, o que pode acontecer segundos mais tarde. Para recuperar os dígitos detectados deve-se utilizar o método ReadDigits.

Ao executar o GetDigits, o programa segue seu fluxo normal, isto é, não fica esperando a execução do GetDigits até o fim.

Parâmetros:

 
Port – Indica o canal da Placa  
MaxDigits – Número máximo de dígitos permitido. Utilize esta propriedade para limitar o número de digitos que o usuário poderá teclar.  
TermDigits – É uma string contendo um ou mais dígitos, que ao serem detectados finaliza a execução do GetDigits e gera o evento OnDigitsReceived. Se qualquer dígito puder interromper utilize o símbolo "@" ao invés de colocar "0123456789#*", apesar de a segunda forma também estar correta. Se não houver dígito finalizador, passar "" (vazio).  
DigitsTimeOut –Refere-se ao tempo máximo de espera pelo primeiro dígito programado no GetDigits. Caso seja detectado o primeiro dígito, este timeout não ocorrerá mais.
InterDigitsTimeOut - É o tempo máximo que o GetDigits esperará de intervalo entre cada dígito. Após este tempo, será gerado o evento OnDigitsReceived como código correspondete ao time-out interdígito. Em milissegundos.  

Valor de Retorno:

Retorna zero se foi iniciado com sucesso ou 1 no caso de erro.

Veja Também: OnDigitsReceived, ReadDigits