# com.comm 库模块帮助文档
## com 成员列表 #
### com.comm #
MSComm串口通信控件
### com.comm() #
创建MSComm串口通信控件
[返回对象:mscomm32Object](#mscomm32Object)
### com.comm(false) #
创建MSComm串口通信控件
禁用onComm事件
## mscomm32Object 成员列表 #
### mscomm32Object.break #
布尔值,设置或清除中断信号
### mscomm32Object.cdHolding #
布尔值
通过查询 Carrier Detect (CD) 线的状态确定当前是否有传输
### mscomm32Object.cdTimeout #
数值,CD超时
### mscomm32Object.comInputModeBinary #
设为InputMode的值时以二进制模式取回数据
### mscomm32Object.comInputModeText #
设为InputMode的值时以文本方式取回数据
### mscomm32Object.comNone #
没有握手。
### mscomm32Object.comRTS #
RTS/CT握手
### mscomm32Object.comRTSXOnXOff #
RTS和XON/XOFF握手
### mscomm32Object.comXOnXOff #
XON/XOFF 握手
### mscomm32Object.commEvent #
onComm事件代码
### mscomm32Object.commId #
数值
串口被打开时，被API所调用的串口句柄或称标志，这也意味着能利用API接口函数去修改这个常量
### mscomm32Object.commPort #
数值,指定端口号
### mscomm32Object.ctsHolding #
布尔值
确定是否可通过查询 Clear To Send (CTS) 线的状态发送数
### mscomm32Object.ctsTimeout #
数值,CTS超时
### mscomm32Object.dsrHolding #
布尔值
确定 Data Set Ready (DSR) 线的状态。
Data Set Ready 信号由调制解调器发送到相连计算机，指示作好操作准备。
该属性在运行时为只读。
### mscomm32Object.dsrTimeout #
数值,DSR超时
### mscomm32Object.dtrEnable #
布尔值
设置为 True，端口打开时DRT线设置为高电平，端口关闭时，设置为低电平
### mscomm32Object.eofEnable #
布尔值,
确定在输入过程中 MSComm 控件是否寻找文件结尾 (EOF) 字符
如果找到 EOF 字符，将停止输入并激活 OnComm 事件，
此时 CommEvent 属性设置为 comEvEOF
### mscomm32Object.getInput() #
读取输入数据,与input属性作用相同
### mscomm32Object.handshaking #
设置硬件握手信号
### mscomm32Object.inBufferCount #
数值，当前接收缓冲区接收到的数据的长度
### mscomm32Object.inBufferSize #
数值，接收缓冲区的大小,默认值为1024,也可以自己设
### mscomm32Object.input #
输入数据
### mscomm32Object.inputLen #
数值,确定被 input 属性读取的字符数。
设置为 0，则读取缓冲区中全部的内容
### mscomm32Object.inputMode #
设置输入方式
使用对象的comInputModeText,comInputModeBinary常量赋值
### mscomm32Object.interval #
数值,时间间隔,单位为毫秒,缺省为1000
### mscomm32Object.nullDiscard #
布尔值,是否将null字符传输给接收缓冲区
### mscomm32Object.outBufferCount #
数值,当前发送缓冲区中数据的长度
赋值为0可清空输出缓冲区
### mscomm32Object.outBufferSize #
数值,发送缓冲区的大小,默认值为1024,也可以自己设定
### mscomm32Object.output #
发送数据，只写属性
如果赋值为字符串，则以文本模式发送
如果赋值为buffer类型字节数组,则以二进制模式发送数据
### mscomm32Object.parityReplace #
当发生奇偶校验错误时，设置并返回替换数据流中一个非法字符的字符
### mscomm32Object.portOpen #
布尔值,端口是否打开
### mscomm32Object.rThreshold #
数值,设置收到多少个字符后触发OnComm事件
### mscomm32Object.rtsEnable #
布尔值
设置为 True，端口打开时RTS线设置为高电平，端口关闭时，设置为低电平
### mscomm32Object.sThreshold #
数值,若设置为 0（缺省值），数据传输事件不会产生 OnComm 事件。
若设置为 1，当传输缓冲区完全空时，产生 OnComm 事件
### mscomm32Object.settings #
字符串,设置波特率等参数
例如"9600,N,8,1"
## mscomm32Object 事件列表 #
### mscomm32Object.onComm #
```aardio
mscomm32Object.onComm = function(event){
if( event == mscomm32Object.comEvReceive ){
io.print( "收到数据:",mscomm32Object.input );
}
}
```