`Class.BillboardGui` è un contenitore per oggetti UI che appaiono nello spazio 3D
ma che fronteggiano sempre la fotocamera. La posizione del contenitore è relativa al
`Class.BasePart` o `Class.Attachment` genitore (o all'
`Class.BillboardGui.Adornee|Adornee`). Per `Class.BasePart|BaseParts`, la
proprietà `Class.BasePart.Position|Position` viene utilizzata, mentre per
`Class.Attachment|Attachments`, la proprietà `Class.Attachment.WorldPosition|WorldPosition` è usata.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt="BillboardGui con una TextLabel che descrive la console dello schermo sopra la quale fluttua." />

La proprietà `Class.BillboardGui.Size|Size` di un billboard funziona leggermente
in modo diverso rispetto a `Class.GuiObject.Size`. Mentre i componenti **offset** funzionano
nello stesso modo, i componenti **scale** sono utilizzati come dimensioni degli stud nello spazio 3D.

Quando si crea un `Class.BillboardGui` con dimensioni scalate che contiene un
`Class.TextLabel`, è utile abilitare la proprietà `Class.TextLabel.TextScaled|TextScaled` in modo che il suo testo si scalino insieme
al canvas del billboard mentre la distanza dalla fotocamera cambia.

Si noti che gli elementi UI interattivi come `Class.ImageButton|ImageButtons` e
`Class.TextButton|TextButtons` all'interno di un `Class.BillboardGui` riceveranno
input dell'utente solo se sono parentati con il `Class.PlayerGui`, tipicamente posizionando il
`Class.BillboardGui` all'interno di `Class.StarterGui`. La
proprietà `Class.BillboardGui.Adornee|Adornee` può essere utilizzata per mirare a una parte o
attacco nel mondo 3D mentre il `Class.BillboardGui` stesso rimane nel
`Class.PlayerGui`.

