Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

EditorResourcePicker

继承: HBoxContainer < BoxContainer < Container < Control < CanvasItem < Node < Object

派生: EditorScriptPicker

Godot 编辑器用于选择 Resource 类型属性的控件。

描述

Control 节点用于编辑器的属性检查器以允许编辑 Resource 类型属性。它提供了创建、加载、保存和转换资源的选项。可以与 EditorInspectorPlugin 检查器插件一起使用以重新创建相同的行为。

注意:这个 Control 不包括资源的任何编辑器,因为编辑是由属性检查器本身或子检查器控制的。

属性

String

base_type

""

bool

editable

true

Resource

edited_resource

bool

toggle_mode

false

方法

bool

_handle_menu_selected ( int id ) virtual

void

_set_create_options ( Object menu_node ) virtual

PackedStringArray

get_allowed_types ( ) const

void

set_toggle_pressed ( bool pressed )


信号

resource_changed ( Resource resource )

当正在编辑的资源改变值时发出。


resource_selected ( Resource resource, bool inspect )

当资源值被设置,并且用户点击它编辑时触发。当 inspecttrue 时,该信号是由上下文菜单“编辑”或“检查”选项引起的。


属性说明

String base_type = ""

  • void set_base_type ( String value )

  • String get_base_type ( )

允许资源类型的基本类型。可以是几个选项的逗号分离列表。


bool editable = true

  • void set_editable ( bool value )

  • bool is_editable ( )

如果为 true,则可以选择和编辑该值。


Resource edited_resource

已编辑的资源值。


bool toggle_mode = false

  • void set_toggle_mode ( bool value )

  • bool is_toggle_mode ( )

如果为 true,带有资源预览的主按钮在切换模式下工作。使用 set_toggle_pressed 来手动设置状态。


方法说明

bool _handle_menu_selected ( int id ) virtual

该虚方法可以被实现,以处理默认未处理的上下文菜单项目。请参阅 _set_create_options


void _set_create_options ( Object menu_node ) virtual

在更新 EditorResourcePicker 的上下文菜单时调用该虚方法。实现该方法以使用你自己的选项覆盖“新建 ...”项目。menu_node 是对 PopupMenu 节点的引用。

注意:实现 _handle_menu_selected 来处理这些自定义项。


PackedStringArray get_allowed_types ( ) const

返回一个与 base_type 对应的所有允许的类型和子类型的列表。如果 base_type 是空,将返回一个空的列表。


void set_toggle_pressed ( bool pressed )

设置主按钮的切换模式状态。只有当 toggle_mode 被设置为 true 时才起作用。