Struct gdnative::api::TextEdit

pub struct TextEdit { /* fields omitted */ }

core class TextEdit inherits Control (unsafe).

Official documentation

See the documentation of this class in the Godot engine's official documentation.

Memory management

Non reference counted objects such as the ones of this type are usually owned by the engine.

TextEdit is a reference-only type. Persistent references can only exist in the unsafe Ref<TextEdit> form.

In the cases where Rust code owns an object of this type, for example if the object was just created on the Rust side and not passed to the engine yet, ownership should be either given to the engine or the object must be manually destroyed using Ref::free, or Ref::queue_free if it is a Node.

Class hierarchy

TextEdit inherits methods from:

• Control
• CanvasItem
• Node
• Object

Safety

All types in the Godot API have "interior mutability" in Rust parlance. To enforce that the official thread-safety guidelines are followed, the typestate pattern is used in the Ref and TRef smart pointers, and the Instance API. The typestate Access in these types tracks whether the access is unique, shared, or exclusive to the current thread. For more information, see the type-level documentation on Ref.

Implementations

impl TextEdit

Constants

pub const MENU_CLEAR: i64

pub const MENU_COPY: i64

pub const MENU_CUT: i64

pub const MENU_MAX: i64

pub const MENU_PASTE: i64

pub const MENU_REDO: i64

pub const MENU_SELECT_ALL: i64

pub const MENU_UNDO: i64

pub const SEARCH_BACKWARDS: i64

pub const SEARCH_MATCH_CASE: i64

pub const SEARCH_RESULT_COLUMN: i64

pub const SEARCH_RESULT_LINE: i64

pub const SEARCH_WHOLE_WORDS: i64

impl TextEdit

pub fn new() -> Ref<TextEdit, Unique>

Creates a new instance of this object.

Because this type is not reference counted, the lifetime of the returned object is not automatically managed.

Immediately after creation, the object is owned by the caller, and can be passed to the engine (in which case the engine will be responsible for destroying the object) or destroyed manually using Ref::free, or preferably Ref::queue_free if it is a Node.

pub fn add_color_region(
    &self,
    begin_key: impl Into<GodotString>,
    end_key: impl Into<GodotString>,
    color: Color,
    line_only: bool
)

Adds color region (given the delimiters) and its colors.

Default Arguments

• line_only - false

pub fn add_keyword_color(&self, keyword: impl Into<GodotString>, color: Color)

Adds a [code]keyword[/code] and its [Color].

pub fn can_fold(&self, line: i64) -> bool

Returns if the given line is foldable, that is, it has indented lines right below it.

pub fn center_viewport_to_cursor(&self)

Centers the viewport on the line the editing cursor is at. This also resets the [member scroll_horizontal] value to [code]0[/code].

pub fn clear_colors(&self)

Clears all custom syntax coloring information previously added with [method add_color_region] or [method add_keyword_color].

pub fn clear_undo_history(&self)

Clears the undo history.

pub fn copy(&self)

Copy's the current text selection.

pub fn cursor_get_blink_enabled(&self) -> bool

If [code]true[/code], the caret (visual cursor) blinks.

pub fn cursor_get_blink_speed(&self) -> f64

Duration (in seconds) of a caret's blinking cycle.

pub fn cursor_get_column(&self) -> i64

Returns the column the editing cursor is at.

pub fn cursor_get_line(&self) -> i64

Returns the line the editing cursor is at.

pub fn cursor_is_block_mode(&self) -> bool

If [code]true[/code], the caret displays as a rectangle.
			If [code]false[/code], the caret displays as a bar.

pub fn cursor_set_blink_enabled(&self, enable: bool)

If [code]true[/code], the caret (visual cursor) blinks.

pub fn cursor_set_blink_speed(&self, blink_speed: f64)

Duration (in seconds) of a caret's blinking cycle.

pub fn cursor_set_block_mode(&self, enable: bool)

If [code]true[/code], the caret displays as a rectangle.
			If [code]false[/code], the caret displays as a bar.

pub fn cursor_set_column(&self, column: i64, adjust_viewport: bool)

Moves the cursor at the specified [code]column[/code] index.
				If [code]adjust_viewport[/code] is set to [code]true[/code], the viewport will center at the cursor position after the move occurs.

Default Arguments

• adjust_viewport - true

pub fn cursor_set_line(
    &self,
    line: i64,
    adjust_viewport: bool,
    can_be_hidden: bool,
    wrap_index: i64
)

Moves the cursor at the specified [code]line[/code] index.
				If [code]adjust_viewport[/code] is set to [code]true[/code], the viewport will center at the cursor position after the move occurs.
				If [code]can_be_hidden[/code] is set to [code]true[/code], the specified [code]line[/code] can be hidden using [method set_line_as_hidden].

Default Arguments

• adjust_viewport - true
• can_be_hidden - true
• wrap_index - 0

pub fn cut(&self)

Cut's the current selection.

pub fn deselect(&self)

Deselects the current selection.

pub fn draw_minimap(&self, draw: bool)

If [code]true[/code], a minimap is shown, providing an outline of your source code.

pub fn fold_all_lines(&self)

Folds all lines that are possible to be folded (see [method can_fold]).

pub fn fold_line(&self, line: i64)

Folds the given line, if possible (see [method can_fold]).

pub fn get_breakpoints(&self) -> VariantArray<Shared>

Returns an array containing the line number of each breakpoint.

pub fn h_scroll(&self) -> i64

The current horizontal scroll value.

pub fn get_keyword_color(&self, keyword: impl Into<GodotString>) -> Color

Returns the [Color] of the specified [code]keyword[/code].

pub fn get_line(&self, line: i64) -> GodotString

Returns the text of a specific line.

pub fn get_line_count(&self) -> i64

Returns the amount of total lines in the text.

pub fn get_menu(&self) -> Option<Ref<PopupMenu, Shared>>

Returns the [PopupMenu] of this [TextEdit]. By default, this menu is displayed when right-clicking on the [TextEdit].

