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

LabelSettings

继承： Resource < RefCounted < Object

提供能够在 Label 中自定义文本的常见设置。

描述

LabelSettings 是一种提供在 Label 中自定义文本的常见设置的资源。优先于 Control.theme 中定义的属性。该资源可以在多个标签之间共享，可以随时替换，因此可以方便、灵活地设置文本样式。

属性

Font

font

Color

font_color

Color(1, 1, 1, 1)

int

font_size

16

float

line_spacing

3.0

Color

outline_color

Color(1, 1, 1, 1)

int

outline_size

0

float

paragraph_spacing

0.0

Color

shadow_color

Color(0, 0, 0, 0)

Vector2

shadow_offset

Vector2(1, 1)

int

shadow_size

1

属性说明

Font font 🔗

  • void set_font(value: Font)

  • Font get_font()

文本使用的 Font。

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

  • void set_font_color(value: Color)

  • Color get_font_color()

文本的颜色。

int font_size = 16 🔗

  • void set_font_size(value: int)

  • int get_font_size()

文本的大小。

float line_spacing = 3.0 🔗

  • void set_line_spacing(value: float)

  • float get_line_spacing()

行与行之间的额外纵向留白（单位为像素），留白会被添加到行的降部。该值可以为负数。

Color outline_color = Color(1, 1, 1, 1) 🔗

  • void set_outline_color(value: Color)

  • Color get_outline_color()

轮廓的颜色。

int outline_size = 0 🔗

  • void set_outline_size(value: int)

  • int get_outline_size()

文本轮廓大小。

float paragraph_spacing = 0.0 🔗

  • void set_paragraph_spacing(value: float)

  • float get_paragraph_spacing()

段落之间的垂直空间。在 line_spacing 上添加。

Color shadow_color = Color(0, 0, 0, 0) 🔗

  • void set_shadow_color(value: Color)

  • Color get_shadow_color()

阴影效果的颜色。如果 Alpha 为 0 ，则不会绘制阴影。

Vector2 shadow_offset = Vector2(1, 1) 🔗

阴影效果的偏移，单位为像素。

int shadow_size = 1 🔗

  • void set_shadow_size(value: int)

  • int get_shadow_size()

阴影效果的大小。