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.

ProgressBar

Eredita: Range < Control < CanvasItem < Node < Object

Un controllo utilizzato per la rappresentazione visiva di una percentuale.

Descrizione

Un controllo utilizzato per la rappresentazione visiva di una percentuale. Mostra la percentuale di riempimento al centro. Può essere utilizzato anche per mostrare un avanzamento indeterminato. Per altre modalità di riempimento, utilizzare invece TextureProgressBar.

Proprietà

bool

editor_preview_indeterminate

int

fill_mode

0

bool

indeterminate

false

bool

show_percentage

true

Proprietà del tema

Color

font_color

Color(0.95, 0.95, 0.95, 1)

Color

font_outline_color

Color(0, 0, 0, 1)

int

outline_size

0

Font

font

int

font_size

StyleBox

background

StyleBox

fill


Enumerazioni

enum FillMode: 🔗

FillMode FILL_BEGIN_TO_END = 0

La barra di avanzamento si riempie orizzontalmente dall'inizio alla fine, in base alla direzione del linguaggio. Se Control.is_layout_rtl() restituisce false, si riempie da sinistra a destra, e se restituisce true, si riempie da destra a sinistra.

FillMode FILL_END_TO_BEGIN = 1

La barra di avanzamento si riempie orizzontalmente dalla fine all'inizio, in base alla direzione del linguaggio. Se Control.is_layout_rtl() restituisce false, si riempie da destra a sinistra, e se restituisce true, si riempie da sinistra a destra.

FillMode FILL_TOP_TO_BOTTOM = 2

L'avanzamento si riempie dall'alto verso il basso.

FillMode FILL_BOTTOM_TO_TOP = 3

L'avanzamento si riempie dal basso verso l'alto.


Descrizioni delle proprietà

bool editor_preview_indeterminate 🔗

  • void set_editor_preview_indeterminate(value: bool)

  • bool is_editor_preview_indeterminate_enabled()

Se false, l'animazione di indeterminate sarà sospesa nell'editor.


int fill_mode = 0 🔗

  • void set_fill_mode(value: int)

  • int get_fill_mode()

La direzione di riempimento. Vedi FillMode per i valori possibili.


bool indeterminate = false 🔗

  • void set_indeterminate(value: bool)

  • bool is_indeterminate()

Se impostato su true, la barra di avanzamento indica che qualcosa sta accadendo con un'animazione, ma non mostra la percentuale o il valore di riempimento.


bool show_percentage = true 🔗

  • void set_show_percentage(value: bool)

  • bool is_percentage_shown()

Se true, la percentuale di riempimento viene visualizzata sulla barra.


Descrizioni delle proprietà del tema

Color font_color = Color(0.95, 0.95, 0.95, 1) 🔗

Il colore del testo.


Color font_outline_color = Color(0, 0, 0, 1) 🔗

La tonalità del contorno del testo della ProgressBar.


int outline_size = 0 🔗

La dimensione del contorno del testo.

Nota: Se si utilizza un font con FontFile.multichannel_signed_distance_field abilitato, il suo FontFile.msdf_pixel_range deve essere impostato su almeno il doppio del valore di outline_size affinché il rendering del contorno appaia corretto. Altrimenti, il contorno potrebbe apparire troncato prima del previsto.


Font font 🔗

Il font utilizzato per disegnare la percentuale di riempimento se show_percentage è true.


int font_size 🔗

La dimensione del font utilizzata per disegnare la percentuale di riempimento se show_percentage è true.


StyleBox background 🔗

Lo stile dello sfondo.


StyleBox fill 🔗

Lo stile dell'avanzamento (ovvero la parte che riempie la barra).