GetLayoutObjectAttribute

Retorna os atributos especificados do objeto de layout fornecido pelo nomeDoObjeto ativo atualmente no cálculo.

Formato 

GetLayoutObjectAttribute ( nomeDoObjeto ; nomeDeAtributo {; númeroDeRepetição ; númeroDeLinhaDoPortal } )

Parâmetros 

nomeDoObjeto - o nome do objeto de layout nomeado no layout atual.

nomeDeAtributo - o nome de um atributo suportado (veja abaixo).

númeroDeRepetição - o número de repetição (para campos de repetição).

númeroDeLinhaDoPortal - o número da linha no portal.

Os parâmetros entre chaves { } são opcionais.

Tipo de dados retornado 

texto

Originada na versão 

8.5

Atributos

Atributo

Retorna

objectType

O tipo de objeto, em inglês.

hasFocus

1 se nomeDoObjeto tiver foco; caso contrário, retornará 0. Os objetos que podem ter o foco são campos, portais, painéis de aba, painéis de slide, botões, botões popover, gráficos e grupos. Também retorna 1 para um portal quando uma linha de portal está selecionada.

containsFocus

1 se nomeDoObjeto tiver foco ou se ele tiver um objeto com foco; caso contrário, retornará 0. Os objetos que podem conter o foco são campos, portais, painéis de aba, painéis de slide, barras de botões, botões, botões popover, popovers, gráficos e grupos.

isFrontPanel

1 se o objeto de destino for a aba ou o painel de slide que está na frente.

isActive

1 se o objeto de destino estiver atualmente ativo; caso contrário, retornará 0.

isObjectHidden

1 se nomeDoObjeto estiver oculto para o registro atual; caso contrário, retornará 0. Retorna 1 para objetos diferentes de popovers que estão à direita do limite do layout.

bounds

Uma lista de valores numéricos, separados por espaços, que descreve o posicionamento do objeto especificado (superior esquerdo a inferior direito) e a rotação.

left

A coordenada da borda esquerda do objeto especificado.

right

A coordenada da borda direita do objeto especificado.

top

A coordenada da borda superior do objeto especificado.

bottom

A coordenada da borda inferior do objeto especificado.

width

A largura do objeto especificado.

height

A altura do objeto especificado.

rotation

A rotação (em graus) do objeto especificado.

startPoint,
endPoint

Um par de valores numéricos (horizontal vertical), separados por espaços, que representam o ponto inicial ou o ponto final de um objeto de linha. Outros objetos retornam o ponto superior esquerdo para startPoint e o ponto inferior direito para endPoint.

source

A descrição de origem do objeto especificado conforme segue.

visualizadores da Web - retorna a URL atual.

campos - retorna o nome de campo totalmente qualificado (nome da tabela::nome do campo).

objetos de texto - retorna o texto (não retorna campos de mesclagem).

portais - retorna o nome da ocorrência de tabela.

gráficos - retorna dados de imagem como o nome de arquivo de imagem.

gráficos - retorna a descrição XML de um objeto de gráfico.

todos os outros objetos, retorna uma cadeia vazia.

content

O conteúdo do objeto especificado conforme segue.

visualizadores da Web - retorna o conteúdo atual (como código HTML).

campos - retorna os dados de campo formatados usando as propriedades do objeto especificado.

objetos de texto - retorna o texto (incluindo o texto dos campos de mesclagem).

gráficos - retornará os dados de imagem como o nome de um arquivo em um campo de container se a imagem for armazenada (no campo ou externamente) ou a referência ao arquivo se a imagem não estiver armazenada.

gráficos - retorna a representação de bitmap de um objeto de gráfico.

botões e botões popover - retorna o texto do botão.

todos os outros objetos, retorna uma cadeia vazia.

enclosingObject

O nomeDoObjeto do objeto de layout circunscrito; caso contrário, retorna uma cadeia vazia. Somente grupos, painéis de aba, painéis de slide, barras de botões, botões popover, popovers e portais podem conter outros objetos.

containedObjects

Uma lista dos objetos nomeados contidos em nomedoObjeto. Somente grupos, painéis de aba, painéis de slide, barras de botões, botões popover, popovers e portais podem conter outros objetos.

Notas 

  • As coordenadas de objeto são fornecidas em pontos em relação ao canto superior esquerdo da área de trabalho da tela primária. A área de trabalho é a área da tela excluindo a barra de tarefas (Windows) ou a área da tela excluindo a barra de menus e o Dock (macOS). No iOS e no iPadOS, a área de trabalho é a tela inteira. Atributos que usam essas coordenadas são bounds, left, top, bottom, startPoint, e endPoint.
  • No FileMaker WebDirect, quando essa função atua em um visualizador Web, o atributo content retorna uma cadeia vazia.
  • Se os objetos forem definidos com redimensionamento automático, os atributos retornados terão como base os limites redimensionados do objeto em seu estado atual.

    No FileMaker WebDirect, os atributos são baseados nos limites do objeto quando o FileMaker WebDirect comunicou os dados de layout pela última vez ao servidor, como no caso em que o usuário alternou para o layout.

  • Se os objetos estiverem localizados acima da barra de ferramentas de status, valores de coordenadas negativos serão retornados.
  • Quando númeroDeRepetição ou númeroDeLinhaDoPortal for 0, a função se comportará como se o parâmetro não tivesse sido especificado. Para númeroDeLinhaDoPortal, a função retorna dados da primeira linha do portal. Para númeroDeRepetição, a função atua na primeira repetição (para retornar content ou source) ou atua em todo o campo (para retornar bounds). Ambos os parâmetros são necessários porque você deve estar preparado para fazer referência a uma determinada repetição de campo em uma determinada linha do portal.

Exemplo 1 

Armazena a URL atual do visualizador Web no campo Pesquisar::Página inicial.

Copiar
Definir campo [Pesquisar::Página inicial ; GetLayoutObjectAttribute ( "Visualizador Web" ; "source" )]