Vedi [In-Experience UI](/ui/in-experience-containers#billboard-ui)
per una guida su come lavorare con i contenitori `Class.BillboardGui`.

##### Comportamento di caching

Per aiutare a migliorare le prestazioni, l'aspetto di un `Class.BillboardGui` viene
memorizzato fino a quando non si verifica uno dei seguenti casi, dopo di che il suo aspetto sarà
ricalcolato al successivo frame di rendering.

- Un discendente viene aggiunto o rimosso dal `Class.BillboardGui`.
- Una proprietà di un discendente del `Class.BillboardGui` cambia.
- Una proprietà del `Class.BillboardGui` stesso cambia.


BillboardGui

Controlla se i discendenti riceveranno eventi di input. Se il
`Class.BillboardGui` contiene un `Class.GuiButton`, quel pulsante diventerà
cliccabile solo se `Class.BillboardGui.Active|Active` è impostato su `true` sia su
`Class.BillboardGui` **che** sul pulsante.

Si noti che gli elementi UI interattivi come `Class.ImageButton|ImageButtons`
e `Class.TextButton|TextButtons` all'interno di un `Class.BillboardGui` riceveranno
input dell'utente solo se sono parentati con il `Class.PlayerGui`,
tipicamente posizionando il `Class.BillboardGui` all'interno di `Class.StarterGui`.
La proprietà `Class.BillboardGui.Adornee|Adornee` può essere utilizzata per mirare a un
parte o attacco nel mondo 3D mentre il `Class.BillboardGui` stesso
rimane nel `Class.PlayerGui`.


BillboardGui.Active

Controlla se i discendenti riceveranno eventi di input.


Imposta il `Class.BasePart` o `Class.Attachment` obiettivo a cui il
`Class.BillboardGui` è posizionato in relazione, sovrascrivendo la parte
o l'attacco genitore.


BillboardGui.Adornee

Imposta la parte obiettivo o l'attacco a cui il `Class.BillboardGui` è
posizionato in relazione.


Questa proprietà determina se il `Class.BillboardGui` sarà sempre
reso sopra ad altri oggetti 3D.

Quando è impostato su `false` (predefinito), il `Class.BillboardGui` si rende come altro
contenuto 3D ed è oscurato da altri oggetti 3D. Quando è impostato su `true`, il
`Class.BillboardGui` si rende sempre sopra al contenuto 3D e l'aspetto cambia
significativamente:

- I colori corrispondono a come appaiono all'interno di un `Class.ScreenGui`.
- Il testo potrebbe apparire più nitido sui dispositivi ad alta DPI.
- `Class.BillboardGui.LightInfluence|LightInfluence` è trattato come se
  fosse `0`.
- `Class.BillboardGui.Brightness|Brightness` non ha effetto.


BillboardGui.AlwaysOnTop

Determina se il `Class.BillboardGui` sarà sempre reso sopra ad altri
oggetti 3D.


Questa proprietà determina il fattore per il quale la luce del contenitore
`Class.BillboardGui` è scalata quando
`Class.BillboardGui.LightInfluence|LightInfluence` è `0`. Per impostazione predefinita,
questa proprietà è `1` e può essere impostata su qualsiasi numero tra `0` e `1000`.
Modificando questa proprietà, la luminosità apparente di un
`Class.BillboardGui` può essere meglio abbinata al suo ambiente. Ad esempio, un billboard video può essere illuminato all'interno di una stanza buia aumentando
`Class.BillboardGui.Brightness|Brightness` a `10`.

Si noti che `Class.BillboardGui.Brightness|Brightness` non è accessibile in
Studio e non ha effetto quando o
`Class.BillboardGui.LightInfluence|LightInfluence` è `1` o
`Class.BillboardGui.AlwaysOnTop|AlwaysOnTop` è `true`.


BillboardGui.Brightness

Determina il fattore per il quale la luce del contenitore `Class.BillboardGui`
è scalata quando `Class.BillboardGui.LightInfluence|LightInfluence` è `0`.


Quando impostato su `true` (predefinito), le porzioni di `Class.GuiObject|GuiObjects`
che cadono al di fuori dei bordi del canvas di `Class.BillboardGui` non saranno
disegnate.

Anche quando questa proprietà è `false`, `Class.GuiObject|GuiObjects` che sono
**completamente** al di fuori del canvas non verranno renderizzati.


BillboardGui.ClipsDescendants

Se le porzioni di `Class.GuiObject|GuiObjects` che cadono al di fuori dei
bordi del canvas di `Class.BillboardGui` saranno disegnate.


La distanza attuale in stud che il `Class.BillboardGui` è dalla
fotocamera del giocatore. Un evento di cambiamento non scatta per questa proprietà a meno che
`Class.BillboardGui.DistanceStep|DistanceStep` sia maggiore di `0`.


BillboardGui.CurrentDistance

La distanza attuale in stud che il `Class.BillboardGui` è dalla
fotocamera del giocatore.


Determina la distanza in stud alla quale il `Class.BillboardGui` smetterà di
scalare più grande in dimensione rispetto alla fotocamera attuale del giocatore, con un
predefinito di `0`. Se il
`Class.BillboardGui.CurrentDistance|CurrentDistance` del
`Class.BillboardGui` è al di sotto di questo valore, non scalerà più grande
rispetto a quanto sarebbe a questa distanza.


BillboardGui.DistanceLowerLimit

Determina la distanza in stud alla quale il `Class.BillboardGui` smetterà di
scalare più grande in dimensione.


Determina le dimensioni `Class.BillboardGui.CurrentDistance|CurrentDistance`
in incrementi e decrementi in stud mentre la fotocamera del giocatore si avvicina e
si allontana dal `Class.BillboardGui`. La proprietà è predefinita su `0`.


BillboardGui.DistanceStep

Determina le dimensioni `Class.BillboardGui.CurrentDistance|CurrentDistance`
in incrementi e decrementi in stud mentre la fotocamera del giocatore si avvicina e
si allontana dal `Class.BillboardGui`.


Determina la distanza in stud alla quale il `Class.BillboardGui` smetterà di
scalare più piccolo in dimensione rispetto alla fotocamera attuale del giocatore. Se
il `Class.BillboardGui.CurrentDistance|CurrentDistance` del
`Class.BillboardGui` è al di sopra di questo valore, non scalerà più piccolo
rispetto a quanto sarebbe a questa distanza.

Questa proprietà viene ignorata se il valore è inferiore a `0`. Il valore predefinito
è `-1`, il che significa che la proprietà viene ignorata per impostazione predefinita.


BillboardGui.DistanceUpperLimit

Determina la distanza in stud alla quale il `Class.BillboardGui` smetterà di
scalare più piccolo in dimensione.


Questa proprietà determina come il `Class.BillboardGui` è spostato rispetto al suo
`Class.BillboardGui.Adornee|Adornee`, in relazione all'orientamento della
`Class.Camera`, in unità di metà dimensioni della bounding box allineata alla
`Class.Camera` del modello.

Vedi anche `Class.BillboardGui.StudsOffset|StudsOffset` che funziona
similmente ma utilizza unità di stud, o
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` che
funziona similmente eccetto che l'orientamento dello spostamento è relativo agli assi
globali.


BillboardGui.ExtentsOffset

Determina come il `Class.BillboardGui` è spostato rispetto al suo
`Class.BillboardGui.Adornee|Adornee`, in relazione all'orientamento della
`Class.Camera`, in unità di metà dimensioni della bounding box allineata alla
`Class.Camera` del modello.


Questa proprietà determina come il `Class.BillboardGui` è spostato rispetto al suo
`Class.BillboardGui.Adornee|Adornee`, in relazione agli assi globali, in
unità di metà dimensioni della bounding box allineata all'asse del modello.

Vedi anche `Class.BillboardGui.StudsOffset|StudsOffset` che funziona
similmente ma utilizza unità di stud, o
`Class.BillboardGui.ExtentsOffset|ExtentsOffset` che funziona similmente
eccetto che l'orientamento dello spostamento è relativo alla `Class.Camera`.


BillboardGui.ExtentsOffsetWorldSpace

Determina come il `Class.BillboardGui` è spostato rispetto al suo
`Class.BillboardGui.Adornee|Adornee`, in relazione agli assi globali, in
unità di metà dimensioni della bounding box allineata all'asse del modello.


Controlla quanto il `Class.BillboardGui` è influenzato dall'illuminazione
ambientale, in un intervallo da `0` a `1`. Impostare questo a `1` significa che
l'illuminazione circostante ha il completo controllo sull'aspetto, mentre
impostarlo a `0` significa che l'illuminazione non ha effetto.


BillboardGui.LightInfluence

Controlla quanto il `Class.BillboardGui` è influenzato dall'illuminazione
ambientale.


Questa proprietà controlla quanto lontano dalla fotocamera il `Class.BillboardGui`
sarà visualizzato prima che smetta di rendere. Un valore di `0` o `inf`
(predefinito) significa che non c'è limite e verrà reso all'infinito.

Per `Class.BillboardGui|BillboardGuis` che appaiono all'aperto, è
raccomandato che `Class.BillboardGui.MaxDistance|MaxDistance` sia sufficientemente
alto da garantire che l'interfaccia utente del contenitore sia abbastanza piccola
sullo schermo quando appare o scompare, riducendo al minimo l'effetto di apparizione/disapparizione improvvisa.


BillboardGui.MaxDistance

Controlla quanto lontano il `Class.BillboardGui` può essere visualizzato prima che
smetta di rendere.


Utilizzato da script per nascondere il `Class.BillboardGui` da un giocatore specifico.

Per nascondere un `Class.BillboardGui` da più di un giocatore, posizionalo in
`Class.StarterGui` e utilizza uno script per impostare la
proprietà `Class.BillboardGui.Enabled|Enabled` in base a se il
`Class.Players.LocalPlayer|LocalPlayer` dovrebbe essere in grado di vederlo. La
proprietà `Class.BillboardGui.Adornee|Adornee` può essere utilizzata per attaccare il
`Class.BillboardGui` a un `Class.BasePart` o `Class.Attachment` nel
`Class.Workspace`, invece di parentarlo.


BillboardGui.PlayerToHideFrom

Utilizzato da script per nascondere il `Class.BillboardGui` da un giocatore specifico.


Controlla la dimensione che il `Class.BillboardGui` avrà sullo schermo.
A differenza di `Class.GuiObject.Size`, i componenti di
[scalabilità](/ui/position-and-size#size) di questa proprietà
impostano la dimensione degli stud del billboard nello spazio 3D.


BillboardGui.Size

Controlla la dimensione che il `Class.BillboardGui` avrà sullo schermo.


Un offset 2D in unità relative alla dimensione che funge da punto di ancoraggio. Questo
può essere utilizzato in modo simile alla proprietà `Class.GuiObject.AnchorPoint`, ma
i valori sono diversi.

<table size="small">
<thead>
<th>Offset di dimensione</th>
<th>Spiegazione</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>Il predefinito in cui l'UI sarà ancorato al suo centro.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>L'UI sarà ancorata in basso a sinistra.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>L'UI sarà ancorata in alto a sinistra.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>L'UI sarà ancorata in alto a destra.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>L'UI sarà ancorata in basso a destra.</td>
</tr>
</tbody>
</table>

Vedi anche `Class.BillboardGui.StudsOffset|StudsOffset`,
`Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`,
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`, e
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` che
sono proprietà di offset che funzionano nello spazio 3D invece.


BillboardGui.SizeOffset

Un offset 2D in unità relative alla dimensione che funge da punto di ancoraggio.


Questa proprietà determina come il `Class.BillboardGui` è spostato rispetto al suo
`Class.BillboardGui.Adornee|Adornee` in stud, in relazione all'orientamento della
`Class.Camera`.

Vedi anche `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`
che funziona similmente eccetto che l'orientamento dello spostamento è relativo agli
globali assi.


BillboardGui.StudsOffset

Determina come il `Class.BillboardGui` è spostato rispetto al suo
`Class.BillboardGui.Adornee|Adornee` in stud, in relazione all'orientamento della
`Class.Camera`.


Questa proprietà determina come il `Class.BillboardGui` è spostato rispetto al suo
`Class.BillboardGui.Adornee|Adornee` in stud, in relazione agli assi globali.

Vedi anche `Class.BillboardGui.StudsOffset|StudsOffset` che funziona
similmente eccetto che l'orientamento dello spostamento è relativo alla `Class.Camera`.


BillboardGui.StudsOffsetWorldSpace

Determina come il `Class.BillboardGui` è spostato rispetto al suo
`Class.BillboardGui.Adornee|Adornee` in stud, in relazione agli assi globali.


Un contenitore per `Class.GuiObject|GuiObjects` che rende nello spazio 3D fronteggiando
la fotocamera.


**LayerCollector** è la classe base dei contenitori UI 2D che rendono
`Class.GuiObject` discendenti, come `Class.ScreenGui`.

Per miglioramenti delle prestazioni, l'aspetto di un `Class.LayerCollector` è
memorizzato fino a quando si verifica uno dei seguenti eventi:

- Un discendente viene aggiunto o rimosso.
- Una proprietà di un discendente cambia.
- Una proprietà del `Class.LayerCollector` stesso cambia.

LayerCollector:GetLayoutNodeTree

LayerCollector

Attiva o disattiva la visibilità di questo `Class.LayerCollector`. Quando `false`, i
contenuti dell'interfaccia utente non verranno visualizzati, non elaborano gli input
utenti e non si aggiornano in risposta a modifiche.

LayerCollector.Enabled

Attiva o disattiva la visibilità di questo `Class.LayerCollector`.

Quando impostato su `false` e questo `Class.LayerCollector` è un figlio diretto di
`Class.StarterGui`, verrà clonato nel `Class.PlayerGui` di ciascun giocatore
una sola volta e non verrà eliminato quando il personaggio del giocatore
rinasce.

Quando impostato su `true` (predefinito), o se questo `Class.LayerCollector` è un
**discendente** **indiretto** di `Class.StarterGui`, verrà clonato nel
`Class.PlayerGui` di ciascun giocatore quando il loro personaggio rinasce, e si
elimina quando il personaggio del giocatore rinasce di nuovo.

LayerCollector.ResetOnSpawn

Determina se il `Class.LayerCollector` si resetta (si elimina e
gli viene fatto un nuovo clone nel `Class.PlayerGui` del giocatore) ogni volta che il
personaggio del giocatore rinasce.

Controlla come si comporta `Class.GuiObject.ZIndex` su tutti i discendenti di questo
`Class.LayerCollector`.

Con `Enum.ZIndexBehavior.Sibling` (predefinito), i figli vengono sempre visualizzati sopra
i loro genitori, e il `Class.GuiObject.ZIndex|ZIndex` viene utilizzato per decidere
l'ordine in cui i figli di un singolo oggetto UI si sovrapporranno tra di loro.

`Enum.ZIndexBehavior.Global` ordina tutti i discendenti secondo il
`Class.GuiObject.ZIndex|ZIndex`, quindi rompe i pareggi utilizzando l'ordine gerarchico.
Di conseguenza, i discendenti di un `Class.GuiObject` devono avere un
valore di `Class.GuiObject.ZIndex|ZIndex` che sia almeno alto quanto il
genitore, altrimenti verranno visualizzati sotto il loro genitore.


LayerCollector.ZIndexBehavior

Controlla come si comporta `Class.GuiObject.ZIndex` su tutti i discendenti di questo
`Class.LayerCollector`.


La classe base dei contenitori UI 2D che rendono `Class.GuiObject|GuiObjects`
in livelli.

`Class.GuiBase2d` è una classe astratta ereditata da 2D
`Class.GuiObject|GuiObjects`.


Questo evento si attiva quando la selezione del gamepad si sposta, esce o cambia
all'interno del `Class.GuiBase2d` connesso o di qualsiasi discendente
`Class.GuiObject|GuiObjects`. Quando l'evidenziazione della selezione si sposta su un
`Class.GuiObject`, l'evento si propaga da quel `Class.GuiObject` a tutti i suoi antenati,
informandoli che la selezione è
cambiata/entrata/uscita da un `Class.GuiObject` nel loro albero discendente.


GuiBase2d.SelectionChanged

amISelected

Vero se la nuova selezione corrisponde al GuiBase2d attaccato.


previousSelection

newSelection

Si attiva quando la selezione del gamepad si sposta, esce o cambia all'interno del
`Class.GuiBase2d` connesso o di qualsiasi discendente
`Class.GuiObject|GuiObjects`.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` è una proprietà di sola lettura
che fornisce la posizione dello schermo di un elemento `Class.GuiBase2d`
in pixel. Questo rappresenta la posizione in pixel effettiva in cui un elemento
viene visualizzato a seguito delle dimensioni e posizioni dei suoi antenati. Nota che
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` rappresenta sempre l'angolo in alto a sinistra
dell'elemento `Class.GuiBase2d`.

Se il `Class.GuiBase2d` è in un `Class.ScreenGui`, la
proprietà `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` utilizza il
sistema di coordinate viewport di `Enum.ScreenInsets|CoreUISafeInsets`. L'origine di questo sistema di coordinate si trova nell'angolo in basso a sinistra della
barra superiore di Roblox. Nota che questo è lo stesso sistema di coordinate utilizzato dalla
proprietà `Class.InputObject.Position`.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="Diagramma che mostra l'origine del sistema di coordinate AbsolutePosition." />

Vedi anche `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` e
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsolutePosition

Descrive la posizione effettiva dello schermo di un elemento `Class.GuiBase2d`, in
pixel.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` è una proprietà di sola lettura
che descrive la rotazione effettiva dello schermo di un elemento `Class.GuiBase2d`,
in gradi. Non esegue **controlli di limite**, quindi il suo valore
potrebbe non essere nell'intervallo `0` a `360`.

Vedi anche `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` e
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsoluteRotation

Descrive la rotazione effettiva dello schermo di un elemento `Class.GuiBase2d`, in
degrees.


`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` è una proprietà di sola lettura che
descrive la dimensione effettiva dello schermo di un elemento `Class.GuiBase2d`, in
pixel.

Vedi anche `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` e
`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.


GuiBase2d.AbsoluteSize

Descrive la dimensione effettiva dello schermo di un elemento `Class.GuiBase2d`, in
pixel.


Quando impostato su `true`, la localizzazione sarà applicata a questo `Class.GuiBase2d`
e alle sue discendenti. Le voci utilizzate per la localizzazione sono lo stesso set di
voci restituite da `Class.LocalizationService:GetTableEntries()`. Le voci
con `Class.GuiBase2d.AutoLocalize|AutoLocalize` abilitate vengono automaticamente
ri-tradotte dopo il caricamento della tabella cloud se necessario.

Vedi anche `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`.


GuiBase2d.AutoLocalize

Quando impostato su `true`, la localizzazione sarà applicata a questo `Class.GuiBase2d`
e alle sue discendenti.


Questa proprietà è impostata automaticamente su true quando una tabella di localizzazione
`Class.LocalizationTable.Root` punta a questo oggetto, o a un antenato di questo
oggetto. `Class.LocalizationTable|LocalizationTables` con la loro
proprietà `Class.LocalizationTable.Root` puntata a un'istanza localizzerà
tutti i `Class.TextLabel.TextButton` che sono discendenti dell'istanza radice.


GuiBase2d.Localize

Impostato automaticamente su true quando la tabella di localizzazione
`Class.LocalizationTable.Root` punta a questo oggetto, o a un antenato di questo
oggetto.


Un riferimento a una `Class.LocalizationTable` da utilizzare per applicare
localizzazione automatizzata a questo `Class.GuiBase2d` e alle sue discendenti.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` deve essere impostato su `true` su
`Class.GuiBase2d` e i suoi antenati affinché la localizzazione automatizzata sia
applicata.

Puoi impostarlo per fare riferimento a una `Class.LocalizationTable` ovunque nel
`Class.DataModel`. L'oggetto `Class.GuiBase2d` e tutti i suoi figli
cercheranno di utilizzare quella specifica `Class.LocalizationTable` e i suoi antenati
per la sostituzione automatica del testo prima di utilizzare le tabelle sotto
`Class.LocalizationService` in un ordine non definito e la tabella cloud.

Se non ci sono traduzioni disponibili nella tabella a cui si fa riferimento, cercherà
una traduzione nel genitore di quella tabella, se è anch'esso una
`Class.LocalizationTable`, e così via.

Vedi anche `Class.LocalizationService:GetTableEntries()` che spiega come
il `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` è utilizzato
per la localizzazione automatica.


GuiBase2d.RootLocalizationTable

Un riferimento a una `Class.LocalizationTable` da utilizzare per applicare
localizzazione automatizzata a questo `Class.GuiBase2d` e alle sue discendenti.


Personalizza il comportamento di selezione del gamepad nella direzione verso il basso.


GuiBase2d.SelectionBehaviorDown

Personalizza il comportamento di selezione del gamepad nella direzione a sinistra.


GuiBase2d.SelectionBehaviorLeft

Personalizza il comportamento di selezione del gamepad nella direzione a destra.


GuiBase2d.SelectionBehaviorRight

Personalizza il comportamento di selezione del gamepad nella direzione verso l'alto.


GuiBase2d.SelectionBehaviorUp

Permette la personalizzazione di come la selezione del gamepad può muoversi tra
i pulsanti, che sono discendenti del gruppo di selezione, lasciare il gruppo,
e selezionare altri pulsanti.

Impostando `Class.GuiBase2d.SelectionGroup|SelectionGroup` su `true` espone le
proprietà `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, e
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`. Per questi comportamenti di selezione,
un'impostazione di `Enum.SelectionBehavior.Escape` (predefinito) significa che la selezione
con gamepad cerca prima di trovare una selezione all'interno del gruppo di selezione e si muovefuori solo se non trova un pulsante adatto. In alternativa, un'impostazione di
`Enum.SelectionBehavior.Stop` significa che la selezione con gamepad cerca solo all'interno
del gruppo di selezione e non si muove al di fuori del gruppo dalla direzione del comportamento di selezione.


GuiBase2d.SelectionGroup

Permette la personalizzazione del movimento di selezione del gamepad.


Una classe astratta ereditata da `Class.GuiObject|GuiObjects`.


GuiBase è una classe astratta dalla quale ereditano la maggior parte degli oggetti dell'interfaccia grafica dell'utente
.

GuiBase

`Instance` è la classe base per tutte le classi nella gerarchia delle classi di Roblox
che possono far parte dell'albero `Class.DataModel`.

Non è possibile creare direttamente oggetti `Instance` radice, ma il costruttore speciale
`Datatype.Instance.new()` crea oggetti attraverso il codice, prendendo il
nome della classe come parametro e restituendo l'oggetto creato.

Dimostra come rilevare i cambiamenti nell'ascendenza di un'istanza collegandosi all'evento
`Class.Instance.AncestryChanged`.

Il Parent di ChangingPart viene impostato su valori diversi nel tempo. Il parent
del pezzo è l'antenato del pezzo, quindi l'evento `Class.Instance.AncestryChanged`
viene attivato ogni volta che cambia.


Si attiva quando questa istanza viene ripristinata o quando uno dei suoi
antenati viene ripristinato.

Puoi utilizzare questo evento per tenere traccia della cancellazione di un'istanza
in Studio, come la cancellazione manuale nell'Explorer o attraverso un plugin. Se
hai bisogno di rilevare quando un'istanza viene distrutta usando `Class.Instance:Destroy()`,
usa invece l'evento `Class.Instance.Destroying`.

Instance.AncestryChanged

child

L'istanza la cui proprietà `Class.Instance.Parent|Parent` è stata modificata,
che può essere questa istanza o un antenato più lontano, **non**
necessariamente l'istanza a cui è collegato gestore.

parent

Si attiva quando viene modificata la proprietà `Class.Instance.Parent` di
questo oggetto o di uno dei suoi antenati.

Questo evento si attiva ogni volta che un attributo viene modificato sull'istanza,
compreso quando un attributo viene impostato su `nil`. Il nome dell'attributo modificato
viene passato alla funzione collegata.

Ad esempio, il seguente frammento di codice collega la funzione `attributeChanged()`
che si attiva ogni volta che uno degli attributi della parte cambia:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "cambiato")
end

part.AttributeChanged:Connect(attributeChanged)
```
Vedi anche `Class.Instance:GetAttributeChangedSignal()` che restituisce un
evento che si attiva quando un attributo specifico cambia.

Instance.AttributeChanged

attribute

Il nome dell'attributo che è stato modificato.

Si attiva ogni volta che un attributo viene modificato sull'`Class.Instance`.

Questo frammento stampa i nomi degli oggetti man mano che vengono aggiunti allo Spazio di lavoro:


Si attiva dopo che un oggetto è stato aggiunto a questo `Class.Instance`.

Nota, quando utilizzi questo metodo su un client per rilevare oggetti creati dal
server è necessario usare `Class.Instance:WaitForChild()` quando si indicizzano i
discendenti di questi oggetti. Questo perché l'oggetto e i suoi discendenti non
sono garantiti di replicarsi dal server al client simultaneamente. Ad esempio:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Usa WaitForChild() poiché i discendenti potrebbero non essere stati ancora replicati
	local head = child:WaitForChild("Head")
end)
```
Nota, questo evento opera solo per i figli immediati del
`Class.Instance`. Per un evento che cattura tutti i discendenti, usa
`Class.Instance.DescendantAdded`.

Vedi anche `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Il `Class.Instance` che è stato aggiunto.

Si attiva dopo che un oggetto è stato aggiunto a questo `Class.Instance`.

Instance.childAdded

Questo frammento stampa i nomi degli oggetti man mano che vengono rimossi dal
Workspace:

Si attiva dopo che un figlio è stato rimosso da questo `Class.Instance`.

Rimosso si riferisce a quando il genitore di un oggetto viene cambiato da questo
`Class.Instance` a qualcosa di diverso da questo `Class.Instance`. Nota, questo
evento si attiverà anche quando un figlio viene distrutto (utilizzando
`Class.Instance:Destroy()`) poiché la funzione di distruzione imposta il genitore di un oggetto
su `nil`.

Questo evento opera solo per i figli immediati del `Class.Instance`.
Per un evento che cattura tutti i discendenti, usa
`Class.Instance.DescendantRemoving`.

Vedi anche `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Il `Class.Instance` che è stato rimosso.