pub fn minimap_width(&self) -> i64

The width, in pixels, of the minimap.

pub fn get_selection_from_column(&self) -> i64

Returns the selection begin column.

pub fn get_selection_from_line(&self) -> i64

Returns the selection begin line.

pub fn get_selection_text(&self) -> GodotString

Returns the text inside the selection.

pub fn get_selection_to_column(&self) -> i64

Returns the selection end column.

pub fn get_selection_to_line(&self) -> i64

Returns the selection end line.

pub fn text(&self) -> GodotString

String value of the [TextEdit].

pub fn v_scroll(&self) -> f64

The current vertical scroll value.

pub fn v_scroll_speed(&self) -> f64

Vertical scroll sensitivity.

pub fn get_word_under_cursor(&self) -> GodotString

Returns a [String] text with the word under the mouse cursor location.

pub fn has_keyword_color(&self, keyword: impl Into<GodotString>) -> bool

Returns whether the specified [code]keyword[/code] has a color set to it or not.

pub fn insert_text_at_cursor(&self, text: impl Into<GodotString>)

Insert the specified text at the cursor position.

pub fn is_breakpoint_gutter_enabled(&self) -> bool

If [code]true[/code], the breakpoint gutter is visible.

pub fn is_context_menu_enabled(&self) -> bool

If [code]true[/code], a right-click displays the context menu.

pub fn is_drawing_fold_gutter(&self) -> bool

If [code]true[/code], the fold gutter is visible. This enables folding groups of indented lines.

pub fn is_drawing_minimap(&self) -> bool

If [code]true[/code], a minimap is shown, providing an outline of your source code.

pub fn is_drawing_spaces(&self) -> bool

If [code]true[/code], the "space" character will have a visible representation.

pub fn is_drawing_tabs(&self) -> bool

If [code]true[/code], the "tab" character will have a visible representation.

pub fn is_folded(&self, line: i64) -> bool

Returns whether the line at the specified index is folded or not.

pub fn is_hiding_enabled(&self) -> bool

If [code]true[/code], all lines that have been set to hidden by [method set_line_as_hidden], will not be visible.

pub fn is_highlight_all_occurrences_enabled(&self) -> bool

If [code]true[/code], all occurrences of the selected text will be highlighted.

pub fn is_highlight_current_line_enabled(&self) -> bool

If [code]true[/code], the line containing the cursor is highlighted.

pub fn is_line_hidden(&self, line: i64) -> bool

Returns whether the line at the specified index is hidden or not.

pub fn is_overriding_selected_font_color(&self) -> bool

If [code]true[/code], custom [code]font_color_selected[/code] will be used for selected text.

pub fn is_readonly(&self) -> bool

If [code]true[/code], read-only mode is enabled. Existing text cannot be modified and new text cannot be added.

pub fn is_right_click_moving_caret(&self) -> bool

If [code]true[/code], a right-click moves the cursor at the mouse position before displaying the context menu.
			If [code]false[/code], the context menu disregards mouse location.

pub fn is_selecting_enabled(&self) -> bool

If [code]true[/code], text can be selected.
			If [code]false[/code], text can not be selected by the user or by the [method select] or [method select_all] methods.

pub fn is_selection_active(&self) -> bool

Returns [code]true[/code] if the selection is active.

pub fn is_shortcut_keys_enabled(&self) -> bool

If [code]true[/code], shortcut keys for context menu items are enabled, even if the context menu is disabled.

pub fn is_show_line_numbers_enabled(&self) -> bool

If [code]true[/code], line numbers are displayed to the left of the text.

pub fn is_smooth_scroll_enabled(&self) -> bool

If [code]true[/code], sets the [code]step[/code] of the scrollbars to [code]0.25[/code] which results in smoother scrolling.

pub fn is_syntax_coloring_enabled(&self) -> bool

If [code]true[/code], any custom color properties that have been set for this [TextEdit] will be visible.

pub fn is_virtual_keyboard_enabled(&self) -> bool

If [code]true[/code], the native virtual keyboard is shown when focused on platforms that support it.

pub fn is_wrap_enabled(&self) -> bool

If [code]true[/code], enables text wrapping when it goes beyond the edge of what is visible.

pub fn menu_option(&self, option: i64)

Triggers a right-click menu action by the specified index. See [enum MenuItems] for a list of available indexes.

pub fn paste(&self)

Paste the current selection.

pub fn redo(&self)

Perform redo operation.

pub fn remove_breakpoints(&self)

Removes all the breakpoints. This will not fire the [signal breakpoint_toggled] signal.

pub fn search(
    &self,
    key: impl Into<GodotString>,
    flags: i64,
    from_line: i64,
    from_column: i64
) -> TypedArray<i32>

Perform a search inside the text. Search flags can be specified in the [enum SearchFlags] enum.
				Returns an empty [code]PoolIntArray[/code] if no result was found. Otherwise, the result line and column can be accessed at indices specified in the [enum SearchResult] enum, e.g:
				[codeblock]
				var result = search(key, flags, line, column)
				if result.size() > 0:
				    # Result found.
				    var res_line = result[TextEdit.SEARCH_RESULT_LINE]
				    var res_column = result[TextEdit.SEARCH_RESULT_COLUMN]
				[/codeblock]

pub fn select(
    &self,
    from_line: i64,
    from_column: i64,
    to_line: i64,
    to_column: i64
)

Perform selection, from line/column to line/column.
				If [member selecting_enabled] is [code]false[/code], no selection will occur.

pub fn select_all(&self)

Select all the text.
				If [member selecting_enabled] is [code]false[/code], no selection will occur.

pub fn set_breakpoint_gutter_enabled(&self, enable: bool)

If [code]true[/code], the breakpoint gutter is visible.

pub fn set_context_menu_enabled(&self, enable: bool)

If [code]true[/code], a right-click displays the context menu.

