new Border()
Border 用于绘制组件边框,开发者如果需要自定义边框,需要继承此类并重写 drawBorder 函数
Example
// 下面这段代码绘制了一个直线边框
function MyBorder() {
MyBorder.superClass.constructor.call(this);
}
ht.Default.def(MyBorder, ht.ui.border.Border, {
getLeft: function() {return 1;},
getTop: function() {return 1;},
getBottom: function() {return 1;},
getRight: function() {return 1;},
draw: function(x, y, width, height, view, dom) {
var g = view.getRootContext(dom);
g.beginPath();
g.rect(x, y, width, height);
g.lineWidth = 1;
g.strokeStyle = 'red';
g.stroke();
}
});
Methods
-
addPropertyChangeListener(listener, scope, ahead) → {void}
-
增加属性事件变化监听函数
Parameters:
Name Type Attributes Description listener
Object 监听器函数
scope
any <optional>
函数域
ahead
boolean <optional>
是否将当前监听器插入到监听器列表开头
Returns:
void -
drawBorder(x, y, width, height, view, dom) → {void}
-
绘制 border,如果自定义 border,都需要重写此函数
Parameters:
Name Type Attributes Description x
number 绘制范围的 x 坐标
y
number 绘制范围的 y 坐标
width
number 绘制范围的宽度
height
number 绘制范围的高度
view
ht.ui.View 当前在绘制的组件
dom
HTMLElement <optional>
当前在绘制的 dom 对象,绝大多数组件无需考虑这个参数(因为只有一个绘制 canvas),特殊情况下如右键菜单,每个子菜单都是一个单独的 canvas,这种情况下才有这个参数
Returns:
void -
firePropertyChange(property, oldValue, newValue, compareFunc) → {boolean}
-
派发属性变化事件
Parameters:
Name Type Attributes Description property
string 属性名
oldValue
any 属性变化之前的值
newValue
any 属性变化之后的值
compareFunc
Object <optional>
比较函数,用于比较新值和旧值是否一致,如果一致则不会派发事件
Returns:
boolean -事件是否派发成功
-
fp(property, oldValue, newValue, compareFunc) → {boolean}
-
派发属性变化事件,firePropertyChange 的缩写
Parameters:
Name Type Attributes Description property
string 属性名
oldValue
any 属性变化之前的值
newValue
any 属性变化之后的值
compareFunc
Object <optional>
比较函数,用于比较新值和旧值是否一致,如果一致则不会派发事件
Returns:
boolean -事件是否派发成功
-
getBottom() → {number}
-
返回边框底部的高度
Returns:
number -底部高度
-
getLeft() → {number}
-
返回边框左侧的宽度
Returns:
number -左侧宽度
-
getRight() → {number}
-
返回边框右侧的宽度
Returns:
number -右侧宽度
-
getSerializableProperties() → {any}
-
获取可序列化的属性
Returns:
any -属性 map
-
getTop() → {number}
-
返回边框顶部的高度
Returns:
number -顶部高度
-
isCSSBorder() → {boolean}
-
此边框是否使用 CSS 设置 border
Returns:
boolean -是否是 CSS border
-
mp(listener, scope, ahead) → {void}
-
增加属性事件变化监听函数,addPropertyChangeListener 的缩写
Parameters:
Name Type Attributes Description listener
Object 监听器函数
scope
any <optional>
函数域
ahead
boolean <optional>
是否将当前监听器插入到监听器列表开头
Returns:
void -
removePropertyChangeListener(listener, scope) → {void}
-
删除属性事件变化监听器
Parameters:
Name Type Attributes Description listener
Object 监听器函数
scope
any <optional>
函数域
Returns:
void -
tearDownBorder(x, y, width, height, view, dom) → {void}
-
border 被卸载时调用,只有 CSS border 才需要重写这个函数将 CSS 清除,一般用 canvas 绘制的 border 无需重写此函数
Parameters:
Name Type Attributes Description x
number 绘制范围的 x 坐标
y
number 绘制范围的 y 坐标
width
number 绘制范围的宽度
height
number 绘制范围的高度
view
ht.ui.View 当前在绘制的组件
dom
HTMLElement <optional>
当前在绘制的 dom 对象,绝大多数组件无需考虑这个参数(因为只有一个绘制 canvas),特殊情况下如右键菜单,每个子菜单都是一个单独的 canvas,这种情况下才有这个参数
Returns:
void -
ump(listener, scope) → {void}
-
删除属性事件变化监听器,removePropertyChangeListener 的缩写
Parameters:
Name Type Attributes Description listener
Object 监听器函数
scope
any <optional>
函数域
Returns:
void