Si attiva dopo che un figlio è stato rimosso da questo `Class.Instance`.

Il seguente esempio stamperà il nome di qualsiasi oggetto che viene aggiunto a
Workspace:

Questo evento si attiva dopo che un discendente è stato aggiunto all'`Class.Instance`.

Poiché si attiva per ogni discendente, l'aggiunta di un oggetto all'`Class.Instance`
attiverà l'evento per questo oggetto e per tutti i suoi discendenti individualmente.

Se ti preoccupa solo i **figli diretti** del
`Class.Instance`, usa `Class.Instance.ChildAdded` invece.

Vedi anche `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Si attiva dopo che un discendente è stato aggiunto all'`Class.Instance`.

L'esempio seguente stampa il nome di qualsiasi discendente mentre viene rimosso
dallo Workspace:

Questo evento si attiva **immediatamente prima** che il genitore `Class.Instance`
cambi in modo tale che un'istanza **discendente** non sarà più un
discendente. `Class.Instance:Destroy()|Destroy()` cambia il `Class.Instance.Parent|Parent`
a `nil`, quindi chiamando quel metodo su un discendente del genitore farà scattare questo evento.

Poiché questo evento si attiva **prima** della rimozione del discendente, il genitore del
discendente non sarà cambiato al momento della chiamata di questo evento. Se il
discendente è anche un **figlio diretto** del genitore, questo evento si attiverà
prima di `Class.Instance.ChildRemoved`.

Se un discendente ha figli, questo evento si attiva prima con il discendente,
seguito dai suoi discendenti.

#### Attenzione

Questo evento si attiva con l'oggetto discendente che viene rimosso.
Tentare di impostare il `Class.Instance.Parent|Parent` del discendente su
qualcos'altro fallirà. Di seguito è riportato un esempio che dimostra questo:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Non manipolare il genitore del discendente in questa funzione!
	-- Questo evento si attiva PERCHÉ il genitore è stato manipolato, e la modifica non è ancora avvenuta
	-- Quindi, è problematico cambiare il genitore in questo modo:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Vedi anche `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Si attiva immediatamente prima che un discendente dell'`Class.Instance` venga rimosso.

