博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

DBEngine接口详细说明

Posted on 2006-04-15 18:21  智岛软件  阅读(1832)  评论(0编辑  收藏  举报

编号:

1

类型:

属性

函数:

Continue

说明:

是否进行下一步操作

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

2

类型:

属性

函数:

InitType

说明:

父窗口通过OpenForm(BSTR strFormName, BSTR strInitData, BSTR strInitType)传给子窗口的参数,可在事件DBEngine_EventLoad(strInitData, strInitType)DBEngine_EventBeforeLoad(strInitData, strInitType)里接收

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

3

类型:

属性

函数:

InitData

说明:

父窗口通过方法OpenForm(BSTR strFormName, BSTR strInitData, BSTR strInitType)传给子窗口的参数,可在事件DBEngine_EventLoad(strInitData, strInitType)DBEngine_EventBeforeLoad(strInitData, strInitType)里接收

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

4

类型:

方法

函数:

BSTR GetPrimaryKey(BSTR strDataSource)

说明:

返回窗体对应数据表的主键

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

5

类型:

方法

函数:

FillData(BSTR strDataSource, LPCTSTR strXML)

说明:

XML方式填充窗体

参数:

strXML 格式为"<Row><姓名>张三</姓名>...</Row>"

返回值:

 

范例:

 

备注:

 

 

编号:

6

类型:

方法

函数:

BOOL NextRecord(BSTR strDataSource)

说明:

跳到下一条记录

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

7

类型:

方法

函数:

BOOL FirstRecord(BSTR strDataSource)

说明:

跳到第一条记录

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

8

类型:

方法

函数:

BOOL PrevRecord(BSTR strDataSource)

说明:

跳到前一条记录

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

9

类型:

方法

函数:

BOOL LastRecord(BSTR strDataSource)

说明:

跳到最后一条记录

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

10

类型:

方法

函数:

void NewRecord(BSTR strDataSource)

说明:

新增记录

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

11

类型:

方法

函数:

void SaveRecord(BSTR strDataSource)

说明:

保存记录

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

12

类型:

方法

函数:

BOOL DeleteRecord(BSTR strDataSource)

说明:

删除当前记录

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

13

类型:

方法

函数:

BSTR UpLoadFile(LPCTSTR strFileName, LPCTSTR strUrl)

说明:

Http方式上传文件

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

14

类型:

方法

函数:

BSTR GetElemData(LPCTSTR strXML, LPCTSTR strElem)

说明:

返回在strXML字符里节点名称为strElem的文本值

参数:

 

返回值:

 

范例:

DBEngine.GetElemData("<姓名>张三</姓名>") = "张三"

备注:

 

 

编号:

15

类型:

方法

函数:

BSTR GetNodeXml(LPCTSTR strXML, LPCTSTR strNodeName)

说明:

返回在strXML字符里节点名称为strElem的全节字符串

参数:

 

返回值:

 

范例:

DBEngine.GetElemData("<员工><姓名>张三</姓名></员工>") = "<姓名>张三</姓名>"

备注:

 

 

编号:

16

类型:

方法

函数:

BSTR GetNodeText(LPCTSTR strXML, LPCTSTR strNodeName)

说明:

返回在strXML字符里节点名称为strElem的文本值,GetElemData相同

参数:

 

返回值:

 

范例:

DBEngine.GetElemData("<姓名>张三</姓名>") = "张三"

备注:

 

 

编号:

17

类型:

方法

函数:

BOOL GoToRecord(BSTR strDataSource, long nIndex)

说明:

跳到指定记录

参数:

nIndex 记录索引号

返回值:

 

范例:

 

备注:

 

 

编号:

18

类型:

方法

函数:

BOOL SetXMLFieldValue(LPCTSTR strDataSource, LPCTSTR strXML)

说明:

XML方式填充控件,等于输入新值,FillData相类似

参数:

strDataSource 数据源名称

strXML 数据格式(见备注)

返回值:

 

范例:

 

备注:

<Table>

         <Rows><!--多行数据-->

                   <Row><!--单行数据-->

                            <姓名>张三</姓名>

                            <姓别></姓别>

                            ...

                   </Row>

                   ...

         </Rows>

 

</Table>

 

编号:

19

类型:

方法

函数:

BSTR UpLoadHugeString(LPCTSTR strString, LPCTSTR strUrl)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

 

编号:

20

类型:

方法

函数:

BSTR GetOrgXMLFieldValue(BSTR strDataSource)

说明:

返回未修改前的内容

参数:

strDataSource 数据源名称

返回值:

SetXMLFieldValue的备注

范例:

 

备注:

 

 

编号:

21

类型:

方法

函数:

BOOL RunFormFromFile(LPCTSTR strFileName)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

22

类型:

方法

函数:

BOOL RunFormFromXML(LPCTSTR strXML)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

23

类型:

方法

函数:

void GotoUrl(LPCTSTR strUrl, BOOL bNewPage)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

24

类型:

方法

函数:

void CloseWindow(BOOL bOK)

说明:

关闭窗口

参数:

bOK1,确定;0,取消

返回值:

 

范例:

 

备注:

 

 

编号:

25

类型:

方法

函数:

BSTR WebFunction(LPCTSTR strFunName, LPCTSTR strInputXML, LPCTSTR strOutputXML)

说明:

调用服务器端接口

参数:

strFunName 服务端函数名称

strInputXML XML方式参数,<Input><TalbeName> </TableName></Input>

strOutputXML 暂无用

返回值:

 

范例:

 

备注:

 

 

编号:

26

类型:

方法

函数:

BSTR OpenForm(LPCTSTR strFormName, LPCTSTR strInitData, strInitType)

说明:

打开一个新窗体

参数:

strFormName 窗名称; strInitData strInitType 为传给新窗体的自定义字符串参数

返回值:

<Return><CloseType>01</CloseType><ReturnValue></ReturnValue></Return>

ReturnValue节点的内容为DBEngine.strReturnValue

范例:

 

备注:

 

 

编号:

27

类型:

方法

函数:

void MsgBox(LPCTSTR strMsg)

说明:

提示对话框

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

28

类型:

方法

函数:

BSTR TextToDoc(LPCTSTR strText)

说明:

XML关键字转文档表示方式

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

29

类型:

方法

函数:

BSTR DocToText(LPCTSTR strDoc)

说明:

XML文档表示方式的关键字转为普通字符

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

30

类型:

方法

函数:

BOOL IsModified(BSTR strDataSource)

说明:

是否修改了窗体某个数据源的数据?

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

31

类型:

方法

函数:

AddKeyName(BSTR strDataSource, LPCTSTR strKeyName)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

32

类型:

方法

函数:

BSTR GetKeyNameAt(BSTR strDataSource, short nIndex)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

33

类型:

方法

函数:

void SetKeyValue(BSTR strDataSource, LPCTSTR strKeyName, LPCTSTR strKeyValue)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

34

类型:

方法

函数:

BSTR GetKeyValue(BSTR strDataSource, LPCTSTR strKeyName)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

35

类型:

方法

函数:

void EmptyKeyValue(BSTR strDataSource)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

36

类型:

方法

函数:

BSTR GetSQLWhere()

说明:

返回当前记录的SQL条件语句

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

37

类型:

方法

函数:

short MsgBox1(LPCTSTR strPrompt, short nButtons)

说明:

弹出提示框,用法与VB一样

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

38

类型:

方法

函数:

BSTR InputBox(LPCTSTR strPrompt)

说明:

输入框

参数:

strPrompt 提示文字

返回值:

 

范例:

 

备注:

 

 

编号:

39

类型:

方法

函数:

BSTR InputBox1(LPCTSTR strPrompt, LPCTSTR strTitle, LPCTSTR strDefault)

说明:

输入框

参数:

strPrompt 提示文字strTitle 标题文字strDefault 默认值文字

返回值:

 

范例:

 

备注:

 

 

编号:

40

类型:

方法

函数:

LocateRecordBySQLWhere(BSTR strDataSource, LPCTSTR strSQLWhere)

说明:

将当前记录定位到指定记录

参数:

strSQLWhere 记录定位SQL条件字符串,"[姓名]=张三"

返回值:

 

范例:

 

备注:

 

 

编号:

42

类型:

方法

函数:

IDispatch* CreateActiveX(BSTR szProgID)

说明:

根据ProgID生成控件实例

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

43

类型:

方法

函数:

SetReadOnly(BSTR strDataSource, boolean bValue)

说明:

设置数据源只读

参数:

strDataSource 数据源名称

bValue 0/1

返回值:

 

范例:

 

备注:

 

 

编号:

44

类型:

方法

函数:

boolean GetReadOnly(BSTR strDataSource)

说明:

返回数据源是否只读

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

45

类型:

方法

函数:

boolean GoToRecord(BSTR strDataSource, long nIndex)

说明:

跳到指定记录

参数:

strDataSource 数据源名称

nIndex 记录索引号

返回值:

 

范例:

 

备注:

 

 

编号:

46

类型:

方法

函数:

FillData(BSTR strDataSource, BSTR strXML)

说明:

XML方式填充控件,等于输入新值,SetXMLFieldValue相类似

参数:

strDataSource 数据源名称

strXML 数据格式(见备注)

返回值:

 

范例:

 

备注:

<Row>

         <字段名称>字段值</字段名称>

         ...

</Row>

 

编号:

47

类型:

方法

函数:

CloseWindow(boolean bOK)

说明:

关闭窗口

参数:

bOK 等于1为确定方式关闭,等于0则为取消方式关闭

返回值:

 

范例:

 

备注:

 

 

编号:

48

类型:

方法

函数:

SetPrimaryKey(BSTR strDataSource, BSTR strPrimaryKey)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

49

类型:

方法

函数:

GetPrimaryKey(BSTR strDataSource)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

50

类型:

方法

函数:

BSTR GetCurRecordSQLWhere(BSTR strDataSource)

说明:

返回指定数据源的定位SQL条件

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

51

类型:

方法

函数:

void SetCurRecordSQLWhere(BSTR strDataSource, BSTR strSQLWhere)

说明:

设置指定数据源的定位SQL条件

参数:

strDataSource 数据源名称

strSQLWhere 定位条件

返回值:

 

范例:

 

备注:

 

 

编号:

52

类型:

方法

函数:

BSTR InputBox(BSTR strPrompt)

说明:

简易输入对话框

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

53

类型:

方法

函数:

BSTR InputBox1(BSTR strPrompt, BSTR strTitle, BSTR strDefault)

说明:

简易输入对话框

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

54

类型:

方法

函数:

BSTR ToDateString(double dDate)

说明:

double型的日期转为字符型(:2006-10-01 12:30)

参数:

dDate double型的日期

返回值:

 

范例:

 

备注:

 

 

编号:

55

类型:

方法

函数:

boolean SaveTextToLocalFile(BSTR strText, BSTR strFileName)

说明:

将文本保存到本地文件

参数:

strText 要保存的文本字符串

strFileName 文件名称(:C:\MyFile\A.txt)

返回值:

 

范例:

 

备注:

 

 

编号:

56

类型:

方法

函数:

BSTR OpenLocalTextFile(BSTR strFileName)

说明:

返回本地文本文件里的所有字符串

参数:

strFileName 文件名称(:C:\MyFile\A.txt)

返回值:

 

范例:

 

备注:

 

 

编号:

57

类型:

方法

函数:

void SetFilterSQLWhere(BSTR strDataSource, BSTR strSQLWhere)

说明:

设置窗体数据源的SQL筛选条件

参数:

strDataSource 数据源名称

strSQLWhere SQL筛选条件

返回值:

 

范例:

 

备注:

 

 

编号:

58

类型:

方法

函数:

BSTR GetFilterSQLWhere(BSTR strDataSource)

说明:

返回窗体数据源的SQL筛选条件

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

59

类型:

方法

函数:

void ReflashCurRecord(BSTR strDataSource)

说明:

从后台取回数据,刷新数据源的当前记录

参数:

strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

60

类型:

方法

函数:

void SetAllCtrlPro(BSTR strKindName, BSTR strProName, BSTR strProValue)

说明:

统一设置某种类型控件的属性

参数:

strKindName 控件类型(EditBox/ComboBox/DateTimeCtrl/InFileEdit/Option)

strProName 属性名称(ReadOnly/Visible)

strProValue 属性值(0/1)

返回值:

 

范例:

 

备注:

 

 

编号:

61

类型:

方法

函数:

BSTR UserEvent(BSTR strEventName, BSTR strInputXML)

说明:

发出用户自定义事件,可在 DBEngine_EventUserEvent(strEventName, strInputXML)里接收

参数:

strEventName 事件名称

strInputXML 参数字符串

返回值:

 

范例:

 

备注:

 

 

编号:

62

类型:

方法

函数:

BSTR ToTimeString(double dDate)

说明:

double型的日期转为时间字符型(12:30)

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

63

类型:

方法

函数:

BSTR ToDateTimeString(double dDate)

说明:

double型的日期转为字符型(:2006-10-01 12:30)

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

64

类型:

方法

函数:

long GetCurIndex(BSTR strDataSource)

说明:

返回数据源当前记录索引号

参数:

strDataSource 数据源名称strDataSource 数据源名称

返回值:

 

范例:

 

备注:

 

 

编号:

65

类型:

方法

函数:

boolean IsNewRecord(BSTR strDataSource)

说明:

数据源是否处于新增记录状态?

参数:

strDataSource 数据源名称

返回值:

true/false

范例:

 

备注:

 

 

编号:

66

类型:

方法

函数:

BSTR LocationDir()

说明:

返回当前系统远程目录,http://www.oapro.com/

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

67

类型:

方法

函数:

boolean SetCurIndex(BSTR strDataSource, long nIndex)

说明:

设置数据源的当前记录索引号

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

68

类型:

方法

函数:

void SetEnableInput(BSTR strDataSource, boolean bEnable)

说明:

设置数据源是否允许输入

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

69

类型:

方法

函数:

BSTR GetCurUserID()

说明:

返回当前用户的ID

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

70

类型:

方法

函数:

boolean JudgeUserPermission(BSTR strUserID, BSTR strPermissionID)

说明:

判断用户是否有权限

参数:

strUserID 用户ID

strPermissionID 权限ID

返回值:

 

范例:

 

备注:

 

 

编号:

71

类型:

方法

函数:

void SetUserEventReturnValue(BSTR strValue)

说明:

设置用户自定义事件的返回值

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

72

类型:

方法

函数:

short MsgBox_Title(BSTR strPrompt, short nButtons, BSTR strTitle)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

73

类型:

方法

函数:

oid SetFormTitle(BSTR strTitle)

说明:

 

参数:

 

返回值:

 

范例:

 

备注:

 

 

编号:

74

类型:

方法

函数:

SetReturnValue(BSTR strValue)

说明:

关闭窗体时,设置返回给父窗体的值

参数:

 

返回值:

 

范例:

 

备注: