GetLayoutObjectAttribute

Returnerar angivna attribut för layoutobjektet som anges av objektnamnet som är aktivt i beräkningen.

Format

GetLayoutObjectAttribute ( objektnamn ; attributnamn {; repetitionsnummer ; Portalradnummer } )

Parametrar

objektnamn - namnet på ett namngivet layoutobjekt i aktuell layout

attributnamn - namnet på ett attribut som stöds (se nedan)

repetitionNumber - repetitionsnummer (för repeterade fält).

Portalradnummer - radnumret i portalen.

Parametrar inom klamrar { } är valfria.

Returnerad datatyp

text

Ursprungsversion

8.5

Attribut

Attribut	...returnerar följande
`objectType`	Objektets typ, på engelska.
`hasFocus`	1 om `objektnamn` har fokus. Annars returneras 0. De objekt som kan ha fokus är fält, portaler, flikpaneler, glidpaneler, knappar, flytande fönster-knappar, diagram och grupper. Returnerar också 1 för en portal när en portalrad är markerad.
`containsFocus`	1 om `objektnamn` har fokus eller om det innehåller ett objekt som har fokus. Annars returneras 0. De objekt som kan innehålla fokus är fält, portaler, flikpaneler. glidpaneler, knapprader, knappar, flytande fönster-knappar, diagram och grupper.
`isFrontPanel`	1 om målobjektet är den flik- eller glidpanel som finns längst fram.
`isActive`	1 om målobjektet för närvarande är aktivt. Annars returneras 0.
`isObjectHidden`	1 om `objektnamn` är dolt för den aktuella posten. Annars returneras 0. Returnerar 1 för objekt som inte är ett flytande fönster och som ligger till höger om layoutgränsen.
`bounds`	En lista med numeriska värden, avgränsade av blanksteg, som beskriver placeringen av angivet objekt (övre-vänster till nedre-höger) och dess rotation.
`left`	Koordinaten för den vänstra kanten av angivet objekt.
`right`	Koordinaten för den högra kanten av angivet objekt.
`top`	Koordinaten för den övre kanten av angivet objekt.
`bottom`	Koordinaten för den nedre kanten av angivet objekt.
`width`	Bredden för angivet objekt.
`height`	Höjden för angivet objekt.
`rotation`	Rotationen (i grader) för angivet objekt.
`startPoint, endPoint`	Ett par numeriska värden (horisontellt vertikalt), separerade av blanksteg. Dessa representerar start- och slutpunkt för ett linjeobjekt. Andra objekt returnerar den övre vänstra punkten för `startPoint` och den nedre högra punkten för `endPoint`.
`source`	Källbeskrivningen för angivet objekt enligt följande. webbvisare - returnerar aktuell URL. fält - returnerar fullständigt fältnamn (tabellnamn::fältnamn). textobjekt - returnerar texten (returnerar textobjektets innehåll istället för det utvärderade värdet av mergefält, mergevariabler och layoutberäkningar). portaler - returnerar namnet på tabellförekomsten. grafik - returnerar bilddata, exempelvis bildens filnamn. diagram - returnerar XML-beskrivningen av ett diagramobjekt. alla andra objekt - returnerar en tom sträng.
`content`	Innehållet i angivet objekt enligt följande. webbvisare - returnerar aktuellt innehåll (som t.ex. HTML-kod). fält - returnerar fältdata som formaterats med hjälp av angivet objekts egenskaper. textobjekt - returnerar texten (returnerar det utvärderade värdet av mergefält, mergevariabler och layoutberäkningar). grafik - returnerar bilddata, exempelvis namnet på ett containerfält om bilden är lagrad (i filen eller externt), eller referensen till filen om bilden inte är lagrad. diagram - returnerar bitmappsrepresentationer av ett diagramobjekt. knappar och knappar för flytande fönster - returnerar knappens text. alla andra objekt - returnerar en tom sträng.
`enclosingObject`	`Objektnamn` för det omgivande layoutobjektet. Annars returneras en tom sträng. Endast grupper, flikpaneler, glidpaneler, knapprader, flytande fönster-knappar, flytande fönster och portaler kan innehålla andra objekt.
`containedObjects`	En lista med namngivna objekt som `objektnamn` innehåller. Endast grupper, flikpaneler, glidpaneler, knapprader, flytande fönster-knappar, flytande fönster och portaler kan innehålla andra objekt.

Kommentarer

Objektkoordinaterna anges i punkter i relation till det övre vänstra hörnet av huvudskärmens arbetsområde. Arbetsområdet är skärmområdet med undantag av aktivitetsfältet (Windows) eller skärmområdet med undantag av menyraden och dockan (macOS). I iOS och iPadOS är arbetsområdet hela skärmen. Attribut som använder dessa kooordianter är bounds, left, top, bottom, startPoint och endPoint.
När den här funktionen fungerar som webbvisare i FileMaker WebDirect returnerar attributet content en tom sträng.
Om objekt ställs in på automatisk storleksändring baseras de returnerade attributen på de ändrade gränserna för objektet i sitt aktuella tillstånd.
I FileMaker WebDirect baseras attribut på objektets värden när FileMaker WebDirect senast kommunicerade layoutdata med servern, som när användaren bytte till layouten.
Om objekt är placerade ovanför statusverktygsfältet returneras negativa värden.
När repetitionsnummer eller portalradnummer är 0 fungerar funktionen som om parametern inte hade angivits. För portalradnummer returnerar funktionen data från den första portalraden. För repetitionsnummer agerar funktionen på den första repetitionen (för återkommande content eller source) eller agerar på hela fältet som en helhet (för att returnera bounds). Båda parametrarna är nödvändiga eftersom du måste kunna referera till en viss fältrepetition inom en viss portalrad.

Exempel 1

Lagrar en webbvisares aktuella URL-adress i fältet Söka::Hemsida.

Kopiera

Tilldela fält [Söka::Hemsida ; GetLayoutObjectAttribute ( "Webbvisare" ; "source" )]