GUI图形界面库

Mac App Store 上的Silk内置了一些GUI类库供使用者开发MacOS上的图形界面程序，只需引用gui.si即可，gui.si包含下列类库：

CNative类
CNative类是所有GUI类的基类，包含如下成员函数：

GrantPermission(path)
GrantPermission 用来获取某个目录的读写权限，由于Mac App Store的SandBox机制，App Store上下载的App默认情况下对除了自己的目录，其它目录均没有读写权限。GrantPermission函数将会弹出选择对话框让用户选择确认后 获取权限，并且会记录用户的选择，下次调用就直接赋予权限，用户不用再次选择。参数path是需要获取权限的目录的路径。

ClearOutput()
ClearOutput()函数用来清空IDE输出窗口的运行结果。

GetInputkey()
GetInputkey()函数从Silk IDE的输入框读取用户的键盘输入。

LiveOutput(enable)
LiveOutput 函数将会控制程序是否实时地在IDE输出窗口输出print或printf等函数的打印信息。在某些情况下（如线程运行），为了程序的运行速度，IDE默 认将不会实时输出打印的信息，程序运行完成会输出所有的打印信息。参数enable可以传入true或者false，true为实时输出。

CWindow类
CWindow类用来创建MacOS的窗口，包含如下成员函数：

CreateWindow(title,width,height)
CreateWindow 用来创建一个Mac的窗口，参数title为窗口的标题，width为窗口宽度，height为窗口高度。

Close()
Close函数关闭当前窗口。

Show(enable)
Show函数显示或隐藏当前窗口，参数enable为true显示，false为隐藏。

SetTitle(title)
SetTitle函数设置窗口标题，参数title为标题字符串。

GetRect()
GetRect函数获取窗口的位置和大小，返回的类型为CRect类，CRect类包含对象的坐标（x，y）以及对象的长和宽（w，h）。

SetRect(rect)
SetRect函数设置窗口的位置和大小，参数rect为CRect类。

SetStyle(resizable,closable=true,miniaturizable=true)
SetStyle函数设置窗口的风格，参数resizable为true表示窗口有最大化按钮并可改变大小，closable表示窗口有关闭按钮，miniaturizable表示窗口有最小化按钮。
closable和miniaturizable都有缺省值true，可省略。

 AddComboBox(rect=null,callback=null,param=null)
  AddComboBox函数用来在窗口上加入下拉列表框控件，参数rect为列表框的位置和大小，callback为列表框改变选项后的回调函数，param为任意参 数，传入可供回调函数使用。
回调函数包 含4个参数，分别为列表框句柄handle，当前选项index，当前选项的文字text，传入的参数param，具体用法如下列例子。
所有参数都有缺省值null，如果使用缺省值而不传入参数，那么Silk将自动设置列表框的位置和大小，一般在窗口的居中位置，宽度200，高度25。
AddComboBox执行成功将返回加入的列表框对象CComboBox。

AddPopupButton(rect=null,callback=null,param=null)
AddPopupButton函数用来在窗口上加入列表按钮控件，参数rect为列表按钮的位置和大小，callback为列表按钮改变选项后的回调函数，param为任意参数，传入可供回调函数使用。
所有参数都有缺省值null，如果使用缺省值而不传入参数，那么Silk将自动设置列表按钮的位置和大小，一般在窗口的居中位置，宽度200，高度25。
AddPopupButton执行成功将返回加入的列表按钮对象CPopupButton。

 
AddTextView(text="",rect=null)
AddTextView函数用来在窗口上加入文本显示框控件，文本显示框支持多行。参数rect为文本显示框的位置和大小，text为文本显示框的初始文字。
AddTextView执行成功将返回加入的文本显示框对象CTextView。


AddTableView(rect=null,selectionChanged=null,doubleClicked=null,param=null)
AddTableView函数用来在窗口上加入表格框控件，表格支持多行多列。参数rect为表格框的位置和大小，selectionChanged为改变表格选项后的回调函数，
doubleClicked为双击表格选项后的回调函数，param为任意参数，传入可供回调函数使用。
所有参数都有缺省值null，如果使用缺省值而不传入参数，那么Silk将自动设置表格框的位置和大小。
AddTableView执行成功将返回加入的表格框对象CTableView。


