ht.ui.drawable.ImageDrawable(image, stretch, colorTint, rect)

new ImageDrawable(image, stretch, colorTint, rect)

ImageDrawable 类从 ht.ui.drawable.Drawable 继承，重写了 draw 方法来绘制图片和矢量图；
提供了拉伸、染色等属性来控制绘制效果。

Parameters:
Name Type Attributes Description
image any
stretch string <optional>
colorTint string <optional>
rect Object <optional>
Example
button.setBackgroundDrawable(new ht.ui.drawable.ImageDrawable('node_image'));

Extends

Methods

addPropertyChangeListener(listener, scope, ahead) → {void}

增加属性事件变化监听函数

Parameters:
Name Type Attributes Description
listener Object

监听器函数
scope any <optional>

函数域
ahead boolean <optional>

是否将当前监听器插入到监听器列表开头
Returns:
void
Inherited From:

draw(x, y, width, height, data, view, dom) → {void}

绘制内容

Parameters:
Name Type Attributes Description
x number

绘制范围的 x 坐标
y number

绘制范围的 y 坐标
width number

绘制范围的宽度
height number

绘制范围的高度
data ht.Data | ht.ui.View <optional>

绘制相关的 Data 对象，如绘制树组件中节点的 icon 时，可以用此参数判断出当前在绘制哪个节点
view ht.ui.View

当前在绘制的组件
dom HTMLElement <optional>

当前在绘制的 dom 对象，绝大多数组件无需考虑这个参数(因为只有一个绘制 canvas)，特殊的是右键菜单，每个子菜单都是一个单独的 canvas，这种情况下才有这个参数
Returns:
void
Inherited From:
Example
// 下面这段代码绘制了一个矩形
function MyDrawable() {
	MyDrawable.superClass.constructor.call(this);
}
ht.Default.def(MyDrawable, ht.ui.drawable.Drawable, {
	draw: function(x, y, width, height, data, view, dom) {
		var g = view.getRootContext(dom);
		g.beginPath();
		g.rect(x, y, width, height);
		g.fillStyle = 'red';
		g.fill();
	}
});

firePropertyChange(property, oldValue, newValue, compareFunc) → {boolean}

派发属性变化事件

Parameters:
Name Type Attributes Description
property string

属性名
oldValue any

属性变化之前的值
newValue any

属性变化之后的值
compareFunc Object <optional>

比较函数，用于比较新值和旧值是否一致，如果一致则不会派发事件
Returns:
boolean -

事件是否派发成功

Inherited From:

fp(property, oldValue, newValue, compareFunc) → {boolean}

派发属性变化事件，firePropertyChange 的缩写

Parameters:
Name Type Attributes Description
property string

属性名
oldValue any

属性变化之前的值
newValue any

属性变化之后的值
compareFunc Object <optional>

比较函数，用于比较新值和旧值是否一致，如果一致则不会派发事件
Returns:
boolean -

事件是否派发成功

Inherited From:

getColorTint() → {string}

获取图片染色

Returns:
string -

图片染色

getImage() → {any}

获取要绘制的图片

Returns:
any -

要绘制的图片，可能是注册的图片名或图片路径或者矢量对象

getRect() → {Object}

获取图片范围

Returns:
Object -

图片范围

getSerializableProperties() → {any}

获取可序列化的属性

Returns:
any -

属性 map

Inherited From:

getStretch() → {string}

获取拉伸方式，默认为 'centerUniform'

Returns:
string -

拉伸方式，可选值为：'fill'|'uniform'|'centerUniform'|'center'|null(等同于 centerUniform)

mp(listener, scope, ahead) → {void}

增加属性事件变化监听函数，addPropertyChangeListener 的缩写

Parameters:
Name Type Attributes Description
listener Object

监听器函数
scope any <optional>

函数域
ahead boolean <optional>

是否将当前监听器插入到监听器列表开头
Returns:
void
Inherited From:

removePropertyChangeListener(listener, scope) → {void}

删除属性事件变化监听器

Parameters:
Name Type Attributes Description
listener Object

监听器函数
scope any <optional>

函数域
Returns:
void
Inherited From:

setColorTint(color) → {void}

设置图片染色

Parameters:
Name Type Description
color string

颜色值
Returns:
void

setImage(image) → {void}

设置要绘制的图片

Parameters:
Name Type Description
image any

要绘制的图片，可以是注册的图片名或图片路径或者矢量对象
Returns:
void

setRect(rect) → {void}

设置图片范围

Parameters:
Name Type Description
rect Object

矩形范围，格式为：{
x: 'left'|'right'|'center'|Number,
y: 'top'|'bottom'|'middle'|Number,
width: 'wrap_content'|'match_parent'|Number,
height: 'wrap_content'|'match_parent'|Number
}
Returns:
void

setStretch(stretch) → {void}

设置拉伸方式

Parameters:
Name Type Description
stretch string

拉伸方式，可选值为：'fill'|'uniform'|'centerUniform'|'center'|null(等同于 'centerUniform')
Returns:
void

ump(listener, scope) → {void}

删除属性事件变化监听器，removePropertyChangeListener 的缩写

Parameters:
Name Type Attributes Description
listener Object

监听器函数
scope any <optional>

函数域
Returns:
void
Inherited From: