Version: 2019.1
语言: 中文

Text

class in UnityEngine.UI

/

继承自：UI.MaskableGraphic


实现接口：ILayoutElement

切换到手册

描述

用于向屏幕绘制字体数据的默认 Graphic。

变量

alignByGeometry使用字形几何形状的范围（而不是字形指标）执行水平对齐。
alignment文本相对其 RectTransform 的定位。
cachedTextGenerator生成可见 Text 时使用的已缓存的 TextGenerator。
cachedTextGeneratorForLayout确定 Layout 时使用的已缓存的 TextGenerator。
flexibleHeight由布局系统调用。
flexibleWidth由布局系统调用。
font文本使用的 Font。
fontSize Font 渲染时应使用的大小。
fontStyle文本使用的 FontStyle。
horizontalOverflow水平溢出模式。
layoutPriority由布局系统调用。
lineSpacing行间距，指定为字体行高的一个因子。值为 1 时将生成标准行间距。
mainTexture来自 Font 的 Texture。
minHeight由布局系统调用。
minWidth由布局系统调用。
pixelsPerUnit（只读）提供有关如何根据屏幕缩放字体的信息。
preferredHeight由布局系统调用。
preferredWidth由布局系统调用。
resizeTextForBestFit是否允许文本自动调整大小。
resizeTextMaxSize允许的最大文本大小。1 = 无限大。
resizeTextMinSize允许的最小文本大小。
supportRichText此 Text 是否支持富文本。
text此 Text 显示的/字符串/值。
verticalOverflow垂直溢出模式。

公共函数

CalculateLayoutInputHorizontal由布局系统调用。
CalculateLayoutInputVertical由布局系统调用。
FontTextureChanged在修改与字体关联的纹理时由 [FontUpdateTracker] 调用。
GetGenerationSettings便捷函数，用于填充文本的生成设置。

受保护的函数

OnDisable请参阅 MonoBehaviour.OnDisable。

静态函数

GetTextAnchorPivot便捷函数，用于确定锚点的向量偏移。

继承的成员

静态变量

defaultGraphicMaterial在未显式指定材质时用于绘制 UI 元素的默认材质。

变量

enabled启用的 Behaviour 可更新，禁用的 Behaviour 不可更新。
isActiveAndEnabled是否已激活并启用 Behaviour？
gameObject此组件附加到的游戏对象。始终将组件附加到游戏对象。
tag此游戏对象的标签。
transform附加到此 GameObject 的 Transform。
canvas对在其中渲染此 Graphic 的 Canvas 的引用。
canvasRenderer此 Graphic 使用的 CanvasRenderer。
color此 Graphic 的基色。
defaultMaterial返回图形的默认材质。
depth图形在层级视图中的绝对深度（由渲染和事件使用）。
mainTexture图形的纹理。（只读）。
material用户设置的 Material。
materialForRendering为进行渲染而发送的材质（只读）。
raycastTarget是否应将此图形视为射线投射目标？
rectTransform此 Graphic 使用的 RectTransform 组件。
maskable此图形是否允许遮罩。
onCullStateChanged在剔除更改时发出的回调。
runInEditMode允许 MonoBehaviour 的特定实例在编辑模式下运行（仅可在 Editor 中使用）。
useGUILayout禁用该属性可跳过 GUI 布局阶段。
hideFlags该对象应该隐藏、随场景一起保存还是由用户修改？
name对象的名称。

公共函数

