BoxSelect
Caixa de seleção.
Sintaxe
BoxSelect
[ TITLE
mensagem ]
[ LINE
linha ]
[ COLUMN
coluna ]
[ CAPTION(1...21)
texto-opção
]
[ OPTION
opção-default;opção-selecionada
]
[ OPTION-CHAR
mnemônico-da-opção-selecionada
]
[ LEAVING
]
[ TIMEOUT-ENABLE
| TIMEOUT-RETRY
| TIMEOUT-DISABLE
]
[ TIMEOUT-RETURN ;
retorno-tempo-limite-decorrido
]
Argumentos
mensagem
Título da janela até 78 caracteres.
linha
Linha de posicionamento da janela.
coluna
Coluna de posicionamento da janela.
texto-opção
Texto de até 78 caracteres a ser exibido em cada linha de
opção (até 21) sendo que o caractere "~"
indica que o caractere seguinte servirá de mnemônico de
atalho.
opção-default
Valor ou variável que Indica em qual das 21 opções
deve estar inicialmente o foco.
opção-selecionada
Variável que receberá o retorno do número da
linha selecionada pelo usuário, podendo retornar os valores de
1 a 21 ou zero caso o usuário tenha desistido da seleção.
mnemônico-da-opção-selecionada
Variável
alfanumérica de 1 byte que receberá o caractere
mnemônico da opção selecionada pelo usuário,
ou espaço caso não tenham sido definidos mnemônicos
ou o usuário tenha desistido da seleção.
LEAVING
Habilita o encerramento da lista mesmo que o caractere teclado não
seja um dos mnemônicos declarados retornando em OPTION-CHAR
e 99 em
OPTION.
TIMEOUT-ENABLE
Habilita o término por tempo de ociosidade decorrido. A
opção default será automaticamente selecionada
pelo sistema em função do limite de ociosidade
declarado na configuração.
TIMEOUT-RETRY
Habilita 5 segundos de espera para mensagens de comentários.
Sem maiores consequências o processamento poderá
prosseguir mesmo sem a intervenção ou conhecimento do
usuário.
TIMEOUT-DISABLE
A intervenção do usuário será
obrigatória e o processamento só prosseguirá ao
ser selecionado um push-button manualmente.
retorno-tempo-limite-decorrido
Variável que receberá o retorno indicativo da
ocorrência de limite de tempo decorrido (1 ou zero caso o
usuário tenha selecionado uma opção
manualmente).
Observações
A acentuação deve ser codificada com a página
de código 850, os processadores de tela se encarregam de
traduzir para o codificação apropriada a plataforma de
execução:
Exemplo
Veja também
BoxFileSelect
Line
Button
Object
COMBO-BOX
Object
LIST-BOX
Send Message
