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 (merge-fält returneras inte).

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 text (inklusive text från merge-fält).

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" )]