Questo campione dimostra come, quando si utilizza il comportamento del segnale Immediato, un
Oggetto in fase di distruzione rimane in posizione fino a quando la funzione collegata non restituisce.

Questo esempio dimostra come, quando si utilizza il comportamento dei segnali Deferred, un'istanza
viene distrutta prima che il segnale venga emesso.


Il `Class.Instance` non verrà mai eliminato dalla memoria mentre una funzione collegata
lo sta ancora utilizzando. Tuttavia, se la funzione attende in qualsiasi
momento, il `Class.Instance` e i suoi discendenti verranno impostati a `nil`.

Se la proprietà `Class.Workspace.SignalBehavior` è impostata su
`Enum.SignalBehavior.Immediate`, questo evento si attiva immediatamente prima che il
`Class.Instance` o uno dei suoi antenati venga distrutto con
`Class.Instance:Destroy()`.

Se la proprietà `Class.Workspace.SignalBehavior` è impostata su
`Enum.SignalBehavior.Deferred`, questo evento si attiverà al prossimo punto di ripresa,
che sarà dopo che il `Class.Instance` o uno dei suoi antenati è
distrutto con `Class.Instance:Destroy()`.

Con il comportamento `Enum.SignalBehavior.Deferred|Deferred`, collegare uno script
a proprio evento `Class.Instance.Destroying` è problematico, poiché lo script
verrà distrutto prima che il callback possa essere chiamato (significa che non verrà
eseguito).

