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.

LinkButton

Eredita: BaseButton < Control < CanvasItem < Node < Object

Un pulsante che rappresenta un collegamento.

Descrizione

Un pulsante che rappresenta un collegamento. Questo tipo di pulsante è utilizzato principalmente per interazioni che causano un cambiamento di contesto (come il collegamento a una pagina web).

Vedi anche BaseButton che contiene le proprietà e i metodi comuni associati a questo nodo.

Proprietà

String

ellipsis_char

"…"

FocusMode

focus_mode

3 (overrides Control)

String

language

""

CursorShape

mouse_default_cursor_shape

2 (overrides Control)

StructuredTextParser

structured_text_bidi_override

0

Array

structured_text_bidi_override_options

[]

String

text

""

TextDirection

text_direction

0

OverrunBehavior

text_overrun_behavior

0

UnderlineMode

underline

0

String

uri

""

Proprietà del tema

Color

font_color

Color(0.875, 0.875, 0.875, 1)

Color

font_disabled_color

Color(0, 0, 0, 1)

Color

font_focus_color

Color(0.95, 0.95, 0.95, 1)

Color

font_hover_color

Color(0.95, 0.95, 0.95, 1)

Color

font_hover_pressed_color

Color(0, 0, 0, 1)

Color

font_outline_color

Color(0, 0, 0, 1)

Color

font_pressed_color

Color(1, 1, 1, 1)

int

outline_size

0

int

underline_spacing

2

Font

font

int

font_size

StyleBox

focus


Enumerazioni

enum UnderlineMode: 🔗

UnderlineMode UNDERLINE_MODE_ALWAYS = 0

Il LinkButton mostrerà sempre una sottolineatura sotto al suo testo.

UnderlineMode UNDERLINE_MODE_ON_HOVER = 1

Il LinkButton mostrerà una sottolineatura sotto il suo testo quando il cursore del mouse è su di esso.

UnderlineMode UNDERLINE_MODE_NEVER = 2

Il LinkButton non mostrerà mai una sottolineatura sotto al suo testo.


Descrizioni delle proprietà

String ellipsis_char = "…" 🔗

  • void set_ellipsis_char(value: String)

  • String get_ellipsis_char()

Carattere di ellissi (puntini di sospensione) utilizzato per ritagliare il testo.


String language = "" 🔗

Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.


StructuredTextParser structured_text_bidi_override = 0 🔗

Imposta la sostituzione dell'algoritmo BiDi per il testo strutturato.


Array structured_text_bidi_override_options = [] 🔗

  • void set_structured_text_bidi_override_options(value: Array)

  • Array get_structured_text_bidi_override_options()

Imposta opzioni aggiuntive per la sostituzione BiDi.


String text = "" 🔗

Il testo del pulsante che sarà visualizzato all'interno dell'area del pulsante.


TextDirection text_direction = 0 🔗

Direzione di scrittura del testo di base.


OverrunBehavior text_overrun_behavior = 0 🔗

Imposta il comportamento di ritaglio quando il testo supera il rettangolo di delimitazione del nodo.


UnderlineMode underline = 0 🔗

La modalità di sottolineatura da utilizzare per il testo.


String uri = "" 🔗

L'URI per questo LinkButton. Se impostato su un URI valido, premendo il pulsante si apre l'URI utilizzando il programma predefinito del sistema operativo per il protocollo (tramite OS.shell_open()). Gli URL HTTP e HTTPS aprono il browser Web predefinito.

uri = "https://godotengine.org"  # Apre l'URL nel browser Web predefinito.
uri = "C:\SomeFolder"  # Apre l'esploratore file nel percorso specificato.
uri = "C:\SomeImage.png"  # Apre l'immagine specificata nell'app di visualizzazione predefinita.

Descrizioni delle proprietà del tema

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

Il Color predefinito del testo del LinkButton.


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

Il Color del testo utilizzato quando il LinkButton è disabilitato.


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

Il Color del testo utilizzato quando il LinkButton è focalizzato. Sostituisce solo il colore del testo normale del pulsante. Gli stati disabilitato, al passaggio del mouse e premuto hanno la precedenza su questo colore.


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

Il Color del testo utilizzato quando si passa il mouse sul LinkButton.


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

Il Color del testo utilizzato quando si passa il mouse sopra e si preme il LinkButton.


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

La tinta del contorno del testo del LinkButton.


Color font_pressed_color = Color(1, 1, 1, 1) 🔗

Il Color del testo utilizzato quando il pulsante LinkButton è premuto.


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.


int underline_spacing = 2 🔗

Lo spazio verticale tra la linea di base del testo e la sottolineatura.


Font font 🔗

Il Font del testo del LinkButton.


int font_size 🔗

Dimensione del font per il testo del LinkButton.


StyleBox focus 🔗

Lo StyleBox utilizzato quando il LinkButton è focalizzato. 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à.