Version: 2023.1

Canvas

class in UnityEngine

/

继承自:Behaviour

切换到手册

描述

可用于屏幕渲染的元素。

画布上的元素在场景渲染之后渲染(从附加的摄像机或使用覆盖模式)。

using System.Collections;
using System.Collections.Generic;
using UnityEditor;
using UnityEngine;
using UnityEngine.UI;

// Create a Canvas that holds a Text GameObject.

public class ExampleClass : MonoBehaviour { void Start() { GameObject myGO; GameObject myText; Canvas myCanvas; Text text; RectTransform rectTransform;

// Canvas myGO = new GameObject(); myGO.name = "TestCanvas"; myGO.AddComponent<Canvas>();

myCanvas = myGO.GetComponent<Canvas>(); myCanvas.renderMode = RenderMode.ScreenSpaceOverlay; myGO.AddComponent<CanvasScaler>(); myGO.AddComponent<GraphicRaycaster>();

// Text myText = new GameObject(); myText.transform.parent = myGO.transform; myText.name = "wibble";

text = myText.AddComponent<Text>(); text.font = (Font)Resources.Load("MyFont"); text.text = "wobble"; text.fontSize = 100;

// Text position rectTransform = text.GetComponent<RectTransform>(); rectTransform.localPosition = new Vector3(0, 0, 0); rectTransform.sizeDelta = new Vector2(400, 200); } }

变量

additionalShaderChannels获取或设置要在创建 Canvas 网格时使用的附加着色器通道的遮罩。
cachedSortingLayerValue基于 SortingLayerID 缓存的计算值。
isRootCanvas这是根 Canvas 吗?
normalizedSortingGridSize画布将可渲染区域拆分成的标准化网格大小。
overridePixelPerfect允许嵌套画布重写从父画布继承的 pixelPerfect 设置。
overrideSorting覆盖画布的排序。
pixelPerfect强制画布中的元素按像素对齐。仅在 renderMode 为屏幕空间时适用。
pixelRect获取 Canvas 的渲染矩形。
planeDistance生成画布的位置到摄像机的距离。
referencePixelsPerUnit被视为默认值的 Pixels Per Unit 数量。
renderingDisplaySizeReturns the canvas display size based on the selected render mode and target display.
renderMode该 Canvas 处于世界模式还是覆盖模式?
renderOrder将画布发射到场景的渲染顺序。(只读)
rootCanvas通过检查每个父项并返回找到的最后一个画布来返回最接近根的 Canvas。如果未找到其他画布,则画布返回自身。
scaleFactor用于缩放整个画布,同时仍使其适合屏幕。仅在 renderMode 为屏幕空间时适用。
sortingLayerID画布排序图层的唯一 ID。
sortingLayerName画布排序图层的名称。
sortingOrder排序图层中的画布顺序。
targetDisplay用于覆盖模式,将显示 UI 画布的显示索引。
updateRectTransformForStandaloneShould the Canvas size be updated based on the render target when a manual Camera.Render call is performed.
vertexColorAlwaysGammaSpaceShould the Canvas vertex color always be in gamma space before passing to the UI shaders in linear color space work flow.
worldCamera Camera used for sizing the Canvas when in Screen Space - Camera. Also used as the Camera that events will be sent through for a World Space Canvas.

静态函数

ForceUpdateCanvases强制所有画布更新其内容。
GetDefaultCanvasMaterial返回可用于在画布上渲染普通元素的默认材质。
GetETC1SupportedCanvasMaterial获取或生成 ETC1 材质。

Events

preWillRenderCanvases在即将开始 Canvas 渲染前调用的事件。
willRenderCanvases在即将开始 Canvas 渲染前调用的事件。

继承的成员

变量

enabled启用的 Behaviour 可更新,禁用的 Behaviour 不可更新。
isActiveAndEnabledReports whether a GameObject and its associated Behaviour is active and enabled.
gameObject此组件附加到的游戏对象。始终将组件附加到游戏对象。
tag此游戏对象的标签。
transform附加到此 GameObject 的 Transform。
hideFlags该对象应该隐藏、随场景一起保存还是由用户修改?
name对象的名称。

公共函数

BroadcastMessage调用此游戏对象或其任何子项中的每个 MonoBehaviour 上名为 methodName 的方法。
CompareTagChecks the GameObject's tag against the defined tag.
GetComponentGets a reference to a component of type T on the same GameObject as the component specified.
GetComponentInChildrenGets a reference to a component of type T on the same GameObject as the component specified, or any child of the GameObject.
GetComponentInParentGets a reference to a component of type T on the same GameObject as the component specified, or any parent of the GameObject.
GetComponentsGets references to all components of type T on the same GameObject as the component specified.
GetComponentsInChildrenGets references to all components of type T on the same GameObject as the component specified, and any child of the GameObject.
GetComponentsInParentGets references to all components of type T on the same GameObject as the component specified, and any parent of the GameObject.
SendMessage调用此游戏对象中的每个 MonoBehaviour 上名为 methodName 的方法。
SendMessageUpwards调用此游戏对象中的每个 MonoBehaviour 上或此行为的每个父级上名为 methodName 的方法。
TryGetComponent获取指定类型的组件(如果存在)。
GetInstanceIDGets the instance ID of the object.
ToString返回对象的名称。

静态函数

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 对象并返回克隆对象。

运算符

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