# Frame 框架操作
Frame
- 表示一个“框架”对象。每个框架都有一个这样的对象与之相对应。框架在金字塔中是个很重要的概念，我们操作金字塔软件看盘分析都在框架中进行，金字塔的概念中，框架是整体的一个局部的概念，比如我们常见的K线技术分析图表，就是一个框架，每个框架由若干的窗格组成，有关窗格的对象我们后面还会有介绍，以K线技术分析框架为例，它就是由一个主窗格（K线图）加下面若干个技术分析副图组成。
- 你可以横向或者纵向切分一个窗格，还可以在当前窗格位置处添加一个窗格，此时两个窗格将会自动分页显示。
- “框架”与“窗格”都各自有其独立的坐标系统，X和Y坐标都由0为起点宽度和高度为终点。你可以通过窗格的一系列转换函数来对窗格和框架进行不同的坐标转换。
属性
| 属性 | 说明 |
|---|---|
| Name | 框架名称，只读属性。 注意：如果频繁调用该属性，请注意使用完毕后释放返回值 |
| Description | 框架描述，读写。 |
| CreateTime | 框架创建时间，只读属性 |
| OwnerName | 框架所有者名称，只读属性。 注意：如果频繁调用该属性，请注意使用完毕后释放返回值 |
| GridCount | 框架内所包含窗格个数。只读。 |
| SplitterBarColor | 切分条颜色，读写。当Enable3DSpliterBar属性为True时，此属性无效。 |
| GridFocusColor | 窗格焦点颜色，读写。 |
| EnableDragSpliterBar | 是否允许用户拖动切分条改变窗格大小，只写属性。 |
| Enable3DSpliterBar | 是否允许切分条以3D模式显示，只写属性。 |
| EnableShowFocus | 是否允许显示窗格焦点框。 |
| NewDocument | 确定该文档是否是新建立尚未保存的新框架，只读属性。 |
| HasVisible | 确定当前框架是否为有效框架。若框架被打开则为1，否则为0 |
| ShowKeyFairy | 当前框架是否允许使用键盘精灵，允许为1，否则为0。该属性主要用来控制用户自定义按键后续操作。 |
| Trading | 图表程序化交易状态 1已开启 0已停止 |
| AutoRedraw | 确定框架是否允许自动更新，若为False则除非手工调用Refresh，否则框架将不进行更新 |
方法
| 方法 | 说明 |
|---|---|
| Splitter | 切分当前活动的窗格。 |
| ActiveGrid | 返回当前活动窗格对象。 |
| SetActiveWindow | 设置指定当前激活活动窗格 |
| SaveDocument | 保存当前活动框架文档。 |
| SaveAsDocument | 另存为当前活动框架文档。 |
| AddGrid | 在当前活动窗格位置插入一个窗格。 |
| AddGridByName | 在指定位置处插入一个窗格。 |
| RemoveGrid | 删除指定名称的窗格。例如 RemoveGrid("Window4"), 删除窗格名称为window4的窗格。 |
| GetGridByIndex | 得到指定序号（基于0索引）的窗格对象。 |
| GetGridByName | 得到指定名称的窗格对象。注意窗格名称是区分大小写得。 |
| GetFormulaByName | 得到指定名称的公式对象，如果该公式再该框架不存在，返回空对象。 |
| ReCalcAllGrid | 重新初始化数据和计算框架内所有公式数据。 |
| InitAllGrid | 重新初始化数据和计算框架内所有公式数据。 |
| ReCalcAllGridFromula | 重新计算框架内所有公式数据，但他与ReCalcAllGrid方法不同的是他不会重新初始化数据。 |
| GetGridByPt | 得到指定框架位置坐标所对应的窗格对象。 |
| Refresh | 刷新显示框架内容。 |
| Close | 关闭当前打开的该框架 |
| StartTrade | 开启图表程序化交易，已当前图表程序化设置界面参数启动。 |
| StopTrade | 停止图表程序化交易 |
| SetMenuUserID | 设置用户自定义菜单操作 |
| ClearMenuUserID | 清理菜单ID函数 |
事件
| 事件 | 说明 |
|---|---|
| SPLITERCHANGE | 当用户用鼠标拖动切分条改变Grid位置大小后发生。 |
| Load | 当框架加载时发生。 |
| Close | 当框架关闭时发生。 |
| Zoom | 当框架大小位置发生改变时发生。 |
| Activate | 当一个对象成为活动窗口时发生。 |
| Deactivate | 当一个对象不再是活动窗口时发生。 |
| GotFocus | 当对象获得焦点时产生该事件。 |
| Initialize | 当框架初始化时发生。 |
| Unload | 当框架被关闭时发生。 |
| Save | 当框架文档被保存时发生。 |
| SaveAs | 当框架文档被另存为时发生。 |
| QueryUnload | 当框架文档关闭前发生，此时若参数返回值为True时，则拒绝关闭。 |
| Paint | 当框架被重新刷新绘制时发生。 |
| PaintBefore | 当框架被重新刷新绘制前发生，若参数返回非零值，则拒绝重新绘制。 |
| Click | 鼠标单击框架时发生。 |
| DblClick | 当用户指向一个对象并双击鼠标时，发生 DblClick 事件。 |
| KeyDown | 按下和释放某键时KeyDown和KeyUp这两个事件依次发生。按下键时发生 KeyDown 事件。 |
| KeyUp | 释放键时发生 |
| KeyPress | 当用户按下一个 ANSI 键时该事件发生。 |
| MouseDown | 用户按下鼠标按键时发生事件 |
| MouseUp | 用户释放鼠标按键时发生 |
| MouseMove | 用户移动鼠标时该事件发生。 |
| AddFormula | 当用户在窗格内添加/更换公式时发生 |
| RemoveFormula | 当用户在窗格内删除公式时发生，具体描述参见AddFormula事件 |
| CursorMove | 当用户移动十字光标时发生 |
| ChangeStock | 当用户在窗格上更换品种时发生 |
| TableChangeStock | 当用户在表(动态显示牌)上双击一个品种时发生.具体描述参见ChangeStock事件。 |
| TableClickStock | 当用户在表（动态显示牌）上单击一个品种时发生，具体描述参见ChangeStock事件。 |
| TableSortOk | 当用户表（动态显示牌）指标排序结束后发生。其参数为Table表对象。 |
| ClickHeader | 当用户在表（动态显示牌）点击表头排序完毕后发生。其参数为Table表对象和基于0的列索引。 |
| TableInited | 当用户表（动态显示牌）重新初始化或者用户更换板块分类时发生。其参数为Table表对象。 |
| RefurbishFinished | 当用户表（动态显示牌）刷新数据完毕后发生。其参数为Table表对象。注意:严禁在该事件中调用Table.SwitchBlock方法。 |
| CalcGridMaxMin | 当窗格计算最高最低显示价位时发生。 |
| CalcData | 当窗格数据需要重新初始化计算时发生。 |
| CalcDataed | 当窗格计算完毕数据后发生。 |
| StartTarder | 当该框架启动图表程序化交易时发生。 |
| EndTarder | 当该框架停止图表程序化交易时发生。 |
| ChangeShowCount | 当用户在K线图俺UP或者DOWN键放大或者缩小图形时发生。 |
| MenuUserID | 当用户做了菜单选择时触发 |