pub fn set_draw_fold_gutter(&self, arg0: bool)

If [code]true[/code], the fold gutter is visible. This enables folding groups of indented lines.

pub fn set_draw_spaces(&self, arg0: bool)

If [code]true[/code], the "space" character will have a visible representation.

pub fn set_draw_tabs(&self, arg0: bool)

If [code]true[/code], the "tab" character will have a visible representation.

pub fn set_h_scroll(&self, value: i64)

The current horizontal scroll value.

pub fn set_hiding_enabled(&self, enable: bool)

If [code]true[/code], all lines that have been set to hidden by [method set_line_as_hidden], will not be visible.

pub fn set_highlight_all_occurrences(&self, enable: bool)

If [code]true[/code], all occurrences of the selected text will be highlighted.

pub fn set_highlight_current_line(&self, enabled: bool)

If [code]true[/code], the line containing the cursor is highlighted.

pub fn set_line(&self, line: i64, new_text: impl Into<GodotString>)

Sets the text for a specific line.

pub fn set_line_as_hidden(&self, line: i64, enable: bool)

If [code]true[/code], hides the line of the specified index.

pub fn set_minimap_width(&self, width: i64)

The width, in pixels, of the minimap.

pub fn set_override_selected_font_color(&self, _override: bool)

If [code]true[/code], custom [code]font_color_selected[/code] will be used for selected text.

pub fn set_readonly(&self, enable: bool)

If [code]true[/code], read-only mode is enabled. Existing text cannot be modified and new text cannot be added.

pub fn set_right_click_moves_caret(&self, enable: bool)

If [code]true[/code], a right-click moves the cursor at the mouse position before displaying the context menu.
			If [code]false[/code], the context menu disregards mouse location.

pub fn set_selecting_enabled(&self, enable: bool)

If [code]true[/code], text can be selected.
			If [code]false[/code], text can not be selected by the user or by the [method select] or [method select_all] methods.

pub fn set_shortcut_keys_enabled(&self, enable: bool)

If [code]true[/code], shortcut keys for context menu items are enabled, even if the context menu is disabled.

pub fn set_show_line_numbers(&self, enable: bool)

If [code]true[/code], line numbers are displayed to the left of the text.

pub fn set_smooth_scroll_enable(&self, enable: bool)

If [code]true[/code], sets the [code]step[/code] of the scrollbars to [code]0.25[/code] which results in smoother scrolling.

pub fn set_syntax_coloring(&self, enable: bool)

If [code]true[/code], any custom color properties that have been set for this [TextEdit] will be visible.

pub fn set_text(&self, text: impl Into<GodotString>)

String value of the [TextEdit].

pub fn set_v_scroll(&self, value: f64)

The current vertical scroll value.

pub fn set_v_scroll_speed(&self, speed: f64)

Vertical scroll sensitivity.

pub fn set_virtual_keyboard_enabled(&self, enable: bool)

If [code]true[/code], the native virtual keyboard is shown when focused on platforms that support it.

pub fn set_wrap_enabled(&self, enable: bool)

If [code]true[/code], enables text wrapping when it goes beyond the edge of what is visible.

pub fn toggle_fold_line(&self, line: i64)

Toggle the folding of the code block at the given line.

pub fn undo(&self)

Perform undo operation.

pub fn unfold_line(&self, line: i64)

Unfolds the given line, if folded.

pub fn unhide_all_lines(&self)

Unhide all lines that were previously set to hidden by [method set_line_as_hidden].

Methods from Deref<Target = Control>

pub const ANCHOR_BEGIN: i64

pub const ANCHOR_END: i64

pub const CURSOR_ARROW: i64

pub const CURSOR_BDIAGSIZE: i64

pub const CURSOR_BUSY: i64

pub const CURSOR_CAN_DROP: i64

pub const CURSOR_CROSS: i64

pub const CURSOR_DRAG: i64

pub const CURSOR_FDIAGSIZE: i64

pub const CURSOR_FORBIDDEN: i64

pub const CURSOR_HELP: i64

pub const CURSOR_HSIZE: i64

pub const CURSOR_HSPLIT: i64

pub const CURSOR_IBEAM: i64

pub const CURSOR_MOVE: i64

pub const CURSOR_POINTING_HAND: i64

pub const CURSOR_VSIZE: i64

pub const CURSOR_VSPLIT: i64

pub const CURSOR_WAIT: i64

pub const FOCUS_ALL: i64

pub const FOCUS_CLICK: i64

pub const FOCUS_NONE: i64

pub const GROW_DIRECTION_BEGIN: i64

pub const GROW_DIRECTION_BOTH: i64

pub const GROW_DIRECTION_END: i64

pub const MOUSE_FILTER_IGNORE: i64

pub const MOUSE_FILTER_PASS: i64

pub const MOUSE_FILTER_STOP: i64

pub const NOTIFICATION_FOCUS_ENTER: i64

pub const NOTIFICATION_FOCUS_EXIT: i64

pub const NOTIFICATION_MODAL_CLOSE: i64

pub const NOTIFICATION_MOUSE_ENTER: i64

pub const NOTIFICATION_MOUSE_EXIT: i64

pub const NOTIFICATION_RESIZED: i64

pub const NOTIFICATION_SCROLL_BEGIN: i64

pub const NOTIFICATION_SCROLL_END: i64

pub const NOTIFICATION_THEME_CHANGED: i64

pub const PRESET_BOTTOM_LEFT: i64

pub const PRESET_BOTTOM_RIGHT: i64

pub const PRESET_BOTTOM_WIDE: i64

pub const PRESET_CENTER: i64

pub const PRESET_CENTER_BOTTOM: i64

pub const PRESET_CENTER_LEFT: i64

pub const PRESET_CENTER_RIGHT: i64

pub const PRESET_CENTER_TOP: i64

pub const PRESET_HCENTER_WIDE: i64

pub const PRESET_LEFT_WIDE: i64

pub const PRESET_MODE_KEEP_HEIGHT: i64

