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...

LinkButton

Hérite de : BaseButton < Control < CanvasItem < Node < Object

Un bouton qui représente un lien.

Description

Un bouton qui représente un lien. Ce type de bouton est principalement utilisé pour les interactions qui provoquent un changement de contexte (comme un lien vers une page web).

Voir aussi BaseButton qui contient des propriétés et des méthodes communes associées à ce nœud.

Propriétés

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	`""`

Propriétés du thème

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

Énumérations

enum UnderlineMode: 🔗

UnderlineMode UNDERLINE_MODE_ALWAYS = 0

Le LinkButton affichera toujours une ligne sous le texte.

UnderlineMode UNDERLINE_MODE_ON_HOVER = 1

Le LinkButton affichera une ligne sous le texte quand il sera survolé pour le curseur de la souris.

UnderlineMode UNDERLINE_MODE_NEVER = 2

Le LinkButton n'affichera jamais de ligne sous le texte.

Descriptions des propriétés

String ellipsis_char = "…" 🔗

void set_ellipsis_char(value: String)
String get_ellipsis_char()

Caractère d’ellipse utilisé pour tronquer du texte.

String language = "" 🔗

void set_language(value: String)
String get_language()

Code de langue utilisé pour les algorithmes de retour à la ligne et de "text shaping". Si laissé vide, la langue actuelle est utilisée à la place.

StructuredTextParser structured_text_bidi_override = 0 🔗

void set_structured_text_bidi_override(value: StructuredTextParser)
StructuredTextParser get_structured_text_bidi_override()

Définit la redéfinition de l'algorithme BiDi pour le texte structuré.

Array structured_text_bidi_override_options = [] 🔗

void set_structured_text_bidi_override_options(value: Array)
Array get_structured_text_bidi_override_options()

Définit des options supplémentaires pour la redéfinition BiDi.

String text = "" 🔗

void set_text(value: String)
String get_text()

Le texte du bouton qui sera affiché à l'intérieur de l'aire du bouton.

TextDirection text_direction = 0 🔗

void set_text_direction(value: TextDirection)
TextDirection get_text_direction()

Direction d'écriture du texte de base.

OverrunBehavior text_overrun_behavior = 0 🔗

void set_text_overrun_behavior(value: OverrunBehavior)
OverrunBehavior get_text_overrun_behavior()

Définit le comportement de coupure lorsque le texte dépasse le rectangle délimitant du nœud.

UnderlineMode underline = 0 🔗

void set_underline_mode(value: UnderlineMode)
UnderlineMode get_underline_mode()

Le mode de sous-lignage à utiliser pour le texte.

String uri = "" 🔗

void set_uri(value: String)
String get_uri()

L'URI pour ce LinkButton. S'il s'agit d'une URI valide, appuyer sur le bouton ouvre l'URI en utilisant le programme par défaut du système d'exploitation pour le protocole (via OS.shell_open()). Les URLs HTTP et HTTPS ouvrent le navigateur Web par défaut.

uri = "https://godotengine.org"  # Ouvre l'URL dans le navigateur Web par défaut.
uri = "C:\UnDossier"  # Ouvre l'explorateur de fichiers au chemin donné.
uri = "C:\UneImage.png"  # Ouvre l'image donnée dans l'application de visualisation par défaut.

Uri = "https://godotengine.org"; // Ouvre l'URL dans le navigateur Web par défaut.
Uri = "C:\UnDossier"; // Ouvre l'explorateur de fichiers au chemin donné.
Uri = "C:\UneImage.png"; // Ouvre l'image donnée dans l'application de visualisation par défaut.

Descriptions des propriétés du thème

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

La Color par défaut du texte pour le LinkButton.

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

Color du texte utilisée quand le LinkButton est désactivé.

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

Color du texte utilisée quand le LinkButton a le focus. Remplace seulement la couleur de texte normale du bouton. Les états désactivé, survolé et appuyé sont prioritaires sur cette couleur.

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

La Color de texte utilisée quand le LinkButton est survolé.

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

Color du texte utilisée quand le LinkButton est survolé et appuyé.

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

La teinte du contour du texte du LinkButton.

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

La Color de texte utilisée quand le LinkButton est pressé.

int outline_size = 0 🔗

La taille du contour du texte.

Note : Si vous utilisez une police avec FontFile.multichannel_signed_distance_field activé, sa propriété FontFile.msdf_pixel_range doit être définie à au moins deux fois la valeur de outline_size pour que le rendu des contours soit correct. Sinon, le contour peut sembler coupé plus tôt que prévu.

int underline_spacing = 2 🔗

L'espacement vertical entre la ligne de base du texte et le surlignage.

Font font 🔗

La Font du texte du LinkButton.

int font_size 🔗

Taille de police du texte de LinkButton.

StyleBox focus 🔗

StyleBox utilisée lorsque le LinkButton a le focus. La StyleBox focus est affichée par-dessus la StyleBox de base, donc une StyleBox partiellement transparente devrait être utilisée pour garantir que la StyleBox de base reste visible. Une StyleBox qui représente un contour ou une sous-lignage fonctionne bien à cette fin. Pour désactiver l'effet visuel du focus, assignez une ressource StyleBoxEmpty. Notez que la désactivation de l'effet visuel du focus va nuire à utilisabilité de la navigation clavier/contrôleur, ce qui n'est donc pas recommandé pour des raisons d'accessibilité.