Ets_Edit_Pad_File_Open()
注意: 需要 OPNET Development Kit
摘要
使用指定的文件和选项打开一个编辑区(edit pad)对话框。
语法
Ets_Edit_Pad_File_Open (title, options, bounds_rect_ptr, file_path, line_num, save_proc, cancel_proc, client_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
title |
const char * |
新编辑区的标题。若为 NIL,标题将是 file_path 所指向文件的名称。 |
options |
int |
编辑区的选项(参见详情)。 |
bounds_rect_ptr |
EtsT_Rect * |
编辑区的对话框尺寸(参见详情)。 |
file_path |
const char * |
包含所需编辑区内容的文件的文件系统路径。 |
line_num |
int |
光标所在的行。 |
save_proc |
EtsT_Edit_Pad_Action_Proc |
用户单击编辑区的 Save 按钮时调用的函数。 |
cancel_proc |
EtsT_Edit_Pad_Action_Proc |
用户单击编辑区的 Cancel 按钮时调用的函数。 |
client_state_ptr |
void * |
用户自定义数据,每次调用 save_proc 和 cancel_proc 回调时都会将其传递给回调。 |
返回类型
EtsT_Dbox *
指向新打开的编辑区对话框的指针。
头文件
ets_api_edit_pad.h
详情
该函数打开一个新的编辑区。它与 Ets_Edit_Pad_Open() 完全相同,只是编辑区的内容取自文件而不是列表。
除非设置了 ETSC_EDIT_PAD_BUILTIN 选项,编辑区将在外部编辑器中打开(如果在 “editor_prog“首选项中指定了外部编辑器)。有关其他支持的选项,参见符号常量。
bounds_rect_ptr 指向一个结构,其中包含对话框相对工作区左上角的左、上、右、下坐标。
光标放置在 line_num 指定的行,其中 0 为编辑区的第一行。若 line_num 为负数或大于文本行数,编辑区将滚动到文本末尾。