AddButton(title,rect=null,callback=null,param=null)
AddButton函数用来在窗口上加入按钮控件。参数title为按钮文字，rect为按钮的位置和大小，callback为按下按钮后的回调函数，param为任意参数，传入可供回调函数使用。
参数rect有缺省值null，如果使用缺省值而不传入参数，那么Silk将自动设置按钮的位置和大小。
AddButton执行成功将返回加入的按钮对象CButton。
具体用法如下列例子。

AddLabel(title,rect=null)
AddLabel函数用来在窗口上加入文本标签控件。参数rect为文本标签的位置和大小，title为文本标签的文字。
AddLabel执行成功将返回加入的文本标签对象CTextField。
具体用法如下列例子。

AddTextField(title="",rect=null)
AddTextField函数用来在窗口上加入文本输入框控件。参数rect为输入框的位置和大小，title为输入框的初始文字。
AddTextField执行成功将返回加入的文本输入框对象CTextField。
具体用法如下列例子。

AddSecureTextField(title="",rect=null)
AddSecureTextField函数用来在窗口上加入密码输入框控件。参数rect为输入框的位置和大小，title为输入框的初始文字。
AddSecureTextField执行成功将返回加入的密码输入框对象CSecureTextField。
具体用法如下列例子。


CreateCanvas(rect,backcolor=null)
CreateCanvas函数用来在窗口上创建画布，在画布上可以绘制各种图形和图像。参数rect为画布的位置和大小，backcolor为画布的背景色。
CreateCanvas执行成功将返回创建的画布对象CCanvas。

BindEvent(event,callback,param=null)
BindEvent函数用来绑定各种键盘，鼠标和窗口事件。参数event为事件名称，callback为事件的回调函数，param为任意参数，
传入可供回调函数使用，目前支持的事件有EventLeftMouseDown，EventLeftMouseUp，EventRightMouseDown，EventRightMouseUp，EventLeftMouseDragged，
EventMouseMoved，EventKeyDown，EventKeyUp和EventWindowWillResize。
具体用法如下列例子。


CreateTimer(interval,callback)
CreateTimer函数用来创建定时器，定时执行各种任务。参数interval为每隔多少秒执行定时器，callback为定时器执行时的回调函数，具体用法如下列例子。


MainLoop(center=true)
MainLoop函数用来显示窗口并进入消息循环接收各种窗口消息，直到收到退出消息才会退出循环终止程序。参数center为设置窗体居中显示。


CMessageBox类
CMessageBox类用来显示消息框，文件选择对话框，文件保存对话框，输入框和颜色选择框，包含如下成员函数：

ShowMessage(title,message,button1="OK",button2=null,button3=null)
ShowMessage 用来显示消息框，参数title为消息框标题，message为消息文字，button1为第一个按钮，一般为确认按钮，缺省文字为OK，
button2为第二个按钮，一般为取消按钮，button3为第三个按钮，一般提问消息需要三个按钮。button2和button3有缺省值null，可以省略。

ShowInputBox(title,button1,button2=null)
ShowInputBox 用来显示输入框，参数title为输入框标题，button1为第一个按钮，一般为确认按钮，button2为第二个按钮，一般为取消按钮。
函数返回值为用户输入的字符串。

ShowFileDialog(title,multisel=false,dir=false,createdir=false)
ShowFileDialog 用来显示文件选择框，参数title为选择框标题，multisel为是否可以选择多个文件，缺省为false；dir为是否可以选择目录，缺省为false；
createdir为是否可以创建目录，缺省为false。函数的返回值为包含选中文件路径的数组。

ShowSaveDialog(title,defaultdir=null,createdir=false)
ShowSaveDialog 用来显示文件保存框，参数title为保存框标题，defaultdir为默认的保存路径，缺省为null；createdir为是否可以创建目录，缺省为false。
函数的返回值为包含选中文件路径的数组。

ShowColorDialog(colorChanged,param=null,color=null)
ShowColorDialog 用来显示颜色选择框，参数colorChanged为选择的颜色改变后的回调函数，param为传入回调函数的任意参数，缺省为null；color为默认的颜色。
注意：ShowColorDialog的回调函数colorChanged必须在窗口的消息循环内使用，所以需调用MainLoop函数进入消息循环后使用。

CComboBox类
CComboBox下拉列表框类，包含如下成员函数：

GetCurSel()
GetCurSel函数 用来获取列表框当前选中的项目的索引，索引从0开始，如果没有选中的项，返回的索引为-1。具体用法见下列例子。

SetCurSel(index)
SetCurSel函数 用来设置列表框当前选中的项目，参数index为需要选中项的索引。具体用法见下列例子。

AddString(string)
AddString函数 用来在列表框中加入项目，参数string为加入的项目，为字符串类型。具体用法见下列例子。

InsertString(string,index)
InsertString函数 用来在列表框的某个项目前插入项目，参数string为插入的项目，index为某个项目的索引。具体用法见下列例子。

Remove(index)
Remove函数 用来删除列表框中的某个项目，参数index为某个项目的索引。具体用法见下列例子。

SetEditable(enable)
SetEditable函数 用来设置列表框是否可以编辑，参数enable为true可编辑。具体用法见下列例子。

Clear()
Clear函数 用来清空列表框中的所有项目。具体用法见下列例子。

GetString()
GetString函数 用来获取列表框中当前的项目文字。具体用法见下列例子。

SetString(string)
SetString函数 用来在列表框中设置当前的文字，参数string为设置的文字。具体用法见下列例子。

GetStringAtIndex(index)
GetStringAtIndex函数 用来获取列表框中某个项目的文字，参数index为某个项目的索引。具体用法见下列例子。


CTableView类
CTableView为表格框类，包含如下成员函数：

GetData(row)
GetData函数 用来获取表格框中的某行数据，参数row为行号，从0开始。具体用法见下列例子。

GetCurSel()
GetCurSel函数 用来获取表格框中当前选中行的行号。具体用法见下列例子。

SetData(row,data)
SetData函数 用来设置表格框中的某行数据，参数row为行号，data为行数据，为字典类型。具体用法见下列例子。

Delete(row)
Delete函数 用来删除表格框中的某行数据，参数row为行号。具体用法见下列例子。

Clear()
Clear函数 用来清空表格框中的所有数据。具体用法见下列例子。

AddData(data)
AddData函数 用来在表格框中添加一行数据，参数data为数据。具体用法见下列例子。

Refresh()
Refresh函数 用来在界面上刷新数据，对表格添加，删除或修改数据后必须调用Refresh函数，不然界面不会更新。具体用法见下列例子。

AddColumn(title,identifier=null,width=null)
AddColumn函数 用来在表格框中添加列，一般在创建表格框后调用，参数title为列名，identifier为列的唯一标识符，width为列宽。具体用法见下列例子。


CButton类
CButton为按钮类，包含如下成员函数：

SetCheckBox(enable,status=0)
SetCheckBox函数 用来设置按钮为Checkbox类型，参数enable为true则为Checkbox类型，status为1则状态打勾。具体用法见下列例子。

SetRadio(enable,status=0)
SetRadio函数 用来设置按钮为Radio类型，参数enable为true则为Radio类型，status为1则radio选中状态。具体用法见下列例子。

GetStatus()
GetStatus函数 用来获取按钮状态，如果是Checkbox或Radio按钮，则打勾或选中返回1，否则返回0。具体用法见下列例子。

SetStatus(status)
SetStatus函数 用来设置Checkbox或Radio按钮的状态，参数status为1则设置为打勾或选中。具体用法见下列例子。

SetTitle(title)
SetTitle函数 用来设置按钮标题，参数title为标题文字。

GetRect()
GetRect函数 用来获取按钮在窗口上的坐标和长宽。

SetRect(rect)
SetRect函数 用来设置按钮在窗口上的坐标和长宽。参数rect为按钮的位置坐标和长宽。

RoundedStyle(enable)
RoundedStyle函数 用来设置按钮为圆角风格，参数enable为true则为圆角按钮。具体用法见下列例子。

CPopupButton类
CPopupButton为按钮列表框类，包含如下成员函数：

AddItem(item)
AddItem函数 用来往按钮列表框中加入项目，参数item为需要加入的项目，字符串类型。


CTextField类，CSecureTextField类，CTextView类
CTextField为字符框类，CSecureTextField为密码框类，CTextView为文本框类（支持多行），他们的用法类似，共同包含如下成员函数：

GetText()
GetText函数 用来获取字符框的内容。具体用法见下列例子。

