Skip to content

类: ImgView

图片

继承

继承于

构造函数

构造函数

new ImgView(params?): ImgView

参数

params?

any

返回

ImgView

重写了

UIBaseView.constructor

属性

属性类型描述

alias

string

别名 用于标识/获取组件

示例

ts
let img = new LM.ImgView()
// 给控件起一个名字
img.alias = "img01"

alpha

number

对象的透明度

Range

示例

let img = new LM.ImgView()
// 修改透明度
img.alpha = 100

alphaFilterClick

boolean

已被弃用

自v1.3.0起废弃,请使用新的alphaHitUnable 透明区域是否可以点击 默认可以点击

alphaHitUnable

boolean

透明区域是否可以点击 默认可以点击

backgroundColor

string

背景色

示例

ts
let img = new LM.ImgView()
// 修改控件的背景色
img.backgroundColor = "#FF0000"

h

number

已被弃用

自v1.3.0起废弃,请使用新的height 对象的宽度 宽高都被设置时才会生效

示例

obj.h = 100

height

number

容器高度(不建议直接使用)

isMirrored

boolean

镜像

示例

let img = new LM.ImgView()
img.isMirrored = true

isPenetrable

boolean

是否可穿透 默认可穿透 当使用Container创建父子级关系时 需要把自己穿透都打开才能触发到Container的点击事件

mirrorType

0 | 1

已被弃用

自v1.3.0起废弃,请使用新的 isMirrored 镜像

示例

let img = new LM.ImgView()
img.mirrorType = 1

mouseThrough

boolean

已被弃用

自v1.3.0起废弃,请使用新的 isPenetrable 是否可穿透 默认可穿透 当使用Container创建父子级关系时 需要把自己穿透都打开才能触发到Container的点击事件

object_fit

"fill" | "none" | "contain" | "cover" | "scale-down"

已被弃用

自v1.3.0起废弃,请使用新的objectFit 图片展示模式

cover:保持宽高比完全覆盖容器,可能裁剪 contain:保持宽高比完整显示,可能留白 fill:拉伸填充,不保持宽高比 none:保持原始尺寸 scale-down:类似contain,但保持原始尺寸

objectFit

"fill" | "none" | "contain" | "cover" | "scale-down" | "centerCrop" | "centerInside"

图片展示模式

cover:保持宽高比完全覆盖容器,可能裁剪 contain:保持宽高比完整显示,可能留白 fill:拉伸填充,不保持宽高比 none:保持原始尺寸 scale-down:类似contain,但保持原始尺寸 centerCrop:保持宽高比,居中显示在容器内,多余部分裁剪 centerInside:保持宽高比,完整居中显示在容器内,可能留白

rotate

number

旋转角度

Range

示例

let img = new LM.ImgView()
img.rotate = 90

rotateCenterX

number

旋转中心点x

Range

示例

let img = new LM.ImgView()
img.rotateCenterX = 0.5

rotateCenterY

number

旋转中心点y

Range

示例

let img = new LM.ImgView()
img.rotateCenterY = 0.5

scaleX

number

x轴缩放

Range

scaleY

number

y轴缩放

Range

src

string

, 图片地址

示例

let img = new LM.ImgView()
img.src = './test.png'

touchEable

boolean

已被弃用

自v1.3.0起废弃,请使用新的touchEnabled 是否可点击(默认可点击)

touchEnabled

boolean

是否可点击(默认可点击)

visible

boolean

组件是否可见

示例

ts
let img = new LM.ImgView()
// 隐藏该控件
img.visible = false

w

number

已被弃用

自v1.3.0起废弃,请使用新的width 对象的宽度 宽高都被设置时才会生效

示例

obj.w = 100

width

number

容器宽度(不建议直接使用)

worldX

number

对象的全局x坐标 (建议不要频繁设置获取,相较于x比较耗性能)

worldY

number

对象的全局y坐标 (建议不要频繁设置获取,相较于y比较耗性能)

x

number

对象的x坐标

示例

obj.x = 100

y

number

对象的y坐标

示例

obj.y = 100

z

number

对象的层级

示例

let img = new LM.ImgView()
this.addChild(img) //注意:需要先添加到父容器后再设置层级,否则层级设置无效。
img.z = 100

zoomCenterX

number

縮放中心点x 默认为0

Range

zoomCenterY

number

縮放中心点y 默认为0

Range

zoomX

number

x轴缩放

Range

zoomY

number

y轴缩放

Range

方法

addChild()

addChild<T>(child): void

