Skip to content
MaskButton

界面 / MaskButton

MaskButton Class

遮罩按钮

Hierarchy

Table of contents

Accessors

circleCenter(): Vector2 client
获取圆形遮罩的中心旋转点
circleValue(): number client
获取圆形遮罩的遮挡百分值
clickMethod(): ButtonClickMethod client
获取点击模式
clickedDelegate(): MulticastDelegate<() => void> client
点击事件
disableImageColor(): Readonly<LinearColor> client
获取禁用图片颜色
disableImageDrawType(): Readonly<SlateBrushDrawType> client
获取禁用图片绘制类型
disableImageGuid(): string client
获取禁用图片ID
disableImageMargin(): Readonly<Margin> client
获取禁用图片边距
disableImageSize(): Readonly<Vector2> client
获取禁用图片大小
enableTransition(inBoolean: boolean): void client
是否套用不同的按下方案
fanShapedRotated(): number client
获取扇形遮罩的旋转
fanShapedRotatedCenter(): Vector2 client
获取扇形遮罩的中心旋转点
fanShapedValue(): number client
获取扇形遮罩的遮罩进度
focusable(): boolean client
获取是否获取输入焦点
hoveredDelegate(): MulticastDelegate<() => void> client
悬浮事件
inverseOpacity(): boolean client
获取反转透明度权重
isTransitionEnable(): boolean client
按钮是否启用过度模式,按下是否有效果
maskImageColor(): Readonly<LinearColor> client
获取遮罩图片颜色
maskImageGuid(): string client
获取设置遮罩图片ID
maskOpacity(): number client
获取遮挡处的底图的透明度
maskTextureOpacity(): number client
获取遮挡处的遮挡图的透明度
maskType(): MaskButtonType client
获取遮罩裁剪类型
normalImageColor(): Readonly<LinearColor> client
获取普通图片颜色
normalImageDrawType(): Readonly<SlateBrushDrawType> client
获取普通图片绘制类型
normalImageGuid(): string client
获取普通图片ID
normalImageMargin(): Readonly<Margin> client
获取普通图片边距
normalImageSize(): Readonly<Vector2> client
获取图片大小
pressedDelegate(): MulticastDelegate<() => void> client
按下事件
pressedImageColor(): Readonly<LinearColor> client
获取按压图片颜色
pressedImageDrawType(): Readonly<SlateBrushDrawType> client
获取按压图片绘制类型
pressedImageGuid(): string client
获取按下图片ID
pressedImageMargin(): Readonly<Margin> client
获取按压图片边距
pressedImageSize(): Readonly<Vector2> client
获取按压图片大小
pressedMethod(): ButtonPressMethod client
获取按压模式
releasedDelegate(): MulticastDelegate<() => void> client
释放事件
roundBoxPercentOffset(): Vector2 client
获取矩形百分比大小边距偏移
roundBoxRadius(): number
获取设置的角半径
roundBoxSharpness(): number
获取设置的圆角锐化度
roundBoxUVRatio(): number
获取圆角调节大小
touchMethod(): ButtonTouchMethod client
获取触摸模式
unHoveredDelegate(): MulticastDelegate<() => void> client
未悬浮事件
useMaskTextureOpacity(): boolean client
获取遮罩轮廓是否裁剪底图
click

Accessors

