基本函数类别：excel

如何使用这些函数? 请先阅读说明文档。

excel

excel:aci->eci
说明：将cad颜色索引转换为excel颜色索引; 参数:Color:cad颜色索引
用法：
```
(excel:aci->eci color)
```
参数：1 color : 未明确定义;

返回值：excel颜色索引
示例：
```
(excel:ACI->ECI 2)
```
excel:aci->truecolor
说明：将cad颜色索引转换为真彩色值; 参数:aci:cad颜色索引
用法：
```
(excel:aci->truecolor aci)
```
参数：1 aci : 未明确定义;

返回值：真彩色值
示例：
```
(excel:ACI->Truecolor)
```
excel:add-sheet
说明：添加个工作表; 参数:XLApp:已打开的excel文件对象; 参数:Name:工作表名
用法：
```
(excel:add-sheet xlapp name)
```
参数：1 xlapp : 未明确定义; 2 name : 未明确定义;

返回值：成功返回t
示例：
```
(excel:add-sheet exobj "123")
```
excel:delete-sheet
说明：说明:删除工作表; 参数:XLApp:已打开的excel文件对象; 参数:Name:工作表名
用法：
```
(excel:delete-sheet xlapp name)
```
参数：1 xlapp : 未明确定义; 2 name : 未明确定义;

返回值：成功返回t
示例：
```
(excel:deleteSheet exobj "123")
```
excel:eci->aci
说明：将excel颜色索引转换为cad颜色索引; 参数:Color:excel颜色索引
用法：
```
(excel:eci->aci color)
```
参数：1 color : 未明确定义;

返回值：cad颜色索引
示例：
```
(Excel:ECI->ACI 6)
```
excel:eci->truecolor
说明：将excel颜色索引转换为真彩色值; 参数:Color:excel颜色索引
用法：
```
(excel:eci->truecolor color)
```
参数：1 color : 未明确定义;

返回值：真彩色值
示例：
```
(excel:ECI->Truecolor 6)
```
excel:get-activesheet
说明：获取当前工作表的名字; 参数:XLApp:打开的excel文件对象
用法：
```
(excel:get-activesheet xlapp)
```
参数：1 xlapp : 未明确定义;

返回值：名字字符串
示例：
```
(excel:getActiveSheet exobj)
```
excel:get-backcolor
说明：获取充填色; 参数:xlapp:已打开的excel文件对象; 参数:index:区域索引，A1引用格式或者行列表
用法：
```
(excel:get-backcolor xlapp index)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值;

返回值：颜色索引字符串 0-56 号
示例：
```
(excel:get-Backcolor exobj "A1")
```
excel:get-mergeindex
说明：获取合并单元格的索引; 参数:xlapp:已打开的excel文件对象; 参数:index:区域索引，A1引用格式或者行列表
用法：
```
(excel:get-mergeindex xlapp index)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值;

返回值：A1格式的索引
示例：
```
(Excel:get-MergeIndex)
```
excel:get-property
说明：检索 VLA 对象的特性; 参数:obj:vla对象; 参数:prop:符号或字符串，标识要检索的特性，字符串的时候可以直接调用多级特性："Rows.Count"
用法：
```
(excel:get-property obj prop)
```
参数：1 obj : activeX 对象; 2 prop : 未明确定义;

返回值：特性的值
示例：
```
(excel:get-property range "MergeArea.Rows.Count")
```
excel:get-range
说明：说明:根据索引获取range对象; 参数:xlapp:已打开的excel文件对象; 参数:index:区域索引，A1引用格式或者行列表
用法：
```
(excel:get-range xlapp index)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值;

返回值：range对象
示例：
```
(excel:get-Range exobj "A1")
```
excel:get-rangeindex
说明：获取range的索引; 参数:range:range对象
用法：
```
(excel:get-rangeindex range)
```
参数：1 range : 未明确定义;

返回值：A1格式的索引
示例：
```
(excel:get-RangeIndex xlrange)
```
excel:get-rangevalue
说明：获取单元格或区域的值; 参数:XLApp:已打开的excel文件对象; 参数:index:位置信息，如"A1"或者'(1 1), "A1:B2"或者'(1 1 2 2)
用法：
```
(excel:get-rangevalue xlapp index)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值;

返回值：值的列表
示例：
```
(excel:get-RangeValue exobj "A1:B2")
```
excel:get-selection
说明：获取选择区域的索引; 参数:xlapp:已打开的excel文件对象
用法：
```
(excel:get-selection xlapp)
```
参数：1 xlapp : 未明确定义;

返回值：A1格式的索引
示例：
```
(excel:get-Selection exobj)
```
excel:get-usedrange
说明：获取已使用的range区域; 参数:XLApp:已打开的excel文件对象; 参数:Name:工作表名
用法：
```
(excel:get-usedrange xlapp name)
```
参数：1 xlapp : 未明确定义; 2 name : 未明确定义;