BroadcastMessage调用此游戏对象或其任何子项中的每个 MonoBehaviour 上名为 methodName 的方法。
CompareTag此游戏对象是否使用 tag 进行了标记？
GetComponent如果游戏对象附加了类型为 type 的组件，则将其返回，否则返回 null。
GetComponentInChildren使用深度首次搜索返回 GameObject 或其任何子项中类型为 type 的组件。
GetComponentInParent返回 GameObject 或其任何父项中类型为 type 的组件。
GetComponents返回 GameObject 中类型为 type 的所有组件。
GetComponentsInChildren返回 GameObject 或其任何子项中类型为 type 的所有组件。
GetComponentsInParent返回 GameObject 或其任何父项中类型为 type 的所有组件。
SendMessage调用此游戏对象中的每个 MonoBehaviour 上名为 methodName 的方法。
SendMessageUpwards调用此游戏对象中的每个 MonoBehaviour 上或此行为的每个父级上名为 methodName 的方法。
CrossFadeAlpha对与此图形关联的 CanvasRenderer 颜色的 Alpha 执行 Tween 操作。
CrossFadeColor对与此 Graphic 关联的 CanvasRenderer 颜色执行 Tween 操作。
GetPixelAdjustedRect返回最接近 Graphic RectTransform 的像素精准矩形。
GraphicUpdateComplete请参阅 ICanvasElement.GraphicUpdateComplete。
LayoutComplete请参阅 ICanvasElement.LayoutComplete。
OnCullingChanged剔除更改时要调用的回调函数。
OnRebuildRequested在需要重新构建 Graphic 时由 Unity 发出的仅限于编辑器的回调。
PixelAdjustPoint调整给定像素以使像素精准。
Raycast当 GraphicRaycaster 射线投射到场景中时，它会执行两个操作。首先它使用 RectTransform 矩形过滤元素。然后它使用此 Raycast 函数确定射线投射命中的元素。
Rebuild按 PreRender 周期重新构建图形几何形状及其材质。
RegisterDirtyLayoutCallback添加监听器，以在图形布局脏化时接收通知。
RegisterDirtyMaterialCallback添加监听器，以在图形材质脏化时接收通知。
RegisterDirtyVerticesCallback添加监听器，以在图形顶点脏化时接收通知。
SetAllDirty将 Graphic 标记为“脏”。
SetLayoutDirty将布局标记为“脏”。
SetMaterialDirty将 Material 标记为“脏”。
SetNativeSize调整图形大小以使其像素精准。
SetVerticesDirty将顶点标记为“脏”。
UnregisterDirtyLayoutCallback删除监听器，在图形布局脏化时不接收通知。
UnregisterDirtyMaterialCallback删除监听器，在图形材质脏化时不接收通知。
UnregisterDirtyVerticesCallback删除监听器，在图形顶点脏化时不接收通知。
Cull请参阅 IClippable.Cull。
GetModifiedMaterial请参阅 IMaterialModifier.GetModifiedMaterial。
RecalculateClipping请参阅：IClippable.RecalculateClipping。
RecalculateMasking请参阅：IMaskable.RecalculateMasking。
SetClipRect请参阅 IClippable.SetClipRect。
CancelInvoke取消该 MonoBehaviour 上的所有 Invoke 调用。
Invoke在 time 秒后调用 methodName 方法。
InvokeRepeating在 time 秒后调用 methodName 方法，然后每 repeatRate 秒调用一次。
IsInvoking是否有任何待处理的 methodName 调用？
StartCoroutine启动一个协同程序。
StopAllCoroutines停止在该行为上运行的所有协同程序。
StopCoroutine停止在该行为上运行的第一个名为 methodName 的协同程序或存储在 routine 中的协同程序。
GetInstanceID返回对象的实例 ID。
ToString返回 GameObject 的名称。
IsActive如果 GameObject 和 Component 处于激活状态，则返回 true。
IsDestroyed如果行为的原生表示已被销毁，则返回 true。

受保护的函数

