# color.view 库模块帮助文档

## color 成员列表 <a id="color" href="#color">&#x23;</a>

### color.view <a id="color.view" href="#color.view">&#x23;</a>
用于显示color.table色表的视图控件

### color.view() <a id="color.view" href="#color.view">&#x23;</a>
[返回对象:colorviewObject](#colorviewObject)

### color.view(plusCtrl) <a id="color.view" href="#color.view">&#x23;</a>
创建色表视图,  
参数必须指定一个plus控件

## colorviewObject 成员列表 <a id="colorviewObject" href="#colorviewObject">&#x23;</a>

### colorviewObject.addItem(rgb,name) <a id="colorviewObject.addItem" href="#colorviewObject.addItem">&#x23;</a>
添加色卡,rgb为RGB格式颜色数值,name为颜色名,  
名称中的英文名或副名称应放在括号内

### colorviewObject.delItem(index) <a id="colorviewObject.delItem" href="#colorviewObject.delItem">&#x23;</a>
删除色卡,参数指定索引

### colorviewObject.getColorTable() <a id="colorviewObject.getColorTable" href="#colorviewObject.getColorTable">&#x23;</a>
返回色表数据

### colorviewObject.getItemRect() <a id="colorviewObject.getItemRect" href="#colorviewObject.getItemRect">&#x23;</a>
返回指定项所在区块的::RECT结构体,  
参数@1使用数值指定索引,如果索引超出范围返回null,  
可选指定参数@2为true返回屏幕坐标  

[返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject)

### colorviewObject.loadColorTable <a id="colorviewObject.loadColorTable" href="#colorviewObject.loadColorTable">&#x23;</a>
加载色表

### colorviewObject.loadColorTable(clrTable,startIndex,endIndex,rows) <a id="colorviewObject.loadColorTable" href="#colorviewObject.loadColorTable">&#x23;</a>
所有参数可选,  
参数@1指定色表,不指定则自动创建默认色表,  
startIndex,endIndex指定当前页开始、结束索引,  
rows指定色卡行数,默认为12

## colorviewObject 事件列表 <a id="colorviewObjectEvent" href="#colorviewObjectEvent">&#x23;</a>

### colorviewObject.onItemClick() <a id="colorviewObject.onItemClick" href="#colorviewObject.onItemClick">&#x23;</a>

```aardio
colorviewObject.onItemClick = function(index,rgb,argb,name,ename){
	/*鼠标点击色卡触发此事件  
index为色卡索引,rgb为GDI颜色值,argb为GDI+颜色值,  
name为颜色中文名字,ename为英文名字*/	
}
```

### colorviewObject.onItemDoubleClick() <a id="colorviewObject.onItemDoubleClick" href="#colorviewObject.onItemDoubleClick">&#x23;</a>

```aardio
colorviewObject.onItemDoubleClick = function(index,rgb,argb,name,ename){
	/*鼠标双击击色卡触发此事件  
index为色卡索引,rgb为GDI颜色值,argb为GDI+颜色值,  
name为颜色中文名字,ename为英文名字*/	
}
```

### colorviewObject.onItemHover() <a id="colorviewObject.onItemHover" href="#colorviewObject.onItemHover">&#x23;</a>

```aardio
colorviewObject.onItemHover = function(index,rgb,argb,name,ename){
	/*鼠标移动到色卡上触发此事件  
index为色卡索引,rgb为GDI颜色值,argb为GDI+颜色值,  
name为颜色中文名字,ename为英文名字*/
}
```

### colorviewObject.onItemLeave <a id="colorviewObject.onItemLeave" href="#colorviewObject.onItemLeave">&#x23;</a>

```aardio
colorviewObject.onItemLeave = function(){
	/*鼠标离开色卡且未移动到其他色卡时触发此事件*/	
}
```