Quando si elimina un `Class.Instance` in Studio, come l'eliminazione manuale
attraverso l'[Explorer](/studio/explorer) o tramite un plugin,
il `Class.Instance` non viene distrutto. Invece, il genitore viene impostato su `nil`
che puoi tracciare con `Class.Instance.AncestryChanged`.

Instance.Destroying

Si attiva immediatamente prima (o viene rinviato fino a dopo) che l'istanza venga
distrutta tramite `Class.Instance:Destroy() `.

Questo evento si attiva ogni volta che viene modificata una proprietà di stile sull'istanza,
compreso quando una proprietà viene impostata su `nil`.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Proprietà stilistiche cambiate")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

Instance.StyledPropertiesChanged

Si attiva ogni volta che viene modificata una proprietà di stile sull'istanza, compreso
quando una proprietà viene impostata su `nil`.

Questo metodo applica un tag all'istanza, senza effetto se il tag è
già stato applicato. Aggiungere con successo un tag attiverà un segnale creato da
`Class.CollectionService:GetInstanceAddedSignal()` con il tag fornito.

#### Avvertenze

- I tag di un'istanza aggiunti lato client verranno eliminati se il
  server aggiunge o rimuove successivamente un tag su quell'istanza poiché il server
  replica tutti i tag insieme e sovrascrive i tag precedenti.

- Quando si etichetta un'istanza, è comune che alcune risorse siano utilizzate per
  dare al tag la sua funzionalità, ad esempio connessioni di eventi o tabelle.
  Per prevenire perdite di memoria, è una buona idea pulirle (disconnettersi,
  impostarle su `nil`, ecc.) quando non sono più necessarie per un tag. Farlo quando
  si chiama `Class.Instance:RemoveTag()`, si chiama
  `Class.Instance:Destroy()`, o in una funzione collegata a un segnale
  restituito da `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

La funzione dei figli restituisce un array dei figli dell'oggetto.

Instance:children

Restituisce un array dei figli dell'oggetto.

Questo metodo distrugge tutti i figli di un'istanza e i discendenti.

```
local part = Instance.new("Part")

-- Aggiungi alcune scintille
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Se non desideri distruggere **tutti** i figli e i discendenti, usa o
`Class.Instance:GetChildren()` o `Class.Instance:GetDescendants()` per
ciclare attraverso quei figli/discendenti e selezionare cosa distruggere. Ad
esempio, il seguente campione di codice distruggerà tutti
`Class.BasePart|BaseParts` discendenti da un `Class.Model`:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