返回值：成功返回range对象
示例：
```
(excel:get-UsedRange exobj "345")
```
excel:merge-range
说明：合并单元格; 参数:xlapp:已打开的excel文件对象; 参数:index:区域索引，A1引用格式或者行列表
用法：
```
(excel:merge-range xlapp index)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值;

返回值：
示例：
excel:new
说明：新建Excel工作簿; 参数:ishide:是否可见，t为可见，nil为不可见
用法：
```
(excel:new ishide)
```
参数：1 ishide : 未明确定义;

返回值：一个表示Excel工作簿的vla对象
示例：
```
(excel:New t)
```
excel:open
说明：打开一个excel文件; 参数:Filename:文件路径; 参数:ishide:是否可见，t为可见，nil为不可见
用法：
```
(excel:open filename ishide)
```
参数：1 filename : 未明确定义; 2 ishide : 未明确定义;

返回值：一个表示打开的excel文件的vla对象
示例：
```
(excel:open "C:\Users\mimi\Desktop\1.xlsx" t)
```
excel:quit
说明：退出excel; 参数:ExlObj:打开的excel对象; 参数:SaveYN:是否保存，t为保存，nil为不保存
用法：
```
(excel:quit exlobj saveyn)
```
参数：1 exlobj : 未明确定义; 2 saveyn : 未明确定义;

返回值：
示例：
excel:quit-all
说明：退出所有打开的excel文件; 参数:SaveYN:是否保存
用法：
```
(excel:quit-all saveyn)
```
参数：1 saveyn : 未明确定义;

返回值：
示例：
excel:range-mergep
说明：判断是否是合并单元格; 参数:xlapp:已打开的excel文件对象; 参数:index:区域索引，A1引用格式或者行列表
用法：
```
(excel:range-mergep xlapp index)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值;

返回值：是，返回t，否，返回nil
示例：
```
(excel:Range-Mergep exobj "A1")
```
excel:rename-sheet
说明：说明:重命名工作表; 参数:XLApp:已打开的excel文件对象; 参数:Old:工作表原名; 参数:New:工作表新名
用法：
```
(excel:rename-sheet xlapp old new)
```
参数：1 xlapp : 未明确定义; 2 old : 未明确定义; 3 new : 未明确定义;

返回值：成功返回t
示例：
```
(excel:rename-Sheet  exobj "123" "345")
```
excel:save
说明：保存当前工作簿; 参数:xlsApp:当前工作簿对象
用法：
```
(excel:save xlsapp)
```
参数：1 xlsapp : 未明确定义;

返回值：正确保存应该返回t，错误返回nil
示例：
```
(excel:save xlsobj)
```
excel:saveas
说明：另存为excel文件; 参数:XLApp:已打开的excel文件对象; 参数:Filename:另存为的文件路径
用法：
```
(excel:saveas xlapp filename)
```
参数：1 xlapp : 未明确定义; 2 filename : 未明确定义;

返回值：
示例：
excel:set-activesheet
说明：设置活动工作表; 参数:XLApp:已打开的excel文件对象; 参数:Name:工作表名
用法：
```
(excel:set-activesheet xlapp name)
```
参数：1 xlapp : 未明确定义; 2 name : 未明确定义;

返回值：成功返回t
示例：
```
(excel:set-ActiveSheet exobj "123")
```
excel:set-backcolor
说明：设置充填色; 参数:xlapp:已打开的excel文件对象; 参数:index:区域索引，A1引用格式或者行列表; 参数:colorindex:颜色索引0-56号
用法：
```
(excel:set-backcolor xlapp index colorindex)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值; 3 colorindex : 未明确定义;

返回值：
示例：
excel:set-rangevalue
说明：设置单元格或区域的值; 参数:XLApp:已打开的excel文件对象; 参数:index:位置信息，如"A1"或者'(1 1), "A1:B2"或者'(1 1 2 2); 参数:value:要设置的值列表或者字符串/数字等
用法：
```
(excel:set-rangevalue xlapp index value)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值; 3 value : 值;

返回值：
示例：
excel:sheets
说明：获取工作表列表; 参数:XLApp:已打开的excel文件对象
用法：
```
(excel:sheets xlapp)
```
参数：1 xlapp : 未明确定义;

返回值：工作表名列表
示例：
```
(excel:sheets exobj)
```
excel:unmerge-range
说明：分解合并单元格; 参数:xlapp:已打开的excel文件对象; 参数:index:区域索引，A1引用格式或者行列表
用法：
```
(excel:unmerge-range xlapp index)
```
参数：1 xlapp : 未明确定义; 2 index : 索引值;

返回值：分解后的range对象
示例：
```
(excel:UnmergeRange exobj "A1")
```
excel:utils-getvalue
说明：说明:工具函数，获取变体的值; 参数:var:变体
用法：
```
(excel:utils-getvalue var)
```
参数：1 var : 未明确定义;

返回值：值列表，其中数字全部转换为字符串
示例：
```
(excel:Utils-GetValue obj)
```
excel:utils-index-cells->range
说明：说明:工具函数，将行号、列标表转换成A1格式的引用; 参数:lst:行号、列标表，列最多支持到ZZ列
用法：
```
(excel:utils-index-cells->range lst)
```
参数：1 lst : 列表;

返回值：A1格式的引用
示例：
```
(Excel:Utils-index-cells->range '(1 2 3 4))
```
excel:utils-index-offset
说明：根据行列偏移量计算单元格索引; 参数:BaseCellId:基础单元格索引，可以为A1引用格式或者行列数字列表; 参数:rowOffset:行偏移量; 参数:columnOffset:列偏移量
用法：
```
(excel:utils-index-offset basecellid rowoffset columnoffset)
```
参数：1 basecellid : 未明确定义; 2 rowoffset : 未明确定义; 3 columnoffset : 未明确定义;

返回值：A1格式的单元格索引
示例：
```
(excel:Utils-index-offset "A1" 2 3)
```
excel:utils-index-range->cells
说明：工具函数，将A1格式的引用转换成行号、列标表; 参数:var:A1格式的字符串
用法：
```
(excel:utils-index-range->cells var)
```
参数：1 var : 未明确定义;

返回值：行号、列标表
示例：
```
(excel:Utils-index-range->cells "DD23:EE44")
```

基本函数 类别：excel

excel

基本函数类别：excel