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...
FoldableContainer
Eredita: Container < Control < CanvasItem < Node < Object
Un contenitore che si può espandere/comprimere.
Descrizione
Un contenitore che si può espandere/comprimere, con un titolo che si può riempire con controlli, come pulsanti. Questo tipo di contenitore è anche detto fisarmonica.
Il titolo può essere posizionato in alto o in basso il contenitore. È possibile espandere o comprimere il contenitore cliccando sul titolo o premendo ui_accept quando è focalizzato. I nodi figlio di controllo sono nascosti quando il contenitore è compresso. Ignora i nodi figlio non di controllo.
È possibile raggruppare un FoldableContainer con altri FoldableContainer in modo che solo uno di essi sia aperto alla volta; vedi foldable_group e FoldableGroup.
Proprietà
focus_mode |
|
|
|
||
|
||
mouse_filter |
|
|
|
||
|
||
|
||
|
||
|
Metodi
void |
add_title_bar_control(control: Control) |
void |
expand() |
void |
fold() |
void |
remove_title_bar_control(control: Control) |
Proprietà del tema
|
||
|
||
|
||
|
||
|
||
|
||
Segnali
folding_changed(is_folded: bool) 🔗
Emesso quando il contenitore viene ridotto/espanso.
Enumerazioni
enum TitlePosition: 🔗
TitlePosition POSITION_TOP = 0
Visualizza il titolo in alto al contenitore.
TitlePosition POSITION_BOTTOM = 1
Visualizza il titolo in basso al contenitore. Capovolge verticalmente tutti gli stylebox.
Descrizioni delle proprietà
FoldableGroup foldable_group 🔗
void set_foldable_group(value: FoldableGroup)
FoldableGroup get_foldable_group()
Il FoldableGroup associato al contenitore. Quando più nodi FoldableContainer condividono lo stesso gruppo, solo uno di essi può essere espanso.
If true, the container will become folded and will hide all its children.
Language code used for text shaping algorithms. If left empty, the current locale is used instead.
Il testo del titolo del contenitore.
HorizontalAlignment title_alignment = 0 🔗
void set_title_alignment(value: HorizontalAlignment)
HorizontalAlignment get_title_alignment()
L'allineamento orizzontale del testo del titolo.
TitlePosition title_position = 0 🔗
void set_title_position(value: TitlePosition)
TitlePosition get_title_position()
La posizione del titolo.
TextDirection title_text_direction = 0 🔗
void set_title_text_direction(value: TextDirection)
TextDirection get_title_text_direction()
Direzione di scrittura del testo del titolo.
OverrunBehavior title_text_overrun_behavior = 0 🔗
void set_title_text_overrun_behavior(value: OverrunBehavior)
OverrunBehavior get_title_text_overrun_behavior()
Definisce il comportamento del titolo quando il testo è più lungo dello spazio disponibile.
Descrizioni dei metodi
void add_title_bar_control(control: Control) 🔗
Aggiunge un Control che sarà posizionato accanto al titolo del contenitore, oscurando l'area cliccabile. Serve principalmente per aggiungere nodi Button, ma può essere qualsiasi Control.
Il controllo sarà aggiunto come figlio di questo contenitore e rimosso dal precedente genitore, se necessario. I controlli sarà posizionati allineati a destra, vale a dire che il primo controllo aggiunto sarà quello più a sinistra.
void expand() 🔗
Espande il contenitore ed emette folding_changed.
void fold() 🔗
Riduce il contenitore ed emette folding_changed.
void remove_title_bar_control(control: Control) 🔗
Rimuove un Control aggiunto con add_title_bar_control(). Il nodo non viene liberato automaticamente, è necessario usare Node.queue_free().
Descrizioni delle proprietà del tema
Color collapsed_font_color = Color(1, 1, 1, 1) 🔗
Il colore del font del titolo quando compresso.
Color font_color = Color(0.875, 0.875, 0.875, 1) 🔗
Il colore del font del titolo quando espanso.
Color font_outline_color = Color(1, 1, 1, 1) 🔗
Il colore del contorno del font del titolo.
Color hover_font_color = Color(0.95, 0.95, 0.95, 1) 🔗
Il colore del font del titolo al passaggio del mouse.
La separazione orizzontale tra l'icona e il testo del titolo e tra i controlli della barra del titolo.
La dimensione del contorno del testo del titolo.
Il font del titolo.
La dimensione del font del titolo.
L'icona del titolo utilizzata quando espanso.
Texture2D expanded_arrow_mirrored 🔗
L'icona del titolo utilizzata quando espanso (per il titolo in basso).
L'icona del titolo utilizzata quando compresso (per i layout da sinistra a destra).
Texture2D folded_arrow_mirrored 🔗
L'icona del titolo utilizzata quando compresso (per i layout da destra a sinistra).
Sfondo utilizzato quando il FoldableContainer ha il focus della GUI. Lo StyleBox di focus è visualizzato sopra lo StyleBox di base, quindi è necessario utilizzare uno StyleBox parzialmente trasparente per garantire che lo StyleBox di base rimanga visibile. Uno StyleBox che rappresenta un contorno o una sottolineatura funziona bene per questo scopo. Per disabilitare l'effetto visivo del focus, assegna una risorsa StyleBoxEmpty. Tieni presente che disattivare l'effetto visivo di focus ridurrà l'usabilità della navigazione tramite tastiera o controller, perciò non è consigliato per motivi di accessibilità.
Sfondo predefinito per il FoldableContainer.
StyleBox title_collapsed_hover_panel 🔗
Sfondo utilizzato quando il cursore del mouse entra nell'area del titolo quando compresso.
StyleBox title_collapsed_panel 🔗
Sfondo predefinito per il FoldableContainer quando è compresso.
Sfondo utilizzato quando il cursore del mouse entra nell'area del titolo quando espanso.
Sfondo predefinito per il FoldableContainer quando è espanso.