RicavaAttributoOggettoFormato

Restituisce gli attributi specificati dell'oggetto formato fornito da nomeOggetto attualmente attivo nel calcolo.

Formato

Parametri

nomeOggetto - il nome di un oggetto del formato denominato nel formato corrente.

Tipo di dati riportato

Creata in

Attributi

Attributo	Restituisce
`objectType`	Il tipo di oggetto, in inglese.
`hasFocus`	1 se `nomeOggetto` è attivo; in caso contrario, restituisce 0. Gli oggetti che possono essere attivi sono i campi, i portali, i pannelli struttura a schede, i pannelli slide, i pulsanti, i pulsanti popover, i grafici e i gruppi. Restituisce 1 anche per un portale, quando ne viene selezionata una riga.
`containsFocus`	1 se `nomeOggetto` è attivo o se contiene un oggetto attivo; in caso contrario, restituisce 0. Gli oggetti che possono essere attivi sono i campi, i portali, i pannelli struttura a schede, i pannelli slide, le barre dei pulsanti, i pulsanti, i pulsanti popover, i popover, i grafici e i gruppi.
`isFrontPanel`	1 se l'oggetto target è il pannello struttura a schede o il pannello slide in primo piano.
`isActive`	1 se l'oggetto target è attivo; in caso contrario, restituisce 0.
`isObjectHidden`	1 se `nomeOggetto` è nascosto per il record corrente; in caso contrario, restituisce 0. Restituisce 1 per oggetti diversi dai popover situati a destra del limite del formato.
`bounds`	Un elenco di valori numerici, separati da spazi, che descrive il posizionamento dell'oggetto specificato (da in alto a sinistra a in basso a destra) e la relativa rotazione.
`left`	La coordinata del bordo sinistro dell'oggetto specificato.
`right`	La coordinata del bordo destro dell'oggetto specificato.
`top`	La coordinata del bordo superiore dell'oggetto specificato.
`bottom`	La coordinata del bordo inferiore dell'oggetto specificato.
`width`	La larghezza dell'oggetto specificato.
`height`	L'altezza dell'oggetto specificato.
`rotation`	La rotazione (in gradi) dell'oggetto specificato.
`startPoint, endPoint`	Una coppia di valori numerici (orizzontale, verticale), separati da spazi, che rappresentano il punto d'inizio o il punto finale di un oggetto linea. Altri oggetti restituiscono invece il punto superiore sinistro come `startPoint` e il punto inferiore destro come `endPoint`.
`source`	La descrizione sorgente dell'oggetto specificato come segue. visualizzatori Web - restituisce l'URL corrente. campi - restituisce il nome completamente qualificato del campo (nome tabella::nome campo). oggetti testo - restituisce il testo (non restituisce campi di fusione). portali - restituisce il nome della ricorrenza di tabella. grafica - restituisce dati immagine come il nome di un file immagine. grafici - restituisce la descrizione XML di un oggetto del grafico. tutti gli altri oggetti - restituisce una stringa vuota.
`content`	Il contenuto dell'oggetto specificato come segue. visualizzatori Web - restituisce il contenuto corrente (come il codice HTML). campi - restituisce i dati campo formattati utilizzando le proprietà dell'oggetto specificate. oggetti testo - restituisce il testo (incluso il testo di campi di fusione). grafica - restituisce dati immagine come il nome di un file di un campo Contenitore se l'immagine è salvata (nel campo o esternamente), oppure il riferimento al file se l'immagine non è salvata. grafici - restituisce la rappresentazione bitmap di un oggetto del grafico. pulsanti e pulsanti popover - restituisce il testo del pulsante. tutti gli altri oggetti - restituisce una stringa vuota.
`enclosingObject`	Il `nomeOggetto` dell'oggetto Contenitore del formato; in caso contrario, restituisce una stringa vuota. Solo i gruppi, i pannelli struttura a schede, i pannelli slide, le barre dei pulsanti, i pulsanti popover, i popover e i portali possono contenere altri oggetti.
`containedObjects`	Un elenco degli oggetti denominati in `nomeOggetto`. Solo i gruppi, i pannelli struttura a schede, i pannelli slide, le barre dei pulsanti, i pulsanti popover, i popover e i portali possono contenere altri oggetti.

Note

•Le coordinate dell'oggetto sono espresse in punti in rapporto all'angolo in alto a sinistra dell'area di lavoro della schermata principale. L'area di lavoro è l'area della schermata, esclusa la barra delle applicazioni (Windows), o l'area della schermata, esclusi la barra dei menu e il Dock (macOS). In iOS, l'area di lavoro è l'intera schermata. Gli attributi che utilizzano queste coordinate sono bounds, left, top, bottom, startPoint e endPoint.

•In FileMaker WebDirect, quando questa funzione agisce in un visualizzatore Web, l'attributo content restituisce una stringa vuota.

•Se per gli oggetti è impostato il ridimensionamento automatico, gli attributi restituiti dipendono dai bordi ridimensionati dell'oggetto allo stato corrente.

In FileMaker WebDirect, gli attributi si basano sugli ultimi bordi dell'oggetto comunicati da FileMaker WebDirect al server insieme ai dati del formato, ad esempio quando l'utente è passato al formato.

•Se gli oggetti si trovano sopra la barra degli strumenti, vengono restituite coordinate negative.

•Quando numeroRipetizione o numeroRigaPortale corrisponde a 0, la funzione si comporta come se il parametro non fosse specificato. Per numeroRigaPortale, la funzione restituisce i dati dalla prima riga del portale. Per numeroRipetizione, la funzione opera sulla prima ripetizione (per restituire content o source) o su tutto il campo nel suo insieme (per restituire bounds). Entrambi i parametri sono necessari perché bisogna poter fare riferimento ad una determinata ripetizione campo in una determinata riga del portale.

Esempio 1

Memorizza l'URL corrente di un visualizzatore Web nel campo Cerca::Pagina iniziale.