pub const PRESET_MODE_KEEP_SIZE: i64

pub const PRESET_MODE_KEEP_WIDTH: i64

pub const PRESET_MODE_MINSIZE: i64

pub const PRESET_RIGHT_WIDE: i64

pub const PRESET_TOP_LEFT: i64

pub const PRESET_TOP_RIGHT: i64

pub const PRESET_TOP_WIDE: i64

pub const PRESET_VCENTER_WIDE: i64

pub const PRESET_WIDE: i64

pub const SIZE_EXPAND: i64

pub const SIZE_EXPAND_FILL: i64

pub const SIZE_FILL: i64

pub const SIZE_SHRINK_CENTER: i64

pub const SIZE_SHRINK_END: i64

pub fn accept_event(&self)

Marks an input event as handled. Once you accept an input event, it stops propagating, even to nodes listening to [method Node._unhandled_input] or [method Node._unhandled_key_input].

pub fn add_color_override(&self, name: impl Into<GodotString>, color: Color)

Overrides the [Color] with given [code]name[/code] in the [member theme] resource the control uses.
				[b]Note:[/b] Unlike other theme overrides, there is no way to undo a color override without manually assigning the previous color.
				[b]Example of overriding a label's color and resetting it later:[/b]
				[codeblock]
				# Override the child node "MyLabel"'s font color to orange.
				$MyLabel.add_color_override("font_color", Color(1, 0.5, 0))

				# Reset the color by creating a new node to get the default value:
				var default_label_color = Label.new().get_color("font_color")
				$MyLabel.add_color_override("font_color", default_label_color)
				[/codeblock]

pub fn add_constant_override(&self, name: impl Into<GodotString>, constant: i64)

Overrides an integer constant with given [code]name[/code] in the [member theme] resource the control uses. If the [code]constant[/code] is [code]0[/code], the override is cleared and the constant from assigned [Theme] is used.

pub fn add_font_override(
    &self,
    name: impl Into<GodotString>,
    font: impl AsArg<Font>
)

Overrides the font with given [code]name[/code] in the [member theme] resource the control uses. If [code]font[/code] is [code]null[/code] or invalid, the override is cleared and the font from assigned [Theme] is used.

pub fn add_icon_override(
    &self,
    name: impl Into<GodotString>,
    texture: impl AsArg<Texture>
)

Overrides the icon with given [code]name[/code] in the [member theme] resource the control uses. If [code]icon[/code] is [code]null[/code] or invalid, the override is cleared and the icon from assigned [Theme] is used.

pub fn add_shader_override(
    &self,
    name: impl Into<GodotString>,
    shader: impl AsArg<Shader>
)

Overrides the [Shader] with given [code]name[/code] in the [member theme] resource the control uses. If [code]shader[/code] is [code]null[/code] or invalid, the override is cleared and the shader from assigned [Theme] is used.

pub fn add_stylebox_override(
    &self,
    name: impl Into<GodotString>,
    stylebox: impl AsArg<StyleBox>
)

Overrides the [StyleBox] with given [code]name[/code] in the [member theme] resource the control uses. If [code]stylebox[/code] is empty or invalid, the override is cleared and the [StyleBox] from assigned [Theme] is used.
				[b]Example of modifying a property in a StyleBox by duplicating it:[/b]
				[codeblock]
				# The snippet below assumes the child node MyButton has a StyleBoxFlat assigned.
				# Resources are shared across instances, so we need to duplicate it
				# to avoid modifying the appearance of all other buttons.
				var new_stylebox_normal = $MyButton.get_stylebox("normal").duplicate()
				new_stylebox_normal.border_width_top = 3
				new_stylebox_normal.border_color = Color(0, 1, 0.5)
				$MyButton.add_stylebox_override("normal", new_stylebox_normal)

				# Remove the stylebox override:
				$MyButton.add_stylebox_override("normal", null)
				[/codeblock]

pub fn force_drag(
    &self,
    data: impl OwnedToVariant,
    preview: impl AsArg<Control>
)

Forces drag and bypasses [method get_drag_data] and [method set_drag_preview] by passing [code]data[/code] and [code]preview[/code]. Drag will start even if the mouse is neither over nor pressed on this control.
				The methods [method can_drop_data] and [method drop_data] must be implemented on controls that want to receive drop data.

pub fn anchor(&self, margin: i64) -> f64

Anchors the top edge of the node to the origin, the center or the end of its parent control. It changes how the top margin updates when the node moves or changes size. You can use  one of the [enum Anchor] constants for convenience.

pub fn get_begin(&self) -> Vector2D<f32, UnknownUnit>

Returns [member margin_left] and [member margin_top]. See also [member rect_position].

