EditorFeatureProfile¶

可用于禁用特定功能的编辑器功能配置文件。

描述¶

编辑器功能配置文件可用于禁用i3D编辑器的特定功能。禁用时，这些功能不会出现在编辑器中，这使得编辑器不那么混乱。这在教育设置中很有用，可以减少混乱或在团队中工作。例如，艺术家和关卡设计师可以使用禁用脚本编辑器的功能配置文件来避免意外更改他们不应该编辑的文件。

要直观地管理编辑器功能配置文件，请使用编辑器窗口顶部的Editor>Manage Feature Profiles…。

方法¶

String	get_feature_name(feature: Feature)
bool	is_class_disabled(class_name: StringName) const
bool	is_class_editor_disabled(class_name: StringName) const
bool	is_class_property_disabled(class_name: StringName, property: StringName) const
bool	is_feature_disabled(feature: Feature) const
Error	load_from_file(path: String)
Error	save_to_file(path: String)
void	set_disable_class(class_name: StringName, disable: bool)
void	set_disable_class_editor(class_name: StringName, disable: bool)
void	set_disable_class_property(class_name: StringName, property: StringName, disable: bool)
void	set_disable_feature(feature: Feature, disable: bool)

枚举¶

enum Feature: 🔗

Feature FEATURE_3D = 0

3D编辑器。如果禁用此功能，3D编辑器将不会显示，但3D节点仍将显示在创建新节点对话框中。

Feature FEATURE_SCRIPT = 1

脚本选项卡，其中包含脚本编辑器和类参考浏览器。如果禁用此功能，将不会显示脚本选项卡。

Feature FEATURE_ASSET_LIB = 2

AssetLib选项卡。如果禁用此功能，AssetLib选项卡将不会显示。

Feature FEATURE_SCENE_TREE = 3

场景树编辑。如果禁用此功能，场景树停靠仍然可见，但将是只读的。

Feature FEATURE_NODE_DOCK = 4

节点停靠。如果禁用此功能，信号和组将无法从编辑器中可见和修改。

Feature FEATURE_FILESYSTEM_DOCK = 5

FileSystem停靠站。如果禁用此功能，FileSystem停靠站将不可见。

Feature FEATURE_IMPORT_DOCK = 6

导入坞站。如果禁用此功能，导入坞站将不可见。

Feature FEATURE_HISTORY_DOCK = 7

历史停靠站。如果禁用此功能，历史停靠站将不可见。

Feature FEATURE_GAME = 8

应用选项卡，允许嵌入应用窗口并通过单击其中选择节点。如果禁用此功能，则不会显示应用选项卡。

Feature FEATURE_MAX = 9

表示Feature枚举的大小。

方法说明¶

String get_feature_name(feature: Feature) 🔗

返回指定feature的人类可读名称。

bool is_class_disabled(class_name: StringName) const 🔗

如果class_name指定的类被禁用，则返回true。禁用时，该类不会出现在创建新节点对话框中。

bool is_class_editor_disabled(class_name: StringName) const 🔗

如果class_name指定的类的编辑被禁用，则返回true。禁用时，该类仍将出现在创建新节点对话框中，但在选择扩展该类的节点时，检查器将是只读的。

bool is_class_property_disabled(class_name: StringName, property: StringName) const 🔗

如果class_name指定的类中禁用了property，则返回true。禁用属性时，选择扩展class_name指定的类的节点时，它不会出现在检查器中。

bool is_feature_disabled(feature: Feature) const 🔗

如果feature被禁用，则返回true。当一个特性被禁用时，它将从编辑器中完全消失。

Error load_from_file(path: String) 🔗

从文件加载编辑器功能配置文件。该文件必须遵循通过使用功能配置文件管理器的导出按钮或save_to_file()方法获得的JSON格式。

注意：通过用户交互界面创建的功能配置文件从feature_profiles目录加载，作为扩展名为. profile的文件。可以使用EditorPaths.get_config_dir()找到编辑器配置文件夹。

Error save_to_file(path: String) 🔗

将编辑器功能配置文件保存为JSON格式的文件。然后可以使用功能配置文件管理器的导入按钮或load_from_file()方法导入它。

注意：通过用户交互界面创建的功能配置文件保存在feature_profiles目录中，作为扩展名为. profile的文件。可以使用EditorPaths.get_config_dir()找到编辑器配置文件夹。

void set_disable_class(class_name: StringName, disable: bool) 🔗

如果disable为true，则禁用class_name指定的类。禁用时，该类不会出现在创建新节点对话框中。

void set_disable_class_editor(class_name: StringName, disable: bool) 🔗

如果disable为true，则禁用对class_name指定的类的编辑。禁用时，该类仍将出现在创建新节点对话框中，但在选择扩展该类的节点时，检查器将是只读的。

void set_disable_class_property(class_name: StringName, property: StringName, disable: bool) 🔗

如果disable为true，则禁用对class_name指定的类中的property的编辑。禁用属性时，当选择扩展class_name指定的类的节点时，它不会出现在检查器中。

void set_disable_feature(feature: Feature, disable: bool) 🔗

如果disable为true，则禁用feature中指定的编辑器特性。当一个特性被禁用时，它将从编辑器中完全消失。