Struct ScrollContainer
#[repr(C)]pub struct ScrollContainer { /* private fields */ }
Expand description
Godot class ScrollContainer.
Inherits Container
.
Related symbols:
scroll_container
: sidecar module with related enum/flag typesIScrollContainer
: virtual methods
See also Godot docs for ScrollContainer
.
§Construction
This class is manually managed. You can create a new instance using ScrollContainer::new_alloc()
.
Do not forget to call free()
or hand over ownership to Godot.
Implementations§
§impl ScrollContainer
impl ScrollContainer
pub fn set_h_scroll(&mut self, value: i32)
pub fn get_h_scroll(&self) -> i32
pub fn set_v_scroll(&mut self, value: i32)
pub fn get_v_scroll(&self) -> i32
pub fn set_horizontal_custom_step(&mut self, value: f32)
pub fn get_horizontal_custom_step(&self) -> f32
pub fn set_vertical_custom_step(&mut self, value: f32)
pub fn get_vertical_custom_step(&self) -> f32
pub fn set_horizontal_scroll_mode(&mut self, enable: ScrollMode)
pub fn get_horizontal_scroll_mode(&self) -> ScrollMode
pub fn set_vertical_scroll_mode(&mut self, enable: ScrollMode)
pub fn get_vertical_scroll_mode(&self) -> ScrollMode
pub fn set_deadzone(&mut self, deadzone: i32)
pub fn get_deadzone(&self) -> i32
pub fn set_follow_focus(&mut self, enabled: bool)
pub fn is_following_focus(&self) -> bool
pub fn get_h_scroll_bar(&mut self) -> Option<Gd<HScrollBar>>
pub fn get_v_scroll_bar(&mut self) -> Option<Gd<VScrollBar>>
pub fn ensure_control_visible(&mut self, control: impl AsObjectArg<Control>)
Methods from Deref<Target = Container>§
pub fn queue_sort(&mut self)
pub fn fit_child_in_rect( &mut self, child: impl AsObjectArg<Control>, rect: Rect2, )
pub fn notify(&mut self, what: ContainerNotification)
pub fn notify(&mut self, what: ContainerNotification)
⚠️ Sends a Godot notification to all classes inherited by the object.
Triggers calls to on_notification()
, and depending on the notification, also to Godot’s lifecycle callbacks such as ready()
.
Starts from the highest ancestor (the Object
class) and goes down the hierarchy.
See also Godot docs for Object::notification()
.
§Panics
If you call this method on a user-defined object while holding a GdRef
or GdMut
guard on the instance, you will encounter
a panic. The reason is that the receiving virtual method on_notification()
acquires a GdMut
lock dynamically, which must
be exclusive.
pub fn notify_reversed(&mut self, what: ContainerNotification)
pub fn notify_reversed(&mut self, what: ContainerNotification)
⚠️ Like Self::notify()
, but starts at the most-derived class and goes up the hierarchy.
See docs of that method, including the panics.
Methods from Deref<Target = Control>§
pub fn accept_event(&mut self)
pub fn get_minimum_size(&self) -> Vector2
pub fn get_combined_minimum_size(&self) -> Vector2
pub fn set_anchors_preset(&mut self, preset: LayoutPreset)
pub fn set_anchors_preset(&mut self, preset: LayoutPreset)
To set the default parameters, use Self::set_anchors_preset_ex
and its builder methods. See the book for detailed usage instructions.
pub fn set_anchors_preset_ex<'a>( &'a mut self, preset: LayoutPreset, ) -> ExSetAnchorsPreset<'a>
pub fn set_offsets_preset(&mut self, preset: LayoutPreset)
pub fn set_offsets_preset(&mut self, preset: LayoutPreset)
To set the default parameters, use Self::set_offsets_preset_ex
and its builder methods. See the book for detailed usage instructions.
pub fn set_offsets_preset_ex<'a>( &'a mut self, preset: LayoutPreset, ) -> ExSetOffsetsPreset<'a>
pub fn set_anchors_and_offsets_preset(&mut self, preset: LayoutPreset)
pub fn set_anchors_and_offsets_preset(&mut self, preset: LayoutPreset)
To set the default parameters, use Self::set_anchors_and_offsets_preset_ex
and its builder methods. See the book for detailed usage instructions.
pub fn set_anchors_and_offsets_preset_ex<'a>( &'a mut self, preset: LayoutPreset, ) -> ExSetAnchorsAndOffsetsPreset<'a>
pub fn set_anchor(&mut self, side: Side, anchor: f32)
pub fn set_anchor(&mut self, side: Side, anchor: f32)
To set the default parameters, use Self::set_anchor_ex
and its builder methods. See the book for detailed usage instructions.
pub fn set_anchor_ex<'a>( &'a mut self, side: Side, anchor: f32, ) -> ExSetAnchor<'a>
pub fn get_anchor(&self, side: Side) -> f32
pub fn set_offset(&mut self, side: Side, offset: f32)
pub fn get_offset(&self, offset: Side) -> f32
pub fn set_anchor_and_offset(&mut self, side: Side, anchor: f32, offset: f32)
pub fn set_anchor_and_offset(&mut self, side: Side, anchor: f32, offset: f32)
To set the default parameters, use Self::set_anchor_and_offset_ex
and its builder methods. See the book for detailed usage instructions.
pub fn set_anchor_and_offset_ex<'a>( &'a mut self, side: Side, anchor: f32, offset: f32, ) -> ExSetAnchorAndOffset<'a>
pub fn set_begin(&mut self, position: Vector2)
pub fn set_end(&mut self, position: Vector2)
pub fn set_position(&mut self, position: Vector2)
pub fn set_position(&mut self, position: Vector2)
To set the default parameters, use Self::set_position_ex
and its builder methods. See the book for detailed usage instructions.
pub fn set_position_ex<'a>(&'a mut self, position: Vector2) -> ExSetPosition<'a>
pub fn set_size(&mut self, size: Vector2)
pub fn set_size(&mut self, size: Vector2)
To set the default parameters, use Self::set_size_ex
and its builder methods. See the book for detailed usage instructions.
pub fn set_size_ex<'a>(&'a mut self, size: Vector2) -> ExSetSize<'a>
pub fn reset_size(&mut self)
pub fn set_custom_minimum_size(&mut self, size: Vector2)
pub fn set_global_position(&mut self, position: Vector2)
pub fn set_global_position(&mut self, position: Vector2)
To set the default parameters, use Self::set_global_position_ex
and its builder methods. See the book for detailed usage instructions.
pub fn set_global_position_ex<'a>( &'a mut self, position: Vector2, ) -> ExSetGlobalPosition<'a>
pub fn set_rotation(&mut self, radians: f32)
pub fn set_rotation_degrees(&mut self, degrees: f32)
pub fn set_scale(&mut self, scale: Vector2)
pub fn set_pivot_offset(&mut self, pivot_offset: Vector2)
pub fn get_begin(&self) -> Vector2
pub fn get_end(&self) -> Vector2
pub fn get_position(&self) -> Vector2
pub fn get_size(&self) -> Vector2
pub fn get_rotation(&self) -> f32
pub fn get_rotation_degrees(&self) -> f32
pub fn get_scale(&self) -> Vector2
pub fn get_pivot_offset(&self) -> Vector2
pub fn get_custom_minimum_size(&self) -> Vector2
pub fn get_parent_area_size(&self) -> Vector2
pub fn get_global_position(&self) -> Vector2
pub fn get_screen_position(&self) -> Vector2
pub fn get_rect(&self) -> Rect2
pub fn get_global_rect(&self) -> Rect2
pub fn set_focus_mode(&mut self, mode: FocusMode)
pub fn get_focus_mode(&self) -> FocusMode
pub fn has_focus(&self) -> bool
pub fn grab_focus(&mut self)
pub fn release_focus(&mut self)
pub fn find_prev_valid_focus(&self) -> Option<Gd<Control>>
pub fn find_next_valid_focus(&self) -> Option<Gd<Control>>
pub fn find_valid_focus_neighbor(&self, side: Side) -> Option<Gd<Control>>
pub fn set_h_size_flags(&mut self, flags: SizeFlags)
pub fn get_h_size_flags(&self) -> SizeFlags
pub fn set_stretch_ratio(&mut self, ratio: f32)
pub fn get_stretch_ratio(&self) -> f32
pub fn set_v_size_flags(&mut self, flags: SizeFlags)
pub fn get_v_size_flags(&self) -> SizeFlags
pub fn set_theme(&mut self, theme: impl AsObjectArg<Theme>)
pub fn get_theme(&self) -> Option<Gd<Theme>>
pub fn set_theme_type_variation(&mut self, theme_type: impl AsArg<StringName>)
pub fn get_theme_type_variation(&self) -> StringName
pub fn begin_bulk_theme_override(&mut self)
pub fn end_bulk_theme_override(&mut self)
pub fn add_theme_icon_override( &mut self, name: impl AsArg<StringName>, texture: impl AsObjectArg<Texture2D>, )
pub fn add_theme_stylebox_override( &mut self, name: impl AsArg<StringName>, stylebox: impl AsObjectArg<StyleBox>, )
pub fn add_theme_font_override( &mut self, name: impl AsArg<StringName>, font: impl AsObjectArg<Font>, )
pub fn add_theme_font_size_override( &mut self, name: impl AsArg<StringName>, font_size: i32, )
pub fn add_theme_color_override( &mut self, name: impl AsArg<StringName>, color: Color, )
pub fn add_theme_constant_override( &mut self, name: impl AsArg<StringName>, constant: i32, )
pub fn remove_theme_icon_override(&mut self, name: impl AsArg<StringName>)
pub fn remove_theme_stylebox_override(&mut self, name: impl AsArg<StringName>)
pub fn remove_theme_font_override(&mut self, name: impl AsArg<StringName>)
pub fn remove_theme_font_size_override(&mut self, name: impl AsArg<StringName>)
pub fn remove_theme_color_override(&mut self, name: impl AsArg<StringName>)
pub fn remove_theme_constant_override(&mut self, name: impl AsArg<StringName>)
pub fn get_theme_icon(
&self,
name: impl AsArg<StringName>,
) -> Option<Gd<Texture2D>>
pub fn get_theme_icon( &self, name: impl AsArg<StringName>, ) -> Option<Gd<Texture2D>>
To set the default parameters, use Self::get_theme_icon_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_theme_icon_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExGetThemeIcon<'a>
pub fn get_theme_stylebox(
&self,
name: impl AsArg<StringName>,
) -> Option<Gd<StyleBox>>
pub fn get_theme_stylebox( &self, name: impl AsArg<StringName>, ) -> Option<Gd<StyleBox>>
To set the default parameters, use Self::get_theme_stylebox_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_theme_stylebox_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExGetThemeStylebox<'a>
pub fn get_theme_font(&self, name: impl AsArg<StringName>) -> Option<Gd<Font>>
pub fn get_theme_font(&self, name: impl AsArg<StringName>) -> Option<Gd<Font>>
To set the default parameters, use Self::get_theme_font_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_theme_font_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExGetThemeFont<'a>
pub fn get_theme_font_size(&self, name: impl AsArg<StringName>) -> i32
pub fn get_theme_font_size(&self, name: impl AsArg<StringName>) -> i32
To set the default parameters, use Self::get_theme_font_size_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_theme_font_size_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExGetThemeFontSize<'a>
pub fn get_theme_color(&self, name: impl AsArg<StringName>) -> Color
pub fn get_theme_color(&self, name: impl AsArg<StringName>) -> Color
To set the default parameters, use Self::get_theme_color_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_theme_color_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExGetThemeColor<'a>
pub fn get_theme_constant(&self, name: impl AsArg<StringName>) -> i32
pub fn get_theme_constant(&self, name: impl AsArg<StringName>) -> i32
To set the default parameters, use Self::get_theme_constant_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_theme_constant_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExGetThemeConstant<'a>
pub fn has_theme_icon_override(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_stylebox_override(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_font_override(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_font_size_override(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_color_override(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_constant_override(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_icon(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_icon(&self, name: impl AsArg<StringName>) -> bool
To set the default parameters, use Self::has_theme_icon_ex
and its builder methods. See the book for detailed usage instructions.
pub fn has_theme_icon_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExHasThemeIcon<'a>
pub fn has_theme_stylebox(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_stylebox(&self, name: impl AsArg<StringName>) -> bool
To set the default parameters, use Self::has_theme_stylebox_ex
and its builder methods. See the book for detailed usage instructions.
pub fn has_theme_stylebox_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExHasThemeStylebox<'a>
pub fn has_theme_font(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_font(&self, name: impl AsArg<StringName>) -> bool
To set the default parameters, use Self::has_theme_font_ex
and its builder methods. See the book for detailed usage instructions.
pub fn has_theme_font_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExHasThemeFont<'a>
pub fn has_theme_font_size(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_font_size(&self, name: impl AsArg<StringName>) -> bool
To set the default parameters, use Self::has_theme_font_size_ex
and its builder methods. See the book for detailed usage instructions.
pub fn has_theme_font_size_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExHasThemeFontSize<'a>
pub fn has_theme_color(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_color(&self, name: impl AsArg<StringName>) -> bool
To set the default parameters, use Self::has_theme_color_ex
and its builder methods. See the book for detailed usage instructions.
pub fn has_theme_color_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExHasThemeColor<'a>
pub fn has_theme_constant(&self, name: impl AsArg<StringName>) -> bool
pub fn has_theme_constant(&self, name: impl AsArg<StringName>) -> bool
To set the default parameters, use Self::has_theme_constant_ex
and its builder methods. See the book for detailed usage instructions.
pub fn has_theme_constant_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExHasThemeConstant<'a>
pub fn get_theme_default_base_scale(&self) -> f32
pub fn get_theme_default_font(&self) -> Option<Gd<Font>>
pub fn get_theme_default_font_size(&self) -> i32
pub fn get_parent_control(&self) -> Option<Gd<Control>>
pub fn set_h_grow_direction(&mut self, direction: GrowDirection)
pub fn get_h_grow_direction(&self) -> GrowDirection
pub fn set_v_grow_direction(&mut self, direction: GrowDirection)
pub fn get_v_grow_direction(&self) -> GrowDirection
pub fn set_tooltip_text(&mut self, hint: impl AsArg<GString>)
pub fn get_tooltip_text(&self) -> GString
pub fn get_tooltip(&self) -> GString
pub fn get_tooltip(&self) -> GString
To set the default parameters, use Self::get_tooltip_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_tooltip_ex<'a>(&'a self) -> ExGetTooltip<'a>
pub fn set_default_cursor_shape(&mut self, shape: CursorShape)
pub fn get_default_cursor_shape(&self) -> CursorShape
pub fn get_cursor_shape(&self) -> CursorShape
pub fn get_cursor_shape(&self) -> CursorShape
To set the default parameters, use Self::get_cursor_shape_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_cursor_shape_ex<'a>(&'a self) -> ExGetCursorShape<'a>
pub fn set_focus_neighbor(&mut self, side: Side, neighbor: impl AsArg<NodePath>)
pub fn get_focus_neighbor(&self, side: Side) -> NodePath
pub fn set_focus_next(&mut self, next: impl AsArg<NodePath>)
pub fn get_focus_next(&self) -> NodePath
pub fn set_focus_previous(&mut self, previous: impl AsArg<NodePath>)
pub fn get_focus_previous(&self) -> NodePath
pub fn force_drag(&mut self, data: &Variant, preview: impl AsObjectArg<Control>)
pub fn set_mouse_filter(&mut self, filter: MouseFilter)
pub fn get_mouse_filter(&self) -> MouseFilter
pub fn set_force_pass_scroll_events(&mut self, force_pass_scroll_events: bool)
pub fn is_force_pass_scroll_events(&self) -> bool
pub fn set_clip_contents(&mut self, enable: bool)
pub fn is_clipping_contents(&mut self) -> bool
pub fn grab_click_focus(&mut self)
pub fn set_drag_forwarding( &mut self, drag_func: &Callable, can_drop_func: &Callable, drop_func: &Callable, )
pub fn set_drag_preview(&mut self, control: impl AsObjectArg<Control>)
pub fn is_drag_successful(&self) -> bool
pub fn warp_mouse(&mut self, position: Vector2)
pub fn set_shortcut_context(&mut self, node: impl AsObjectArg<Node>)
pub fn get_shortcut_context(&self) -> Option<Gd<Node>>
pub fn update_minimum_size(&mut self)
pub fn set_layout_direction(&mut self, direction: LayoutDirection)
pub fn get_layout_direction(&self) -> LayoutDirection
pub fn is_layout_rtl(&self) -> bool
pub fn set_auto_translate(&mut self, enable: bool)
pub fn is_auto_translating(&self) -> bool
pub fn set_localize_numeral_system(&mut self, enable: bool)
pub fn is_localizing_numeral_system(&self) -> bool
pub fn notify(&mut self, what: ControlNotification)
pub fn notify(&mut self, what: ControlNotification)
⚠️ Sends a Godot notification to all classes inherited by the object.
Triggers calls to on_notification()
, and depending on the notification, also to Godot’s lifecycle callbacks such as ready()
.
Starts from the highest ancestor (the Object
class) and goes down the hierarchy.
See also Godot docs for Object::notification()
.
§Panics
If you call this method on a user-defined object while holding a GdRef
or GdMut
guard on the instance, you will encounter
a panic. The reason is that the receiving virtual method on_notification()
acquires a GdMut
lock dynamically, which must
be exclusive.
pub fn notify_reversed(&mut self, what: ControlNotification)
pub fn notify_reversed(&mut self, what: ControlNotification)
⚠️ Like Self::notify()
, but starts at the most-derived class and goes up the hierarchy.
See docs of that method, including the panics.
Methods from Deref<Target = CanvasItem>§
pub fn get_canvas_item(&self) -> Rid
pub fn set_visible(&mut self, visible: bool)
pub fn is_visible(&self) -> bool
pub fn is_visible_in_tree(&self) -> bool
pub fn show(&mut self)
pub fn hide(&mut self)
pub fn queue_redraw(&mut self)
pub fn move_to_front(&mut self)
pub fn set_as_top_level(&mut self, enable: bool)
pub fn is_set_as_top_level(&self) -> bool
pub fn set_light_mask(&mut self, light_mask: i32)
pub fn get_light_mask(&self) -> i32
pub fn set_modulate(&mut self, modulate: Color)
pub fn get_modulate(&self) -> Color
pub fn set_self_modulate(&mut self, self_modulate: Color)
pub fn get_self_modulate(&self) -> Color
pub fn set_z_index(&mut self, z_index: i32)
pub fn get_z_index(&self) -> i32
pub fn set_z_as_relative(&mut self, enable: bool)
pub fn is_z_relative(&self) -> bool
pub fn set_y_sort_enabled(&mut self, enabled: bool)
pub fn is_y_sort_enabled(&self) -> bool
pub fn set_draw_behind_parent(&mut self, enable: bool)
pub fn is_draw_behind_parent_enabled(&self) -> bool
pub fn draw_line(&mut self, from: Vector2, to: Vector2, color: Color)
pub fn draw_line(&mut self, from: Vector2, to: Vector2, color: Color)
To set the default parameters, use Self::draw_line_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_line_ex<'a>( &'a mut self, from: Vector2, to: Vector2, color: Color, ) -> ExDrawLine<'a>
pub fn draw_dashed_line(&mut self, from: Vector2, to: Vector2, color: Color)
pub fn draw_dashed_line(&mut self, from: Vector2, to: Vector2, color: Color)
To set the default parameters, use Self::draw_dashed_line_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_dashed_line_ex<'a>( &'a mut self, from: Vector2, to: Vector2, color: Color, ) -> ExDrawDashedLine<'a>
pub fn draw_polyline(&mut self, points: &PackedVector2Array, color: Color)
pub fn draw_polyline(&mut self, points: &PackedVector2Array, color: Color)
To set the default parameters, use Self::draw_polyline_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_polyline_ex<'a>( &'a mut self, points: &'a PackedVector2Array, color: Color, ) -> ExDrawPolyline<'a>
pub fn draw_polyline_colors(
&mut self,
points: &PackedVector2Array,
colors: &PackedColorArray,
)
pub fn draw_polyline_colors( &mut self, points: &PackedVector2Array, colors: &PackedColorArray, )
To set the default parameters, use Self::draw_polyline_colors_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_polyline_colors_ex<'a>( &'a mut self, points: &'a PackedVector2Array, colors: &'a PackedColorArray, ) -> ExDrawPolylineColors<'a>
pub fn draw_arc(
&mut self,
center: Vector2,
radius: f32,
start_angle: f32,
end_angle: f32,
point_count: i32,
color: Color,
)
pub fn draw_arc( &mut self, center: Vector2, radius: f32, start_angle: f32, end_angle: f32, point_count: i32, color: Color, )
To set the default parameters, use Self::draw_arc_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_arc_ex<'a>( &'a mut self, center: Vector2, radius: f32, start_angle: f32, end_angle: f32, point_count: i32, color: Color, ) -> ExDrawArc<'a>
pub fn draw_multiline(&mut self, points: &PackedVector2Array, color: Color)
pub fn draw_multiline(&mut self, points: &PackedVector2Array, color: Color)
To set the default parameters, use Self::draw_multiline_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_multiline_ex<'a>( &'a mut self, points: &'a PackedVector2Array, color: Color, ) -> ExDrawMultiline<'a>
pub fn draw_multiline_colors(
&mut self,
points: &PackedVector2Array,
colors: &PackedColorArray,
)
pub fn draw_multiline_colors( &mut self, points: &PackedVector2Array, colors: &PackedColorArray, )
To set the default parameters, use Self::draw_multiline_colors_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_multiline_colors_ex<'a>( &'a mut self, points: &'a PackedVector2Array, colors: &'a PackedColorArray, ) -> ExDrawMultilineColors<'a>
pub fn draw_rect(&mut self, rect: Rect2, color: Color)
pub fn draw_rect(&mut self, rect: Rect2, color: Color)
To set the default parameters, use Self::draw_rect_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_rect_ex<'a>( &'a mut self, rect: Rect2, color: Color, ) -> ExDrawRect<'a>
pub fn draw_circle(&mut self, position: Vector2, radius: f32, color: Color)
pub fn draw_circle(&mut self, position: Vector2, radius: f32, color: Color)
To set the default parameters, use Self::draw_circle_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_circle_ex<'a>( &'a mut self, position: Vector2, radius: f32, color: Color, ) -> ExDrawCircle<'a>
pub fn draw_texture(
&mut self,
texture: impl AsObjectArg<Texture2D>,
position: Vector2,
)
pub fn draw_texture( &mut self, texture: impl AsObjectArg<Texture2D>, position: Vector2, )
To set the default parameters, use Self::draw_texture_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_texture_ex<'a>( &'a mut self, texture: impl AsObjectArg<Texture2D>, position: Vector2, ) -> ExDrawTexture<'a>
pub fn draw_texture_rect(
&mut self,
texture: impl AsObjectArg<Texture2D>,
rect: Rect2,
tile: bool,
)
pub fn draw_texture_rect( &mut self, texture: impl AsObjectArg<Texture2D>, rect: Rect2, tile: bool, )
To set the default parameters, use Self::draw_texture_rect_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_texture_rect_ex<'a>( &'a mut self, texture: impl AsObjectArg<Texture2D>, rect: Rect2, tile: bool, ) -> ExDrawTextureRect<'a>
pub fn draw_texture_rect_region(
&mut self,
texture: impl AsObjectArg<Texture2D>,
rect: Rect2,
src_rect: Rect2,
)
pub fn draw_texture_rect_region( &mut self, texture: impl AsObjectArg<Texture2D>, rect: Rect2, src_rect: Rect2, )
To set the default parameters, use Self::draw_texture_rect_region_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_texture_rect_region_ex<'a>( &'a mut self, texture: impl AsObjectArg<Texture2D>, rect: Rect2, src_rect: Rect2, ) -> ExDrawTextureRectRegion<'a>
pub fn draw_msdf_texture_rect_region(
&mut self,
texture: impl AsObjectArg<Texture2D>,
rect: Rect2,
src_rect: Rect2,
)
pub fn draw_msdf_texture_rect_region( &mut self, texture: impl AsObjectArg<Texture2D>, rect: Rect2, src_rect: Rect2, )
To set the default parameters, use Self::draw_msdf_texture_rect_region_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_msdf_texture_rect_region_ex<'a>( &'a mut self, texture: impl AsObjectArg<Texture2D>, rect: Rect2, src_rect: Rect2, ) -> ExDrawMsdfTextureRectRegion<'a>
pub fn draw_lcd_texture_rect_region(
&mut self,
texture: impl AsObjectArg<Texture2D>,
rect: Rect2,
src_rect: Rect2,
)
pub fn draw_lcd_texture_rect_region( &mut self, texture: impl AsObjectArg<Texture2D>, rect: Rect2, src_rect: Rect2, )
To set the default parameters, use Self::draw_lcd_texture_rect_region_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_lcd_texture_rect_region_ex<'a>( &'a mut self, texture: impl AsObjectArg<Texture2D>, rect: Rect2, src_rect: Rect2, ) -> ExDrawLcdTextureRectRegion<'a>
pub fn draw_style_box( &mut self, style_box: impl AsObjectArg<StyleBox>, rect: Rect2, )
pub fn draw_primitive(
&mut self,
points: &PackedVector2Array,
colors: &PackedColorArray,
uvs: &PackedVector2Array,
)
pub fn draw_primitive( &mut self, points: &PackedVector2Array, colors: &PackedColorArray, uvs: &PackedVector2Array, )
To set the default parameters, use Self::draw_primitive_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_primitive_ex<'a>( &'a mut self, points: &'a PackedVector2Array, colors: &'a PackedColorArray, uvs: &'a PackedVector2Array, ) -> ExDrawPrimitive<'a>
pub fn draw_polygon(
&mut self,
points: &PackedVector2Array,
colors: &PackedColorArray,
)
pub fn draw_polygon( &mut self, points: &PackedVector2Array, colors: &PackedColorArray, )
To set the default parameters, use Self::draw_polygon_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_polygon_ex<'a>( &'a mut self, points: &'a PackedVector2Array, colors: &'a PackedColorArray, ) -> ExDrawPolygon<'a>
pub fn draw_colored_polygon(
&mut self,
points: &PackedVector2Array,
color: Color,
)
pub fn draw_colored_polygon( &mut self, points: &PackedVector2Array, color: Color, )
To set the default parameters, use Self::draw_colored_polygon_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_colored_polygon_ex<'a>( &'a mut self, points: &'a PackedVector2Array, color: Color, ) -> ExDrawColoredPolygon<'a>
pub fn draw_string(
&self,
font: impl AsObjectArg<Font>,
pos: Vector2,
text: impl AsArg<GString>,
)
pub fn draw_string( &self, font: impl AsObjectArg<Font>, pos: Vector2, text: impl AsArg<GString>, )
To set the default parameters, use Self::draw_string_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_string_ex<'a>( &'a self, font: impl AsObjectArg<Font>, pos: Vector2, text: impl AsArg<GString> + 'a, ) -> ExDrawString<'a>
pub fn draw_multiline_string(
&self,
font: impl AsObjectArg<Font>,
pos: Vector2,
text: impl AsArg<GString>,
)
pub fn draw_multiline_string( &self, font: impl AsObjectArg<Font>, pos: Vector2, text: impl AsArg<GString>, )
To set the default parameters, use Self::draw_multiline_string_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_multiline_string_ex<'a>( &'a self, font: impl AsObjectArg<Font>, pos: Vector2, text: impl AsArg<GString> + 'a, ) -> ExDrawMultilineString<'a>
pub fn draw_string_outline(
&self,
font: impl AsObjectArg<Font>,
pos: Vector2,
text: impl AsArg<GString>,
)
pub fn draw_string_outline( &self, font: impl AsObjectArg<Font>, pos: Vector2, text: impl AsArg<GString>, )
To set the default parameters, use Self::draw_string_outline_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_string_outline_ex<'a>( &'a self, font: impl AsObjectArg<Font>, pos: Vector2, text: impl AsArg<GString> + 'a, ) -> ExDrawStringOutline<'a>
pub fn draw_multiline_string_outline(
&self,
font: impl AsObjectArg<Font>,
pos: Vector2,
text: impl AsArg<GString>,
)
pub fn draw_multiline_string_outline( &self, font: impl AsObjectArg<Font>, pos: Vector2, text: impl AsArg<GString>, )
To set the default parameters, use Self::draw_multiline_string_outline_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_multiline_string_outline_ex<'a>( &'a self, font: impl AsObjectArg<Font>, pos: Vector2, text: impl AsArg<GString> + 'a, ) -> ExDrawMultilineStringOutline<'a>
pub fn draw_char(
&self,
font: impl AsObjectArg<Font>,
pos: Vector2,
char: impl AsArg<GString>,
)
pub fn draw_char( &self, font: impl AsObjectArg<Font>, pos: Vector2, char: impl AsArg<GString>, )
To set the default parameters, use Self::draw_char_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_char_ex<'a>( &'a self, font: impl AsObjectArg<Font>, pos: Vector2, char: impl AsArg<GString> + 'a, ) -> ExDrawChar<'a>
pub fn draw_char_outline(
&self,
font: impl AsObjectArg<Font>,
pos: Vector2,
char: impl AsArg<GString>,
)
pub fn draw_char_outline( &self, font: impl AsObjectArg<Font>, pos: Vector2, char: impl AsArg<GString>, )
To set the default parameters, use Self::draw_char_outline_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_char_outline_ex<'a>( &'a self, font: impl AsObjectArg<Font>, pos: Vector2, char: impl AsArg<GString> + 'a, ) -> ExDrawCharOutline<'a>
pub fn draw_mesh(
&mut self,
mesh: impl AsObjectArg<Mesh>,
texture: impl AsObjectArg<Texture2D>,
)
pub fn draw_mesh( &mut self, mesh: impl AsObjectArg<Mesh>, texture: impl AsObjectArg<Texture2D>, )
To set the default parameters, use Self::draw_mesh_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_mesh_ex<'a>( &'a mut self, mesh: impl AsObjectArg<Mesh>, texture: impl AsObjectArg<Texture2D>, ) -> ExDrawMesh<'a>
pub fn draw_multimesh( &mut self, multimesh: impl AsObjectArg<MultiMesh>, texture: impl AsObjectArg<Texture2D>, )
pub fn draw_set_transform(&mut self, position: Vector2)
pub fn draw_set_transform(&mut self, position: Vector2)
To set the default parameters, use Self::draw_set_transform_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_set_transform_ex<'a>( &'a mut self, position: Vector2, ) -> ExDrawSetTransform<'a>
pub fn draw_set_transform_matrix(&mut self, xform: Transform2D)
pub fn draw_animation_slice(
&mut self,
animation_length: f64,
slice_begin: f64,
slice_end: f64,
)
pub fn draw_animation_slice( &mut self, animation_length: f64, slice_begin: f64, slice_end: f64, )
To set the default parameters, use Self::draw_animation_slice_ex
and its builder methods. See the book for detailed usage instructions.
pub fn draw_animation_slice_ex<'a>( &'a mut self, animation_length: f64, slice_begin: f64, slice_end: f64, ) -> ExDrawAnimationSlice<'a>
pub fn draw_end_animation(&mut self)
pub fn get_transform(&self) -> Transform2D
pub fn get_global_transform(&self) -> Transform2D
pub fn get_global_transform_with_canvas(&self) -> Transform2D
pub fn get_viewport_transform(&self) -> Transform2D
pub fn get_viewport_rect(&self) -> Rect2
pub fn get_canvas_transform(&self) -> Transform2D
pub fn get_screen_transform(&self) -> Transform2D
pub fn get_local_mouse_position(&self) -> Vector2
pub fn get_global_mouse_position(&self) -> Vector2
pub fn get_canvas(&self) -> Rid
pub fn get_canvas_layer_node(&self) -> Option<Gd<CanvasLayer>>
pub fn get_world_2d(&self) -> Option<Gd<World2D>>
pub fn set_material(&mut self, material: impl AsObjectArg<Material>)
pub fn get_material(&self) -> Option<Gd<Material>>
pub fn set_use_parent_material(&mut self, enable: bool)
pub fn get_use_parent_material(&self) -> bool
pub fn set_notify_local_transform(&mut self, enable: bool)
pub fn is_local_transform_notification_enabled(&self) -> bool
pub fn set_notify_transform(&mut self, enable: bool)
pub fn is_transform_notification_enabled(&self) -> bool
pub fn force_update_transform(&mut self)
pub fn make_canvas_position_local(&self, screen_point: Vector2) -> Vector2
pub fn make_input_local( &self, event: impl AsObjectArg<InputEvent>, ) -> Option<Gd<InputEvent>>
pub fn set_visibility_layer(&mut self, layer: u32)
pub fn get_visibility_layer(&self) -> u32
pub fn set_visibility_layer_bit(&mut self, layer: u32, enabled: bool)
pub fn get_visibility_layer_bit(&self, layer: u32) -> bool
pub fn set_texture_filter(&mut self, mode: TextureFilter)
pub fn get_texture_filter(&self) -> TextureFilter
pub fn set_texture_repeat(&mut self, mode: TextureRepeat)
pub fn get_texture_repeat(&self) -> TextureRepeat
pub fn set_clip_children_mode(&mut self, mode: ClipChildrenMode)
pub fn get_clip_children_mode(&self) -> ClipChildrenMode
pub fn notify(&mut self, what: CanvasItemNotification)
pub fn notify(&mut self, what: CanvasItemNotification)
⚠️ Sends a Godot notification to all classes inherited by the object.
Triggers calls to on_notification()
, and depending on the notification, also to Godot’s lifecycle callbacks such as ready()
.
Starts from the highest ancestor (the Object
class) and goes down the hierarchy.
See also Godot docs for Object::notification()
.
§Panics
If you call this method on a user-defined object while holding a GdRef
or GdMut
guard on the instance, you will encounter
a panic. The reason is that the receiving virtual method on_notification()
acquires a GdMut
lock dynamically, which must
be exclusive.
pub fn notify_reversed(&mut self, what: CanvasItemNotification)
pub fn notify_reversed(&mut self, what: CanvasItemNotification)
⚠️ Like Self::notify()
, but starts at the most-derived class and goes up the hierarchy.
See docs of that method, including the panics.
Methods from Deref<Target = Node>§
pub fn get_node_as<T>(&self, path: impl AsArg<NodePath>) -> Gd<T>
pub fn get_node_as<T>(&self, path: impl AsArg<NodePath>) -> Gd<T>
⚠️ Retrieves the node at path path
, panicking if not found or bad type.
§Panics
If the node is not found, or if it does not have type T
or inherited.
pub fn try_get_node_as<T>(&self, path: impl AsArg<NodePath>) -> Option<Gd<T>>
pub fn try_get_node_as<T>(&self, path: impl AsArg<NodePath>) -> Option<Gd<T>>
Retrieves the node at path path
(fallible).
If the node is not found, or if it does not have type T
or inherited,
None
will be returned.
pub fn add_sibling(&mut self, sibling: impl AsObjectArg<Node>)
pub fn add_sibling(&mut self, sibling: impl AsObjectArg<Node>)
To set the default parameters, use Self::add_sibling_ex
and its builder methods. See the book for detailed usage instructions.
pub fn add_sibling_ex<'a>( &'a mut self, sibling: impl AsObjectArg<Node>, ) -> ExAddSibling<'a>
pub fn set_name(&mut self, name: impl AsArg<GString>)
pub fn get_name(&self) -> StringName
pub fn add_child(&mut self, node: impl AsObjectArg<Node>)
pub fn add_child(&mut self, node: impl AsObjectArg<Node>)
To set the default parameters, use Self::add_child_ex
and its builder methods. See the book for detailed usage instructions.
pub fn add_child_ex<'a>( &'a mut self, node: impl AsObjectArg<Node>, ) -> ExAddChild<'a>
pub fn remove_child(&mut self, node: impl AsObjectArg<Node>)
pub fn reparent(&mut self, new_parent: impl AsObjectArg<Node>)
pub fn reparent(&mut self, new_parent: impl AsObjectArg<Node>)
To set the default parameters, use Self::reparent_ex
and its builder methods. See the book for detailed usage instructions.
pub fn reparent_ex<'a>( &'a mut self, new_parent: impl AsObjectArg<Node>, ) -> ExReparent<'a>
pub fn get_child_count(&self) -> i32
pub fn get_child_count(&self) -> i32
To set the default parameters, use Self::get_child_count_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_child_count_ex<'a>(&'a self) -> ExGetChildCount<'a>
pub fn get_children(&self) -> Array<Gd<Node>>
pub fn get_children(&self) -> Array<Gd<Node>>
To set the default parameters, use Self::get_children_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_children_ex<'a>(&'a self) -> ExGetChildren<'a>
pub fn get_child(&self, idx: i32) -> Option<Gd<Node>>
pub fn get_child(&self, idx: i32) -> Option<Gd<Node>>
To set the default parameters, use Self::get_child_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_child_ex<'a>(&'a self, idx: i32) -> ExGetChild<'a>
pub fn has_node(&self, path: impl AsArg<NodePath>) -> bool
pub fn get_node_or_null(&self, path: impl AsArg<NodePath>) -> Option<Gd<Node>>
pub fn get_parent(&self) -> Option<Gd<Node>>
pub fn find_child(&self, pattern: impl AsArg<GString>) -> Option<Gd<Node>>
pub fn find_child(&self, pattern: impl AsArg<GString>) -> Option<Gd<Node>>
To set the default parameters, use Self::find_child_ex
and its builder methods. See the book for detailed usage instructions.
pub fn find_child_ex<'a>( &'a self, pattern: impl AsArg<GString> + 'a, ) -> ExFindChild<'a>
pub fn find_children(&self, pattern: impl AsArg<GString>) -> Array<Gd<Node>>
pub fn find_children(&self, pattern: impl AsArg<GString>) -> Array<Gd<Node>>
To set the default parameters, use Self::find_children_ex
and its builder methods. See the book for detailed usage instructions.
pub fn find_children_ex<'a>( &'a self, pattern: impl AsArg<GString> + 'a, ) -> ExFindChildren<'a>
pub fn find_parent(&self, pattern: impl AsArg<GString>) -> Option<Gd<Node>>
pub fn has_node_and_resource(&self, path: impl AsArg<NodePath>) -> bool
pub fn get_node_and_resource( &mut self, path: impl AsArg<NodePath>, ) -> Array<Variant>
pub fn is_inside_tree(&self) -> bool
pub fn is_part_of_edited_scene(&self) -> bool
pub fn is_ancestor_of(&self, node: impl AsObjectArg<Node>) -> bool
pub fn is_greater_than(&self, node: impl AsObjectArg<Node>) -> bool
pub fn get_path(&self) -> NodePath
pub fn get_path_to(&self, node: impl AsObjectArg<Node>) -> NodePath
pub fn get_path_to(&self, node: impl AsObjectArg<Node>) -> NodePath
To set the default parameters, use Self::get_path_to_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_path_to_ex<'a>( &'a self, node: impl AsObjectArg<Node>, ) -> ExGetPathTo<'a>
pub fn add_to_group(&mut self, group: impl AsArg<StringName>)
pub fn add_to_group(&mut self, group: impl AsArg<StringName>)
To set the default parameters, use Self::add_to_group_ex
and its builder methods. See the book for detailed usage instructions.
pub fn add_to_group_ex<'a>( &'a mut self, group: impl AsArg<StringName> + 'a, ) -> ExAddToGroup<'a>
pub fn remove_from_group(&mut self, group: impl AsArg<StringName>)
pub fn is_in_group(&self, group: impl AsArg<StringName>) -> bool
pub fn move_child(&mut self, child_node: impl AsObjectArg<Node>, to_index: i32)
pub fn get_groups(&self) -> Array<StringName>
pub fn set_owner(&mut self, owner: impl AsObjectArg<Node>)
pub fn get_owner(&self) -> Option<Gd<Node>>
pub fn get_index(&self) -> i32
pub fn get_index(&self) -> i32
To set the default parameters, use Self::get_index_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_index_ex<'a>(&'a self) -> ExGetIndex<'a>
pub fn print_tree(&mut self)
pub fn print_tree_pretty(&mut self)
pub fn get_tree_string(&mut self) -> GString
pub fn get_tree_string_pretty(&mut self) -> GString
pub fn set_scene_file_path(&mut self, scene_file_path: impl AsArg<GString>)
pub fn get_scene_file_path(&self) -> GString
pub fn propagate_notification(&mut self, what: i32)
pub fn propagate_call(&mut self, method: impl AsArg<StringName>)
pub fn propagate_call(&mut self, method: impl AsArg<StringName>)
To set the default parameters, use Self::propagate_call_ex
and its builder methods. See the book for detailed usage instructions.
pub fn propagate_call_ex<'a>( &'a mut self, method: impl AsArg<StringName> + 'a, ) -> ExPropagateCall<'a>
pub fn set_physics_process(&mut self, enable: bool)
pub fn get_physics_process_delta_time(&self) -> f64
pub fn is_physics_processing(&self) -> bool
pub fn get_process_delta_time(&self) -> f64
pub fn set_process(&mut self, enable: bool)
pub fn set_process_priority(&mut self, priority: i32)
pub fn get_process_priority(&self) -> i32
pub fn set_physics_process_priority(&mut self, priority: i32)
pub fn get_physics_process_priority(&self) -> i32
pub fn is_processing(&self) -> bool
pub fn set_process_input(&mut self, enable: bool)
pub fn is_processing_input(&self) -> bool
pub fn set_process_shortcut_input(&mut self, enable: bool)
pub fn is_processing_shortcut_input(&self) -> bool
pub fn set_process_unhandled_input(&mut self, enable: bool)
pub fn is_processing_unhandled_input(&self) -> bool
pub fn set_process_unhandled_key_input(&mut self, enable: bool)
pub fn is_processing_unhandled_key_input(&self) -> bool
pub fn set_process_mode(&mut self, mode: ProcessMode)
pub fn get_process_mode(&self) -> ProcessMode
pub fn can_process(&self) -> bool
pub fn set_process_thread_group(&mut self, mode: ProcessThreadGroup)
pub fn get_process_thread_group(&self) -> ProcessThreadGroup
pub fn set_process_thread_messages(&mut self, flags: ProcessThreadMessages)
pub fn get_process_thread_messages(&self) -> ProcessThreadMessages
pub fn set_process_thread_group_order(&mut self, order: i32)
pub fn get_process_thread_group_order(&self) -> i32
pub fn set_display_folded(&mut self, fold: bool)
pub fn is_displayed_folded(&self) -> bool
pub fn set_process_internal(&mut self, enable: bool)
pub fn is_processing_internal(&self) -> bool
pub fn set_physics_process_internal(&mut self, enable: bool)
pub fn is_physics_processing_internal(&self) -> bool
pub fn set_physics_interpolation_mode(&mut self, mode: PhysicsInterpolationMode)
pub fn get_physics_interpolation_mode(&self) -> PhysicsInterpolationMode
pub fn is_physics_interpolated(&self) -> bool
pub fn is_physics_interpolated_and_enabled(&self) -> bool
pub fn reset_physics_interpolation(&mut self)
pub fn set_auto_translate_mode(&mut self, mode: AutoTranslateMode)
pub fn get_auto_translate_mode(&self) -> AutoTranslateMode
pub fn get_window(&self) -> Option<Gd<Window>>
pub fn get_last_exclusive_window(&self) -> Option<Gd<Window>>
pub fn get_tree(&self) -> Option<Gd<SceneTree>>
pub fn create_tween(&mut self) -> Option<Gd<Tween>>
pub fn duplicate(&self) -> Option<Gd<Node>>
pub fn duplicate(&self) -> Option<Gd<Node>>
To set the default parameters, use Self::duplicate_ex
and its builder methods. See the book for detailed usage instructions.
pub fn duplicate_ex<'a>(&'a self) -> ExDuplicate<'a>
pub fn replace_by(&mut self, node: impl AsObjectArg<Node>)
pub fn replace_by(&mut self, node: impl AsObjectArg<Node>)
To set the default parameters, use Self::replace_by_ex
and its builder methods. See the book for detailed usage instructions.
pub fn replace_by_ex<'a>( &'a mut self, node: impl AsObjectArg<Node>, ) -> ExReplaceBy<'a>
pub fn set_scene_instance_load_placeholder(&mut self, load_placeholder: bool)
pub fn get_scene_instance_load_placeholder(&self) -> bool
pub fn set_editable_instance( &mut self, node: impl AsObjectArg<Node>, is_editable: bool, )
pub fn is_editable_instance(&self, node: impl AsObjectArg<Node>) -> bool
pub fn get_viewport(&self) -> Option<Gd<Viewport>>
pub fn queue_free(&mut self)
pub fn request_ready(&mut self)
pub fn is_node_ready(&self) -> bool
To set the default parameters, use Self::set_multiplayer_authority_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_multiplayer(&self) -> Option<Gd<MultiplayerApi>>
pub fn rpc_config(&mut self, method: impl AsArg<StringName>, config: &Variant)
pub fn set_editor_description( &mut self, editor_description: impl AsArg<GString>, )
pub fn get_editor_description(&self) -> GString
pub fn set_unique_name_in_owner(&mut self, enable: bool)
pub fn is_unique_name_in_owner(&self) -> bool
pub fn atr(&self, message: impl AsArg<GString>) -> GString
pub fn atr(&self, message: impl AsArg<GString>) -> GString
To set the default parameters, use Self::atr_ex
and its builder methods. See the book for detailed usage instructions.
pub fn atr_ex<'a>(&'a self, message: impl AsArg<GString> + 'a) -> ExAtr<'a>
pub fn atr_n(
&self,
message: impl AsArg<GString>,
plural_message: impl AsArg<StringName>,
n: i32,
) -> GString
pub fn atr_n( &self, message: impl AsArg<GString>, plural_message: impl AsArg<StringName>, n: i32, ) -> GString
To set the default parameters, use Self::atr_n_ex
and its builder methods. See the book for detailed usage instructions.
pub fn atr_n_ex<'a>( &'a self, message: impl AsArg<GString> + 'a, plural_message: impl AsArg<StringName> + 'a, n: i32, ) -> ExAtrN<'a>
pub fn rpc(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Error
pub fn rpc( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Error
§Panics
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will panic in such a case.
pub fn try_rpc(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Result<Error, CallError>
pub fn try_rpc( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Result<Error, CallError>
§Return type
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will return Err
in such a case.
pub fn rpc_id(
&mut self,
peer_id: i64,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Error
pub fn rpc_id( &mut self, peer_id: i64, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Error
§Panics
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will panic in such a case.
pub fn try_rpc_id(
&mut self,
peer_id: i64,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Result<Error, CallError>
pub fn try_rpc_id( &mut self, peer_id: i64, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Result<Error, CallError>
§Return type
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will return Err
in such a case.
pub fn update_configuration_warnings(&mut self)
pub fn call_deferred_thread_group(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Variant
pub fn call_deferred_thread_group( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Variant
§Panics
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will panic in such a case.
pub fn try_call_deferred_thread_group(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Result<Variant, CallError>
pub fn try_call_deferred_thread_group( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Result<Variant, CallError>
§Return type
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will return Err
in such a case.
pub fn set_deferred_thread_group( &mut self, property: impl AsArg<StringName>, value: &Variant, )
pub fn notify_deferred_thread_group(&mut self, what: i32)
pub fn call_thread_safe(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Variant
pub fn call_thread_safe( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Variant
§Panics
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will panic in such a case.
pub fn try_call_thread_safe(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Result<Variant, CallError>
pub fn try_call_thread_safe( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Result<Variant, CallError>
§Return type
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will return Err
in such a case.
pub fn set_thread_safe( &mut self, property: impl AsArg<StringName>, value: &Variant, )
pub fn notify_thread_safe(&mut self, what: i32)
pub fn notify(&mut self, what: NodeNotification)
pub fn notify(&mut self, what: NodeNotification)
⚠️ Sends a Godot notification to all classes inherited by the object.
Triggers calls to on_notification()
, and depending on the notification, also to Godot’s lifecycle callbacks such as ready()
.
Starts from the highest ancestor (the Object
class) and goes down the hierarchy.
See also Godot docs for Object::notification()
.
§Panics
If you call this method on a user-defined object while holding a GdRef
or GdMut
guard on the instance, you will encounter
a panic. The reason is that the receiving virtual method on_notification()
acquires a GdMut
lock dynamically, which must
be exclusive.
pub fn notify_reversed(&mut self, what: NodeNotification)
pub fn notify_reversed(&mut self, what: NodeNotification)
⚠️ Like Self::notify()
, but starts at the most-derived class and goes up the hierarchy.
See docs of that method, including the panics.
Methods from Deref<Target = Object>§
pub fn get_class(&self) -> GString
pub fn is_class(&self, class: impl AsArg<GString>) -> bool
pub fn set(&mut self, property: impl AsArg<StringName>, value: &Variant)
pub fn get(&self, property: impl AsArg<StringName>) -> Variant
pub fn set_indexed( &mut self, property_path: impl AsArg<NodePath>, value: &Variant, )
pub fn get_indexed(&self, property_path: impl AsArg<NodePath>) -> Variant
pub fn get_property_list(&self) -> Array<Dictionary>
pub fn get_method_list(&self) -> Array<Dictionary>
pub fn property_can_revert(&self, property: impl AsArg<StringName>) -> bool
pub fn property_get_revert(&self, property: impl AsArg<StringName>) -> Variant
pub fn set_script(&mut self, script: &Variant)
pub fn get_script(&self) -> Variant
pub fn set_meta(&mut self, name: impl AsArg<StringName>, value: &Variant)
pub fn remove_meta(&mut self, name: impl AsArg<StringName>)
pub fn get_meta(&self, name: impl AsArg<StringName>) -> Variant
pub fn get_meta(&self, name: impl AsArg<StringName>) -> Variant
To set the default parameters, use Self::get_meta_ex
and its builder methods. See the book for detailed usage instructions.
pub fn get_meta_ex<'a>( &'a self, name: impl AsArg<StringName> + 'a, ) -> ExGetMeta<'a>
pub fn has_meta(&self, name: impl AsArg<StringName>) -> bool
pub fn get_meta_list(&self) -> Array<StringName>
pub fn add_user_signal(&mut self, signal: impl AsArg<GString>)
pub fn add_user_signal(&mut self, signal: impl AsArg<GString>)
To set the default parameters, use Self::add_user_signal_ex
and its builder methods. See the book for detailed usage instructions.
pub fn add_user_signal_ex<'a>( &'a mut self, signal: impl AsArg<GString> + 'a, ) -> ExAddUserSignal<'a>
pub fn has_user_signal(&self, signal: impl AsArg<StringName>) -> bool
pub fn remove_user_signal(&mut self, signal: impl AsArg<StringName>)
pub fn emit_signal(
&mut self,
signal: impl AsArg<StringName>,
varargs: &[Variant],
) -> Error
pub fn emit_signal( &mut self, signal: impl AsArg<StringName>, varargs: &[Variant], ) -> Error
§Panics
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will panic in such a case.
pub fn try_emit_signal(
&mut self,
signal: impl AsArg<StringName>,
varargs: &[Variant],
) -> Result<Error, CallError>
pub fn try_emit_signal( &mut self, signal: impl AsArg<StringName>, varargs: &[Variant], ) -> Result<Error, CallError>
§Return type
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will return Err
in such a case.
pub fn call(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Variant
pub fn call( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Variant
§Panics
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will panic in such a case.
pub fn try_call(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Result<Variant, CallError>
pub fn try_call( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Result<Variant, CallError>
§Return type
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will return Err
in such a case.
pub fn call_deferred(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Variant
pub fn call_deferred( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Variant
§Panics
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will panic in such a case.
pub fn try_call_deferred(
&mut self,
method: impl AsArg<StringName>,
varargs: &[Variant],
) -> Result<Variant, CallError>
pub fn try_call_deferred( &mut self, method: impl AsArg<StringName>, varargs: &[Variant], ) -> Result<Variant, CallError>
§Return type
This is a varcall method, meaning parameters and return values are passed as Variant
.
It can detect call failures and will return Err
in such a case.
pub fn set_deferred( &mut self, property: impl AsArg<StringName>, value: &Variant, )
pub fn callv( &mut self, method: impl AsArg<StringName>, arg_array: &Array<Variant>, ) -> Variant
pub fn has_method(&self, method: impl AsArg<StringName>) -> bool
pub fn get_method_argument_count(&self, method: impl AsArg<StringName>) -> i32
pub fn has_signal(&self, signal: impl AsArg<StringName>) -> bool
pub fn get_signal_list(&self) -> Array<Dictionary>
pub fn get_signal_connection_list( &self, signal: impl AsArg<StringName>, ) -> Array<Dictionary>
pub fn get_incoming_connections(&self) -> Array<Dictionary>
pub fn connect(
&mut self,
signal: impl AsArg<StringName>,
callable: &Callable,
) -> Error
pub fn connect( &mut self, signal: impl AsArg<StringName>, callable: &Callable, ) -> Error
To set the default parameters, use Self::connect_ex
and its builder methods. See the book for detailed usage instructions.
pub fn connect_ex<'a>( &'a mut self, signal: impl AsArg<StringName> + 'a, callable: &'a Callable, ) -> ExConnect<'a>
pub fn disconnect( &mut self, signal: impl AsArg<StringName>, callable: &Callable, )
pub fn is_connected( &self, signal: impl AsArg<StringName>, callable: &Callable, ) -> bool
pub fn set_block_signals(&mut self, enable: bool)
pub fn is_blocking_signals(&self) -> bool
pub fn notify_property_list_changed(&mut self)
pub fn set_message_translation(&mut self, enable: bool)
pub fn can_translate_messages(&self) -> bool
pub fn tr(&self, message: impl AsArg<StringName>) -> GString
pub fn tr(&self, message: impl AsArg<StringName>) -> GString
To set the default parameters, use Self::tr_ex
and its builder methods. See the book for detailed usage instructions.
pub fn tr_ex<'a>(&'a self, message: impl AsArg<StringName> + 'a) -> ExTr<'a>
pub fn tr_n(
&self,
message: impl AsArg<StringName>,
plural_message: impl AsArg<StringName>,
n: i32,
) -> GString
pub fn tr_n( &self, message: impl AsArg<StringName>, plural_message: impl AsArg<StringName>, n: i32, ) -> GString
To set the default parameters, use Self::tr_n_ex
and its builder methods. See the book for detailed usage instructions.
pub fn tr_n_ex<'a>( &'a self, message: impl AsArg<StringName> + 'a, plural_message: impl AsArg<StringName> + 'a, n: i32, ) -> ExTrN<'a>
pub fn is_queued_for_deletion(&self) -> bool
pub fn cancel_free(&mut self)
pub fn notify(&mut self, what: ObjectNotification)
pub fn notify(&mut self, what: ObjectNotification)
⚠️ Sends a Godot notification to all classes inherited by the object.
Triggers calls to on_notification()
, and depending on the notification, also to Godot’s lifecycle callbacks such as ready()
.
Starts from the highest ancestor (the Object
class) and goes down the hierarchy.
See also Godot docs for Object::notification()
.
§Panics
If you call this method on a user-defined object while holding a GdRef
or GdMut
guard on the instance, you will encounter
a panic. The reason is that the receiving virtual method on_notification()
acquires a GdMut
lock dynamically, which must
be exclusive.
pub fn notify_reversed(&mut self, what: ObjectNotification)
pub fn notify_reversed(&mut self, what: ObjectNotification)
⚠️ Like Self::notify()
, but starts at the most-derived class and goes up the hierarchy.
See docs of that method, including the panics.