LinkButton

Inherits: BaseButton < Control < CanvasItem < Node < Object

Simple button used to represent a link to some resource.

Description

This kind of button is primarily used when the interaction with the button causes a context change (like linking to a web page).

See also BaseButton which contains common properties and methods associated with this node.

Properties

FocusMode

focus_mode

0 (parent override)

CursorShape

mouse_default_cursor_shape

2 (parent override)

String

text

“”

UnderlineMode

underline

0

Theme Properties

StyleBox

focus

Font

font

Color

font_color

Color( 0.88, 0.88, 0.88, 1 )

Color

font_color_focus

Color( 0.94, 0.94, 0.94, 1 )

Color

font_color_hover

Color( 0.94, 0.94, 0.94, 1 )

Color

font_color_pressed

Color( 1, 1, 1, 1 )

int

underline_spacing

2

Enumerations

enum UnderlineMode:

  • UNDERLINE_MODE_ALWAYS = 0 —- The LinkButton will always show an underline at the bottom of its text.

  • UNDERLINE_MODE_ON_HOVER = 1 —- The LinkButton will show an underline at the bottom of its text when the mouse cursor is over it.

  • UNDERLINE_MODE_NEVER = 2 —- The LinkButton will never show an underline at the bottom of its text.

Property Descriptions

Default

“”

Setter

set_text(value)

Getter

get_text()

The button’s text that will be displayed inside the button’s area.


Default

0

Setter

set_underline_mode(value)

Getter

get_underline_mode()

Determines when to show the underline. See UnderlineMode for options.

Theme Property Descriptions

StyleBox used when the LinkButton is focused. It is displayed over the current StyleBox, so using StyleBoxEmpty will just disable the focus visual effect.


Font of the LinkButton‘s text.


Default

Color( 0.88, 0.88, 0.88, 1 )

Default text Color of the LinkButton.


Default

Color( 0.94, 0.94, 0.94, 1 )

Text Color used when the LinkButton is focused. Only replaces the normal text color of the button. Disabled, hovered, and pressed states take precedence over this color.


Default

Color( 0.94, 0.94, 0.94, 1 )

Text Color used when the LinkButton is being hovered.


  • Color font_color_pressed

Default

Color( 1, 1, 1, 1 )

Text Color used when the LinkButton is being pressed.


  • int underline_spacing

Default

2

The vertical space between the baseline of text and the underline.