添加一个子对象

类型参数

T

T extends UIBaseView

参数

child

T

返回

void

示例

ts
// 声明一张图片
let img = new LM.ImgView()
// 设置图片的路劲
img.src = "ui/bg.png"
// 添加到当前容器中
this.addChild(img)

继承自

UIBaseView.addChild


addEffect()

addEffect(effect): void

添加按钮特效

参数

effect

BaseEffect

返回

void


clear()

clear(): void

  • 清理绘制的图案

返回

void


clearFilter()

clearFilter(): any

清除滤镜

返回

any


click()

click(fn): any

参数

fn

Function

返回

any

已被弃用

自v1.3.0起废弃,请使用新的onClick 点击行为

示例

ts
let img = new LM.ImgView()
// 为这张图片注册了点击事件
img.click( 
   () => {
     console.log("点击了改控件")
   }
)

继承自

UIBaseView.click


dispose()

dispose(): void

销毁组件

返回

void

继承自

UIBaseView.dispose


drawCircle()

drawCircle(x, y, radius, fillColor?): void

绘制圆形

参数

x

number

圆心横坐标

y

number

圆心纵坐标

radius

number

圆的半径

fillColor?

string

填充颜色,默认为黑色

返回

void


drawGraphic()

drawGraphic(type, info, color): any

参数

type

number

0矩形,1三角形,2圆形,3线,4 圆角矩形

info

any

type=0 info=[x,y,w,h] type=1 info=[x1,y1,x2,y2,x3,y3] type=2 info=[x,y,r] r为半径 type=3 info=[x1,y1,x2,y2] type=4 info=[x,y,w,h,radius] r为矩形圆角半径

color

any

颜色 16进制字符串 "#ffffff" 或者 rgb格式 [255,255,255]

返回

any

已被弃用

自v1.3.0起废弃,请使用新的 drawRect,drawRoundRect,drawCircle,drawTriangle 绘制图形

示例

ts
// 绘制矩形 
let img = new LM.ImgView()
img.drawGraphic(0,[10,10,200,200],"#ff0000")
// 绘制三角形
img.drawGraphic(1,[10,10,20,20,30,30],"#ff0000")
// 绘制圆形
img.drawGraphic(2,[10,10,10],"#ff0000")
// 绘制一条线
img.drawGraphic(3,[10,10,100,100],"#ff0000")
// 绘制圆角矩形
img.drawGraphic(4,[10,10,100,100,10],"#ff0000")

drawLine()

drawLine(x1, y1, x2, y2, color?): void

绘制线段

参数

x1

number

起点X坐标

y1

number

起点Y坐标

x2

number

终点X坐标

y2

number

终点Y坐标

color?

string

线条颜色,默认为黑色

返回

void

已被弃用

自v1.3.0起暂停使用 后续完善后开放


drawRect()

drawRect(x, y, width, height, fillColor?): void

绘制矩形

参数

x

number

左上角X坐标

y

number

左上角Y坐标

width

number

宽度

height

number

高度

fillColor?

string

填充颜色,默认为黑色

返回

void


drawRoundRect()

drawRoundRect(x, y, width, height, radius, fillColor?): void

绘制圆角矩形

参数

x

number

左上角X坐标

y

number

左上角Y坐标

width

number

宽度

height

number

高度

radius

number

圆角半径

fillColor?

string

填充颜色,默认为黑色

返回

void


drawTriangle()

drawTriangle(x1, y1, x2, y2, x3, y3, fillColor?): void

绘制三角形

参数

x1

number

第一个点X坐标

y1

number

第一个点Y坐标

x2

number

第二个点X坐标

y2

number

第二个点Y坐标

x3

number

第三个点X坐标

y3

number

第三个点Y坐标

fillColor?

string

填充颜色,默认为黑色

返回

void

已被弃用

自v1.3.0起暂停使用 后续完善后开放


getParent()

getParent(): UIBaseView

获取父级

返回

UIBaseView

继承自

UIBaseView.getParent


getSaveData()

getSaveData(): any

获取组件的存档信息

返回

any

继承自

UIBaseView.getSaveData


onClick()

onClick(fn): any

点击行为

参数

fn

Function

返回

any

示例

ts
let img = new LM.ImgView()
// 为这张图片注册了点击事件
img.onClick( 
   () => {
     console.log("点击了改控件")
   }
)

继承自

UIBaseView.onClick


onTouchCancel()

onTouchCancel(fn): any

鼠标移出

参数

fn

Function

返回

any

示例

