Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Variazioni di tipi del tema

Quando si progetta un'interfaccia utente, può capitare che un nodo Control debba avere un aspetto diverso da quello normalmente definito da un Theme. Ogni nodo controllo dispone di sovrascritture delle proprietà del tema, che consentono di ridefinire lo stile di ogni singolo elemento dell'interfaccia utente.

Questo approccio diventa rapidamente difficile da gestire se è necessario condividere lo stesso aspetto personalizzato tra diversi controlli. Immagina di utilizzare varianti grigie, blu e rosse di Button in tutto il progetto. Configurarlo ogni volta che aggiungi un nuovo elemento pulsante all'interfaccia è una faticata.

Per aiutare a organizzare e sfruttare al meglio la potenza dei temi, è possibile utilizzare le variazioni di tipo del tema. Queste funzionano come i normali tipi del tema, ma anziché essere autosufficienti e indipendenti, estendono un altro tipo base.

Seguendo l'esempio precedente, il tema può avere stili, colori e font definiti per il tipo Button, personalizzando l'aspetto di ogni elemento pulsante nell'interfaccia utente. Per avere un pulsante grigio, rosso o blu, dovresti creare un nuovo tipo, ad esempio GrayButton, e segnarlo come variazione del tipo base Button.

Le variazioni di tipo possono sostituire alcuni aspetti del tipo base, mantenendone però altri. Possono anche definire proprietà non definite dallo stile base. Ad esempio, il tuo GrayButton può sovrascrivere lo stile normal del Button base e aggiungere font_color, che Button non ha mai definito. Il controllo utilizzerà una combinazione di entrambi i tipi, dando priorità alla variazione di tipo.

Nota

Il modo in cui i controlli determinano quali elementi del tema utilizzare da ciascun tipo e da ciascun tema è descritto meglio nella sezione Personalizzazione di un progetto dell'articolo "Introduzione al GUI skinning".

Creare una variazione di tipo

Per creare una variazione di tipo, apri l'editor di temi, poi clicca sull'icona "più" accanto al menu a discesa Tipo sul lato destro dell'editor. Digita il nome che desideri assegnare alla variazione di tipo del tema nella casella di testo, poi clicca su Aggiungi tipo.

Sotto il menu a discesa Tipo si trovano le schede delle proprietà. Passa alla scheda con l'icona di una chiave inglese e un cacciavite.

Clicca sull'icona più accanto al campo Tipo base. Lì puoi selezionare il tipo base, che in genere corrisponde al nome della classe di un nodo controllo (ad esempio, Button, Label, ecc.). Le variazioni di tipo possono anche concatenarsi ed estendere altre variazioni di tipo. Questo funziona nello stesso modo in cui i nodi controllo ereditano lo stile dalla loro classe base. Ad esempio, CheckButton eredita gli stili da Button perché i tipi di nodo corrispondenti si estendono a vicenda.

Dopo aver selezionato il tipo base, dovresti ora essere in grado di vederne le proprietà nelle altre schede dell'editor di temi. Puoi modificarle come al solito.

Utilizzare una variazione di tipo

Ora che è stata creata una variazione di tipo, puoi applicarla ai tuoi nodi. Nel pannello Ispettore, sotto la proprietà Tema di un nodo controllo, puoi trovare la proprietà Variazione di tipo del tema. È inizialmente vuota, il che significa che solo il tipo base ha effetto su questo nodo.

È possibile selezionare una variazione di tipo da un elenco a discesa oppure inserirne il nome manualmente. Le variazioni appaiono nell'elenco solo se appartengono al tema per tutto il progetto, che è possibile configurare nelle impostazioni del progetto. In tutti gli altri casi, bisogna inserire manualmente il nome della variazione. Clicca sull'icona della matita a destra. Poi digita il nome della variazione e clicca sull'icona del segno di spunta o premi Invio. Se esiste una variazione con quel nome, sarà ora utilizzata dal nodo.