Questo metodo distrugge tutti i figli di un'istanza.

Dimostra come clonare un modello utilizzando `Class.Instance:Clone()`.


`Clone()` crea una copia di un'istanza e di tutti i suoi discendenti,
ignorando tutte le istanze che non sono
`Class.Instance.Archivable|Archivable`. La copia dell'istanza radice è
restituita da questo metodo e il suo `Class.Instance.Parent|Parent` è impostato su
`nil`. Nota che se l'istanza stessa ha `Class.Instance.Archivable|Archivable`
impostato su `false`, questo metodo restituirà `nil`.

Se una proprietà di riferimento come `Class.ObjectValue.Value` è impostata in un
'istanza clonata, il valore della proprietà della copia dipende dal valore
originale:

- Se una proprietà di riferimento fa riferimento a un'istanza che è **stata** clonata,
  la copia farà riferimento alla copia.
- Se una proprietà di riferimento fa riferimento a un'istanza che **non è stata** clonata,
  lo stesso valore è mantenuto nella copia.

Instance:Clone

Crea una copia di un'istanza e di tutti i suoi discendenti, ignorando le istanze
che non sono `Class.Instance.Archivable|Archivable`.

Instance:clone

Dimostra come distruggere un Part utilizzando la funzione `Class.Instance:Destroy()`.

Questa funzione è il modo corretto per smaltire gli oggetti che non sono più
necessari.


Imposta la proprietà `Class.Instance.Parent` su `nil`, blocca la
proprietà `Class.Instance.Parent`, disconnetta tutte le connessioni e chiama
`Destroy()` su tutti i figli. Questo metodo è il modo corretto per eliminare
oggetti che non sono più richiesti.

Eliminare oggetti non necessari è importante, poiché oggetti e
connessioni non necessari in un luogo consumano memoria, il che può portare a gravi
problemi di prestazioni nel tempo.

Come migliore pratica dopo aver chiamato `Destroy()` su un oggetto, imposta qualsiasi
variabile che fa riferimento all'oggetto (o ai suoi discendenti) su `nil`. Questo
prevenire il tuo codice di accedere a qualsiasi cosa riguardo all'oggetto.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Non farlo:
print(part.Name)  --> "Hello, world"
-- Fai questo per impedire che la riga sopra funzioni:
part = nil
```
Una volta che un `Class.Instance` è stato distrutto da questo metodo, non può essere riutilizzato perché la proprietà `Class.Instance.Parent`
è bloccata. Per **rimuovere temporaneamente** un oggetto invece di distruggerlo, imposta
`Class.Instance.Parent|Parent` su `nil`. Ad esempio:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Per distruggere un oggetto dopo un determinato periodo di tempo, usa
`Class.Debris:AddItem()`.

Instance:Destroy

Imposta la proprietà `Class.Instance.Parent` su `nil`, blocca la
proprietà `Class.Instance.Parent`, disconnetta tutte le connessioni e chiama
`Destroy()` su tutti i figli.

Instance:destroy

Restituisce il primo antenato del `Class.Instance` il cui
`Class.Instance.Name` è uguale al nome fornito.

Questo metodo lavora verso l'alto, il che significa che inizia dal
immediato `Class.Instance.Parent` dell'istanza e lavora verso il
`Class.DataModel`. Se non viene trovato nessun antenato corrispondente, restituisce `nil`.

Il seguente frammento di codice troverebbe il primo antenato dell'oggetto
chiamato `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Per varianti di questo metodo che trovano antenati di una classe specifica,
si prega di vedere `Class.Instance:FindFirstAncestorOfClass()` e
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Restituisce il primo antenato del `Class.Instance` il cui
`Class.Instance.Name` è uguale al nome fornito.

Restituisce il primo antenato del `Class.Instance` il cui
`Class.Object.ClassName` è uguale al className fornito.

Questo metodo riesce verso l'alto, il che significa che inizia dal
immediato `Class.Instance.Parent` dell'istanza e lavora verso il
`Class.DataModel`. Se non viene trovato nessun antenato corrispondente, restituisce `nil`.

Un uso comune di questo metodo è trovare il `Class.Model` a cui
un `Class.BasePart` appartiene. Ad esempio:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Questo metodo è una variante di `Class.Instance:FindFirstAncestor()`
che controlla la proprietà `Class.Object.ClassName` invece di
`Class.Instance.Name`. Esiste anche `Class.Instance:FindFirstAncestorWhichIsA()`
che utilizza il metodo `Class.Object:IsA()` invece per rispettare l'ereditarietà della classe.

Instance:FindFirstAncestorOfClass

className

Restituisce il primo antenato del `Class.Instance` il cui
`Class.Object.ClassName` è uguale al className fornito.

Restituisce il primo antenato del `Class.Instance` per cui
`Class.Object:IsA()` restituisce vero per il className fornito.

Questo metodo lavora verso l'alto, il che significa che inizia dal
immediato `Class.Instance.Parent` dell'istanza e lavora verso il
`Class.DataModel`. Se non viene trovato nessun antenato corrispondente, restituisce `nil`.

A differenza di `Class.Instance:FindFirstAncestorOfClass()`, questo metodo utilizza
`Class.Object:IsA()` che rispetta l'ereditarietà della classe. Ad esempio:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Pertanto, il seguente campione di codice restituirà il primo
antenato `Class.BasePart`, indipendentemente dal fatto che sia un
`Class.WedgePart`, `Class.MeshPart` o `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Vedi anche `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Restituisce il primo antenato del `Class.Instance` per cui
`Class.Object:IsA()` restituisce vero per il className fornito.

Il seguente codice cercherebbe un oggetto di nome "Brick" nel Workspace. Se trovato, cambierà il nome dell'oggetto in "Foo".

