Get format

4D v15.4

Get format


Get format ( {* ;} objeto ) -> Resultado

Parâmetro	Tipo	Descrição
*	Operador	se especificado, objeto é um nome de objeto (string), se omitido, objeto é um campo ou uma variável
objeto	Objeto de formulário	Nome de objeto (se* é especificado) ou Campo ou Variável (se * é omitido)
Resultado	String	Exibir formato de objeto

Descrição

O comando Get format devolve o formato de saída atual aplicado ao objeto especificado no parâmetro objeto.

Se passa o parâmetro opcional *, indica um nome de objeto (neste caso, passe uma string em objeto). Se omite este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, não passa uma string, mas uma referência de campo ou de variável.

Este comando devolve o formato de saída atual do objeto, ou seja o formato definido no ambiente Desenho ou utilizando o comando OBJECT SET FORMAT . Get format funciona com todos os tipos de objetos de formulário (campos ou variáveis) que aceitam um formato de saída: booleano, data, hora, imagem, string, numérico, como também com grades de botões, dials, termômetros, réguas, menus imagem suspenso, botões imagem e botões 3D. Para maior informação sobre formatos de saída destes objetos, consulte a documentação do comando OBJECT SET FORMAT .

Nota: se aplica o comando a um conjunto de objetos, o formulário, se devolve o formulário do último objeto selecionado.

Quando o comando Get format se aplica a objetos de tipo data, hora ou imagem (formatos definidos como constantes), a string que se devolve corresponde ao código ASCII da constante. Para obter o valor da constante, simplesmente aplique a função Character code ao resultado (ver exemplo a continuação).

Exemplo 1

Este exemplo lhe permite obter o valor da constante do formato aplicado a variável imagem chamada “minhafoto”:

 C_TEXT($formato)

 OBJECT SET FORMAT(*;"minhafoto";Char(On background))

  //Aplicação do formato de fundo (value = 3)

 $formato:=OBJECT Get format(*;"minhaphoto")

 ALERT("Format número:"+String(Character code($formato)))

  //Mostrar o valor "3"

Exemplo 2

Este exemplo lhe permite obter o formato aplicado ao campo booleano [Membros]Estado_civil:

 C_TEXT($format)

 <p>$format:=OBJECT Get format([Membros]Estado_civil)

 ALERT($format) //Visualizar formato, por exemplo "Casado;Solteiro"

Ver também

OBJECT SET FORMAT