ts
let img = new LM.ImgView()
// 注册了移出事件
img.touchOut(()=>{console.log("移出")})

继承自

UIBaseView.onTouchCancel


onTouchDown()

onTouchDown(fn): any

按下行为

参数

fn

Function

返回

any

示例

ts
let text = new LM.TextView()
// 注册了按下事件
text.onTouchDown(()=>{console.log("按下")})

继承自

UIBaseView.onTouchDown


onTouchMove()

onTouchMove(fn): any

鼠标移动行为

参数

fn

Function

返回

any

示例

ts
let text = new LM.TextView()
// 注册了移动事件
text.onTouchMove(()=>{console.log("移动了")})

继承自

UIBaseView.onTouchMove


onTouchUp()

onTouchUp(fn): any

抬起行为

参数

fn

Function

返回

any

示例

ts
let img = new LM.ImgView()
// 注册了抬起事件
img.onTouchUp(()=>{console.log("抬起")})

继承自

UIBaseView.onTouchUp


removeFromParent()

removeFromParent(): void

从父级移除

返回

void

继承自

UIBaseView.removeFromParent


set9Grid()

set9Grid(info): any

九宫格设置

参数

info

number[]

[top,bottom,left,right]

返回

any

示例

ts
let img = new LM.ImgView()
img.set9Grid([10,10,10,10])

setAnchor()

setAnchor(x, y): any

设置组件中心点位置 默认是左上角为0,0 设置anchor点位置后 旋转中心点rotateCenterXY也会被更改为anchor点

参数

x

number

x轴中心点

y

number

y轴中心点

返回

any

示例

ts
let img = new LM.ImgView()
img.setAnchor(0.5,0.5)

setClip()

setClip(x, y, w, h): any

设置图片裁剪

参数

x

any

裁剪x

y

any

裁剪y

w

any

裁剪宽度

h

any

裁剪高度

返回

any

示例

ts
let img = new LM.ImgView()
img.setClip(10,10,100,100)

setFilterData()

调用签名

setFilterData(type): any

清空滤镜

参数
type

NONE

LM.FilterMode.NONE

返回

any

调用签名

setFilterData(type, data): any

设置色相滤镜

参数
type

HUE

LM.FilterMode.HUE

data

[number, number, number, number, number]

颜色数组

返回

any

调用签名

setFilterData(type, data, target, hideTarget?): any

设置叠加滤镜

参数
type

ADD

LM.FilterMode.ADD

data

FilterEffectEnum

滤镜数据

target

ImgView

目标图片

hideTarget?

boolean

是否显示目标图片

返回

any

调用签名

setFilterData(type, data, targets, hideTarget?): any

设置多个叠加滤镜

参数
type

ADD

LM.FilterMode.ADD

data

FilterEffectEnum

滤镜数据

targets

ImgView[]

目标图片数组

hideTarget?

boolean

是否显示目标图片

返回

any


setNineGrid()

setNineGrid(info): any

参数

info

number[]

[top,bottom,left,right]

返回

any

已被弃用

自v1.3.0起废弃,请使用新的set9Grid 九宫格设置

示例

ts
let img = new LM.ImgView()
img.setNineGrid([10,10,10,10])

touchCancel()

touchCancel(fn): any

参数

fn

Function

返回

any

已被弃用

自v1.3.0起废弃,请使用新的onTouchCancel 鼠标移出

示例

ts
let img = new LM.ImgView()
// 注册了移出事件
img.touchOut(()=>{console.log("移出")})

继承自

UIBaseView.touchCancel


touchDown()

touchDown(fn): any

参数

fn

Function

返回

any

已被弃用

自v1.3.0起废弃,请使用新的onTouchDown 按下行为

示例

ts
let text = new LM.TextView()
// 注册了按下事件
text.touchDown(()=>{console.log("按下")})

继承自

UIBaseView.touchDown


touchMove()

touchMove(fn): any

参数

fn

Function

返回

any

已被弃用

自v1.3.0起废弃,请使用新的onTouchMove 鼠标移动行为

示例

ts
let text = new LM.TextView()
// 注册了移动事件
text.touchMove(()=>{console.log("移动了")})

继承自

UIBaseView.touchMove


touchUp()

touchUp(fn): any

参数

fn

Function

返回

any

已被弃用

自v1.3.0起废弃,请使用新的onTouchUp 抬起行为

示例

ts
let img = new LM.ImgView()
// 注册了抬起事件
img.touchUp(()=>{console.log("抬起")})

继承自

UIBaseView.touchUp