Version: 2023.1

PrefabStage

class in UnityEditor.SceneManagement

/

继承自:SceneManagement.PreviewSceneStage

切换到手册

描述

The PrefabStage class represents an editing context for Prefab Assets.

阶段是包括场景集合的编辑上下文。主要阶段包含所有当前打开的常规场景,而预制件阶段包含仅用于编辑预制件的预览场景。

预制件模式下在 Scene 视图中显示的每个示踪导航都代表一个阶段。带有预制件图标的示踪导航代表预制件阶段。

变量

assetPathThe asset path where the Prefab Asset file is stored, relative to the project root.
modeThe Prefab Stage can be opened either in isolation or in context.
openedFromInstanceObjectA GameObject inside the Prefab instance that you opened Prefab Mode through.
openedFromInstanceRootThe root of the Prefab instance that you opened Prefab Mode through.
prefabContentsRoot已加载的预制件资源内容的根游戏对象。

公共函数

ClearDirtiness清除预制件阶段的脏 (dirtyness) 标志。
IsPartOfPrefabContents此游戏对象是否是预制件阶段中加载的预制件资源内容的一部分?

Events

prefabSaved每当已保存预制件阶段的内容时都会调用的回调。
prefabSaving每当即将保存预制件阶段的内容时都会调用的回调。
prefabStageClosing每当即将打开预制件阶段时都会调用的回调。
prefabStageDirtied每当预制件阶段从未修改变为已修改时调用的回调。
prefabStageOpened每当已打开预制件阶段时都会调用的回调。

继承的成员

变量

hideFlags该对象应该隐藏、随场景一起保存还是由用户修改?
name对象的名称。
sceneThe preview Scene this stage controls. Stage content should be moved into this Scene.
stageHandleSee Stage.stageHandle.
assetPathThe path of the Asset file associated with the stage, relative to the project root folder.
stageHandleThe StageHandle struct for this stage.

公共函数

GetInstanceIDGets the instance ID of the object.
ToString返回对象的名称。
FindComponentOfType返回给定类型的第一个载入激活对象。
FindComponentsOfType返回给定类型的所有载入激活对象的列表。
GetCombinedSceneCullingMaskForCameraGets the Scene culling mask from this Stage.

受保护的函数

OnCloseStageUnity calls this method when the Stage is closed. Classes that inherit from PreviewSceneStage should implement cleanup logic in this method.
OnOpenStageUnity calls this method when the Stage is opened. Classes that inherit from PreviewSceneStage should implement initialization logic in this method.
CreateHeaderContentCreates the header content for this Stage. Both the Hierarchy window header and Scene view breadcrumb bar use this content.
GetHashForStateStorageUnity calls this method to get a hash code that is used to save the state of the Stage to disk.
OnCloseStageUnity calls this method when the Stage is closed. Classes that inherit from Stage should implement cleanup logic in this method.
OnDisable请参阅 ScriptableObject.OnDisable。
OnEnable请参阅 ScriptableObject.OnEnable。
OnFirstTimeOpenStageInSceneViewUnity calls this method the first time a Stage is opened for a specific Asset, for a specific Scene view.
OnOpenStageUnity calls this method when the Stage is opened. Classes that inherit from Stage should implement initialization logic in this method.
OnReturnToStageUnity calls this method when you return to a Stage that is already open.

静态函数

Destroy移除 GameObject、组件或资源。
DestroyImmediate立即销毁对象 /obj/。强烈建议您改用 Destroy。
DontDestroyOnLoad在加载新的 Scene 时,请勿销毁 Object。
FindAnyObjectByTypeRetrieves any active loaded object of Type type.
FindFirstObjectByTypeRetrieves the first active loaded object of Type type.
FindObjectsByTypeRetrieves a list of all loaded objects of Type type.
Instantiate克隆 original 对象并返回克隆对象。
CreateInstance创建脚本化对象的实例。

运算符

bool该对象是否存在?
operator !=比较两个对象是否引用不同的对象。
operator ==比较两个对象引用,判断它们是否引用同一个对象。

消息

Awake当 ScriptableObject 脚本启动时调用此函数。
OnDestroy当脚本化对象将销毁时调用此函数。
OnDisable当脚本化对象超出范围时调用此函数。
OnEnable当对象加载时调用此函数。
OnValidateEditor-only function that Unity calls when the script is loaded or a value changes in the Inspector.
Reset重置为默认值。