OnPopulateMeshUI 元素需要生成顶点时的回调函数。
UpdateGeometry用于将 Graphic 的几何形状更新到 CanvasRenderer 的调用。
UpdateMaterial用于将 Graphic 的 Material 更新到 CanvasRenderer 的调用。
Awake请参阅 MonoBehaviour.Awake。
OnBeforeTransformParentChanged请参阅 MonoBehaviour.OnBeforeTransformParentChanged。
OnCanvasGroupChanged请参阅 MonoBehaviour.OnCanvasGroupChanged。
OnCanvasHierarchyChanged在父画布的状态发生更改时调用。
OnDestroy请参阅 MonoBehaviour.OnDestroy。
OnDidApplyAnimationProperties请参阅 LayoutGroup.OnDidApplyAnimationProperties。
OnEnable请参阅 MonoBehaviour.OnEnable。
OnRectTransformDimensionsChange如果关联的 RectTransform 的尺寸发生更改，则系统会调用此回调。
OnTransformParentChanged请参阅 MonoBehaviour.OnRectTransformParentChanged。
OnValidate请参阅 MonoBehaviour.OnValidate。
Reset请参阅 MonoBehaviour.Reset。
Start请参阅 MonoBehaviour.Start。

静态函数

print将消息记录到 Unity 控制台（与 Debug.Log 相同）。
Destroy删除 GameObject、组件或资源。
DestroyImmediate立即销毁对象 /obj/。强烈建议您改用 Destroy。
DontDestroyOnLoad在加载新的 Scene 时，请勿销毁 Object。
FindObjectOfType返回第一个类型为 type 的已加载的激活对象。
FindObjectsOfType返回所有类型为 type 的已加载的激活对象的列表。
Instantiate克隆 original 对象并返回克隆对象。

运算符

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

消息