Restituisce il primo figlio del `Class.Instance` con il nome fornito, o
`nil` se non esiste alcun figlio di questo tipo. Se l'argomento opzionale `recursive`
è `true`, questo metodo cerca tutti i discendenti anziché solo i
figli immediati del `Class.Instance`.

#### Verifica dell'esistenza di un oggetto

`FindFirstChild()` è necessario se hai bisogno di verificare che un oggetto esista
prima di continuare. Tentare di indicizzare un figlio per nome utilizzando l'operatore punto solleva un errore se il figlio non esiste.

```lua
local Workspace = game:GetService("Workspace")

-- La seguente riga genera un errore se la parte non esiste
Workspace.Part.Transparency = 0.5
```
Un approccio migliore è usare `FindFirstChild()` per prima controllare `Part`, poi usare un'istruzione `if` per eseguire codice di cui ha bisogno.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Trovare un figlio il cui nome corrisponde a una proprietà

A volte il `Class.Instance.Name|Name` di un oggetto è lo stesso di quello
una proprietà del suo `Class.Instance.Parent|Parent`. Quando si utilizza l'operatore punto, le proprietà hanno la precedenza sui figli se condividono un nome.

Nell'esempio seguente, un `Class.Folder` chiamato `Color` è stato aggiunto a un
`Class.Part`, che ha anche la proprietà `Class.Part.Color`. Nota che
`part.Color` si riferisce al valore della proprietà `Datatype.Color3`, non all'istanza figlio `Class.Folder`. Un vantaggio dell'uso di
`Class.Instance:FindFirstChild()|FindFirstChild()` è che l'introduzione di nuove proprietà non comporta un rischio per il tuo codice.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- La proprietà
local c2 = part:FindFirstChild("Color")  -- La cartella figlio
```

#### Note sulle prestazioni

`Class.Instance:FindFirstChild()|FindFirstChild()` richiede circa il 20% in più
rispetto a utilizzare l'operatore punto e quasi 8 volte di più rispetto a semplicemente memorizzare
un riferimento a un oggetto. Pertanto, dovresti evitare di chiamarlo in
codice dipendente dalle prestazioni, come in cicli stretti o funzioni collegate
a `Class.RunService.Heartbeat` e `Class.RunService.PreRender`. Invece,
memorizza il risultato in una variabile o considera di utilizzare
`Class.Instance.ChildAdded|ChildAdded` o
`Class.Instance:WaitForChild()|WaitForChild()` per rilevare quando un figlio di un
certo nome diventa disponibile.

Instance:FindFirstChild

recursive

Se la ricerca deve essere effettuata ricorsivamente.

Restituisce il primo figlio del `Class.Instance` trovato con il nome fornito.

Instance:findFirstChild

Restituisce il primo figlio del `Class.Instance` il cui
`Class.Object.ClassName|ClassName` è uguale al `className` fornito.
A differenza di `Class.Instance:FindFirstChildWhichIsA()`, questo metodo restituisce solo
oggetti la cui classe corrisponde a `className`, ignorando l'ereditarietà della classe. Se non viene trovato alcun figlio corrispondente, questo metodo restituisce `nil`.

Instance:FindFirstChildOfClass

Restituisce il primo figlio del `Class.Instance` il cui
`Class.Object.ClassName|ClassName` è uguale al nome della classe fornito.

Restituisce il primo figlio del `Class.Instance` per cui
`Class.Object:IsA()` restituisce vero per il className fornito.

Se non viene trovato alcun figlio corrispondente, questo metodo restituisce `nil`. Se l'argomento
opzionale ricorsivo è vero, questo metodo cerca tutti i discendenti anziché
solo i figli immediati del `Class.Instance`.

A differenza di `Class.Instance:FindFirstChildOfClass()`, questo metodo utilizza
`Class.Object:IsA()` che rispetta l'ereditarietà della classe. Ad esempio:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Pertanto, il seguente campione di codice restituirà il primo
figlio `Class.BasePart`, indipendentemente dal fatto che sia un
`Class.WedgePart`, `Class.MeshPart` o `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
I programmatori che cercano un figlio per nome dovrebbero usare
`Class.Instance:FindFirstChild()` invece.

Instance:FindFirstChildWhichIsA

Restituisce il primo figlio del `Class.Instance` per cui
`Class.Object:IsA()` restituisce vero per il className fornito.

Restituisce il primo discendente trovato con il dato `Class.Instance.Name`.

Questo metodo è disabilitato e non può essere utilizzato. Per trovare il primo discendente
di un'istanza, considera di utilizzare il parametro `recursive` su
`Class.Instance:FindFirstChild()` invece.

Instance:FindFirstDescendant

Restituisce il primo discendente trovato con il dato `Class.Instance.Name`.

Se il `Class.Instance` è un `Class.Actor`, viene restituito il `Class.Actor` stesso.
Altrimenti, viene restituito il suo antenato `Class.Actor` più vicino. Se nessun
autore è un `Class.Actor`, il risultato è `nil`.

Instance:GetActor

Restituisce il `Class.Actor` associato con l'istanza, se presente.

Questo metodo restituisce il valore che è stato assegnato al dato
nome dell'attributo. Se non è stato assegnato alcun attributo, viene restituito `nil`.

Ad esempio, il seguente frammento di codice imposta e poi ottiene il valore
attribuito all'istanza `InitialPosition`:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Vedi anche

- `Class.Instance:SetAttribute()` che imposta l'attributo con il dato
  nome al valore fornito.
- `Class.Instance:GetAttributes()` che restituisce un dizionario di coppie chiave‑valore
  per ciascuno degli attributi dell'istanza.

Instance:GetAttribute

Restituisce il valore che è stato assegnato al dato nome dell'attributo.

Instance

`Instance` è la classe base per tutte le classi nella gerarchia delle classi di Roblox
che possono far parte dell'albero `Class.DataModel`.

/reference/engine/classes/BillboardGui.yaml