autoSizeHorizontalEnable(): boolean client
获取是否自动水平设置大小
autoSizeVerticalEnable(): boolean client
获取是否自动垂直设置大小
cachedGeometry(): Geometry client
获取上一次的GetTickSpaceGeometry
constraints(): Readonly<UIConstraintAnchors> client
获取控件的布局
desiredSize(): Vector2 client
获取期望大小
enable(): boolean client
是否可用
guid(): string client
获取控件GUID
isHovered(): boolean client
是否是hovered
mouseCursor(): MouseCursor client
获取控件上光标类型
name(): string client
获取名字
onFocusChange(): Delegate<(absolutionPosition: Vector2) => boolean> client
焦点改变事件
onFoucsLost(): Delegate<(absolutionPosition: Vector2) => boolean> client
丢失焦点事件
onKeyDownEvent(): Delegate<(absolutionPosition: Vector2, keyEvent: KeyEvent) => boolean> client
按键按下事件
onKeyUpEvent(): Delegate<(absolutionPosition: Vector2, keyEvent: KeyEvent) => boolean> client
按键抬起事件
onMouseButtonDoubleClick(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
鼠标双击事件
onMouseButtonDown(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
鼠标按下事件
onMouseButtonUp(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
鼠标抬起事件
onMouseEnter(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
鼠标进入控件事件
onMouseLeave(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
鼠标离开控件事件
onMouseMove(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
鼠标移动事件
onMouseWheel(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
鼠标滚轮滚动事件
onTouchEnded(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
触摸结束事件
onTouchMoved(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
触摸移动事件
onTouchStarted(): Delegate<(absolutionPosition: Vector2, pointEvent: PointerEvent) => boolean> client
触摸按下事件
paintSpaceGeometry(): Geometry client
获取最后一次用于渲染Widget的几何信息
parent(): Widget client
获取父节点
position(): Readonly<Vector2> client
获取控件的位置
renderOpacity(): number client
获取渲染透明度
renderScale(): Vector2 client
获取渲染缩放
renderShear(): Vector2 client
获取渲染错切形变
renderTransformAngle(): number client
获取渲染的角度
renderTransformPivot(): Vector2 client
获取渲染锚点
size(): Vector2 client
获取大小
tickSpaceGeometry(): Geometry client
获取最后一次用于驱动Widget Tick的几何信息
transform(): Readonly<UITransform> client
得到控件的大小和位置
visibility(): SlateVisibility client
获取可见性
visible(): boolean client
是否可见
zOrder(): number client
获取zorder

Methods

addKey(key: Keys): void client
同一按键同时只能操控一个UI控件,最新绑定的UI控件会覆盖之前的绑定;脚本中添加的绑定无法覆盖编辑器按键绑定菜单中绑定相同按键的UI控件,但当两个UI控件分别通过代码和菜单绑定到同一按键时,使用代码绑定的优先级更高
getKeys(): Keys[] client
获取当前UI控件绑定的所有键盘按键,包括编辑器按键绑定菜单和用代码绑定的按键
isPressed(): boolean client
是否按下
removeKey(key: Keys): void client
此操作只会解绑动态绑定的按键无法解除编辑器按键绑定菜单中绑定的按键
setDisableImageColorByHex(inHexString: string): void client
设置不可用颜色指定Hex的颜色文本设定颜色 #05050505
setDisableImageColorDecimal(R: number, G: number, B: number, A: number): void client
设置禁用颜色
setMaskImageColorByHex(inHexString: string): void client
设置遮罩图片颜色指定Hex的颜色文本设定颜色 #05050505
setMaskImageColorDecimal(R: number, G: number, B: number, A: number): void client
设置遮罩图片颜色
setNormalImageColorByHex(inHexString: string): void client
设置普通图片颜色指定Hex的颜色文本设定颜色 #05050505
setNormalImageColorDecimal(R: number, G: number, B: number, A: number): void client
设置普通图片颜色
setPressedImageColorByHex(inHexString: string): void client
设置按压图片颜色指定Hex的颜色文本设定颜色 #05050505
setPressedImageColorDecimal(R: number, G: number, B: number, A: number): void client
设置按压图片颜色
newObject(parent?: Canvas, inName?: string): MaskButton client
创建 Mask 控件
click

Methods

addChild(child: Widget): void client
添加子节点
destroyObject(): void client
立刻移除并销毁 不可以在使用
equal(that: Widget): boolean client
判断是不是同一个对象
findChildByPath(inPath: string): Widget client
通过相对路径查找节点
getChildAt(index: number): Widget client
获取第几位子节点
getChildByName<T: extends Widget<T>>(name: string): T: extends Widget<T> client
通过名字查找节点
getChildrenCount(): number client
获取子节点数量
invalidateLayoutAndVolatility(): void client
立刻触发重新渲染的和排布计算
removeAllChildren(): void client
清除所有子节点,会销毁UI无法再使用
removeChild(child: Widget): void client
移除节点,会销毁UI无法在使用
removeChildAt(index: number): void client
移除第几个节点,会销毁UI无法再使用
removeObject(): void client
立刻移除并添加到根节点 可以再使用

Accessors


circleCenter

get circleCenter(): Vector2 client

set circleCenter(center): void client

获取圆形遮罩的中心旋转点

Returns

Vector2中心百分点

设置圆形遮罩的中心旋转点

Parameters

center Vector2中心点百分比

circleValue

get circleValue(): number client

set circleValue(value): void client

获取圆形遮罩的遮挡百分值

Returns

number进度值,0~1

设置圆形遮罩的遮挡百分值

Parameters

value number百分进度值,0~1

clickMethod

get clickMethod(): ButtonClickMethod client

set clickMethod(inClickMethod): void client

获取点击模式

Returns

ButtonClickMethod点击模式

设置点击模式

Parameters

inClickMethod ButtonClickMethod点击模式选择

clickedDelegate

get clickedDelegate(): MulticastDelegate<() => void> client

点击事件

Returns

MulticastDelegate<() => void>返回事件的代理

disableImageColor

get disableImageColor(): Readonly<LinearColor> client

set disableImageColor(inColor): void client

获取禁用图片颜色

Returns

Readonly<LinearColor>禁用图片颜色,Type.LinearColor类型,数据范围0~1

设置禁用图片颜色

Parameters

inColor LinearColor颜色,Type.LinearColor类型,数据范围0~1

disableImageDrawType

get disableImageDrawType(): Readonly<SlateBrushDrawType> client

set disableImageDrawType(inDrawType): void client

获取禁用图片绘制类型

Returns

Readonly<SlateBrushDrawType>禁用图片绘制类型

设置禁用图片绘制类型

Parameters

inDrawTypeSlateBrushDrawType

禁用图片绘制类型


disableImageGuid

get disableImageGuid(): string client

set disableImageGuid(inGuid): void client

获取禁用图片ID

Returns

string禁用图片ID

设置不可用图片ID

Parameters

inGuid string图片id

disableImageMargin

get disableImageMargin(): Readonly<Margin> client

set disableImageMargin(inMargin): void client

获取禁用图片边距

Returns

Readonly<Margin>禁用图片边距

设置禁用图片边距

Parameters

inMargin Margin禁用图片边距

disableImageSize

get disableImageSize(): Readonly<Vector2> client

set disableImageSize(inSize): void client

获取禁用图片大小

Returns

Readonly<Vector2>禁用图片大小

设置禁用图片大小

Parameters

inSize Vector2大小

enableTransition

set enableTransition(inBoolean): void client

是否套用不同的按下方案

Parameters

inBoolean boolean是否套用不同的按下方案

fanShapedRotated

get fanShapedRotated(): number client

set fanShapedRotated(value): void client

获取扇形遮罩的旋转

Returns

number旋转角度 0~1

设置扇形遮罩的旋转

Parameters

value number旋转角度 0 ~ 1

fanShapedRotatedCenter

get fanShapedRotatedCenter(): Vector2 client

set fanShapedRotatedCenter(center): void client

获取扇形遮罩的中心旋转点

Returns

Vector2旋转中心百分点

设置扇形遮罩的中心旋转点

Parameters

center Vector2中心点百分比

fanShapedValue

get fanShapedValue(): number client

set fanShapedValue(value): void client

获取扇形遮罩的遮罩进度

Returns

number进度值

设置扇形遮罩的遮罩进度

Parameters

value number百分进度值

focusable

get focusable(): boolean client

set focusable(inFocus): void client

获取是否获取输入焦点

Returns

boolean是否获取输入焦点

设置是否获取输入焦点

Parameters

inFocus boolean是否获取输入焦点

hoveredDelegate

get hoveredDelegate(): MulticastDelegate<() => void> client

悬浮事件

Returns

MulticastDelegate<() => void>返回事件的代理

inverseOpacity

get inverseOpacity(): boolean client

set inverseOpacity(inverseOpacityWeight): void client

获取反转透明度权重

Returns

boolean权重

反转透明度权重

Parameters

inverseOpacityWeight boolean权重

isTransitionEnable

get isTransitionEnable(): boolean client

按钮是否启用过度模式,按下是否有效果

Returns

boolean按钮是否启用过度模式

maskImageColor

get maskImageColor(): Readonly<LinearColor> client

set maskImageColor(inColor): void client

获取遮罩图片颜色

Returns

Readonly<LinearColor>图片的颜色,Type.LinearColor类型,数据范围0~1

设置遮罩图片颜色

Parameters

inColor Readonly<LinearColor>颜色,Type.LinearColor类型,数据范围0~1

maskImageGuid

get maskImageGuid(): string client

set maskImageGuid(InGuid): void client

获取设置遮罩图片ID

Returns

string遮罩图片ID

设置遮罩图片ID

Parameters

InGuidstring

maskOpacity

get maskOpacity(): number client

set maskOpacity(o): void client

获取遮挡处的底图的透明度

Returns

number透明度

设置遮挡处的底图的透明度

Parameters

o number透明度

maskTextureOpacity

get maskTextureOpacity(): number client

set maskTextureOpacity(o): void client

获取遮挡处的遮挡图的透明度

Returns

number透明度

设置遮挡处的遮挡图的透明度

Parameters

o number透明度

maskType

get maskType(): MaskButtonType client

set maskType(inType): void client

获取遮罩裁剪类型

Returns

MaskButtonType裁剪类型

设置遮罩裁剪类型

Parameters

inType MaskButtonType裁剪类型

normalImageColor

get normalImageColor(): Readonly<LinearColor> client

set normalImageColor(inNormalColor): void client

获取普通图片颜色

Returns

Readonly<LinearColor>普通图片颜色,Type.LinearColor类型,数据范围0~1

设置普通图片颜色

Parameters

inNormalColor LinearColor颜色,Type.LinearColor类型,数据范围0~1

normalImageDrawType

get normalImageDrawType(): Readonly<SlateBrushDrawType> client

set normalImageDrawType(inDrawType): void client

获取普通图片绘制类型

Returns

Readonly<SlateBrushDrawType>普通图片绘制类型

设置普通图片绘制类型

Parameters

inDrawType SlateBrushDrawType类型

normalImageGuid

get normalImageGuid(): string client

set normalImageGuid(inGuid): void client

获取普通图片ID

Returns

string普通图片ID

设置普通图片ID

Parameters

inGuid string图片id

normalImageMargin

get normalImageMargin(): Readonly<Margin> client

set normalImageMargin(inMargin): void client

获取普通图片边距

Returns

Readonly<Margin>普通图片边距

设置普通图片边距

Parameters

inMargin Margin普通图片边距

normalImageSize

get normalImageSize(): Readonly<Vector2> client

set normalImageSize(inSize): void client

获取图片大小

Returns

Readonly<Vector2>普通图片大小

设置图片大小

Parameters

inSize Vector2大小

pressedDelegate

get pressedDelegate(): MulticastDelegate<() => void> client

按下事件

Returns

MulticastDelegate<() => void>返回事件的代理

pressedImageColor

get pressedImageColor(): Readonly<LinearColor> client

set pressedImageColor(inColor): void client

获取按压图片颜色

Returns

Readonly<LinearColor>按压图片颜色,Type.LinearColor类型,数据范围0~1

设置按压图片颜色

Parameters

inColor LinearColor颜色,Type.LinearColor类型,数据范围0~1

pressedImageDrawType

get pressedImageDrawType(): Readonly<SlateBrushDrawType> client

set pressedImageDrawType(inDrawType): void client

获取按压图片绘制类型

Returns

Readonly<SlateBrushDrawType>按压图片绘制类型

设置按压图片绘制类型

Parameters

inDrawType SlateBrushDrawType类型

pressedImageGuid

get pressedImageGuid(): string client

set pressedImageGuid(inGuid): void client

获取按下图片ID

Returns

string按下图片ID

设置按下图片ID

Parameters

inGuid string图片id

pressedImageMargin

get pressedImageMargin(): Readonly<Margin> client

set pressedImageMargin(inMargin): void client

获取按压图片边距

Returns

Readonly<Margin>按压图片边距

设置按压图片边距

Parameters

inMargin Margin按压图片边距

pressedImageSize

get pressedImageSize(): Readonly<Vector2> client

set pressedImageSize(inSize): void client

获取按压图片大小

Returns

Readonly<Vector2>按压图片大小

设置按压图片大小

Parameters

inSize Vector2大小

pressedMethod

get pressedMethod(): ButtonPressMethod client

set pressedMethod(inPressedMethod): void client

获取按压模式

Returns

ButtonPressMethod按压模式

设置按压模式

Parameters

inPressedMethod ButtonPressMethodPress模式选择

releasedDelegate

get releasedDelegate(): MulticastDelegate<() => void> client

释放事件

Returns

MulticastDelegate<() => void>返回事件的代理

roundBoxPercentOffset

get roundBoxPercentOffset(): Vector2 client

set roundBoxPercentOffset(percent): void client

获取矩形百分比大小边距偏移

Returns

Vector2矩形大小边距偏移的百分比占据,0~0.5

设置矩形大小边距偏移

Parameters

percent Vector2矩形大小百分比,0~0.5

roundBoxRadius

get roundBoxRadius(): number

set roundBoxRadius(value): void

获取设置的角半径

Returns

number角半径百分比

设置角半径

Parameters

value number角半径百分比

roundBoxSharpness

get roundBoxSharpness(): number

set roundBoxSharpness(v): void

获取设置的圆角锐化度

Returns

number锐化度

设置的圆角锐化度

Parameters

v number锐化度

roundBoxUVRatio

get roundBoxUVRatio(): number

set roundBoxUVRatio(v): void

获取圆角调节大小

Returns

number圆角调节大小

设置圆角调节大小

Parameters

v number圆角调节大小

touchMethod

get touchMethod(): ButtonTouchMethod client

set touchMethod(inTouchMethod): void client

获取触摸模式

Returns

ButtonTouchMethod触摸模式

设置触摸模式

Parameters

inTouchMethod ButtonTouchMethodTouch模式选择

unHoveredDelegate

get unHoveredDelegate(): MulticastDelegate<() => void> client

未悬浮事件

Returns

MulticastDelegate<() => void>返回事件的代理

useMaskTextureOpacity

get useMaskTextureOpacity(): boolean client

set useMaskTextureOpacity(inUseWeight): void client

获取遮罩轮廓是否裁剪底图

Returns

boolean权重

设置遮罩轮廓是否裁剪底图

Parameters

inUseWeight boolean是否裁剪

Methods


addKey

addKey(key): void client

同一按键同时只能操控一个UI控件,最新绑定的UI控件会覆盖之前的绑定;脚本中添加的绑定无法覆盖编辑器按键绑定菜单中绑定相同按键的UI控件,但当两个UI控件分别通过代码和菜单绑定到同一按键时,使用代码绑定的优先级更高

Parameters

key Keys绑定的按键

getKeys

getKeys(): Keys[] client

获取当前UI控件绑定的所有键盘按键,包括编辑器按键绑定菜单和用代码绑定的按键

Returns

Keys[]返回当前控件绑定的所有按键,可能为空

isPressed

isPressed(): boolean client

是否按下

Returns

boolean返回按钮是否按下

removeKey

removeKey(key): void client

此操作只会解绑动态绑定的按键无法解除编辑器按键绑定菜单中绑定的按键

Parameters

key Keys解除绑定的按键

setDisableImageColorByHex

setDisableImageColorByHex(inHexString): void client

设置不可用颜色指定Hex的颜色文本设定颜色 #05050505

Parameters

inHexString string颜色字符串 range: 符合 Hex 特点的字符串类型

setDisableImageColorDecimal

setDisableImageColorDecimal(R, G, B, A): void client

设置禁用颜色

Parameters

R number颜色 R 值。
range:[0, 255] type: 整数
G number颜色 G 值。
range:[0, 255] type: 整数
B number颜色 B 值。
range:[0, 255] type: 整数
A number颜色 透明度。
range:[0, 255] type: 整数

setMaskImageColorByHex

setMaskImageColorByHex(inHexString): void client

设置遮罩图片颜色指定Hex的颜色文本设定颜色 #05050505

Parameters

inHexString string颜色字符串 range: 符合 Hex 特点的字符串类型

setMaskImageColorDecimal

setMaskImageColorDecimal(R, G, B, A): void client

设置遮罩图片颜色

Parameters

R number颜色 R 值。
range:[0, 255] type: 整数
G number颜色 G 值。
range:[0, 255] type: 整数
B number颜色 B 值。
range:[0, 255] type: 整数
A number颜色 透明度。
range:[0, 255] type: 整数

setNormalImageColorByHex

setNormalImageColorByHex(inHexString): void client

设置普通图片颜色指定Hex的颜色文本设定颜色 #05050505

Parameters

inHexString string颜色字符串 range: 符合 Hex 特点的字符串类型

setNormalImageColorDecimal

setNormalImageColorDecimal(R, G, B, A): void client

设置普通图片颜色

Parameters

R number颜色 R 值。
range:[0, 255] type: 整数
G number颜色 G 值。
range:[0, 255] type: 整数
B number颜色 B 值。
range:[0, 255] type: 整数
A number颜色 透明度。
range:[0, 255] type: 整数

setPressedImageColorByHex

setPressedImageColorByHex(inHexString): void client

设置按压图片颜色指定Hex的颜色文本设定颜色 #05050505

Parameters

inHexString string颜色字符串 range: 符合 Hex 特点的字符串类型

setPressedImageColorDecimal

setPressedImageColorDecimal(R, G, B, A): void client

设置按压图片颜色

Parameters

R number颜色 R 值。
range:[0, 255] type: 整数
G number颜色 G 值。
range:[0, 255] type: 整数
B number颜色 B 值。
range:[0, 255] type: 整数
A number颜色 透明度。
range:[0, 255] type: 整数

newObject

Static newObject(parent?, inName?): MaskButton client

创建 Mask 控件

Parameters

parent? Canvas创建控件的外parent对象 default: null
inName? string创建控件的名称 default:null range:设置合理的名称即可

Returns

MaskButton返回创建的对象

当 parent 和 InName 与已有的对象相同时,旧的对象会被销毁