SetText(text)
SetText函数 用来设置字符框的内容，参数text为需要设置的文字。具体用法见下列例子。

GetRect()
GetRect函数 用来获取字符框在窗口上的坐标和长宽。

SetRect(rect)
SetRect函数 用来设置字符框在窗口上的坐标和长宽。参数rect为字符框的位置坐标和长宽。

SetEditable(enable)
SetEditable函数 用来设置字符框是否可编辑，参数enable为true表示可编辑。具体用法见下列例子。


CTimer类
CTimer为定时器类，包含如下成员变量和成员函数：

handle
handle成员变量 用来获取定时器的句柄用来和定时器回调函数参数里的句柄比较。具体用法见下列例子。

Pause()
Pause函数 用来暂停定时器。具体用法见下列例子。

Start()
Start函数 用来启动定时器，当定时器被Pause函数暂停时，可以通过Start重新启动。具体用法见下列例子。

Stop()
Stop函数 用来停止定时器，也就是关闭定时器。具体用法见下列例子。


CCanvas类
CCanvas为画布类，包含如下成员函数：

DrawLine(point1,point2,width=1.0,color="00ff00")
DrawLine 函数 用来在画布上画线段。参数point1为线段起始点坐标，point2为终点坐标；width为线段的宽度，默认为1.0；color为线段的颜色，颜色 为字符串类型，可以传入颜色的十六进制字符串形式，常用颜色（red，green，blue，yellow，white，black）可以用英文单词代 替。具体用法见下列例子。

DrawRect(rect,width=1.0,colorLine="ff0000",fill=true,colorFill="ff0000")
DrawRect函数 用来在画布上画矩形。参数rect为矩形的左下角坐标和长宽；width为线的宽度；colorLine为线的颜色；fill为是否用颜色填充矩形，默认为true；colorFill为填充的颜色，默认为红色。
具体用法见下列例子。

DrawRoundedRect(rect,width=1.0,colorLine="ff0000",fill=true,colorFill="ff0000",xRadius=30.0,yRadius=30.0)
DrawRoundedRect 函数 用来在画布上画圆角矩形。参数rect为矩形的左下角坐标和长宽；width为线的宽度；colorLine为线的颜色；fill为是否用颜色填充矩形， 默认为true；colorFill为填充的颜色，默认为红色；xRadius为圆角在x轴方向的半径，yRadius为圆角在y轴方向的半径，默认为 30，这2个参数用来调整圆角的弧度。
具体用法见下列例子。

DrawOval(rect,width=1.0,colorLine="ff0000",fill=true,colorFill="ff0000")
DrawOval函数 用来在画布上画椭圆或圆（外围矩形为正方形时为圆）。参数rect为椭圆外围矩形的左下角坐标和长宽；width为线的宽度；colorLine为线的颜色；fill为是否用颜色填充矩形，默认为true；colorFill为填充的颜色，默认为红色。
具体用法见下列例子。

DrawText(text,point,color="ff0000",size=12,center=false,font="Helvetica")
DrawText 函数 用来在画布上画文字。参数text为文字字符串；point为文字外围矩形框的左下角坐标；color为文字颜色；size为文字字体大小，默认为12； center表示文字是否居中显示，默认不居中；font为文字的字体名，默认为Helvetica。具体用法见下列例子。

OpenImage(filename)
OpenImage函数 用来打开图像文件，返回一个类型为CImage的图像对象，CImage只有一个成员函数Close()，如果对象不再使用，可以通过Close关闭。参数filename为图像文件的路径。具体用法见下列例子。

DrawImage(image,rect,operation=1,fraction=1.0,scale=1)
DrawImage 函数 用来在画布上画图像。参数image为通过OpenImage函数打开的图像对象；rect为图像在画布上显示的位置坐标和长宽；operation为是 否透明显示图像，缺省1为透明；fraction为图像透明度，默认为1.0；scale为是否可以放大缩小图片，默认为1，表示可以放大缩小，将按 rect的大小显示图片，如果为0，则按图片原始大小显示，rect的大小将被忽略。具体用法见下列例子。

SaveToImage(filename,rect=null)
SaveToImage函数 用来保存画布到图像文件。参数filename为图像文件的路径；rect为指定要保存画布的某一部分的坐标和大小，默认为null，表示要保存全部的画布。具体用法见下列例子。

