20080405-Loadrunner-Baan Vuser Functions

总觉得学习Loadrunner而不从这些基础函数开始就是一个缺陷，因此有时间允许就逐个翻译这些文档。

[b][u]Button Object Functions[/u][/b]
[color=blue]button_press[/color]: Activates a push button.
[color=blue]button_set[/color]: Sets the state of the specified radio or check button.

[b][u]Edit Object Functions[/u][/b]
[color=#0000ff]edit_get_text[/color]: Returns the text in an edit object.
[color=#0000ff]edit_set[/color]: Replaces the entire contents of an edit object.
[color=#0000ff]edit_set_insert_pos[/color]: Places the cursor at the specified point.
[color=#0000ff]edit_set_selection[/color]: Selects text in an edit object.
[color=#0000ff]edit_type[/color]: Types a string in an edit object.

[b][u]List Object Functions[/b][/u]
[color=blue]list_activate_item[/color]: Activates items in a list.
[color=blue]list_collapse_item[/color]: Hides items in a list.
[color=blue]list_expand_item[/color]: Show hidden items in a list.
[color=blue]list_get_selected[/color]: Returns the currently selected item in a list.
[color=blue]list_select_item[/color]: Selects a list item.

[b][u]Menu Object Functions[/u][/b]
[color=blue]menu_select_item[/color]: Selects an item from a menu.

[b][u]Object Functions[/u][/b]
[color=blue]obj_get_info[/color]: Returns the value of an object attribute.
[color=blue]obj_get_text[/color]: Reads text from an object.
[color=blue]obj_mouse_click[/color]: Clicks within an object.
[color=blue]obj_mouse_dbl_click[/color]: Double-clicks with an object.
[color=blue]obj_mouse_drag[/color]: Drags the mouse within an object.
[color=blue]obj_type[/color]: Sends keyboard input to an object.
[color=blue]obj_wait_info[/color]: Waits for the value of an object attribute.

[u][b]Scrool Object Functions[/b][/u]
[color=blue]scroll_drag_from_min[/color]: Drags a scroll object to the specified distance from the minimum position.
[color=blue]scroll_line[/color]: Scrolls the specified number of lines.
[color=blue]scroll_page[/color]: Moves a scroll object the specified number of pages.

[u][b]Tab and Toolbar Object Functions[/b][/u]
[color=blue]tab_select_item[/color]: Select a tab in the active windows.
[color=blue]toolbar_button_press[/color]: Clicks a toolbar button.

[u][b]Static Object Functions[/b][/u]
[color=blue]static_get_text[/color]: Returns the contents of a static text object.

[u][b]Synchronization Functions[/b][/u]
[color=blue]obj_wait_info[/color]: Waits for the value of an object attribute
[color=blue]tbl_wait_selected_cell[/color]: Waits for the specified cell to appear in focus.
[color=blue]win_wait_info[/color]Waits for the value of a window attribute.

[u][b]Table Functions[/b][/u]
[color=blue]tbl_activate_cell[/color]: Clicks Enter in the specified cell.
[color=blue]tbl_get_cell_data[/color]: Retrieves the contents of the specified cell from a table.
[color=blue]tbl_get_selected_cell[/color]: Returns the cell currently in focus in a table.
[color=blue]tbl_press_zoom_button[/color]: Clicks the table's zoom button.
[color=blue]tbl_set_cell_data[/color]: Sets the contents of a cell to the specified text in a table.
[color=blue]tbl_set_selected_cell[/color]: Selects a table cell.
[color=blue]tbl_set_selected_rows[/color]: Selects the specified rows in a table.

[u][b]Window Object Functions[/b][/u]
[color=blue]set_window[/color]: Specifies the window that receives subsequent input.
[color=blue]win_activate[/color]: Activates a window.
[color=blue]win_close[/color]: Closes a window.
[color=blue]win_get_info[/color]: Reads text from a window.
[color=blue]win_get_info[/color]: Returns the value of a window attribute.
[color=blue]win_max[/color]: Maximizes a window to fill the entire screen.
[color=blue]win_min[/color]: Minimizes a window to an icon.
[color=blue]win_mouse_click[/color]: Clicks within a window.
[color=blue]win_mouse_dbl_click[/color]: Double-clicks within a window.
[color=blue]win_mouse_drag[/color]: Drags the mouse within a window.
[color=blue]win_move[/color]: Moves a window to a new absolute location.
[color=blue]win_resize[/color]: Resizes a window.
[color=blue]win_restore[/color]: Restores a window from an iconized or maximized state to its previous size.
[color=blue]win_type[/color]: Send keyboard input to a window.

[u][b]Session Functions[/b][/u]
[color=blue]close_session[/color]: Closes all Baan sessions and windows.
[color=blue]start_session[/color]: Begins a specific Baan session.
[color=blue]init_session[/color]: Initializes a Baan session.
[color=blue]set_default_timeout[/color]: Sets the default timeout.
[color=blue]set_exception[/color]: Specifies how to handle exceptions.
[color=blue]set_think_time[/color]: Sets the think time range

[u][b]Return Values[/b][/u]
E_OK 0 Operation successful.
E_GENERAL_ERROR -10001 General error occurred.
E_ILLEGAL_OPERATION -10004 Operation invalid for object.
E_OUT_OF_RANGE -10005 Object is out of range.
E_NOT_DISPLAYED -10101 Window or object is not displayed.
E_DISABLED -10102 Window or object is disabled.
E_IMPROPER_CLASS -10103 Object class cannot perform this operation.
E_ILLEGAL_KEY -10104 Key or mouse button name is illegal.
E_ITEM_NOT_FOUND -10105 未找到符合的Item。
E_NOT_RESPONDING -10106 AUT is alive but does not respond.
E_OBJECT_SYNTAX -10107 Illegal syntax used.
E_DUPLICATE_OBJECT -10108 对象不唯一
E_DUPLICATE_DESC -10109 内容不唯一
E_DUPLICATE_WINDOW -10110 窗口不唯一
E_DUPLICATE_WIN_DESC -10111 Window description is not unique.
E_ILLEGAL_NUM_OF_PARAMS -10112 Number of parameters does not match those for the command.
E_NOTICE_NOT_FOUND -10113 Notice window not found.
E_AUT_DISCONNECTED -10114 AUT is not connected to the system.
E_ATTR_NOT_SUPPORTED -10115 函数不支持该属性
E_MISMATCH -10116 Verification mismatch found.
E_ITEM_NOT_UNIQUE -10117 More than one item in list or menu has this name.
E_TEXT_TOO_LONG -10118 Text to be inserted exceeds maximum number of characters. The string will be truncated to the appropriate length.
E_DIFF -10119 未比较GUI验证点
E_CMP_FAILED -10120 比较失败
E_CAPT_FAILED -10121 抓取失败
E_WRONG_OBJ_CHKLIST -10122 Object in checklist is not the object in the command.
E_SET_WIN -10123 Window setting parameters missing.
E_BITMAP_TIMEOUT -10124 wait_bitmap exceeded specified wait time.
E_BAD_CHECK_NAME -10125 Syntax error in requested check.
E_OBJ_CAPT_FAILED -10126 Capture failed for specified object.
E_UNEXP_WIN -10127 Window in checklist is not the window in the command.
E_CAPT_FUNC_NOT_FOUND -10128 Capture function not defined.
E_CMP_FUNC_NOT_FOUND -10129 比较函数未定义
E_TSL_ERR -10130 语法错误
E_TOOLKIT_MISMATCH -10131 Incorrect toolkit detected.
E_RECT_COVERED -10132 Desired rectangle is hidden.
E_RECT_OUT -10133 Desired rectangle does not appear on screen.
E_AREA_COVERED -10134 Desired area is hidden.
E_AREA_OUT -10135 Desired area does not appear on screen.
E_STR_NOT_FOUND -10136 Text string not located.
E_WAIT_INFO_TIMEOUT -10137 wait_info exceeded specified wait time.
E_SYNC_FAIL -10138 同步失败
E_DIFF_SIZE -10139 Expected and actual bitmaps are different sizes.
E_CANT_DRAG -10140 当前对象不支持拖动
E_DROP_WITHOUT_DRAG -10141 没有下拉选项
E_VIR_OBJ -10142 函数不支持虚拟对象
E_MISSING_ATTR -10143 Virtual object not found because obligatory attribute is missing.
E_EDIT_SET_FAILED -10144 未找可编辑的对象