AwakeAwake 在加载脚本实例时调用。
FixedUpdate用于物理计算且独立于帧率的 MonoBehaviour.FixedUpdate 消息。
LateUpdate如果启用了 Behaviour，则每帧调用 LateUpdate。
OnAnimatorIK用于设置动画 IK（反向运动学）的回调。
OnAnimatorMove用于处理动画移动以修改根运动的回调。
OnApplicationFocus当玩家获得或失去焦点时，发送给所有 GameObject。
OnApplicationPause当应用程序暂停时，发送给所有 GameObject。
OnApplicationQuit在应用程序退出前，发送给所有游戏对象。
OnAudioFilterRead如果实现了 OnAudioFilterRead，Unity 将在音频 DSP 链中插入一个自定义滤波器。
OnBecameInvisibleOnBecameInvisible 在渲染器对任何摄像机都不可见时调用。
OnBecameVisibleOnBecameVisible 在渲染器变为对任意摄像机可见时调用。
OnCollisionEnter当该碰撞体/刚体已开始接触另一个刚体/碰撞体时，调用 OnCollisionEnter。
OnCollisionEnter2D当传入碰撞体与该对象的碰撞体接触时发送（仅限 2D 物理）。
OnCollisionExit当该碰撞体/刚体已停止接触另一个刚体/碰撞体时，调用 OnCollisionExit。
OnCollisionExit2D当另一个对象上的碰撞体停止接触该对象的碰撞体时发送（仅限 2D 物理）。
OnCollisionStay对应正在接触刚体/碰撞体的每一个碰撞体/刚体，每帧调用一次 :ref::OnCollisionStay。
OnCollisionStay2D在另一个对象上的碰撞体正在接触该对象的碰撞体时发送每个帧（仅限 2D 物理）。
OnConnectedToServer成功连接到服务器后在客户端上调用。
OnControllerColliderHit当该控制器在执行 Move 时撞到碰撞体时调用 OnControllerColliderHit。
OnDestroy销毁附加的行为将导致游戏或场景收到 OnDestroy。
OnDisconnectedFromServer当连接丢失或与服务器断开连接时，在客户端上调用。
OnDrawGizmos如果您想绘制能够选择并且始终绘制的辅助图标，则可以实现 OnDrawGizmos。
OnDrawGizmosSelected如果选择了对象，则实现 OnDrawGizmosSelected 来绘制辅助图标。
OnEnable该函数在对象变为启用和激活状态时调用。
OnFailedToConnect出于某种原因连接尝试失败时，在客户端上调用。
OnFailedToConnectToMasterServer在连接到 MasterServer 时发生问题的情况下，在客户端或服务器上调用。
OnGUI系统调用 OnGUI 来渲染和处理 GUI 事件。
OnJointBreak在附加到相同游戏对象的关节断开时调用。
OnJointBreak2D在附加到相同游戏对象的 Joint2D 断开时调用。
OnMasterServerEvent在从 MasterServer 报告事件时，在客户端或服务器上调用。
OnMouseDown当用户在 GUIElement 或 Collider 上按下鼠标按钮时，将调用 OnMouseDown。
OnMouseDrag当用户单击 GUIElement 或 Collider 并仍然按住鼠标时，将调用 OnMouseDrag。
OnMouseEnter当鼠标进入 GUIElement 或 Collider 时调用。
OnMouseExit当鼠标不再处于 GUIElement 或 Collider 上方时调用。
OnMouseOver当鼠标悬停在 GUIElement 或 Collider 上时，每帧调用一次。
OnMouseUp当用户松开鼠标按钮时，将调用 OnMouseUp。
OnMouseUpAsButton松开鼠标时，仅当鼠标在按下时所在的 GUIElement 或 Collider 上时，才调用 OnMouseUpAsButton。
OnNetworkInstantiate在已通过 Network.Instantiate 进行网络实例化的对象上调用。
OnParticleCollision当粒子击中碰撞体时，将调用 OnParticleCollision。
OnParticleSystemStopped系统中的所有粒子都死亡时，便会调用 OnParticleSystemStopped，然后将不再产生新粒子。在调用 Stop 之后，或者超过非循环系统的 Duration 属性时，将停止产生新粒子。
OnParticleTrigger粒子系统中的任何粒子满足触发模块中的条件时，将调用 OnParticleTrigger。
OnPlayerConnected每当有新玩家成功连接，就在服务器上调用。
OnPlayerDisconnected每当有玩家与服务器断开连接，就在服务器上调用。
OnPostRender在摄像机完成场景渲染后，将调用 OnPostRender。
OnPreCull在摄像机剔除场景前，将调用 OnPreCull。
OnPreRender在摄像机开始渲染场景前，将调用 OnPreRender。
OnRenderImageOnRenderImage 在图像的所有渲染操作全部完成后调用。
OnRenderObject在摄像机渲染场景后，将调用 OnRenderObject。
OnSerializeNetworkView用于在网络视图监视的脚本中自定义变量同步。
OnServerInitialized每当调用 Network.InitializeServer 并且完成时，对该服务器调用该函数。
OnTransformChildrenChanged当 GameObject 的变换的子项列表发生更改时，将调用该函数。
OnTransformParentChanged当 GameObject 的变换的父属性发生更改时，将调用该函数。
OnTriggerEnter GameObject 与另一 GameObject 碰撞时，将调用 OnTriggerEnter。
OnTriggerEnter2D当另一个对象进入附加到该对象的触发碰撞体时发送（仅限 2D 物理）。
OnTriggerExit当 Collider other 已停止接触该触发器时调用 OnTriggerExit。
OnTriggerExit2D当另一个对象离开附加到该对象的触发碰撞体时发送（仅限 2D 物理）。
OnTriggerStay对于接触触发器的每一个 Collider /other/，每次物理更新调用一次 OnTriggerStay。
OnTriggerStay2D在另一个对象位于附加到该对象的触发碰撞体之内时发送每个帧（仅限 2D 物理）。
OnValidate加载脚本后或检视面板中的值发生更改时，将调用此函数（只能在编辑器中调用）。
OnWillRenderObject如果对象可见并且不是 UI 元素，则为每个摄像机调用 OnWillRenderObject。
Reset重置为默认值。
Start在首次调用任何 Update 方法之前启用脚本时，在帧上调用 Start。
Update如果启用了 MonoBehaviour，则每帧调用 Update。
Copyright © 2023 Unity Technologies
优美缔软件（上海）有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961