pub fn get_color(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> Color

Returns a color from assigned [Theme] with given [code]name[/code] and associated with [Control] of given [code]type[/code].
				[codeblock]
				func _ready():
				    modulate = get_color("font_color", "Button") #get the color defined for button fonts
				[/codeblock]

Default Arguments

• type - ""

pub fn get_combined_minimum_size(&self) -> Vector2D<f32, UnknownUnit>

Returns combined minimum size from [member rect_min_size] and [method get_minimum_size].

pub fn get_constant(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> i64

Returns a constant from assigned [Theme] with given [code]name[/code] and associated with [Control] of given [code]type[/code].

Default Arguments

• type - ""

pub fn get_cursor_shape(
    &self,
    position: Vector2D<f32, UnknownUnit>
) -> CursorShape

Returns the mouse cursor shape the control displays on mouse hover. See [enum CursorShape].

Default Arguments

• position - Vector2( 0, 0 )

pub fn custom_minimum_size(&self) -> Vector2D<f32, UnknownUnit>

The minimum size of the node's bounding rectangle. If you set it to a value greater than (0, 0), the node's bounding rectangle will always have at least this size, even if its content is smaller. If it's set to (0, 0), the node sizes automatically to fit its content, be it a texture or child nodes.

pub fn default_cursor_shape(&self) -> CursorShape

The default cursor shape for this control. Useful for Godot plugins and applications or games that use the system's mouse cursors.
			[b]Note:[/b] On Linux, shapes may vary depending on the cursor theme of the system.

pub fn get_end(&self) -> Vector2D<f32, UnknownUnit>

Returns [member margin_right] and [member margin_bottom].

pub fn focus_mode(&self) -> FocusMode

The focus access mode for the control (None, Click or All). Only one Control can be focused at the same time, and it will receive keyboard signals.

pub fn focus_neighbour(&self, margin: i64) -> NodePath

Tells Godot which node it should give keyboard focus to if the user presses the top arrow on the keyboard or top on a gamepad by default. You can change the key by editing the [code]ui_top[/code] input action. The node must be a [Control]. If this property is not set, Godot will give focus to the closest [Control] to the bottom of this one.

pub fn focus_next(&self) -> NodePath

Tells Godot which node it should give keyboard focus to if the user presses Tab on a keyboard by default. You can change the key by editing the [code]ui_focus_next[/code] input action.
			If this property is not set, Godot will select a "best guess" based on surrounding nodes in the scene tree.

pub fn get_focus_owner(&self) -> Option<Ref<Control, Shared>>

Returns the control that has the keyboard focus or [code]null[/code] if none.

pub fn focus_previous(&self) -> NodePath

Tells Godot which node it should give keyboard focus to if the user presses Shift+Tab on a keyboard by default. You can change the key by editing the [code]ui_focus_prev[/code] input action.
			If this property is not set, Godot will select a "best guess" based on surrounding nodes in the scene tree.

pub fn get_font(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> Option<Ref<Font, Shared>>

Returns a font from assigned [Theme] with given [code]name[/code] and associated with [Control] of given [code]type[/code].

Default Arguments

• type - ""

pub fn global_position(&self) -> Vector2D<f32, UnknownUnit>

The node's global position, relative to the world (usually to the top-left corner of the window).

pub fn get_global_rect(&self) -> Rect<f32, UnknownUnit>

Returns the position and size of the control relative to the top-left corner of the screen. See [member rect_position] and [member rect_size].

pub fn h_grow_direction(&self) -> GrowDirection

Controls the direction on the horizontal axis in which the control should grow if its horizontal minimum size is changed to be greater than its current size, as the control always has to be at least the minimum size.

pub fn h_size_flags(&self) -> i64

Tells the parent [Container] nodes how they should resize and place the node on the X axis. Use one of the [enum SizeFlags] constants to change the flags. See the constants to learn what each does.

pub fn get_icon(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> Option<Ref<Texture, Shared>>

Returns an icon from assigned [Theme] with given [code]name[/code] and associated with [Control] of given [code]type[/code].

Default Arguments

• type - ""

pub fn margin(&self, margin: i64) -> f64

Distance between the node's top edge and its parent control, based on [member anchor_top].
			Margins are often controlled by one or multiple parent [Container] nodes, so you should not modify them manually if your node is a direct child of a [Container]. Margins update automatically when you move or resize the node.

pub fn get_minimum_size(&self) -> Vector2D<f32, UnknownUnit>

Returns the minimum size for this control. See [member rect_min_size].

pub fn mouse_filter(&self) -> MouseFilter

Controls whether the control will be able to receive mouse button input events through [method _gui_input] and how these events should be handled. Also controls whether the control can receive the [signal mouse_entered], and [signal mouse_exited] signals. See the constants to learn what each does.

pub fn get_parent_area_size(&self) -> Vector2D<f32, UnknownUnit>

Returns the width/height occupied in the parent control.

pub fn get_parent_control(&self) -> Option<Ref<Control, Shared>>

Returns the parent control node.

pub fn pivot_offset(&self) -> Vector2D<f32, UnknownUnit>

By default, the node's pivot is its top-left corner. When you change its [member rect_scale], it will scale around this pivot. Set this property to [member rect_size] / 2 to center the pivot in the node's rectangle.

pub fn position(&self) -> Vector2D<f32, UnknownUnit>

The node's position, relative to its parent. It corresponds to the rectangle's top-left corner. The property is not affected by [member rect_pivot_offset].

pub fn get_rect(&self) -> Rect<f32, UnknownUnit>

Returns the position and size of the control relative to the top-left corner of the parent Control. See [member rect_position] and [member rect_size].

pub fn get_rotation(&self) -> f64

Returns the rotation (in radians).

pub fn rotation_degrees(&self) -> f64

The node's rotation around its pivot, in degrees. See [member rect_pivot_offset] to change the pivot's position.

pub fn scale(&self) -> Vector2D<f32, UnknownUnit>

The node's scale, relative to its [member rect_size]. Change this property to scale the node around its [member rect_pivot_offset]. The Control's [member hint_tooltip] will also scale according to this value.
			[b]Note:[/b] This property is mainly intended to be used for animation purposes. Text inside the Control will look pixelated or blurry when the Control is scaled. To support multiple resolutions in your project, use an appropriate viewport stretch mode as described in the [url=https://docs.godotengine.org/en/latest/tutorials/viewports/multiple_resolutions.html]documentation[/url] instead of scaling Controls individually.
			[b]Note:[/b] If the Control node is a child of a [Container] node, the scale will be reset to [code]Vector2(1, 1)[/code] when the scene is instanced. To set the Control's scale when it's instanced, wait for one frame using [code]yield(get_tree(), "idle_frame")[/code] then set its [member rect_scale] property.

pub fn size(&self) -> Vector2D<f32, UnknownUnit>

The size of the node's bounding rectangle, in pixels. [Container] nodes update this property automatically.

pub fn stretch_ratio(&self) -> f64

If the node and at least one of its neighbours uses the [constant SIZE_EXPAND] size flag, the parent [Container] will let it take more or less space depending on this property. If this node has a stretch ratio of 2 and its neighbour a ratio of 1, this node will take two thirds of the available space.

pub fn get_stylebox(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> Option<Ref<StyleBox, Shared>>

Returns a [StyleBox] from assigned [Theme] with given [code]name[/code] and associated with [Control] of given [code]type[/code].

Default Arguments

• type - ""

pub fn theme(&self) -> Option<Ref<Theme, Shared>>

Changing this property replaces the current [Theme] resource this node and all its [Control] children use.

pub fn get_tooltip(
    &self,
    at_position: Vector2D<f32, UnknownUnit>
) -> GodotString

Returns the tooltip, which will appear when the cursor is resting over this control. See [member hint_tooltip].

Default Arguments

• at_position - Vector2( 0, 0 )

pub fn v_grow_direction(&self) -> GrowDirection

Controls the direction on the vertical axis in which the control should grow if its vertical minimum size is changed to be greater than its current size, as the control always has to be at least the minimum size.

pub fn v_size_flags(&self) -> i64

Tells the parent [Container] nodes how they should resize and place the node on the Y axis. Use one of the [enum SizeFlags] constants to change the flags. See the constants to learn what each does.

pub fn grab_click_focus(&self)

Creates an [InputEventMouseButton] that attempts to click the control. If the event is received, the control acquires focus.
				[codeblock]
				func _process(delta):
				    grab_click_focus() #when clicking another Control node, this node will be clicked instead
				[/codeblock]

pub fn grab_focus(&self)

Steal the focus from another control and become the focused control (see [member focus_mode]).

pub fn has_color(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> bool

Returns [code]true[/code] if [Color] with given [code]name[/code] and associated with [Control] of given [code]type[/code] exists in assigned [Theme].

Default Arguments

• type - ""

pub fn has_color_override(&self, name: impl Into<GodotString>) -> bool

Returns [code]true[/code] if [Color] with given [code]name[/code] has a valid override in this [Control] node.

pub fn has_constant(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> bool

Returns [code]true[/code] if constant with given [code]name[/code] and associated with [Control] of given [code]type[/code] exists in assigned [Theme].

Default Arguments

• type - ""

pub fn has_constant_override(&self, name: impl Into<GodotString>) -> bool

Returns [code]true[/code] if constant with given [code]name[/code] has a valid override in this [Control] node.

pub fn has_focus(&self) -> bool

Returns [code]true[/code] if this is the current focused control. See [member focus_mode].

pub fn has_font(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> bool

Returns [code]true[/code] if font with given [code]name[/code] and associated with [Control] of given [code]type[/code] exists in assigned [Theme].

Default Arguments

• type - ""

pub fn has_font_override(&self, name: impl Into<GodotString>) -> bool

Returns [code]true[/code] if font with given [code]name[/code] has a valid override in this [Control] node.

pub fn has_icon(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> bool

Returns [code]true[/code] if icon with given [code]name[/code] and associated with [Control] of given [code]type[/code] exists in assigned [Theme].

Default Arguments

• type - ""

pub fn has_icon_override(&self, name: impl Into<GodotString>) -> bool

Returns [code]true[/code] if icon with given [code]name[/code] has a valid override in this [Control] node.

pub fn has_shader_override(&self, name: impl Into<GodotString>) -> bool

Returns [code]true[/code] if [Shader] with given [code]name[/code] has a valid override in this [Control] node.

pub fn has_stylebox(
    &self,
    name: impl Into<GodotString>,
    _type: impl Into<GodotString>
) -> bool

Returns [code]true[/code] if [StyleBox] with given [code]name[/code] and associated with [Control] of given [code]type[/code] exists in assigned [Theme].

Default Arguments

• type - ""

pub fn has_stylebox_override(&self, name: impl Into<GodotString>) -> bool

Returns [code]true[/code] if [StyleBox] with given [code]name[/code] has a valid override in this [Control] node.

pub fn is_clipping_contents(&self) -> bool

Enables whether rendering of [CanvasItem] based children should be clipped to this control's rectangle. If [code]true[/code], parts of a child which would be visibly outside of this control's rectangle will not be rendered.

pub fn minimum_size_changed(&self)

Invalidates the size cache in this node and in parent nodes up to toplevel. Intended to be used with [method get_minimum_size] when the return value is changed. Setting [member rect_min_size] directly calls this method automatically.

pub fn release_focus(&self)

Give up the focus. No other control will be able to receive keyboard input.

pub fn set_anchor(
    &self,
    margin: i64,
    anchor: f64,
    keep_margin: bool,
    push_opposite_anchor: bool
)

Sets the anchor identified by [code]margin[/code] constant from [enum Margin] enum to value [code]anchor[/code]. A setter method for [member anchor_bottom], [member anchor_left], [member anchor_right] and [member anchor_top].
				If [code]keep_margin[/code] is [code]true[/code], margins aren't updated after this operation.
				If [code]push_opposite_anchor[/code] is [code]true[/code] and the opposite anchor overlaps this anchor, the opposite one will have its value overridden. For example, when setting left anchor to 1 and the right anchor has value of 0.5, the right anchor will also get value of 1. If [code]push_opposite_anchor[/code] was [code]false[/code], the left anchor would get value 0.5.

Default Arguments

• keep_margin - false
• push_opposite_anchor - true

pub fn set_anchor_and_margin(
    &self,
    margin: i64,
    anchor: f64,
    offset: f64,
    push_opposite_anchor: bool
)

Works the same as [method set_anchor], but instead of [code]keep_margin[/code] argument and automatic update of margin, it allows to set the margin offset yourself (see [method set_margin]).

Default Arguments

• push_opposite_anchor - false

pub fn set_anchors_and_margins_preset(
    &self,
    preset: i64,
    resize_mode: i64,
    margin: i64
)

Sets both anchor preset and margin preset. See [method set_anchors_preset] and [method set_margins_preset].

Default Arguments

• resize_mode - 0
• margin - 0

pub fn set_anchors_preset(&self, preset: i64, keep_margins: bool)

Sets the anchors to a [code]preset[/code] from [enum Control.LayoutPreset] enum. This is code equivalent of using the Layout menu in 2D editor.
				If [code]keep_margins[/code] is [code]true[/code], control's position will also be updated.

Default Arguments

• keep_margins - false

pub fn set_begin(&self, position: Vector2D<f32, UnknownUnit>)

Sets [member margin_left] and [member margin_top] at the same time. Equivalent of changing [member rect_position].

pub fn set_clip_contents(&self, enable: bool)

Enables whether rendering of [CanvasItem] based children should be clipped to this control's rectangle. If [code]true[/code], parts of a child which would be visibly outside of this control's rectangle will not be rendered.

pub fn set_custom_minimum_size(&self, size: Vector2D<f32, UnknownUnit>)

The minimum size of the node's bounding rectangle. If you set it to a value greater than (0, 0), the node's bounding rectangle will always have at least this size, even if its content is smaller. If it's set to (0, 0), the node sizes automatically to fit its content, be it a texture or child nodes.

pub fn set_default_cursor_shape(&self, shape: i64)

The default cursor shape for this control. Useful for Godot plugins and applications or games that use the system's mouse cursors.
			[b]Note:[/b] On Linux, shapes may vary depending on the cursor theme of the system.

pub fn set_drag_forwarding(&self, target: impl AsArg<Control>)

Forwards the handling of this control's drag and drop to [code]target[/code] control.
				Forwarding can be implemented in the target control similar to the methods [method get_drag_data], [method can_drop_data], and [method drop_data] but with two differences:
				1. The function name must be suffixed with [b]_fw[/b]
				2. The function must take an extra argument that is the control doing the forwarding
				[codeblock]
				# ThisControl.gd
				extends Control
				func _ready():
				    set_drag_forwarding(target_control)

				# TargetControl.gd
				extends Control
				func can_drop_data_fw(position, data, from_control):
				    return true

				func drop_data_fw(position, data, from_control):
				    my_handle_data(data)

				func get_drag_data_fw(position, from_control):
				    set_drag_preview(my_preview)
				    return my_data()
				[/codeblock]

pub fn set_drag_preview(&self, control: impl AsArg<Control>)

Shows the given control at the mouse pointer. A good time to call this method is in [method get_drag_data]. The control must not be in the scene tree.
				[codeblock]
				export (Color, RGBA) var color = Color(1, 0, 0, 1)

				func get_drag_data(position):
				    # Use a control that is not in the tree
				    var cpb = ColorPickerButton.new()
				    cpb.color = color
				    cpb.rect_size = Vector2(50, 50)
				    set_drag_preview(cpb)
				    return color
				[/codeblock]

pub fn set_end(&self, position: Vector2D<f32, UnknownUnit>)

Sets [member margin_right] and [member margin_bottom] at the same time.

pub fn set_focus_mode(&self, mode: i64)

The focus access mode for the control (None, Click or All). Only one Control can be focused at the same time, and it will receive keyboard signals.

pub fn set_focus_neighbour(&self, margin: i64, neighbour: impl Into<NodePath>)

Tells Godot which node it should give keyboard focus to if the user presses the top arrow on the keyboard or top on a gamepad by default. You can change the key by editing the [code]ui_top[/code] input action. The node must be a [Control]. If this property is not set, Godot will give focus to the closest [Control] to the bottom of this one.

pub fn set_focus_next(&self, next: impl Into<NodePath>)

Tells Godot which node it should give keyboard focus to if the user presses Tab on a keyboard by default. You can change the key by editing the [code]ui_focus_next[/code] input action.
			If this property is not set, Godot will select a "best guess" based on surrounding nodes in the scene tree.

pub fn set_focus_previous(&self, previous: impl Into<NodePath>)

Tells Godot which node it should give keyboard focus to if the user presses Shift+Tab on a keyboard by default. You can change the key by editing the [code]ui_focus_prev[/code] input action.
			If this property is not set, Godot will select a "best guess" based on surrounding nodes in the scene tree.

pub fn set_global_position(
    &self,
    position: Vector2D<f32, UnknownUnit>,
    keep_margins: bool
)

Sets the [member rect_global_position] to given [code]position[/code].
				If [code]keep_margins[/code] is [code]true[/code], control's anchors will be updated instead of margins.

Default Arguments

• keep_margins - false

pub fn set_h_grow_direction(&self, direction: i64)

Controls the direction on the horizontal axis in which the control should grow if its horizontal minimum size is changed to be greater than its current size, as the control always has to be at least the minimum size.

pub fn set_h_size_flags(&self, flags: i64)

Tells the parent [Container] nodes how they should resize and place the node on the X axis. Use one of the [enum SizeFlags] constants to change the flags. See the constants to learn what each does.

pub fn set_margin(&self, margin: i64, offset: f64)

Distance between the node's top edge and its parent control, based on [member anchor_top].
			Margins are often controlled by one or multiple parent [Container] nodes, so you should not modify them manually if your node is a direct child of a [Container]. Margins update automatically when you move or resize the node.

pub fn set_margins_preset(&self, preset: i64, resize_mode: i64, margin: i64)

Sets the margins to a [code]preset[/code] from [enum Control.LayoutPreset] enum. This is code equivalent of using the Layout menu in 2D editor.
				Use parameter [code]resize_mode[/code] with constants from [enum Control.LayoutPresetMode] to better determine the resulting size of the [Control]. Constant size will be ignored if used with presets that change size, e.g. [code]PRESET_LEFT_WIDE[/code].
				Use parameter [code]margin[/code] to determine the gap between the [Control] and the edges.

Default Arguments

• resize_mode - 0
• margin - 0

pub fn set_mouse_filter(&self, filter: i64)

Controls whether the control will be able to receive mouse button input events through [method _gui_input] and how these events should be handled. Also controls whether the control can receive the [signal mouse_entered], and [signal mouse_exited] signals. See the constants to learn what each does.

pub fn set_pivot_offset(&self, pivot_offset: Vector2D<f32, UnknownUnit>)

By default, the node's pivot is its top-left corner. When you change its [member rect_scale], it will scale around this pivot. Set this property to [member rect_size] / 2 to center the pivot in the node's rectangle.

pub fn set_position(
    &self,
    position: Vector2D<f32, UnknownUnit>,
    keep_margins: bool
)

Sets the [member rect_position] to given [code]position[/code].
				If [code]keep_margins[/code] is [code]true[/code], control's anchors will be updated instead of margins.

Default Arguments

• keep_margins - false

pub fn set_rotation(&self, radians: f64)

Sets the rotation (in radians).

pub fn set_rotation_degrees(&self, degrees: f64)

The node's rotation around its pivot, in degrees. See [member rect_pivot_offset] to change the pivot's position.

pub fn set_scale(&self, scale: Vector2D<f32, UnknownUnit>)

The node's scale, relative to its [member rect_size]. Change this property to scale the node around its [member rect_pivot_offset]. The Control's [member hint_tooltip] will also scale according to this value.
			[b]Note:[/b] This property is mainly intended to be used for animation purposes. Text inside the Control will look pixelated or blurry when the Control is scaled. To support multiple resolutions in your project, use an appropriate viewport stretch mode as described in the [url=https://docs.godotengine.org/en/latest/tutorials/viewports/multiple_resolutions.html]documentation[/url] instead of scaling Controls individually.
			[b]Note:[/b] If the Control node is a child of a [Container] node, the scale will be reset to [code]Vector2(1, 1)[/code] when the scene is instanced. To set the Control's scale when it's instanced, wait for one frame using [code]yield(get_tree(), "idle_frame")[/code] then set its [member rect_scale] property.

pub fn set_size(&self, size: Vector2D<f32, UnknownUnit>, keep_margins: bool)

Sets the size (see [member rect_size]).
				If [code]keep_margins[/code] is [code]true[/code], control's anchors will be updated instead of margins.

Default Arguments

• keep_margins - false

pub fn set_stretch_ratio(&self, ratio: f64)

If the node and at least one of its neighbours uses the [constant SIZE_EXPAND] size flag, the parent [Container] will let it take more or less space depending on this property. If this node has a stretch ratio of 2 and its neighbour a ratio of 1, this node will take two thirds of the available space.

pub fn set_theme(&self, theme: impl AsArg<Theme>)

Changing this property replaces the current [Theme] resource this node and all its [Control] children use.

pub fn set_tooltip(&self, tooltip: impl Into<GodotString>)

Changes the tooltip text. The tooltip appears when the user's mouse cursor stays idle over this control for a few moments, provided that the [member mouse_filter] property is not [constant MOUSE_FILTER_IGNORE]. You can change the time required for the tooltip to appear with [code]gui/timers/tooltip_delay_sec[/code] option in Project Settings.

pub fn set_v_grow_direction(&self, direction: i64)

Controls the direction on the vertical axis in which the control should grow if its vertical minimum size is changed to be greater than its current size, as the control always has to be at least the minimum size.

pub fn set_v_size_flags(&self, flags: i64)

Tells the parent [Container] nodes how they should resize and place the node on the Y axis. Use one of the [enum SizeFlags] constants to change the flags. See the constants to learn what each does.

pub fn show_modal(&self, exclusive: bool)

Displays a control as modal. Control must be a subwindow. Modal controls capture the input signals until closed or the area outside them is accessed. When a modal control loses focus, or the ESC key is pressed, they automatically hide. Modal controls are used extensively for popup dialogs and menus.
				If [code]exclusive[/code] is [code]true[/code], other controls will not receive input and clicking outside this control will not close it.

Default Arguments

• exclusive - false

pub fn warp_mouse(&self, to_position: Vector2D<f32, UnknownUnit>)

Moves the mouse cursor to [code]to_position[/code], relative to [member rect_position] of this [Control].

Trait Implementations

impl Debug for TextEdit

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Deref for TextEdit

type Target = Control

The resulting type after dereferencing.

fn deref(&self) -> &Control

Dereferences the value.

impl DerefMut for TextEdit

fn deref_mut(&mut self) -> &mut Control

Mutably dereferences the value.

impl GodotObject for TextEdit

type RefKind = ManuallyManaged

The memory management kind of this type. This modifies the behavior of the Ref smart pointer. See its type-level documentation for more information.

fn class_name() -> &'static str

fn null() -> Null<Self>

Creates an explicitly null reference of Self as a method argument. This makes type inference easier for the compiler compared to Option.

fn new() -> Ref<Self, Unique> where
    Self: Instanciable, 

Creates a new instance of Self using a zero-argument constructor, as a Unique reference.

fn cast<T>(&self) -> Option<&T> where
    T: GodotObject + SubClass<Self>, 

Performs a dynamic reference downcast to target type.

fn upcast<T>(&self) -> &T where
    Self: SubClass<T>,
    T: GodotObject, 

Performs a static reference upcast to a supertype that is guaranteed to be valid.

unsafe fn assume_shared(&self) -> Ref<Self, Shared>

Creates a persistent reference to the same Godot object with shared thread access.

unsafe fn assume_thread_local(&self) -> Ref<Self, ThreadLocal> where
    Self: GodotObject<RefKind = RefCounted>, 

Creates a persistent reference to the same Godot object with thread-local thread access.

unsafe fn assume_unique(&self) -> Ref<Self, Unique>

Creates a persistent reference to the same Godot object with unique access.

impl Instanciable for TextEdit

fn construct() -> Ref<TextEdit, Unique>

impl QueueFree for TextEdit

unsafe fn godot_queue_free(obj: *mut c_void)

impl SubClass<CanvasItem> for TextEdit

impl SubClass<Control> for TextEdit

impl SubClass<Node> for TextEdit

impl SubClass<Object> for TextEdit