易语言组件与实

上述例程在随书光盘中的文件名为：“树型框属性-允许编辑.e”。 5．“始终显示选择项”属性
逻辑型。本属性指定是否始终显示当前被选择项目，即使树型框失去焦点。默认为“假”。 如图12-22所示，第3个树型框的始终显示选择项属性为“真”，当焦点不存在第3个树型框时，即以默 认或刚才所选择的项目为灰色。而第4个树型框的始终显示选择项属性为“假”，所以当焦点移开时，即 没有任何变色项目指示。
图12-21 运行“树型框-属性.e”例程
本例程在随书光盘中的文件名为：“树型框-属性.e” 2．“显示连线”属性
逻辑型。本属性指定是否显示连接线。默认为“真”。 可以如图12-21所示，第3个树型框的显示连线属性为“真”，所以有细线将每行进行连接，而第4个树 型框的显示连线属性为“假”，所以没有细线连接于每行。
4．“置项目文本()”方法
设置指定项目的文本。成功返回“真”，失败返回“假”。本命令为初级对象成员命令。
参数<1>的名称为“项目索引”，类型为“整数型（int）”。0 为项目一，1 为项目二，如此类推。 参数<2>的名称为“欲置入的项目文本”，类型为“文本型（text）”。 标题为“置项目文本”按钮的相关程序代码如下：
w
页码，5/12(W)
图12-26 树型框的命令
打开一个大型的演示例程：“树型框命令.e”，下面的所有讲解均在此例程中进行，如图12-27所示。
图12-27 运行“树型框命令.e”例程
1．“取项目数()”方法 返回树型框中所有项目的数目（整数型）。 实际上它返回的是所有项目的总数。 标题为“取项目数”按钮的相关程序代码如下：
“取选中图片（）”命令返回指定项目被选中后的图片索引（数值型）。如果该项目不存在，将返回 -1 。
参数<1>的名称为“项目索引”，类型为“整数型（int）”。0 为项目一，1 为项目二，如此类推。 标题为“取图片”按钮的相关程序代码如下：
子程序：_按钮7_被单击 编辑框1.内容 ＝ “当前选中图片索引为：” ＋ 到文本 (树型框1.取选中图片 (树型框1.现行选中项))
通过项目的改变，就会将当前项目的索引显示在一个编辑框中。 7．“图片组”属性
为树型框提供标志图片。 基本上，操作方法与工具条组件及状态条组件的载入图片方法是一样的。
8．“项目”属性
本属性指定各树型框项目。 单击本属性后面的 钮，可以进入树型框项目设置对话框，如图12-24所示。
mk:@MSITStore:C:\Users\Lizhihua-1981\Desktop\桌面文件夹\外挂教程\易语言组... 2013/11/2
子程序：_树型框1_结束编辑 返回值类型：逻辑型 参数：项目索引 数据类型：整数型 ※草稿：信息框 (“刚才已更改项目为：” ＋ 树型框1.取项目文本 (项目索引), 0, ) 信息框 (“刚才已更改项目为：” ＋ 树型框1.取项目文本 (树型框1.现行选中项), 0, )
上述代码中，两行命令均可以使用。参数“项目索引”与“树型框1.现行选中项”内容是一样的。 4．“双击项目”事件
子程序：_按钮4_被单击
局部变量：文本变量
数据类型：文本型
输入框 (“请输入项目文本”, , , 文本变量, )
树型框1.置项目文本 (树型框1.现行选中项, 文本变量)
树型框1.刷新显示 ()
上述代码实现了弹出一个输入框，输入要改项目的文本后，刚才所选中的项目就被更换了。
5．“取图片()”、“取选中图片()”方法
3．“显示根部线”属性
逻辑型。本属性指定是否从根部显示连接线。默认为“假”。 打开例程“树型框-属性2.e”，可以对比一下左边的两个树型框，第1个树型框的显示根部线属性都为 “真”，因此可以看到最左边的连接线。第2个树型框的显示根部线属性为“假”，因此图标顶在最左 边，如图12-22所示。
图12-22 运行“树型框-属性2.e”例程
子程序：_按钮3_被单击 编辑框1.内容 ＝ “当前缩进层次为：” ＋ 到文本 (树型框1.取缩进层次 (树型框1.现行选中项))
3．“取项目文本()”方法 返回指定项目的文本。如果该项目不存在，将返回空文本。本命令为初级对象成员命令。
mk:@MSITStore:C:\Users\Lizhihua-1981\Desktop\桌面文件夹\外挂教程\易语言组... 2013/11/2
张图片，从 0 开始。 标题为“置图片”按钮的相关程序代码如下：
当使用鼠标左键在某项目上双击时产生此事件。 5．“被双击”事件
处理本事件的子程序如果返回“假”，则取消本事件，不再将此事件传递到所属对象上去；如果不返 回值或返回“真”，则将此事件继续传递到所属对象上去。
实际操作中，只要在树型框的空白处双击，就会产生本事件。相关程序代码为：
子程序：_树型框1_被双击
“置选中图片（）”设置指定项目被选中后所显示图片的索引（数值型）。成功返回“真”，失败返 回“假”。本命令为初级对象成员命令。
参数<1>的名称为“项目索引”，类型为“整数型（int）”。0 为项目一，1 为项目二，如此类推。 参数<2>的名称为“图片索引”，类型为“整数型（int）”。图片索引用于指定图片组属性中的某
子程序：_按钮8_被单击
局部变量：变量1 数据类型：整数型
mk:@MSITStore:C:\Users\Lizhihua-1981\Desktop\桌面文件夹\外挂教程\易语言组... 2013/11/2
w
页码，7/12(W)
输入框 (“请输入一个数值”, , , 变量1, ) 树型框1.置图片 (树型框1.现行选中项, 变量1) 树型框1.刷新显示 ()源自w页码，6/12(W)
参数<1>的名称为“项目索引”，类型为“整数型（int）”。0 为项目一，1 为项目二，如此类推。 标题为“取项目文本”按钮的相关程序代码如下：
子程序：_按钮5_被单击 编辑框1.内容 ＝ “当前项目文本为：” ＋ 到文本 (树型框1.取项目文本 (树型框1.现行选中项))
上述例程将当前选中的项目文本显示在编辑框中。
2．“开始编辑”事件 当项目进入标题编辑状态前产生此事件，要产生本事件“允许编辑”属性必须为“真”。事件处理子 程序返回“假”则不允许进入编辑状态，返回“真”或不返回值允许进入。
3．“结束编辑”事件 当项目结束标题编辑状态前产生此事件，要产生本事件“允许编辑”属性必须为“真”。在事件处理 子程序中读取“结束编辑文本”属性可以得知标题被编辑后的内容，事件处理子程序返回假不允许使用编 辑后的内容替换原有标题，返回“真”或不返回值则允许替换。 例程“树型框事件.e”相关的程序代码为：
mk:@MSITStore:C:\Users\Lizhihua-1981\Desktop\桌面文件夹\外挂教程\易语言组... 2013/11/2
w
页码，4/12(W)
返回值类型：逻辑型 参数：横向位置 数据类型：整数型 参数：纵向位置 数据类型：整数型 参数：功能键状态 数据类型：整数型 信息框 (“要加入吗？”, 0, )
上面两个命令都是取图片类的，但为何一个是 取图片，另一个是取选中图片呢？原来，在选中状 态与非选中状态的小图标图片可以是不一样的。这 是在树型框项目设置对话框中也可以进行设置的， 如图12-28所示。
6．“置图片()”、“置选中图片()”方法
“置图片（）”设置在指定项目首部所显示图
片的索引（数值型）。成功返回“真”，失败返回
子程序：_树型框1_鼠标右键被按下 返回值类型：逻辑型 参数：横向位置 数据类型：整数型 参数：纵向位置 数据类型：整数型 参数：功能键状态 数据类型：整数型 弹出菜单 (弹, , ) ══════════════════════════════ 子程序：_编辑本项_被选择 树型框1.进入编辑 (树型框1.现行选中项)
12.3.3 树型框组件的专有方法
树型框组件现有21个专有方法。可以在支持库面板的“扩展界面支持库一”中找到。如图12-26所示。 下面，将所有的组件命令进行详细介绍、比较。
mk:@MSITStore:C:\Users\Lizhihua-1981\Desktop\桌面文件夹\外挂教程\易语言组... 2013/11/2
6．“现行选中项”属性
本属性指定树型框中现行被选中项目的位置，位置值从 0 开始， -1 表示现行没有被选中的项目。 本属性是使用最多的一个属性。如果你想知道鼠标选择了哪一个项目，就必须用本属性取得。 如：例程“树型框属性-允许编辑.e”中使用到的相关程序为：
子程序：_树型框1_项目被选择 参数：选择方式 数据类型：整数型 编辑框1.内容 ＝ 到文本 (树型框1.现行选中项)
w
页码，3/12(W)
图12-24 树型框项目设置对话框
在弹出的对话框中，可以对每个行项目的标题、图片索引、选中后图片索引、及项目数值等属性进行 操作。
12.3.2 树型框组件的重要事件
1．“项目被选择”事件 如果当前选择项目被改变即产生此事件。 参看例程：“树型框事件.e”。相关的程序代码为：
子程序：_树型框1_项目被选择 参数：选择方式 数据类型：整数型 编辑框1.内容 ＝ 到文本 (树型框1.现行选中项)
图12-28 树型框项目设置对话框
“假”。本命令为初级对象成员命令。
参数<1>的名称为“项目索引”，类型为“整数型
（int）”。0 为项目一，1 为项目二，如此类推。
参数<2>的名称为“图片索引”，类型为“整数型（int）”。图片索引用于指定图片组属性中的某
张图片，从 0 开始。
标题为“置图片”按钮的相关程序代码如下：
子程序：_按钮2_被单击 编辑框1.内容 ＝ “当前所有项目总数为：” ＋ 到文本 (树型框1.取项目数 ())
2．“取缩进层次()”方法 返回指定项目所处缩进层次，层次值从1开始。如果未找到指定项目，返回 0 。本命令为初级对象成 员命令。 参数<1>的名称为“项目索引”，类型为“整数型（int）”。0 为项目一，1 为项目二，如此类推。 标题为“取缩进层次”按钮的相关程序代码如下：