Referência > Referência de funções > Funções lógicas > GetLayoutObjectAttribute
 
GetLayoutObjectAttribute
Propósito 
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.
Nota  Os parâmetros entre chaves { } são opcionais.
Tipo de dados retornado 
texto
Originado em 
FileMaker Pro 8.5
Atributos
 
Atributo
Retorna
Tipo de dados retornado
objectType
O tipo de objeto, em inglês.
texto
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 guia, 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.
número
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 guia, painéis de slide, barras de botões, botões, botões popover, popovers, gráficos e grupos.
número
isFrontPanel
1 se o objeto de destino for a guia ou o painel de slide que está na frente.
número
isActive
1 se o objeto de destino estiver atualmente ativo; caso contrário, retornará 0.
número
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.
número
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.
texto
left
A coordenada da borda esquerda do objeto especificado.
número
right
A coordenada da borda direita do objeto especificado.
número
top
A coordenada da borda superior do objeto especificado.
número
bottom
A coordenada da borda inferior do objeto especificado.
número
width
A largura do objeto especificado.
número
height
A altura do objeto especificado.
número
rotation
A rotação (em graus) do objeto especificado.
número
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 pontoInicial e o ponto inferior direito para pontoFinal.
texto
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 tabela relacionado.
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.
texto
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.
texto
enclosingObject
O nomeDoObjeto do objeto de layout circunscrito; caso contrário, retorna uma cadeia vazia. Somente grupos, painéis de guia, painéis de slide, barras de botões, botões popover, popovers e portais podem conter outros objetos.
texto
containedObjects
Uma lista dos objetos nomeados contidos em nomedoObjeto. Somente grupos, painéis de guia, painéis de slide, barras de botões, botões popover, popovers e portais podem conter outros objetos.
texto
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, 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 ou um gráfico, os atributos content e source retornam 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úmerodeLinhadePortal for 0, a função se comportará como se o parâmetro não tivesse sido especificado. Para númerodeLinhadePortal, 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.
Definir campo [Pesquisar::Página inicial; GetLayoutObjectAttribute("Visualizador Web"; "source")]
Tópicos relacionados 
Referência de funções (lista de categorias)
Referência de funções (lista em ordem alfabética)
Sobre fórmulas
Sobre funções
Definição de campos de cálculo
Utilização de operadores em fórmulas
Nomeação de objetos