LinkButton¶

继承： BaseButton < Control < Item < Object

表示链接的按钮。

描述¶

表示链接的按钮。这种类型的按钮主要用于导致上下文更改的交互（如链接到网页）。

另请参阅BaseButton，其中包含与此节点关联的常用属性和方法。

属性¶

FocusMode	focus_mode	`0` (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`
UnderlineMode	underline	`0`
String	uri	`""`

主题属性¶

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

枚举¶

enum UnderlineMode: 🔗

UnderlineMode UNDERLINE_MODE_ALWAYS = 0

LinkButton将始终在其文本底部显示下划线。

UnderlineMode UNDERLINE_MODE_ON_HOVER = 1

当鼠标光标在LinkButton上时，LinkButton将在其文本底部显示下划线。

UnderlineMode UNDERLINE_MODE_NEVER = 2

LinkButton永远不会在文本底部显示下划线。

属性说明¶

String language = "" 🔗

void set_language(value: String)
String get_language()

用于换行和文本整形算法的语言代码，如果留空则使用当前语言环境。

StructuredTextParser structured_text_bidi_override = 0 🔗

void set_structured_text_bidi_override(value: StructuredTextParser)
StructuredTextParser get_structured_text_bidi_override()

为结构化文本设置BiDi算法覆盖。

Array structured_text_bidi_override_options = [] 🔗

void set_structured_text_bidi_override_options(value: Array)
Array get_structured_text_bidi_override_options()

为BiDi覆盖设置附加选项。

String text = "" 🔗

void set_text(value: String)
String get_text()

将显示在按钮区域内的按钮文本。

TextDirection text_direction = 0 🔗

void set_text_direction(value: TextDirection)
TextDirection get_text_direction()

基本文本写作方向。

UnderlineMode underline = 0 🔗

void set_underline_mode(value: UnderlineMode)
UnderlineMode get_underline_mode()

用于文本的下划线模式。有关可用模式，请参阅UnderlineMode。

String uri = "" 🔗

void set_uri(value: String)
String get_uri()

用于此LinkButton的URI。如果设置为有效的URI，按下按钮将使用操作系统默认的协议程序打开该URI（通过OS.shell_open()）。HTTP和HTTPS URL将打开默认的网页浏览器。

uri = "https://i3yoo.cn"  # Opens the URL in the default web browser.
uri = "C:\SomeFolder"  # Opens the file explorer at the given path.
uri = "C:\SomeImage.png"  # Opens the given image in the default viewing app.

Uri = "https://i3yoo.cn"; // Opens the URL in the default web browser.
Uri = "C:\SomeFolder"; // Opens the file explorer at the given path.
Uri = "C:\SomeImage.png"; // Opens the given image in the default viewing app.

主题属性说明¶

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

LinkButton的默认文本Color。

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

禁用LinkButton时使用的文本Color。

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

聚焦LinkButton时使用的文本Color。仅替换按钮的正常文本颜色。禁用、悬停和按下状态优先于此颜色。

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

悬停LinkButton时使用的文本Color。

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

悬停并按下LinkButton时使用的文本Color。

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

LinkButton的文本轮廓色调。

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

按下LinkButton时使用的文本Color。

int outline_size = 0 🔗

文本大纲的大小。

注意：如果使用启用了FontFile.multichannel_signed_distance_field的字体，则其FontFile.msdf_pixel_range必须设置为至少两倍outline_size的值才能使轮廓渲染看起来正确。否则，轮廓可能会比预期的更早被切断。

int underline_spacing = 2 🔗

文本基线和下划线之间的垂直空间。

Font font 🔗

LinkButton文本的Font。

int font_size 🔗

LinkButton文本的字体大小。

StyleBox focus 🔗

StyleBox在LinkButton聚焦时使用。focus StyleBox显示在底座StyleBox的上方，因此应使用部分透明的StyleBox来确保底座StyleBox保持可见。表示轮廓或下划线的StyleBox可以很好地用于此目的。要禁用焦点视觉效果，请分配StyleBoxEmpty资源。请注意，禁用焦点视觉效果会损害键盘/控制器导航可用性，因此出于可访问性原因不建议这样做。