Saltar para o conteúdo principal
Versão: Próximo

OBJECT SET VISIBLE

OBJECT SET VISIBLE ( {* ;} objeto ; visivel )

ParâmetroTipoDescrição
*Operadorse especificado, objeto é um nome de objeto (string), se omitido, objeto é um campo ou uma variável
objetoanyNome de objeto (se* é especificado) ou Campo ou Variável (se * é omitido)
visivelBooleanTrue para visível, False para invisível

Esse comando não é seguro para thread e não pode ser usado em código adequado.

Descrição

O comando OBJECT SET VISIBLE mostra ou oculta os objetos especificados por objeto.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se não passa este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, é passada uma referência de campo ou variável (campo ou variável objeto unicamente) ao invés de um string.Para mais informações sobre nomes de objetos, consulte a seção

Se passa visível igual a TRUE, os objetos são mostrados. Se passa visível igual a FALSE, os objetos são ocultados.

Exemplo

Este é um formulário típico no ambiente Desenho:

Os objetos na área de grupo Informação do empregador cada um tem um nome de objeto que contêm a expressão “empregador” (incluindo a área de grupo). Quando a caixa de seleção Empregado atualmente está selecionada, os objetos devem ser visíveis; quando a caixa não está selecionada, os objetos devem ser invisíveis.
Este é o método de objeto da caixa de seleção:

    // Método de objeto de Caixa de seleção cbEmpregadoAtualmente
 Case of
    :(FORM Event=On Load)
       cbEmpregadoAtualmente:=1
 
    :(FORM Event=On Clicked)
  // Ocultar ou mostrar todos os objetos cujo nome contem "emp"
       OBJECT SET VISIBLE(*;"@emp@";cbEmpregadoAtualmente # 0)
  // Mas sempre conservar a caixa de seleção visível
       OBJECT SET VISIBLE(cbEmpregadoAtualmente;True)
 End case

Portanto, em execução, o formulário se vê dessa maneira:

ou:

Ver também

OBJECT Get visible
OBJECT SET ENTERABLE