Clear()
Clear函数 用来清除画布上所画内容，最后需要调用Refresh才能呈现清除后的画布。具体用法见下列例子。

Refresh()
Refresh函数 用来刷新画布，对画布的任何操作（DrawLine，DrawRect，DrawImage等）最后都需要调用Refresh函数才能呈现。具体用法见下列例子。

GetRect()
GetRect函数 用来获取画布在窗口上的坐标和长宽。

SetRect(rect)
SetRect函数 用来设置画布在窗口上的坐标和长宽。参数rect为画布的位置坐标和长宽。具体用法见下列例子。

 SetBackColor(color)
SetBackColor函数 用来设置画布的背景颜色。参数color为颜色值。具体用法见下列例子。


CPoint类
CPoint为构建二维坐标系（坐标系原点为左下角，右边为x轴正方向，上边为y轴正方向。）上一个点的类，包含x，y成员变量，分别代表x轴和y轴上的坐标，包含如下成员函数：

CPoint(x,y)
CPoint函数 用来构造坐标系上的一个点。参数x为x坐标，y为y坐标。具体用法见下列例子。

CRect类
CRect为构建二维坐标系（坐标系原点为左下角，右边为x轴正方向，上边为y轴正方向。）上一个矩形，包含x，y，w，h成员变量，分别代表x轴和y轴上的坐标，以及x轴上的宽度和轴上的高度。包含如下成员函数：

CRect(x,y,w,h)
CRect函数 用来构造坐标系上的一个矩形。参数x为矩形左下角x坐标，y为矩形左下角y坐标，w为矩形x轴方向宽度，h为矩形y轴方向高度。具体用法见下列例子。

CHttpRequest类
CHttpRequest为一个实现了HTTP客户端的类，帮助用户通过HTTP协议连接Web服务器。包含如下成员函数：

HttpGet(url,callback=null,filepath=null,header=null)
HttpGet 函数 用来通过GET方式连接Web服务器获取数据。参数url为服务器的网址，callback为获取数据完成后的回调函数，如果callback不为 null，则采用异步方式连接，为null则为同步方式；filepath为保存数据的文件的路径，如果filepath不为null，则获取的数据将会 保存到文件，为null则会返回数据，注意：目前CHttpRequest类只能处理UTF8编码的数据，如果获取的数据不是UTF8编码，请设置 filepath让数据保存到文件，然后读取文件再处理；header为HTTP的头信息，如果需要定制HTTP头，则可以设置此参数。返回的数据是字典类型，包含服务器返回的status，body，header，error等数据。
具体用法见下列例子。

HttpPost(url,body,callback=null,filepath=null,header=null)
HttpPost 函数 用来通过POST方式连接Web服务器发送和获取数据。参数url为服务器的网址；body为需要通过POST方式发送的数据；callback为获取数据完成后的回调函数，如果callback不为 null，则采用异步方式连接，为null则为同步方式；filepath为保存数据的文件的路径，如果filepath不为null，则获取的数据将会 保存到文件，为null则会返回数据，注意：目前CHttpRequest类只能处理UTF8编码的数据，如果获取的数据不是UTF8编码，请设置 filepath让数据保存到文件，然后读取文件再处理；header为HTTP的头信息，如果需要定制HTTP头，则可以设置此参数。返回的数据是字典类型，包含服务器返回的status，body，header，error等数据。
具体用法见下列例子。


CAudioPlay类
CAudioPlay为播放音频的类，音频可以是mp3，wav文件等。包含如下成员函数：

PlayFile(file)
PlayFile 函数 用来直接播放音频文件。参数file为音频文件的路径。PlayFile播放的文件无法通过Stop停止，直到播放完成。具体用法见下列例子。

Open(file,callback)
Open 函数 用来打开需要播放的音频文件。参数file为音频文件的路径，callback为文件播放完成后的回调函数。具体用法见下列例子。

Play()
Play 函数 用来播放被Open函数打开的音频文件。具体用法见下列例子。

Pause()
Pause 函数 用来暂停播放的音频文件，暂停后可以再次通过Play函数播放。具体用法见下列例子。

Stop()
Stop 函数 用来停止播放的音频文件。具体用法见下列例子。