<%
Set oComp = Server.CreateObject("VoAsp.Component")
@@ -13992,7 +13992,7 @@
SELF:Request:GetServerVariable("PATH_TRANSLATED")
RETURN SELF:Response:_Write("Path name: " + cRet)
- HTML code:
+ HTML 代码:
<html>
<p>
@@ -14002,7 +14002,7 @@
...
</html>
- ASP code (response.asp):
+ ASP 代码 (response.asp):
<%
Set oComp = Server.CreateObject("VoAsp.Component")
@@ -14040,7 +14040,7 @@
RETURN SELF:Response:_Write(cRet)
- HTML code:
+ HTML 代码:
<html>
<p>
@@ -14050,7 +14050,7 @@
...
</html>
- ASP code (response.asp):
+ ASP 代码 (response.asp):
<%
Set oComp = Server.CreateObject("VoAsp.Component")
@@ -15736,8 +15736,8 @@
- Windows API Constant
- Description
+ Windows API 常量
+ 描述
-
DDL_ARCHIVE
@@ -16012,8 +16012,8 @@
- Constant
- Description
+ 常量
+ 描述
-
LVA_ALIGNLEFT
@@ -18635,7 +18635,7 @@
多行编辑控件中的位置,指定所需字符串所在的行。指定以下值之一:
-
+
-
0
多行编辑控件中的当前行(即,当前包含文本光标的行)。这是默认值。
@@ -18662,7 +18662,7 @@
多行编辑控件中的位置,指定所需字符串所在的行。指定以下值之一:
-
+
-
0
多行编辑控件中的当前行(即,当前包含文本光标的行)。这是默认值。
@@ -19516,7 +19516,7 @@
指定要使用的视图模式。使用以下符号之一:
-
+
-
符号
描述
@@ -20648,7 +20648,7 @@
如果省略 nHandle 参数,0是唯一支持的选项,也是默认值。
-
+
-
Pointer
描述
@@ -21240,47 +21240,47 @@
-
DMPAPER_LETTER
- Letter, 8 1/2 x 11 in.
+ Letter,8 1/2 x 11 英寸。
-
DMPAPER_LETTERSMALL
- Letter Small, 8 1/2 x 11 in.
+ Letter Small,8 1/2 x 11 英寸。
-
DMPAPER_TABLOID
- Tabloid, 11 x 17 in.
+ Tabloid,11 x 17 英寸。
-
DMPAPER_LEDGER
- Ledger, 17 x 11 in.
+ Ledger,17 x 11 英寸。
-
DMPAPER_LEGAL
- Legal, 8 1/2 x 14 in.
+ Legal,8 1/2 x 14 英寸。
-
DMPAPER_STATEMENT
- Statement, 5 1/2 x 8 1/2 in.
+ Statement,5 1/2 x 8 1/2 英寸。
-
DMPAPER_EXECUTIVE
- Executive, 7 1/2 x 10 1/2 in.
+ Executive,7 1/2 x 10 1/2 英寸。
-
DMPAPER_A3
- A3, 297 x 420 mm
+ A3,297 x 420 毫米
-
DMPAPER_A4
- A4, 210 x 297 mm
+ A4,210 x 297 毫米
-
DMPAPER_A4SMALL
- A4 Small, 210 x 297 mm
+ A4 Small,210 x 297 毫米
-
DMPAPER_A5
- A5, 148 x 210 mm
+ A5,148 x 210 毫米
-
DMPAPER_B4
@@ -21292,7 +21292,7 @@
-
DMPAPER_FOLIO
- Folio, 8 1/2 x 13 in.
+ Folio,8 1/2 x 13 英寸。
-
DMPAPER_QUARTO
@@ -21308,27 +21308,27 @@
-
DMPAPER_NOTE
- Note, 8 1/2 x 11 in.
+ Note,8 1/2 x 11 英寸。
-
DMPAPER_ENV_9
- Envelope #9, 3 7/8 x 87/8in.
+ 9 号信封,3 7/8 x 87/8 英寸。
-
DMPAPER_ENV_10
- Envelope #10, 4 1/8 x 91/2in.
+ 10 号信封,4 1/8 x 91/2 英寸。
-
DMPAPER_ENV_11
- Envelope #11, 4 1/2 x 103/8in.
+ 11 号信封,4 1/2 x 103/8 英寸。
-
DMPAPER_ENV_12
- Envelope #12, 4 1/2 x 11 in.
+ 12 号信封,4 1/2 x 11 英寸。
-
DMPAPER_ENV_14
- Envelope #14, 5 x 11 1/2 in.
+ 14 号信封,5 x 11 1/2 英寸。
-
DMPAPER_CSHEET
@@ -21384,27 +21384,27 @@
-
DMPAPER_ENV_MONARCH
- Envelope Monarch, 3 7/8 x 71/2 in.
+ Monarch 信封,3 7/8 x 71/2 英寸。
-
DMPAPER_ENV_PERSONAL
- Envelope, 3 5/8 x 6 1/2 in.
+ 信封,3 5/8 x 6 1/2 英寸。
-
DMPAPER_FANFOLD_US
- U.S. Standard Fanfold, 147/8 x 11 in.
+ 美国标准连续纸(U.S. Standard Fanfold),147/8 x 11 英寸。
-
DMPAPER_FANFOLD_STD_GERMAN
- German Standard Fanfold, 81/2 x 12 in.
+ 德国标准连续纸(German Standard Fanfold),81/2 x 12 英寸。
-
DMPAPER_FANFOLD_LGL_GERMAN
- German Legal Fanfold, 81/2 x 13 in.
+ 德国法律连续纸(German Legal Fanfold),81/2 x 13 英寸。
-
DMPAPER_LAST
- German Legal Fanfold, 81/2 x 13 in.
+ 德国法律连续纸(German Legal Fanfold),81/2 x 13 英寸。
-
DMPAPER_USER
@@ -22412,7 +22412,7 @@
如果省略,缺省值是 1(Letter 8 1/2 x 11 in)。
-
+
-
A3
297 x 420 mm
@@ -23374,8 +23374,8 @@
以下常量之一,表示富文本中当前选择的类型:
- Constant
- Description
+ 常量
+ 描述
-
RESEL_EMPTY
@@ -23399,7 +23399,7 @@
Operation
- Description
+ 描述
-
#Add
@@ -23422,8 +23422,8 @@
- Constant
- Description
+ 常量
+ 描述
-
REOPT_AUTOWORD
@@ -23595,8 +23595,8 @@
以下常量之一,表示富文本中新选择的类型:
- Constant
- Description
+ 常量
+ 描述
-
RESEL_EMPTY
@@ -23845,8 +23845,8 @@
一个字符串,表示生成此 ScrollEvent 时发生的滚动操作的类型。 返回以下值中的一个:
- Constant
- Description
+ 常量
+ 描述
-
BLOCKDECREMENT
@@ -24170,7 +24170,7 @@
Window
- Any area of the window not explicitly identified in this table
+ 窗口中未在此表中明确标识的任何区域
Window_Border
@@ -24178,27 +24178,27 @@
Window_Caption
- Title bar
+ 标题栏
Window_MaxBox
- Maximize button
+ 最大化按钮
Window_MinBox
- Minimize button
+ 最小化按钮
Window_SysMenuBox
- System menu button
+ 系统菜单按钮
Window_Unknown
- Any area of the window not explicitly identified in this table
+ 窗口中未在此表中明确标识的任何区域
Window_WindowCanvas
- Canvas area
+ 画布区域
diff --git a/src/DocChinese/RTComments.Xml b/src/DocChinese/RTComments.Xml
index 912496a7e9..15259c95a6 100644
--- a/src/DocChinese/RTComments.Xml
+++ b/src/DocChinese/RTComments.Xml
@@ -202,7 +202,7 @@
- Constant
+ 常量
描述
-
@@ -338,7 +338,7 @@
- Constant
+ 常量
返回值
@@ -803,7 +803,7 @@
返回值
-
-
no parameter
+ 无参数
如果定义了范围,则返回 .T.(true),否则返回 .F.(false)。
-
diff --git a/src/DocChinese/Rdd.xml b/src/DocChinese/Rdd.xml
index f68aa2e524..d3df67ba9c 100644
--- a/src/DocChinese/Rdd.xml
+++ b/src/DocChinese/Rdd.xml
@@ -4375,7 +4375,7 @@
每个子数组由四个元素组成,包含以下顺序键信息:
- Constant
+ 常量
描述
-
diff --git a/src/DocChinese/Sql.Xml b/src/DocChinese/Sql.Xml
index b21be46631..fde0883f83 100644
--- a/src/DocChinese/Sql.Xml
+++ b/src/DocChinese/Sql.Xml
@@ -1281,7 +1281,7 @@
返回特殊列,即使它们可以具有NULL值。
- Level 1
+ 级别 1
diff --git a/src/DocChinese/VFPDocs.xml b/src/DocChinese/VFPDocs.xml
index c9d1e78f62..1dc7afd53c 100644
--- a/src/DocChinese/VFPDocs.xml
+++ b/src/DocChinese/VFPDocs.xml
@@ -614,7 +614,7 @@
0或省略
返回包含以下项目的两列数组,从第一列开始:
-
+
-
打印机名称。
@@ -628,7 +628,7 @@
1
返回包含以下项目的五列数组,从第一列开始:
-
+
-
打印机名称。
@@ -1912,11 +1912,28 @@
Buffering
N
- 1 – 行和表缓冲关闭。(默认)
- 2 – 悲观行缓冲开启。
- 3 – 乐观行缓冲开启。
- 4 – 悲观表缓冲开启。
- 5 – 乐观表缓冲开启。
+
+ -
+
1
+ 行和表缓冲关闭。(默认)
+
+ -
+
2
+ 悲观行缓冲开启。
+
+ -
+
3
+ 乐观行缓冲开启。
+
+ -
+
4
+ 悲观表缓冲开启。
+
+ -
+
5
+ 乐观表缓冲开启。
+
+
可读/写。
@@ -2077,18 +2094,56 @@
SourceName
N
- 1 – 数据源是本地SQL视图。
- 101 (1 + 100) - 游标由CursorFill方法创建。
- 201 (1 + 200) - 游标使用CursorAttach方法附加到CursorAdapter对象。
- 2 – 数据源是远程SQL视图。
- 102 (2 + 100) - 游标由CursorFill创建。
- 202 (2 + 200) - 游标使用CursorAttach附加到CursorAdapter对象。
- 3 – 数据源是表。
- 103 (3 + 100) - 游标由CursorFill创建。
- 203 (3 + 200) - 游标使用CursorAttach附加到CursorAdapter对象。
- 4 - 游标基于ADO记录集并附加到CursorAdapter对象。
- 104 (4 + 100) - 游标由CursorFill创建。
- 204 (4 + 200) - 游标使用CursorAttach附加到CursorAdapter对象。
+
+ -
+
1
+ 数据源是本地SQL视图。
+
+ -
+
101 (1 + 100)
+ 游标由CursorFill方法创建。
+
+ -
+
201 (1 + 200)
+ 游标使用CursorAttach方法附加到CursorAdapter对象。
+
+ -
+
2
+ 数据源是远程SQL视图。
+
+ -
+
102 (2 + 100)
+ 游标由CursorFill创建。
+
+ -
+
202 (2 + 200)
+ 游标使用CursorAttach附加到CursorAdapter对象。
+
+ -
+
3
+ 数据源是表。
+
+ -
+
103 (3 + 100)
+ 游标由CursorFill创建。
+
+ -
+
203 (3 + 200)
+ 游标使用CursorAttach附加到CursorAdapter对象。
+
+ -
+
4
+ 游标基于ADO记录集并附加到CursorAdapter对象。
+
+ -
+
104 (4 + 100)
+ 游标由CursorFill创建。
+
+ -
+
204 (4 + 200)
+ 游标使用CursorAttach附加到CursorAdapter对象。
+
+
只读。
@@ -2129,8 +2184,16 @@
UpdateType
N
- 1 – 指定用新数据更新旧数据。(默认)
- 2 – 指定通过删除旧数据并插入新数据来进行更新。
+
+ -
+
1
+ 指定用新数据更新旧数据。(默认)
+
+ -
+
2
+ 指定通过删除旧数据并插入新数据来进行更新。
+
+
可读/写。
@@ -2246,11 +2309,28 @@
-
Buffering
- 1 – 关闭行和表缓冲。记录锁定和数据写入与早期FoxPro版本相同。(默认)
- 2 – 开启悲观行缓冲。
- 3 – 开启乐观行缓冲。
- 4 – 开启悲观表缓冲。
- 5 – 开启乐观表缓冲。除了1(关闭)之外,所有缓冲模式都必须将Set multilocs设置为on。
+
+ -
+
1
+ 关闭行和表缓冲。记录锁定和数据写入与早期FoxPro版本相同。(默认)
+
+ -
+
2
+ 开启悲观行缓冲。
+
+ -
+
3
+ 开启乐观行缓冲。
+
+ -
+
4
+ 开启悲观表缓冲。
+
+ -
+
5
+ 开启乐观表缓冲。除了1(关闭)之外,所有缓冲模式都必须将Set multilocs设置为on。
+
+
-
@@ -2386,8 +2466,16 @@
-
UpdateType
- 1 – 用新数据更新旧数据。(默认)
- 2 – 通过删除旧数据并插入新数据来更新。
+
+ -
+
1
+ 用新数据更新旧数据。(默认)
+
+ -
+
2
+ 通过删除旧数据并插入新数据来更新。
+
+
-
@@ -3571,8 +3659,16 @@
N
视图源。SourceType可能具有以下值:
- 1 - 视图使用本地表。
- 2 - 视图使用远程表。
+
+ -
+
1
+ 视图使用本地表。
+
+ -
+
2
+ 视图使用远程表。
+
+
只读。
@@ -7509,35 +7605,20 @@
- Marks a cursor as a result set in the current data session.
- Only one cursor per data session can be marked. When marking a new cursor,
- SetResultSet( ) clears the marker from any previously marked cursor.
+ 将游标标记为当前数据会话中的结果集。
每个数据会话中只能标记一个游标。标记新游标时,SetResultSet( ) 会清除之前已标记游标上的标记。
- Specifies a work area number.
- Or
- Specifies the alias of the cursor you want to mark.
+ 指定工作区编号。
或
指定要标记的游标的别名。
- Numeric. SetResultSet( ) returns the number of the work area of the previously marked cursor in the current data session or zero (0)
- if no cursor is marked in the current data session.
+ 数值类型。SetResultSet( ) 返回当前数据会话中先前已标记游标的工作区编号;如果当前数据会话中没有标记任何游标,则返回零 (0)。
- SetResultSet( ) is supported in X# and the X# OLE DB Provider. You can use SetResultSet( ) in a database container (DBC)
- stored procedure or send it to the X# OLE DB Provider, assuming that the cursor has been previously opened by the OLE DB Provider.
- For example, suppose a previous command opens a cursor named MyCursor in the OLE DB Provider. The following line of code retrieves an
- ADO RecordSet for the cursor, MyCursor:
+ X# 和 X# OLE DB Provider 支持 SetResultSet( )。您可以在数据库容器 (DBC) 存储过程中使用 SetResultSet( ),或将其发送到 X# OLE DB Provider,前提是该游标之前已由 OLE DB Provider 打开。例如,假设先前的某条命令在 OLE DB Provider 中打开了名为 MyCursor 的游标。下面这行代码将为游标 MyCursor 检索一个 ADO RecordSet:
oRecordSet = oConn.Execute("SetResultSet('MyCursor')")
- By using SetResultSet( ) to mark a cursor or table opened by the X# OLE DB Provider, you can retrieve a rowset created from the
- table or cursor from a database container (DBC) stored procedure. When the OLE DB Provider completes command execution, it creates a
- rowset from the marked cursor, if it exists, then clears the marker flag from the cursor.
- In this scenario, the OLE DB Provider disregards all other return values. For example, if a stored procedure contains a RETURN
- Value statement and a marked cursor, the OLE DB Provider does not return the value. Instead, it returns the marked cursor as a rowset
- to the calling application. When the rowset closes, the cursor also closes.
- However, even though the OLE DB Provider disregards all return values when a marked cursor exists, you can use SetResultSet( )
- with the RETURN command. For example:
+ 通过使用 SetResultSet( ) 标记由 X# OLE DB Provider 打开的游标或表,您可以从数据库容器 (DBC) 存储过程中检索由该表或游标创建的行集。当 OLE DB Provider 完成命令执行时,如果存在已标记的游标,它会根据该游标创建一个行集,然后清除该游标上的标记。在这种情况下,OLE DB Provider 会忽略所有其他返回值。例如,如果存储过程包含 RETURN Value 语句和一个已标记的游标,OLE DB Provider 不会返回该值,而是将已标记的游标作为行集返回给调用应用程序。行集关闭时,游标也随之关闭。不过,即使存在已标记的游标时 OLE DB Provider 会忽略所有返回值,您仍然可以将 SetResultSet( ) 与 RETURN 命令一起使用。例如:
RETURN SetResultSet("MyCursor")
- This statement creates and returns a rowset from the marked cursor, not the return value from SetResultSet( ).
+ 此语句根据已标记的游标创建并返回一个行集,而不是返回 SetResultSet( ) 的返回值。
@@ -8555,7 +8636,7 @@
如果eExpression是一个数组,将评估数组中的第一个元素。
-
+
lNullDataType
描述
@@ -8753,7 +8834,7 @@
-
- Character、Character (Binary)、Memo、Memo (Binary)
+ 字符类型、字符类型 (二进制)、备注类型、备注类型 (二进制)
接受任何数据,但截断超出Character列长度的任何数据。
@@ -8809,7 +8890,7 @@
-
- Numeric、Float
+ 数值类型、浮点类型
接受有或没有小数的数值数据,但根据X#规则截断这些类型接受范围之外的数字
diff --git a/src/DocChinese/VOSDK.Xml b/src/DocChinese/VOSDK.Xml
index 1c17a338f1..f202cbd843 100644
--- a/src/DocChinese/VOSDK.Xml
+++ b/src/DocChinese/VOSDK.Xml
@@ -81,7 +81,7 @@
此 Notify() 方法是链接浏览器和服务器之间自动通知的核心, 允许任何窗口更改字段值或发起移动,并确保所有 客户端窗口反映更改。
任何注册为服务器客户端的类都必须智能地响应 Notify 消息。
与定义的常量一样,您永远不应依赖常量的实际值——它们不会
必然保持不变。然而,常量确实保持其顺序:
-
+
常量
描述
diff --git a/src/DocChinese/VfpRuntimeDocs.xml b/src/DocChinese/VfpRuntimeDocs.xml
index 2b5a71af68..cd6f3946cd 100644
--- a/src/DocChinese/VfpRuntimeDocs.xml
+++ b/src/DocChinese/VfpRuntimeDocs.xml
@@ -318,93 +318,70 @@
- Returns an array containing the names of functions loaded by DECLARE DLLs.
+ 返回一个数组,其中包含由 DECLARE DLLs 加载的函数的名称。
- Specifies the name of the array. If the array you specify doesn't exist, X# automatically creates the array. If the array exists and isn't large enough to contain all the functions loaded by DECLARE DLLS, X# automatically increases the size of the array to accommodate the information. If the array is larger than necessary, X# truncates the array. If no DLL functions have been declared, the array is not created, and an existing array is not modified.
+ 指定数组的名称。如果指定的数组不存在,X# 会自动创建该数组。如果数组已存在但不足以容纳 DECLARE DLLS 加载的所有函数,X# 会自动增大数组以容纳这些信息。如果数组大于所需大小,X# 会截断该数组。如果没有声明任何 DLL 函数,则不会创建数组,现有数组也不会被修改。
- Numeric
+ 数值类型
- The numeric value returned by the ADLLS function specifies the number of DLL loaded functions. If no alias is provided, the 2nd element returns the same value as the 1st element (function name).
- The array created by the ADLLS function has the following format:
- 1
- Function Name
- Character
- 2
- Function Alias
- Character
- 3
- Library Name
- Character
- For details about how to declare functions, see DECLARE - DLL Command.
+ ADLLS 函数返回的数值指定已加载的 DLL 函数的数量。如果未提供别名,则第 2 个元素返回与第 1 个元素(函数名称)相同的值。ADLLS 函数创建的数组具有以下格式:
+
+ 1 函数名称 字符类型
+ 2 函数别名 字符类型
+ 3 库名称 字符类型
+
+有关如何声明函数的详细信息,请参见 DECLARE - DLL 命令。
- Retrieves the dock state of any dockable form, Integrated Development Environment (IDE) window, or toolbar. For forms only, you can use the GetDockState Method. ADOCKSTATE( ) is available in the run time.
+ 检索任何可停靠窗体、集成开发环境 (IDE) 窗口或工具栏的停靠状态。仅对于窗体,您也可以使用 GetDockState 方法。ADOCKSTATE( ) 在运行时中可用。
- Specifies an array with one or more rows containing the dock state of dockable items.
- Both system and user-defined toolbars can appear in the array. A form appears in the array only if the form's Dockable property is set to a value greater than 0.
- The following table illustrates the information that the array contains.
- 1
- Name of the form, IDE window, or toolbar.
- For user-defined toolbars, the first element contains the Caption property value for that toolbar.
- 2
- Dock state:
- 1 - Docked
- 0 - Undocked
- 3
- Dock position.
- For form and toolbar values, see DockPosition Property. For windows, see DOCK Command.
- Target object that specified object is docked with.
- This element does not apply to toolbars unless they are docked to the main X# window. For toolbars or windows docked to the main X# window, the fourth element contains the main X# window name, which you can retrieve using the _VFP Caption property. If a window or toolbar is not docked, the fourth element contains an empty string.
- If a toolbar appears between the X# desktop and a window docked to the X# desktop, the fourth element contains the name of the toolbar.
- Object reference to docking form or toolbar.
- Applies only when docking user-defined forms or toolbars; otherwise, this element contains an empty string (IDE window).
- Object reference to the target object if it is a user-defined form. If the target object is the main X# window, this element contains an object reference to the _SCREEN system variable. Otherwise, this element contains an empty string (IDE window).
+ 指定一个数组,其中包含一行或多行可停靠项的停靠状态。系统工具栏和用户定义的工具栏都可以出现在该数组中。只有当窗体的 Dockable 属性设置为大于 0 的值时,窗体才会出现在数组中。下表说明了数组所包含的信息。
+
+ 1 窗体、IDE 窗口或工具栏的名称。
对于用户定义的工具栏,第一个元素包含该工具栏的 Caption 属性值。
+ 2 停靠状态:
+
+ 1 已停靠
+ 0 未停靠
+
+ 3 停靠位置。
对于窗体和工具栏的取值,请参见 DockPosition 属性。对于窗口,请参见 DOCK 命令。
+ 4 指定对象所停靠到的目标对象。
除非工具栏停靠到 X# 主窗口,否则此元素不适用于工具栏。对于停靠到 X# 主窗口的工具栏或窗口,第四个元素包含 X# 主窗口的名称,您可以使用 _VFP Caption 属性检索该名称。如果窗口或工具栏未停靠,则第四个元素包含空字符串。
如果某个工具栏位于 X# 桌面与停靠到 X# 桌面的窗口之间,则第四个元素包含该工具栏的名称。
+ 5 指向进行停靠的窗体或工具栏的对象引用。
仅在停靠用户定义的窗体或工具栏时适用;否则,此元素包含空字符串(IDE 窗口)。
+ 6 如果目标对象是用户定义的窗体,则为指向目标对象的对象引用。如果目标对象是 X# 主窗口,则此元素包含指向 _SCREEN 系统变量的对象引用。否则,此元素包含空字符串(IDE 窗口)。
+
- Specifies one or more items for which you want ADOCKSTATE( ) to return dock state information.
- The following table lists the values for nType.
- 0
- Return all or no windows. (Default)
- 1
- Return only IDE windows.
- 2
- Return only toolbars.
- 3
- Return only user-defined forms.
+ 指定希望 ADOCKSTATE( ) 返回其停靠状态信息的一个或多个项。下表列出了 nType 的取值。
+
+ 0 返回所有窗口或不返回窗口。(默认值)
+ 1 仅返回 IDE 窗口。
+ 2 仅返回工具栏。
+ 3 仅返回用户定义的窗体。
+
- Specifies the number of elements to return in the array.
- The following table lists the values for nExtended.
- 0
- Return a four-element array for windows and toolbars.
- 1
- Return a six-element array for forms.
+ 指定数组中要返回的元素数量。下表列出了 nExtended 的取值。
+
+ 0 为窗口和工具栏返回一个四元素数组。
+ 1 为窗体返回一个六元素数组。
+
- Numeric data type. ADOCKSTATE( ) returns the number of rows populated or 0 if none found.
+ 数值类型。ADOCKSTATE( ) 返回已填充的行数;如果未找到任何项,则返回 0。
- For tab-docked windows, the leftmost window is the anchor window and contains details about how the entire container is docked. X# traverses the windows from left to right. For link-docked windows, the upper left window in a link-docked container contains details about how the entire container is docked.
- The following rules determine docking order:
- X# traverses the link-docked container beginning with upper leftmost window.
- X# traverses windows from top to bottom, from left to right. A link-docked container might consist of multiple inner containers. Thus, the ordering of windows in the ADOCKSTATE( ) array might appear different.
- The position contained in the third element of the array is relative to the window referenced in first element of the array.
- X# traverses all link-docked windows first and tab-docked windows second. Essentially, X# makes two passes through a linked container. X# includes only the leftmost tab-docked window in the first pass for link-docked windows.
- X# traverses a tab-docked container from left to right.
- If the third element in the array is set to -1 (not docked), the container is not docked. If the container is docked to the desktop, the third element in the array contains the position in which the container is docked to the X# desktop as referenced in the fourth element of the array.
- For example, the following code creates an array, opens and docks several windows, and produces an array as shown:
+ 对于选项卡停靠的窗口,最左侧的窗口是锚点窗口,包含有关整个容器如何停靠的详细信息。X# 从左到右遍历这些窗口。对于链接停靠的窗口,链接停靠容器中左上角的窗口包含有关整个容器如何停靠的详细信息。下列规则决定停靠顺序:X# 从最左上角的窗口开始遍历链接停靠的容器。X# 按从上到下、从左到右的顺序遍历窗口。一个链接停靠的容器可能由多个内部容器组成,因此 ADOCKSTATE( ) 数组中窗口的排列顺序可能看起来有所不同。数组第三个元素中包含的位置是相对于数组第一个元素所引用的窗口而言的。X# 先遍历所有链接停靠的窗口,再遍历选项卡停靠的窗口。本质上,X# 会对链接容器进行两次遍历。在对链接停靠窗口的第一次遍历中,X# 只包含最左侧的选项卡停靠窗口。X# 从左到右遍历选项卡停靠的容器。如果数组中的第三个元素设置为 -1(未停靠),则该容器未停靠。如果容器停靠到桌面,则数组中的第三个元素包含该容器停靠到 X# 桌面的位置,该桌面由数组的第四个元素引用。例如,下面的代码创建一个数组,打开并停靠若干窗口,并生成如下所示的数组:
CLEAR ALL
PUBLIC aa
@@ -430,47 +407,20 @@
DOCK WINDOW Locals POSITION 3 WINDOW Command
ADOCKSTATE(aa,1)
- The resulting array appears as follows:
- 1
- Trace
- 1
- -1
-
- 2
- Properties
- 1
- 3
- Trace
- 3
- Watch
- 1
- 2
- Trace
- 4
- Locals
- 1
- 3
- Watch
- 5
- View
- 1
- 2
- Watch
- 6
- Document View
- 1
- 3
- View
- 7
- Command
- 1
- 4
- Watch
- X# displays docking information for debugger windows in the debugger. If a window is undocked, X# shows the name, dock state (0) and position (-1). If a window is docked, X# shows only the name, dock state (1), position, and window ("X# Debugger").
- Historically, in prior versions of X#, the Data Session window has always been referred to as the View window. Additionally, language used to control this window, such as HIDE WINDOW, ACTIVATE WINDOW, WONTOP( ), also refers to this window as the View window. X# continues to refer to the View window for the ADOCKSTATE( ) function.
+ 生成的数组如下所示:
+
+ 1 Trace 1 -1
+ 2 Properties 1 3 Trace
+ 3 Watch 1 2 Trace
+ 4 Locals 1 3 Watch
+ 5 View 1 2 Watch
+ 6 文档视图 1 3 View
+ 7 Command 1 4 Watch
+
+X# 在调试器中显示调试器窗口的停靠信息。如果窗口未停靠,X# 显示名称、停靠状态 (0) 和位置 (-1)。如果窗口已停靠,X# 仅显示名称、停靠状态 (1)、位置和窗口("X# Debugger")。
在 X# 的早期版本中,数据会话窗口一直被称为 View 窗口。此外,用于控制此窗口的语言,例如 HIDE WINDOW、ACTIVATE WINDOW、WONTOP( ),也将此窗口称为 View 窗口。X# 在 ADOCKSTATE( ) 函数中继续使用 View 窗口这一称呼。
- The following example shows the return results of ADOCKSTATE( ) when no toolbars or windows have been previously docked, for example, after deleting the FoxUser resource files or when X# is newly installed. Make sure the Command window is open.
+ 下面的示例显示了在之前没有停靠任何工具栏或窗口时(例如,删除 FoxUser 资源文件之后,或 X# 刚刚安装时)ADOCKSTATE( ) 的返回结果。请确保 Command 窗口已打开。
CLEAR
dockNum = ADOCKSTATE(dockState)
@@ -483,7 +433,7 @@
&& Standard toolbar is docked to the Microsoft
&& X# desktop.
- The following example shows how to use the DOCK command to dock the Command window to the X# desktop window and use ADOCKSTATE( ) to obtain the dock state of the Command window. First, make sure the Command window is open. After docking the Command window, you can see that the Standard toolbar and Command windows are docked to the X# desktop window. The position of the toolbars or windows in the array returned by ADOCKSTATE( ) can vary depending on the order in which the toolbars or windows are docked.
+ 下面的示例演示如何使用 DOCK 命令将 Command 窗口停靠到 X# 桌面窗口,并使用 ADOCKSTATE( ) 获取 Command 窗口的停靠状态。首先,请确保 Command 窗口已打开。停靠 Command 窗口之后,您可以看到 Standard 工具栏和 Command 窗口已停靠到 X# 桌面窗口。ADOCKSTATE( ) 返回的数组中工具栏或窗口的位置可能因工具栏或窗口的停靠顺序而异。
CLEAR
DOCK WINDOW Command POSITION 0
@@ -530,64 +480,52 @@
- Creates a variable array containing information about the most recent X#, OLE, or ODBC error.
+ 创建一个变量数组,其中包含有关最近一次 X#、OLE 或 ODBC 错误的信息。
- Specifies the name of the array for AERROR( ) to create.
-
-
- Numeric. AERROR( ) returns the number of rows in the array.
-
-
-
- AERROR( ) creates an array with seven columns containing information about the error. The type of error that occurred determines the number of rows in the array.
- If no error occurred, AERROR( ) does not create the array.
- When a X# error occurs, the array contains one row. The following table describes the contents of each element.
- 1
- Numeric. The number of the error. Identical to the value returned by ERROR( ).
- 2
- Character. The text of the error message. Identical to the value returned by MESSAGE( ).
- 3
- The null value. However, if the error has an additional error parameter, contains the text of the error parameter. Almost identical to the value returned by SYS(2018), the difference being that AERROR( ) returns mixed case but SYS(2018) returns all uppercase.
- 4
- The null value. However, as appropriate, contains the number of the work area in which the error occurred.
- 5
- The null value. However, if a trigger failed (error 1539), contains one of the following numeric values:1 – Insert trigger failed.2 – Update trigger failed.3 – Delete trigger failed.
- 6
- The null value.
- 7
- The null value.
- When OLE errors numbered 1427 or 1429 occur, the array contains one row. The following table describes the contents of each element.
- 1
- Numeric. Contains 1427 or 1429.
- 2
- Character. The text of the X# error message.
- 3
- Character. The text of the OLE error message.
- 4
- Character. The application name (for example, Microsoft Excel).
- 5
- The null value or Character. Contains the name of the application's Help file where more information about the error can be found if the information is available from the application; otherwise contains the null value.
- 6
- The null value or Character. Contains the Help context ID for the appropriate Help topic if the information is available from the application; otherwise contains the null value.
- 7
- Numeric. An OLE 2.0 exception number.
- When an ODBC error numbered 1526 occurs, the array contains one or more rows, one row for each ODBC error. The following table describes the contents of each element.
- 1
- Numeric. Contains 1526.
- 2
- Character. The text of the error message.
- 3
- Character. The text of the ODBC error message.
- 4
- Character. The current ODBC SQL state.
- 5
- Numeric. The error number from the ODBC data source.
- 6
- Numeric. The ODBC connection handle.
- 7
- The null value.
+ 指定供 AERROR( ) 创建的数组的名称。
+
+
+ 数值类型。AERROR( ) 返回数组中的行数。
+
+
+
+ AERROR( ) 创建一个包含七列的数组,其中包含有关错误的信息。发生的错误类型决定数组中的行数。
如果没有发生错误,AERROR( ) 不会创建数组。
发生 X# 错误时,数组包含一行。下表描述了每个元素的内容。
+
+ 1 数值类型。错误编号。与 ERROR( ) 返回的值相同。
+ 2 字符类型。错误消息的文本。与 MESSAGE( ) 返回的值相同。
+ 3 空值。但是,如果错误带有附加的错误参数,则包含该错误参数的文本。几乎与 SYS(2018) 返回的值相同,区别在于 AERROR( ) 返回大小写混合的文本,而 SYS(2018) 返回全部大写的文本。
+ 4 空值。但是,视情况包含发生错误的工作区的编号。
+ 5 空值。但是,如果触发器失败(错误 1539),则包含下列数值之一:
+
+ 1 插入触发器失败。
+ 2 更新触发器失败。
+ 3 删除触发器失败。
+
+ 6 空值。
+ 7 空值。
+
+发生编号为 1427 或 1429 的 OLE 错误时,数组包含一行。下表描述了每个元素的内容。
+
+ 1 数值类型。包含 1427 或 1429。
+ 2 字符类型。X# 错误消息的文本。
+ 3 字符类型。OLE 错误消息的文本。
+ 4 字符类型。应用程序名称(例如 Microsoft Excel)。
+ 5 空值或字符类型。如果应用程序提供了相关信息,则包含该应用程序的帮助文件名称,可在其中找到有关该错误的更多信息;否则包含空值。
+ 6 空值或字符类型。如果应用程序提供了相关信息,则包含相应帮助主题的帮助上下文 ID;否则包含空值。
+ 7 数值类型。OLE 2.0 异常编号。
+
+发生编号为 1526 的 ODBC 错误时,数组包含一行或多行,每个 ODBC 错误占一行。下表描述了每个元素的内容。
+
+ 1 数值类型。包含 1526。
+ 2 字符类型。错误消息的文本。
+ 3 字符类型。ODBC 错误消息的文本。
+ 4 字符类型。当前的 ODBC SQL 状态。
+ 5 数值类型。来自 ODBC 数据源的错误编号。
+ 6 数值类型。ODBC 连接句柄。
+ 7 空值。
+
@@ -606,61 +544,51 @@
- You can use the AEVENTS( ) function to retrieve the number of existing event bindings.
+ 您可以使用 AEVENTS( ) 函数检索现有事件绑定的数量。
- Specifies the name of the array that contains the results of AEVENTS( ).
- 0
- Specifies that AEVENTS( ) returns a three-element array containing an object reference to the current event source, the name of the triggered event, and how the event was triggered.
- 1
- Event source
- Object reference
- 2
- String
- 3
- Event type, or how event was raised.
- 0 - System
- 1 - RAISEEVENT( ) function
- 2 - Method call
- The third array element indicates how an event was triggered. If the event is a property, this value can be 1 or 2. The value is 2 if the property is set or assigned.
- 1
- Specifies that AEVENTS( ) returns a four-column array containing information about Windows Message (Win Msg) events.
- The array contains one row for each binding. Bindings are created with the BINDEVENT( ) Function.
- The following table describes the contents of each column in the array.
- hWnd
- Integer
- Window Message
- Reference of handler
- Handler delegate
+ 指定包含 AEVENTS( ) 结果的数组的名称。
+
+ 0 指定 AEVENTS( ) 返回一个三元素数组,其中包含指向当前事件源的对象引用、被触发事件的名称,以及事件的触发方式。
+
+ 1 事件源 对象引用
+ 2 字符串
+ 3 事件类型,即事件的引发方式。
+
+ 0 系统
+ 1 RAISEEVENT( ) 函数
+ 2 方法调用
+
+
+ 第三个数组元素指示事件的触发方式。如果事件是属性,则此值可以为 1 或 2。如果属性被设置或赋值,则值为 2。
+ 1 指定 AEVENTS( ) 返回一个四列数组,其中包含有关 Windows 消息 (Win Msg) 事件的信息。
数组为每个绑定包含一行。绑定通过 BINDEVENT( ) 函数创建。
下表描述了数组中每一列的内容。
+
+ hWnd 整数类型
+ 窗口消息
+ 处理程序的引用
+ 处理程序委托
+
+
- Specifies an object reference. If you specify an object reference, AEVENTS( ) returns a five-column array that contains the events raised and the delegate methods for oEventObject. Each row in ArrayName represents a binding. The following table describes the information in each of the five columns.
- 1
- .T. if second element is the event source
- .F. if second element is the event handler
- Logical
- 2
- Event source if you pass the event handler to oEventObject; otherwise, event handler if you pass the event source to oEventObject.
- Object reference
- 3
- String
- 4
- Delegate method
- 5
- BINDEVENT( ) flags
- Integer
- When you pass oEventObject, the number of bindings returned by AEVENTS( ) should equal the number of unbound events returned by the UNBINDEVENTS( ) function when passing only the oEventObject parameter.
+ 指定一个对象引用。如果指定了对象引用,AEVENTS( ) 返回一个五列数组,其中包含针对 oEventObject 引发的事件及委托方法。ArrayName 中的每一行表示一个绑定。下表描述了五列中每一列的信息。
+
+ 1 如果第二个元素是事件源,则为 .T.;如果第二个元素是事件处理程序,则为 .F. 逻辑类型
+ 2 如果将事件处理程序传递给 oEventObject,则为事件源;否则,如果将事件源传递给 oEventObject,则为事件处理程序。 对象引用
+ 3 字符串
+ 4 委托方法
+ 5 BINDEVENT( ) 标志 整数类型
+
+传递 oEventObject 时,AEVENTS( ) 返回的绑定数量应等于仅传递 oEventObject 参数时 UNBINDEVENTS( ) 函数返回的已解除绑定事件的数量。
- Numeric. AEVENTS( ) returns the number of rows in the specified array. Typically, the number represents the number of event bindings. However, if you pass zero (0), then AEVENTS( ) returns 3.
+ 数值类型。AEVENTS( ) 返回指定数组中的行数。通常,该数字表示事件绑定的数量。但是,如果传递零 (0),则 AEVENTS( ) 返回 3。
- If AEVENTS( ) returns 0, and the array does not exist, X# does not create the array. X# changes or alters an existing array only if valid results are returned. The array remains unchanged under the following conditions:
- No events exist.
- You specify a value of 0 as the second parameter, and AEVENTS( ) does not appear within an event or oEventObject has no bindings.
+ 如果 AEVENTS( ) 返回 0 且数组不存在,X# 不会创建该数组。只有在返回有效结果时,X# 才会更改或修改现有数组。在下列情况下,数组保持不变:不存在任何事件。您将第二个参数指定为 0,且 AEVENTS( ) 未出现在事件内,或者 oEventObject 没有绑定。
@@ -709,85 +637,84 @@
- Retrieves and stores information about the structure of the table in a specified work area, specified by a table alias, or in the currently selected work area in an array and returns the number of fields in the table.
+ 将指定工作区、由表别名指定的表或当前选定工作区中的表的结构信息检索并存储到数组中,并返回表中的字段数。
- Specifies an array to store information about the table structure.
- If the array you specify does not exist, X# automatically creates it. If the array exists and is not large enough to contain all the information returned by AFIELDS( ), the size of the array is automatically increased to accommodate the information.
+ 指定用于存储表结构信息的数组。如果指定的数组不存在,X# 会自动创建它。如果数组已存在但不足以容纳 AFIELDS( ) 返回的所有信息,则数组大小会自动增大以容纳这些信息。
- Specifies the work area of the table.
+ 指定表所在的工作区。
- Specifies a table alias.
- If you omit nWorkArea and cTableAlias, AFIELDS( ) retrieves information for the table in the currently selected work area.
+ 指定表别名。如果省略 nWorkArea 和 cTableAlias,AFIELDS( ) 将检索当前选定工作区中的表的信息。
- Numeric data type. AFIELDS( ) returns the number of fields in the table. The array contains 18 columns and has the same number of rows as fields in the table.
- The following table describes the content of each column in the first row of the array and the data type of the information stored in each column. Values for table-specific properties in columns 10 through 16 only appear in the first row of the array. One row is created for each field in the table.
+ 数值类型。AFIELDS( ) 返回表中的字段数。该数组包含 18 列,行数与表中的字段数相同。下表描述了数组第一行中每一列的内容以及每列中所存储信息的数据类型。第 10 列到第 16 列中特定于表的属性值仅出现在数组的第一行中。表中的每个字段对应创建一行。
-
1
- Field name
+ 字段名
- Character
+ 字符类型
-
2
- Field type:
- C = Character
- Y = Currency
- D = Date
- T = DateTime
- B = Double
- F = Float
- G = General
- I = Integer
- L = Logical
- M = Memo
- N = Numeric
- Q = Varbinary
- V = Varchar and Varchar (Binary)
- W = Blob
+ 字段类型:
+
+ C 字符类型
+ Y 货币类型
+ D 日期类型
+ T 日期时间类型
+ B 双精度类型
+ F 浮点类型
+ G 通用类型
+ I 整数类型
+ L 逻辑类型
+ M 备注类型
+ N 数值类型
+ Q Varbinary
+ V Varchar 和 Varchar (Binary)
+ W Blob
+
- Character
+ 字符类型
-
3
- Field width
+ 字段宽度
- Numeric
+ 数值类型
-
4
- Decimal places
+ 小数位数
- Numeric
+ 数值类型
-
5
- Null values allowed
+ 允许空值
- Logical
+ 逻辑类型
-
@@ -795,10 +722,10 @@
6
- Code page translation not allowed
+ 不允许代码页转换
- Logical
+ 逻辑类型
-
@@ -806,10 +733,10 @@
7
- Field validation expression
+ 字段验证表达式
- Character
+ 字符类型
-
@@ -817,10 +744,10 @@
8
- Field validation text
+ 字段验证文本
- Character
+ 字符类型
-
@@ -828,10 +755,10 @@
9
- Field default value
+ 字段默认值
- Character
+ 字符类型
-
@@ -839,10 +766,10 @@
10
- Table validation expression
+ 表验证表达式
- Character
+ 字符类型
-
@@ -850,10 +777,10 @@
11
- Table validation text
+ 表验证文本
- Character
+ 字符类型
-
@@ -861,10 +788,10 @@
12
- Long table name
+ 长表名
- Character
+ 字符类型
-
@@ -872,10 +799,10 @@
13
- Insert trigger expression
+ 插入触发器表达式
- Character
+ 字符类型
-
@@ -883,10 +810,10 @@
14
- Update trigger expression
+ 更新触发器表达式
- Character
+ 字符类型
-
@@ -894,10 +821,10 @@
15
- Delete trigger expression
+ 删除触发器表达式
- Character
+ 字符类型
-
@@ -905,10 +832,10 @@
16
- Table comment
+ 表注释
- Character
+ 字符类型
-
@@ -916,10 +843,10 @@
17
- NextValue for autoincrementing
+ 自动递增的 NextValue
- Numeric
+ 数值类型
-
@@ -927,17 +854,16 @@
18
- Step for autoincrementing
+ 自动递增的步长 (Step)
- Numeric
+ 数值类型
- If the fields in the table use autoincrementing, the Step value is greater than 0.
- You can use COPY STRUCTURE EXTENDED to place similar information into a table instead of an array.
+ 如果表中的字段使用自动递增,则 Step 值大于 0。您可以使用 COPY STRUCTURE EXTENDED 将类似信息放入表而不是数组中。
@@ -954,61 +880,37 @@
- Places information about available fonts, such as their names, into an array.
- You can also use AFONT( ) to determine available font sizes or if a font is scalable. To display a dialog box containing available fonts, font sizes, and styles, use the GETFONT( ) function. For more information, see GETFONT( ) Function.
+ 将有关可用字体的信息(例如字体名称)放入数组。您还可以使用 AFONT( ) 确定可用的字体大小,或某种字体是否可缩放。若要显示包含可用字体、字体大小和样式的对话框,请使用 GETFONT( ) 函数。有关更多信息,请参见 GETFONT( ) 函数。
- Specifies the variable array into which the names of available fonts are placed. If the array is not large enough to contain all the fonts, X# automatically increases the size of the array. If you specify an existing two-dimensional array, X# changes the array to a one-dimensional array.
+ 指定用于存放可用字体名称的变量数组。如果数组不足以容纳所有字体,X# 会自动增大数组。如果指定一个现有的二维数组,X# 会将其更改为一维数组。
- Specifies a font for which information is placed into the array.
- If the font you specify supports only discrete font sizes (8-point, 10-point, ...), the font sizes are stored to the array, and AFONT( ) returns True (.T.). If the font you specify in cFontName is scalable (supports fractional font size values), the array has a single element containing –1, and AFONT( ) returns True (.T.).
- If the font you specify is not available, the array is not created, and AFONT( ) returns False (.F.).
+ 指定要将其信息放入数组的字体。如果指定的字体仅支持离散的字体大小(8 磅、10 磅……),则这些字体大小会存储到数组中,并且 AFONT( ) 返回 True (.T.)。如果 cFontName 中指定的字体是可缩放的(支持小数字体大小值),则数组包含单个元素 –1,并且 AFONT( ) 返回 True (.T.)。如果指定的字体不可用,则不会创建数组,并且 AFONT( ) 返回 False (.F.)。
- Specifies a size for the font specified in cFontName.
- If the font size nFontSize is available for the font specified in cFontName, the array has a single element containing a True (.T.) value, and AFONT( ) returns True (.T.). If the font size is not available for the specified font, the array is not created, and AFONT( ) returns False (.F.).
+ 指定 cFontName 中所指定字体的字体大小。如果字体大小 nFontSize 对于 cFontName 中指定的字体可用,则数组包含单个元素,其值为 True (.T.),并且 AFONT( ) 返回 True (.T.)。如果该字体大小对于指定的字体不可用,则不会创建数组,并且 AFONT( ) 返回 False (.F.)。
- Specifies a character set for the font specified in cFontName. If the font character set specified is available for the font specified in cFontName, the array has a single element containing a True (.T.) value, and AFONT( ) returns True (.T.). If the font character set is not available for the specified font, the array is not created, and AFONT( ) returns False (.F.).
+ 指定 cFontName 中所指定字体的字符集。如果指定的字体字符集对于 cFontName 中指定的字体可用,则数组包含单个元素,其值为 True (.T.),并且 AFONT( ) 返回 True (.T.)。如果该字体字符集对于指定的字体不可用,则不会创建数组,并且 AFONT( ) 返回 False (.F.)。
- Controls whether the third parameter passed is treated as the font size or font character set.
- The following table describes behavior for various nFlags values specified.
- Omitted or 0 for the first bit
- Third parameter is treated as a font size value.
- If third parameter is -1, array is updated with all available font sizes for the font specified in cFontName for nonproportional fonts, such as MS Sans Serif, and AFONT( ) returns True (.T.). This behavior in X# 8.0 and later is equivalent to passing only the first two parameters.
- In versions prior to X# 8.0, if you specified any negative or positive font size for a non-proportional font, AFONT( ) returned False (.F.).
- If the third parameter passed is 0, for nonproportional fonts, AFONT( ) returns False (.F.) for X# 8.0 and later. However, the behavior for proportional fonts such as TrueType or OpenType (Arial) has not changed.
- Third parameter is treated as a font character set. Array is populated with character sets available for the specified font.
- If the third parameter passed is -1, array is updated with all available font character sets for the font specified in cFontName.
+ 控制所传递的第三个参数是被视为字体大小还是字体字符集。下表描述了指定各种 nFlags 值时的行为。省略或第一位为 0 第三个参数被视为字体大小值。如果第三个参数为 -1,则对于非比例字体(如 MS Sans Serif),数组会更新为 cFontName 中指定字体的所有可用字体大小,并且 AFONT( ) 返回 True (.T.)。X# 8.0 及更高版本中的这一行为等同于仅传递前两个参数。在 X# 8.0 之前的版本中,如果为非比例字体指定任何负数或正数字体大小,AFONT( ) 会返回 False (.F.)。如果传递的第三个参数为 0,则对于非比例字体,在 X# 8.0 及更高版本中 AFONT( ) 返回 False (.F.)。但是,TrueType 或 OpenType (Arial) 等比例字体的行为没有改变。第三个参数被视为字体字符集。数组中填充指定字体可用的字符集。如果传递的第三个参数为 -1,则数组会更新为 cFontName 中指定字体的所有可用字体字符集。
- Logical data type. AFONT( ) returns True (.T.) if array is successfully created. Otherwise, AFONT( ) returns False (.F.).
+ 逻辑类型。如果数组创建成功,AFONT( ) 返回 True (.T.);否则,AFONT( ) 返回 False (.F.)。
- If only ArrayName was passed in versions earlier than X# 8.0, the array populated in AFONT( ) included extra fonts that were really part of a single font family. For example, the array might have included the following Arial fonts under X# 7.0:
- Arial
- Arial Baltic
- Arial Black
- Arial CE
- Arial CYR
- Arial Greek
- Arial Narrow
- Arial Tur
- Many of these fonts are not included in a standard Font Picker dialog box such as the GETFONT( ) function. In this version of X#, the array in AFONT( ) excludes these extra fonts. For example, the array only includes the following fonts:
- Arial
- Arial Baltic
- Arial Black
+ 在 X# 8.0 之前的版本中,如果只传递了 ArrayName,则 AFONT( ) 填充的数组会包含一些实际上属于同一字体系列的额外字体。例如,在 X# 7.0 下,该数组可能包含以下 Arial 字体:
Arial
Arial Baltic
Arial Black
Arial CE
Arial CYR
Arial Greek
Arial Narrow
Arial Tur
其中许多字体并不会出现在标准的字体选择对话框中,例如 GETFONT( ) 函数。在此版本的 X# 中,AFONT( ) 的数组排除了这些额外的字体。例如,数组中仅包含以下字体:
Arial
Arial Baltic
Arial Black
@@ -1028,51 +930,46 @@
- Displays class libraries in the Open dialog box and creates an array containing the name of the class library and class chosen.
+ 在打开对话框中显示类库,并创建一个包含所选类库名称和类名称的数组。
- Specifies the name of the array in which the names of the class library and class are placed. The following table lists the contents of each element of the array created when you chose a class.
- 1
- File name of the class library chosen.
- 2
- Name of the class chosen.
+ 指定用于存放类库名称和类名称的数组的名称。下表列出了选择类后所创建数组中各元素的内容。
+
+ 1 所选类库的文件名。
+ 2 所选类的名称。
+
- Specifies the name of the class library initially selected when the Open dialog is displayed. cLibraryName can be a visual (.vcx) or program (.prg) -based class library.
- The class library name you specify is displayed in the File name text box. An error is generated if the class library you specify doesn't exist or cLibraryName is the empty string or the null value.
+ 指定显示“打开”对话框时初始选中的类库名称。cLibraryName 可以是可视(.vcx)类库,也可以是基于程序(.prg)的类库。指定的类库名称显示在“文件名”文本框中。如果指定的类库不存在,或者 cLibraryName 为空字符串或 null 值,则会产生错误。
- Specifies the name of the class initially selected in the Class name list when the Open dialog is displayed. If the class you specify doesn't exist, the first class in the Class name list is selected. An error is generated if you omit cLibraryName or cClassName is the null value.
+ 指定显示“打开”对话框时在“类名称”列表中初始选中的类的名称。如果指定的类不存在,则选中“类名称”列表中的第一个类。如果省略 cLibraryName,或者 cClassName 为 null 值,则会产生错误。
- Specifies the text displayed in the title bar of the Open dialog. By default, "Open" is the text displayed.
+ 指定显示在“打开”对话框标题栏中的文本。默认情况下,显示的文本为“Open”。
- Specifies the text displayed next to the File name text box. By default, "File name:" is the text displayed.
+ 指定显示在“文件名”文本框旁边的文本。默认情况下,显示的文本为“File name:”。
- Specifies the caption for the OK button.
+ 指定“确定”按钮的标题。
- Logical data type. AGETCLASS( ) returns True (.T.), if you chose a class, and creates a one-dimensional array containing two elements. The first element contains the file name of the class library chosen; the second element contains the name of the class chosen. AGETCLASS returns False (.F.) if you exit the Class Library dialog box by pressing ESC, choosing Cancel, or clicking the Close button.
+ 逻辑类型。如果选择了某个类,AGETCLASS( ) 返回 True (.T.),并创建一个包含两个元素的一维数组。第一个元素包含所选类库的文件名;第二个元素包含所选类的名称。如果通过按 ESC、选择“取消”或单击“关闭”按钮退出“类库”对话框,AGETCLASS 返回 False (.F.)。
- If the array you specify does not exist, X# automatically creates the array.
- If the array exists and is not large enough to contain the names of the class library and class, X# automatically increases the size of the array.
- If the array is larger than necessary, X# truncates the array. If the array exists, and AGETCLASS( ) returns False (.F.) because the Class Library dialog box was closed by pressing ESC, choosing Cancel, or clicking the Close button, the array remains unchanged.
- If the array does not exist, and AGETCLASS( ) returns false (.F.), the array is not created.
- X# 8.0 does not support AGETCLASS( ) in its run-time libraries. AGETCLASS( ) is supported in X# 9.0 run-time libraries, but the Program (*.prg) option is not available in the Files of type drop-down list box.
+ 如果指定的数组不存在,X# 会自动创建该数组。如果数组已存在但不足以容纳类库名称和类名称,X# 会自动增大数组。如果数组大于所需大小,X# 会截断该数组。如果数组已存在,并且由于通过按 ESC、选择“取消”或单击“关闭”按钮关闭了“类库”对话框而使 AGETCLASS( ) 返回 False (.F.),则数组保持不变。如果数组不存在,并且 AGETCLASS( ) 返回 false (.F.),则不会创建该数组。X# 8.0 的运行时库不支持 AGETCLASS( )。X# 9.0 的运行时库支持 AGETCLASS( ),但文件类型下拉列表框中没有 Program (*.prg) 选项。
@@ -1142,20 +1039,19 @@
- Places instances of a class into a variable array and returns the number of instances placed in the array.
+ 将类的实例放入变量数组中,并返回放入数组中的实例数。
- Specifies the name of the array into which the instances are placed. If the array you specify doesn't exist, X# automatically creates the array. If the array exists and isn't large enough to contain all the instances, X# automatically increases the size of the array to accommodate the instances. If the array is larger than necessary, X# truncates the array. If the array exists and AINSTANCE( ) returns 0 because no instances are found, the array remains unchanged. If the array doesn't exist and AINSTANCE( ) returns 0, the array is not created.
- Only class instances assigned to variables and array elements with CREATEOBJECT( ) or NEWOBJECT( ) are placed into the array.
+ 指定用于存放实例的数组的名称。如果指定的数组不存在,X# 会自动创建该数组。如果数组已存在但不足以容纳所有实例,X# 会自动增大数组以容纳这些实例。如果数组大于所需大小,X# 会截断该数组。如果数组已存在,并且由于未找到任何实例而使 AINSTANCE( ) 返回 0,则数组保持不变。如果数组不存在,并且 AINSTANCE( ) 返回 0,则不会创建该数组。只有通过 CREATEOBJECT( ) 或 NEWOBJECT( ) 赋值给变量和数组元素的类实例才会被放入数组中。
- Specifies a X# base class name or a user-defined class name. For a complete list of the X# base classes, see Base Classes in X#.
+ 指定 X# 基类名称或用户定义的类名称。有关 X# 基类的完整列表,请参阅 X# 中的基类。
- Numeric
+ 数值类型
@@ -1170,43 +1066,33 @@
- Returns an array containing the names of all valid X# commands, functions, or base classes.
+ 返回一个数组,其中包含所有有效的 X# 命令、函数或基类的名称。
- Specifies the name of the array to contain the language items. If the array doesn't exist, X# automatically creates the array. If the array exists and isn't large enough to contain all the data, X# automatically increases the size of the array to accommodate the information. If the array is larger than necessary, X# truncates the array.
+ 指定用于存放语言项的数组的名称。如果数组不存在,X# 会自动创建该数组。如果数组已存在但不足以容纳所有数据,X# 会自动增大数组以容纳这些信息。如果数组大于所需大小,X# 会截断该数组。
- Specifies the type of language item returned, according to the following list:
- 1
- Commands
- One-dimensional: Command name
- 2
- Functions
- Two-dimensional:
- Function name [M] nParamR [- nParamT]
- The matchFlag, M, specifies that you must use the full function name in code.nParamR specifies the number of required parameters. nParamT specifies total number of possible parameters.
- 3
- Base classes
- One-dimensional:
- Base Class name
- 4
- DBC Events
- DBC event name (The displayed name omits the "DBC_" prefix of the event name.)
+ 根据以下列表指定返回的语言项的类型:
+
+ 1 命令 一维:命令名称
+ 2 函数 二维:
函数名称 [M] nParamR [- nParamT]
匹配标志 M 指定在代码中必须使用完整的函数名称。nParamR 指定必需参数的数量。nParamT 指定可能的参数总数。
+ 3 基类 一维:基类名称
+ 4 DBC 事件 DBC 事件名称(显示的名称省略了事件名称的“DBC_”前缀。)
+
- The ALANGUAGE( ) function returns an array of all valid X# commands and functions. To return object information, use the AMEMBERS( ) function.
- Use the ALANGUAGE( ) function to access X# functions as in the following code:
+ ALANGUAGE( ) 函数返回包含所有有效 X# 命令和函数的数组。要返回对象信息,请使用 AMEMBERS( ) 函数。可以使用 ALANGUAGE( ) 函数访问 X# 函数,如下列代码所示:
ALANGUAGE(FuncArr,2)
- The resulting array, FuncArr, will contain the following values:
+ 生成的数组 FuncArr 将包含以下值:
JUSTSTEM, M1
- JUSTSTEM( ) cannot be abbreviated and it requires one parameter.
+ JUSTSTEM( ) 不能缩写,并且需要一个参数。
KEYMATCH, 1-4
- KEYMATCH( ) can be abbreviated to four characters, and has one required, and three optional parameters (total = 4).
+ KEYMATCH( ) 可以缩写为四个字符,并且有一个必需参数和三个可选参数(共 4 个)。
LASTKEY, 0
- LASTKEY( ) can be abbreviated and requires no parameters.
+ LASTKEY( ) 可以缩写,并且不需要参数。
@@ -1256,20 +1142,19 @@
- Returns the table alias of the current or specified work area.
+ 返回当前或指定工作区的表别名。
- Specifies the work area number for which ALIAS( ) returns the table alias.
+ 指定 ALIAS( ) 返回其表别名的工作区编号。
- Specifies the table alias for which ALIAS( ) returns the table alias.
- If you omit nWorkArea or cTableAlias, ALIAS( ) returns the alias of the table open in the current work area. An empty string is returned if a table isn't open in the current or specified work area.
+ 指定 ALIAS( ) 返回其表别名的表别名。如果省略 nWorkArea 或 cTableAlias,ALIAS( ) 返回在当前工作区中打开的表的别名。如果当前或指定的工作区中没有打开表,则返回空字符串。
- Character
+ 字符类型
@@ -1286,26 +1171,22 @@
- Removes all leading and trailing spaces or parsing characters from the specified character expression, or all leading and trailing zero (0) bytes from the specified binary expression.
+ 从指定的字符表达式中删除所有前导和尾随空格或解析字符,或者从指定的二进制表达式中删除所有前导和尾随的零 (0) 字节。
- Specifies an expression of Character or Varbinary type to remove leading and trailing spaces or 0 bytes from, respectively.
+ 指定 Character 或 Varbinary 类型的表达式,分别从中删除前导和尾随空格或 0 字节。
- Specifies if trimming is case-sensitive when one or more parse characters (cParseChar, cParseChar2, … are included. Trimming is case-sensitive if nFlags is zero or is omitted. Trimming is case-insensitive if nFlags 1.
-
- cParseChar [, cParseChar2 [, ...]]
- Specifies one or more character strings that are trimmed from the beginning and end of cExpression. If cParseChar is not included, then leading and trailing spaces or 0 bytes are removed from Expression.
- Note The maximum number of strings permitted in cParseChar is 23.
+ 指定在包含一个或多个解析字符(cParseChar、cParseChar2、…)时,裁剪是否区分大小写。如果 nFlags 为零或被省略,则裁剪区分大小写。如果 nFlags 为 1,则裁剪不区分大小写。cParseChar [, cParseChar2 [, ...]] 指定一个或多个要从 cExpression 的开头和结尾裁剪掉的字符串。如果未包含 cParseChar,则从 Expression 中删除前导和尾随的空格或 0 字节。注意 cParseChar 中允许的字符串最大数量为 23。
- Character or Varbinary. ALLTRIM( ) returns the specified expression without leading or trailing spaces, parsing characters, or 0 bytes respectively.
+ Character 或 Varbinary。ALLTRIM( ) 返回分别去除了前导或尾随空格、解析字符或 0 字节的指定表达式。
- You can use ALLTRIM( ) to ensure that spaces or 0 bytes are removed from data entered by a user.
+ 可以使用 ALLTRIM( ) 确保从用户输入的数据中删除空格或 0 字节。
@@ -1325,117 +1206,126 @@
- Creates an array containing information about the mouse pointer position and the object over which the mouse pointer is positioned.
+ 创建一个数组,其中包含有关鼠标指针位置以及鼠标指针所在对象的信息。
- Specifies the name of the array containing the mouse pointer information. If the array you specify doesn't exist, X# automatically creates a four-row array. If the array exists, X# dimensions it to four rows.
- The following table describes the contents of each row in the array:
- 1
- Contains an object reference to the object over which the mouse pointer is positioned when AMOUSEOBJ( ) is executed.
- 2
- Contains an object reference to the container of the object over which the mouse pointer is positioned when AMOUSEOBJ( ) is executed.
- 3
- Contains the horizontal (X) coordinate in pixels of the mouse pointer, relative to the container of the object over which the mouse pointer is positioned when AMOUSEOBJ( ) is executed.
- 4
- Contains the vertical (Y) coordinate in pixels of the mouse pointer, relative to the container of the object over which the mouse pointer is positioned when AMOUSEOBJ( ) is executed.
- The first and second rows in the array can contain the same values if the mouse is positioned over a generic container such as a pageframe.
- [, 1]
- This optional parameter specifies that the mouse pointer information contained in the array is relative to the current form (THISFORM). If you include this option, the second array row always contains an object reference to the current form, and the third and fourth rows contain the mouse pointer coordinates relative to the current form.
+ 指定包含鼠标指针信息的数组的名称。如果指定的数组不存在,X# 会自动创建一个四行的数组。如果数组已存在,X# 会将其维数调整为四行。
+下表描述了数组中各行的内容:
+
+ 1 包含执行 AMOUSEOBJ( ) 时鼠标指针所在对象的对象引用。
+ 2 包含执行 AMOUSEOBJ( ) 时鼠标指针所在对象的容器的对象引用。
+ 3 包含鼠标指针的水平 (X) 坐标(以像素为单位),相对于执行 AMOUSEOBJ( ) 时鼠标指针所在对象的容器。
+ 4 包含鼠标指针的垂直 (Y) 坐标(以像素为单位),相对于执行 AMOUSEOBJ( ) 时鼠标指针所在对象的容器。
+
+如果鼠标位于页框等通用容器之上,则数组的第一行和第二行可以包含相同的值。
[, 1] 此可选参数指定数组中包含的鼠标指针信息是相对于当前表单 (THISFORM) 的。如果包含此选项,则数组的第二行始终包含当前表单的对象引用,第三行和第四行包含相对于当前表单的鼠标指针坐标。
- Numeric
+ 数值类型
- You can also use AMOUSEOBJ( ) to determine where to position the mouse pointer during design time. The following table lists the design time element and the values contained in each row of the array:
- Form and Class Designers
- Row 1 – Object reference to the control.Row 2 – Object reference to the form.Row 3 – Mouse pointer horizontal (X) coordinate relative to the form.Row 4 – Mouse pointer vertical (Y) coordinate relative to the form.
- Project Manager
- Row 1 – Object reference to the project.Row 2 – Object reference to the project.Row 3 – Zero.Row 4 – Zero.
- X# Desktop
- Row 1 – Object reference to the desktop.Row 2 – Object reference to the desktop.Row 3 – Mouse pointer horizontal (X) coordinate relative to the desktop.Row 4 – Mouse pointer vertical (Y) coordinate relative to the desktop.
- AMOUSEOBJ( ) returns 4 (the number of rows in the array) if you position the mouse pointer over an area listed above. If you position the mouse pointer over an area other than those listed above, AMOUSEOBJ( ) returns zero. If the array you specify already exists, it remains unchanged. If the array you specify does not exist, the system does not create it.
+ 还可以使用 AMOUSEOBJ( ) 在设计时确定鼠标指针的位置。下表列出了设计时元素以及数组中每一行包含的值:
+
+ 表单和类设计器
+
+ 第 1 行 控件的对象引用。
+ 第 2 行 表单的对象引用。
+ 第 3 行 鼠标指针相对于表单的水平 (X) 坐标。
+ 第 4 行 鼠标指针相对于表单的垂直 (Y) 坐标。
+
+ 项目管理器
+
+ 第 1 行 项目的对象引用。
+ 第 2 行 项目的对象引用。
+ 第 3 行 零。
+ 第 4 行 零。
+
+ X# 桌面
+
+ 第 1 行 桌面的对象引用。
+ 第 2 行 桌面的对象引用。
+ 第 3 行 鼠标指针相对于桌面的水平 (X) 坐标。
+ 第 4 行 鼠标指针相对于桌面的垂直 (Y) 坐标。
+
+
+如果将鼠标指针定位在上述任一区域之上,AMOUSEOBJ( ) 返回 4(数组的行数)。如果将鼠标指针定位在上述区域之外的区域,AMOUSEOBJ( ) 返回零。如果指定的数组已存在,则保持不变。如果指定的数组不存在,系统不会创建它。
- Included for backward compatibility. Use CPCONVERT( ) Function instead.
- Converts each character of a character expression to the corresponding character in the MS-DOS (OEM) character set.
+ 为向后兼容而保留。请改用 CPCONVERT( ) 函数。将字符表达式的每个字符转换为 MS-DOS (OEM) 字符集中对应的字符。
- Return value - Character
+ 返回值 - Character
-
- ANSITOOEM() is supported in FoxPro for Windows and FoxPro for Macintosh.
-
- Use ANSITOOEM() to move data from FoxPro for Windows and FoxPro for Macintosh to FoxPro for MS-DOS. ANSITOOEM() converts each character in expC to the corresponding character in the MS-DOS (OEM) character set. The character expression expC should contain characters from the ANSI character set.
-
- If a character in expC doesn't have an MS-DOS equivalent, the character is converted to a similar MS-DOS character.
-
+
FoxPro for Windows 和 FoxPro for Macintosh 支持 ANSITOOEM()。
使用 ANSITOOEM() 可将数据从 FoxPro for Windows 和 FoxPro for Macintosh 移至 FoxPro for MS-DOS。ANSITOOEM() 将 expC 中的每个字符转换为 MS-DOS (OEM) 字符集中对应的字符。字符表达式 expC 应包含 ANSI 字符集中的字符。
如果 expC 中的某个字符没有对应的 MS-DOS 字符,则该字符会被转换为相似的 MS-DOS 字符。
- Creates an array containing X# language elements contained in a program file.
+ 创建一个数组,其中包含程序文件中所含的 X# 语言元素。
- Specifies the name of the array to be created.
+ 指定要创建的数组的名称。
- Specifies the filename of the program that this function traverses.
+ 指定此函数遍历的程序的文件名。
- Specifies the type of information returned in cArrayName. The following table specifies valid nType values and describes the information returned by each nType value.
- 0 (default
- Populates the array with all document information.
- Column1 – Doc View content
- Column2 – line
- Column3 – type
- Column4 – indentation
- Indentation is used with preprocessor directives to show nested levels of #IF type statements.
- Populates the array with only the class definitions in the document.
- Column1 – class name
- Column3 – parentclass
- Column4 - is OLEpublic
- Populates the array with only class procedure information (class definition excluded)
- Populates the array with #define and other preprocessor directives in the document.
- The following table describes the "type" values returned in Column3 for nType values of 0 and 3.
- Define
- #DEFINE preprocessor directive
- Directive
- Other preprocessor directives, such as #IF
- Class
- Class definition line
- Procedure
- Procedure, Method or Event
-
-
- Numeric. APROCINFO( ) returns the number of rows added to the array.
-
-
- X# automatically creates the array you specify if it doesn't already exist. X# automatically increases or truncates the size of the array to accommodate the returned information. This function supports program (PRG) files only.
+ 指定在 cArrayName 中返回的信息类型。下表指定了有效的 nType 值,并描述了每个 nType 值返回的信息。
+
+ 0(默认值) 用所有文档信息填充数组。
+
+ Column1 文档视图内容
+ Column2 行
+ Column3 类型
+ Column4 缩进
+
+ 缩进与预处理器指令一起使用,用于显示 #IF 类型语句的嵌套层级。
+ 1 仅用文档中的类定义填充数组。
+
+ Column1 类名称
+ Column3 父类
+ Column4 是否为 OLEpublic
+
+ 2 仅用类过程信息(不包括类定义)填充数组
+ 3 用文档中的 #define 和其他预处理器指令填充数组。
+
+下表描述了 nType 值为 0 和 3 时在 Column3 中返回的“类型”值。
+
+ Define #DEFINE 预处理器指令
+ Directive 其他预处理器指令,例如 #IF
+ Class 类定义行
+ Procedure 过程、方法或事件
+
+
+
+ 数值类型。APROCINFO( ) 返回添加到数组中的行数。
+
+
+ 如果指定的数组尚不存在,X# 会自动创建它。X# 会自动增大或截断数组的大小以容纳返回的信息。此函数仅支持程序 (PRG) 文件。
- Returns the ANSI value for the leftmost character in a character expression.
+ 返回字符表达式中最左侧字符的 ANSI 值。
- Specifies the character expression containing the character whose ANSI value ASC( ) returns. Any characters after the first character in cExpression are ignored by ASC( ).
+ 指定字符表达式,ASC( ) 返回其中字符的 ANSI 值。cExpression 中第一个字符之后的任何字符都会被 ASC( ) 忽略。
- Numeric
+ 数值类型
- ASC( ) returns the position of the character in the character table of the current code page. Every character has a unique ANSI value in the range from 0 to 255.
+ ASC( ) 返回该字符在当前代码页字符表中的位置。每个字符都有一个唯一的 ANSI 值,范围从 0 到 255。
@@ -1450,92 +1340,61 @@
- Searches an array for an element containing the same data and data type as an expression.
+ 在数组中搜索包含与表达式具有相同数据和数据类型的元素。
- Specifies the name of the array to search.
+ 指定要搜索的数组的名称。
- Specifies the general expression to search for.
+ 指定要搜索的通用表达式。
- Specifies the element number at which the search begins. The element number you specify is included in the search. If you omit nStartElement or if you pass negative value on its place, the entire array is searched by default.
+ 指定开始搜索的元素编号。搜索包含指定的元素编号。如果省略 nStartElement,或者在其位置传递负值,则默认搜索整个数组。
- Specifies the number of elements that are searched. If you omit nStartElement and nElementsSearched or if you pass negative value on its place, the search begins with the first array element and continues to the last array element if you do not specify nSearchColumn.
- You can refer to an element in a two-dimensional variable array in one of two ways. The first method uses two subscripts to specify the row and column position of the element in the array; the other method uses an element number. This function and others that manipulate two-dimensional arrays require element numbers (nStartElement and nElementsSearched). Use AELEMENT( ) to return the element number from row and column subscripts in a two-dimensional array.
+ 指定要搜索的元素数量。如果省略 nStartElement 和 nElementsSearched,或者在其位置传递负值,并且未指定 nSearchColumn,则搜索从第一个数组元素开始,一直持续到最后一个数组元素。可以通过两种方式引用二维变量数组中的元素。第一种方法使用两个下标来指定元素在数组中的行和列位置;另一种方法使用元素编号。此函数以及其他操作二维数组的函数需要元素编号(nStartElement 和 nElementsSearched)。使用 AELEMENT( ) 可根据二维数组中的行和列下标返回元素编号。
- Specifies the array column to search. This is often useful in arrays created by functions such as AFIELDS( ).
- You can use 0 or a negative number for nSearchColumn to impose a search of the entire array. If you use a value greater than 0 for nSearchColumn, ASCAN( ) treats the specified column as a one-dimensional array, using each data row as an element in the search. For instance, the following example searches only the third and fourth elements of column 2 instead of the entire array.
+ 指定要搜索的数组列。这对于由 AFIELDS( ) 等函数创建的数组通常很有用。可以对 nSearchColumn 使用 0 或负数,以强制搜索整个数组。如果对 nSearchColumn 使用大于 0 的值,ASCAN( ) 会将指定的列视为一维数组,并将每个数据行作为搜索中的一个元素。例如,下面的示例仅搜索第 2 列的第三个和第四个元素,而不是整个数组。
? ASCAN(abc,"M",3,2,2)
- X# generates an error if nSearchColumn is a number larger than the number of available columns.
+ 如果 nSearchColumn 大于可用列数,X# 会产生错误。
? ASCAN(abc,"HELLO",-1,-1,2,15) && Search the whole column 2 of two-dimensional array
- nFlags
-
- Specifies additional search criteria to apply to the scan function. Default scans are case-sensitive.
- The number you specify in nFlags provides a bit-value that determines the case sensitivity or exactness setting of a scan according to the following table:
- NFlag
- 0000
- Behavior existing in X# 6 or earlier
- 0001
- Case Insensitive
- 0010
- Current behavior existing in the previous version of X#
- 0011
- 4
- 0100
- Exact OFF
- 0101
- Case Insensitive; Exact OFF
- 0110
- Exact ON
- 7
- 0111
- Case Insensitive; Exact ON
- 8
- 1000
- Return row number
- 9
- 1001
- Case Insensitive; return row number
- 1010
- 1011
- 12
- 1100
- Return row number; Exact OFF
- 13
- 1101
- Case Insensitive; Return row number; Exact OFF
- 14
- 1110
- Return row number; Exact ON
- 1111
- Case Insensitive; Return row number; Exact ON
- The bit values are as follows:
- Case Insensitive bit
- Exactness ON bit (Only effective if bit 2 is set)
- Override system Exact setting bit
- Return row number if 2D array
- nFlags applies only to the ASCAN( ) function and does not affect settings for SET EXACT.
-
-
- Numeric
-
-
- If a match is found, ASCAN( ) returns the number of the element containing the expression. If a match cannot be found, ASCAN( ) returns 0.
- The criteria for a successful match of character data are determined by the setting of the system SET EXACT if nFlag with bit 2 is not set. If SET EXACT is ON, an element must match the search expression character for character and have the same length. If SET EXACT is OFF, and an element and search expression match until the end of the expression is reached, the match is successful. For more information on match criteria for character strings, see the string comparison table in the SET EXACT Command topic.
- In X# 6.0, the nStartElement and nElementsSearched parameters are optional. The nStartElement must be > 0 while nElementsSearched can be any value. In order to accommodate the nSearchColumn parameter, you will need to bypass these parameters by passing a value of -1.
- The nStartElement and nElementsSearched parameters take on special meaning if the value of nSearchColumn is greater than 0. In X# 6.0, they are always referenced to the entire array. Beginning with X# 7.0, if a positive nSearchColumn is passed, the values of nStartElement and nElementsSearched are referenced to the single one-dimensional array represented by the nSearchColumn. For example, the following would only search the third and fourth elements of column 2, and not the entire array:
+ nFlags 指定应用于扫描函数的附加搜索条件。默认扫描区分大小写。
在 nFlags 中指定的数字提供一个位值,该位值按下表确定扫描的大小写敏感性或精确性设置:
+
+ NFlag 位模式 行为
+ 0 0000 X# 6 或更早版本中已有的行为
+ 1 0001 不区分大小写
+ 2 0010 X# 上一版本中已有的当前行为
+ 3 0011
+ 4 0100 Exact OFF
+ 5 0101 不区分大小写;Exact OFF
+ 6 0110 Exact ON
+ 7 0111 不区分大小写;Exact ON
+ 8 1000 返回行号
+ 9 1001 不区分大小写;返回行号
+ 10 1010
+ 11 1011
+ 12 1100 返回行号;Exact OFF
+ 13 1101 不区分大小写;返回行号;Exact OFF
+ 14 1110 返回行号;Exact ON
+ 15 1111 不区分大小写;返回行号;Exact ON
+
+各位值如下:
不区分大小写位
Exactness ON 位(仅当第 2 位被设置时有效)
覆盖系统 Exact 设置位
如果是二维数组则返回行号
nFlags 仅适用于 ASCAN( ) 函数,不影响 SET EXACT 的设置。
+
+
+ 数值类型
+
+
+ 如果找到匹配项,ASCAN( ) 返回包含该表达式的元素的编号。如果找不到匹配项,ASCAN( ) 返回 0。如果未设置 nFlag 的第 2 位,则字符数据成功匹配的条件由系统 SET EXACT 的设置决定。如果 SET EXACT 为 ON,则元素必须与搜索表达式逐字符匹配且长度相同。如果 SET EXACT 为 OFF,并且元素与搜索表达式一直匹配到表达式末尾,则匹配成功。有关字符串匹配条件的更多信息,请参阅 SET EXACT 命令主题中的字符串比较表。在 X# 6.0 中,nStartElement 和 nElementsSearched 参数是可选的。nStartElement 必须 > 0,而 nElementsSearched 可以是任意值。为了使用 nSearchColumn 参数,需要通过传递值 -1 来跳过这些参数。如果 nSearchColumn 的值大于 0,则 nStartElement 和 nElementsSearched 参数具有特殊含义。在 X# 6.0 中,它们始终针对整个数组。从 X# 7.0 开始,如果传递了正的 nSearchColumn,则 nStartElement 和 nElementsSearched 的值针对由 nSearchColumn 所表示的单个一维数组。例如,下面的示例只搜索第 2 列的第三个和第四个元素,而不是整个数组:
? ASCAN(abc,"M",3,2,2)
@@ -1562,33 +1421,22 @@
- Places an object reference for the currently selected control or container that exists in the Form Designer, Class Designer, or code editing window into a specified variable array. When calling ASELOBJ( ) in a code editing window, the array also includes elements for forms (.scx), visual class libraries (.vcx), and #INCLUDE file names. You can also use ASELOBJ( ) to create control builders.
+ 将 Form Designer、Class Designer 或代码编辑窗口中当前选定的控件或容器的对象引用放入指定的变量数组中。在代码编辑窗口中调用 ASELOBJ( ) 时,数组还包含表单 (.scx)、可视类库 (.vcx) 和 #INCLUDE 文件名的元素。还可以使用 ASELOBJ( ) 创建控件生成器。
- Specifies the name of the array you want to use.
- 1
- Creates a one-element array containing an object reference to the container for the currently active and selected control.
- For example, if the currently active and selected control is a spinner on a form, the array contains an element with the value "FORM." When calling ASELOBJ( ) in the Command window, include this argument.
- When a page frame is selected, ASELOBJ() returns the name of the current page.
- 2
- Creates a one-element array containing an object reference to the DataEnvironment object for the form. The DataEnvironment object makes it possible for you to determine the data environment properties of the form.
- 3
- Creates three-element array containing information in context with the currently active code editing window: object reference to a container object, the full path and name of the .scx or .vcx file, and the full path and name of the #INCLUDE file, if available.
- The following table shows the order in which these elements appear.
- Object reference to container object
- Full path and name of .scx or .vcx file
- Full path and name of #INCLUDE file, if available
- If no #INCLUDE file is available, the third element contains an empty string.
+ 指定要使用的数组的名称。
+
+ 1 创建一个单元素数组,其中包含当前活动且选定控件的容器的对象引用。
例如,如果当前活动且选定的控件是表单上的微调控件,则数组包含一个值为“FORM.”的元素。在命令窗口中调用 ASELOBJ( ) 时,请包含此参数。
选定页框时,ASELOBJ() 返回当前页的名称。
+ 2 创建一个单元素数组,其中包含表单的 DataEnvironment 对象的对象引用。通过 DataEnvironment 对象可以确定表单的数据环境属性。
+ 3 创建一个三元素数组,其中包含与当前活动代码编辑窗口相关的信息:容器对象的对象引用、.scx 或 .vcx 文件的完整路径和名称,以及 #INCLUDE 文件的完整路径和名称(如果可用)。
下表显示了这些元素出现的顺序。
容器对象的对象引用
.scx 或 .vcx 文件的完整路径和名称
#INCLUDE 文件的完整路径和名称(如果可用)
如果没有可用的 #INCLUDE 文件,则第三个元素包含空字符串。
+
- Numeric data type. ASELOBJ( ) returns the number of objects selected. The array contains three columns and a row for each selected object. .
+ 数值类型。ASELOBJ( ) 返回所选对象的数量。该数组包含三列,每个所选对象对应一行。.
- If no controls are selected, and the argument, 1, is omitted, ASELOBJ( ) returns 0 and does not create the array. If no controls exist on the form, ASELOBJ( ) does not recognize the form as the selected control. If no controls are currently selected and the argument, 1, is included, ASELOBJ( ) returns 1.
- If the array does not exist, X# automatically creates the array.
- If the array exists but is too small to contain all the information, X# automatically increases the size of the array to accommodate the information. If the array is larger than needed, X# truncates the array.
- If the array exists, and ASELOBJ( ) returns 0 because no controls are selected, the array remains unchanged. If the array does not exist, and ASELOBJ( ) returns 0, the array is not created.
+ 如果未选中任何控件,且省略了参数 1,ASELOBJ( ) 返回 0 且不创建数组。如果窗体上不存在任何控件,ASELOBJ( ) 不会将该窗体识别为所选控件。如果当前未选中任何控件但包含了参数 1,ASELOBJ( ) 返回 1。如果数组不存在,X# 会自动创建该数组。如果数组存在但太小,无法容纳所有信息,X# 会自动增大数组以容纳这些信息。如果数组大于所需大小,X# 会截断该数组。如果数组存在,并且由于未选中任何控件而使 ASELOBJ( ) 返回 0,则数组保持不变。如果数组不存在,且 ASELOBJ( ) 返回 0,则不会创建该数组。
@@ -1608,17 +1456,17 @@
- Returns in radians the arc sine of a numeric expression.
+ 返回数值表达式的反正弦值(以弧度表示)。
- Specifies the numeric expression whose arc sine ASIN( ) returns. The value of nExpression can range from +1 through –1, and the value ASIN( ) returns can range from –pi/2 through +pi/2 ( –1.57079 to 1.57079). The number of decimal places in the display of the result can be specified with SET DECIMALS.
+ 指定要由 ASIN( ) 返回其反正弦值的数值表达式。nExpression 的值范围为 +1 到 –1,ASIN( ) 返回的值范围为 –pi/2 到 +pi/2(–1.57079 到 1.57079)。结果显示的小数位数可以通过 SET DECIMALS 指定。
- Numeric
+ 数值类型
- Use RTOD( ) to convert radians to degrees.
+ 使用 RTOD( ) 可将弧度转换为角度。
@@ -1632,20 +1480,16 @@
- Sorts elements in an array in ascending or descending order.
+ 按升序或降序对数组中的元素进行排序。
- Specifies the name of the array to sort.
+ 指定要排序的数组的名称。
- Specifies the starting element of the sort. If you omit nStartElement, the array is sorted starting with the first array element by default. If the array is one-dimensional, the sort includes nStartElement. If the array is two-dimensional, the starting element nStartElement determines both the row where the sort begins and the column that determines the sort order of the rows.
- You can refer to an element in a two-dimensional array in one of two ways. The first method uses two subscripts to specify the row and column position of the element in the array; the other method uses an element number. This function and others that manipulate two-dimensional arrays require element numbers (in ASORT() the numeric expressions nStartElement and nNumberSorted). You can use AELEMENT( ) to return the element number from row and column subscripts in a two-dimensional array.
- The following example illustrates that the starting element nStartElement determines how the rows in a two-dimensional array are sorted. A small array named codegaArray/code is created and sorted twice. The first sort begins with the first element of codegaArray/code; the rows are sorted based on the values contained in the first column of the array. The second sort begins with the fourth element of codegaArray/code; the rows are sorted based on the values contained in the second column.
- The first sort begins with the first row. The second sort begins with the second row. You can use DISPLAY MEMORY to display the contents of the array; in these examples tables are used to graphically display the results of the sorts.
- These commands create the array named codegaArray/code:
+ 指定排序的起始元素。如果省略 nStartElement,则默认从数组的第一个元素开始排序。如果数组是一维的,排序包含 nStartElement。如果数组是二维的,起始元素 nStartElement 既决定排序开始的行,也决定用于确定行顺序的列。可以通过两种方式引用二维数组中的元素。第一种方法使用两个下标指定元素在数组中的行和列位置;另一种方法使用元素编号。此函数及其他操作二维数组的函数需要使用元素编号(在 ASORT() 中为数值表达式 nStartElement 和 nNumberSorted)。可以使用 AELEMENT( ) 根据二维数组中的行和列下标返回元素编号。下面的示例说明起始元素 nStartElement 如何决定二维数组中各行的排序方式。创建一个名为 codegaArray/code 的小型数组并对其排序两次。第一次排序从 codegaArray/code 的第一个元素开始;各行根据数组第一列中包含的值进行排序。第二次排序从 codegaArray/code 的第四个元素开始;各行根据第二列中包含的值进行排序。第一次排序从第一行开始。第二次排序从第二行开始。可以使用 DISPLAY MEMORY 显示数组的内容;在这些示例中,使用表格以图形方式显示排序结果。这些命令创建名为 codegaArray/code 的数组:
DIMENSION gaArray(3,2)
gaArray(1) = 'G'
@@ -1655,47 +1499,38 @@
gaArray(5) = 'B'
gaArray(6) = 'N'
- codegaArray/code looks like this:
- Row 1
- Row 2
- Row 3
- The array is then sorted by ASORT( ) starting with the first element (1,1) in the array. The elements in the first column are placed in ascending order by rearranging the rows of the array.
+ gaArray 如下所示: Row 1 Row 2 Row 3 然后 ASORT( ) 从数组中的第一个元素 (1,1) 开始对数组排序。通过重新排列数组的行,第一列中的元素按升序排列。
=ASORT(gaArray,1)
- Note the new order of the rows:
- The array is then sorted starting with the fourth element (2,2) in the array. The elements in the second column are placed in order by rearranging the array rows.
+ 请注意行的新顺序: 然后从数组中的第四个元素 (2,2) 开始对数组排序。通过重新排列数组的行,第二列中的元素按顺序排列。
=ASORT(gaArray,4)
- Note the difference in the order of the rows:
+ 请注意行顺序的差异:
- Specifies the number of elements that are sorted in a one-dimensional array, or the number of rows that are sorted in a two-dimensional array. For example, if the array is one-dimensional and nStartElement is 2, indicating that the sort starts with the second array element, and nNumberSorted is 3, indicating that the sort should include three elements, the second, third and fourth array elements are sorted. If nNumberSorted is –1 or is omitted, all array elements from the starting element nStartElement through the last element in the array are sorted.
- If the array is two-dimensional, nNumberSorted designates the number of rows to sort, beginning with the row containing the starting element nStartElement. For example, if nStartElement is 2 and nNumberSorted is 3, the row containing the second array element and the following two rows are sorted. If nNumberSorted is –1 or is omitted, all array rows beginning with the row containing the starting element nStartElement through the last array row are sorted.
+ 指定一维数组中要排序的元素数量,或二维数组中要排序的行数。例如,如果数组是一维的,nStartElement 为 2(表示从第二个数组元素开始排序),nNumberSorted 为 3(表示排序包含三个元素),则对第二个、第三个和第四个数组元素进行排序。如果 nNumberSorted 为 –1 或被省略,则对从起始元素 nStartElement 到数组最后一个元素的所有数组元素进行排序。如果数组是二维的,nNumberSorted 指定要排序的行数,从包含起始元素 nStartElement 的行开始。例如,如果 nStartElement 为 2,nNumberSorted 为 3,则对包含第二个数组元素的行及其后的两行进行排序。如果 nNumberSorted 为 –1 或被省略,则对从包含起始元素 nStartElement 的行到数组最后一行的所有数组行进行排序。
- Specifies the sort order (ascending or descending) for the elements in the array. By default, array elements are sorted in ascending order. If nSortOrder is 0 or is omitted, the array elements are sorted in ascending order. If nSortOrder is any positive value, the array elements are sorted in descending order.
+ 指定数组元素的排序顺序(升序或降序)。默认情况下,数组元素按升序排序。如果 nSortOrder 为 0 或被省略,数组元素按升序排序。如果 nSortOrder 为任何正值,数组元素按降序排序。
- Specifies case-sensitive search criteria to apply to the sort function. Valid values are 0 (the default) and 1. ASORT( ) uses the current collate sequence (see SET COLLATE Command) to determine the sort order. Certain collate sequences (such as "GENERAL") are not case-sensitive, and specifying nFlags = 0 will not cause a case-sensitive sorting.
- The nFlags parameter is only useful when the current collate sequence is case-sensitive (such as "MACHINE"), and you wish to do a non-case-sensitive sort.
- The number you specify in nFlags provides a bit-value that determines the case sensitivity of a sort according to the following table:
- nFlag
- 000
- Case-sensitive sort
- 001
- Case insensitive sort
- If you specify nFlags, you can omit the other parameters by passing them in as -1.
+ 指定应用于排序函数的区分大小写的搜索条件。有效值为 0(默认值)和 1。ASORT( ) 使用当前的排序规则(collate sequence,参见 SET COLLATE Command)来确定排序顺序。某些排序规则(如 "GENERAL")不区分大小写,指定 nFlags = 0 不会导致区分大小写的排序。nFlags 参数仅在当前排序规则区分大小写(如 "MACHINE")并且希望执行不区分大小写的排序时才有用。nFlags 中指定的数字提供一个位值,根据下表确定排序是否区分大小写:
+
+ nFlag
+ 000 区分大小写的排序
+ 001 不区分大小写的排序
+
+如果指定了 nFlags,可以通过传入 -1 来省略其他参数。
- Numeric
+ 数值类型
- All elements included in the sort must be of the same data type. One-dimensional arrays are sorted by their elements; two-dimensional arrays are sorted by their rows. When a two-dimensional array is sorted, the order of the rows in the array is changed so that the elements in a column of the array are in ascending or descending order.
- If the sort is successful, 1 is returned; otherwise –1 is returned.
+ 参与排序的所有元素必须具有相同的数据类型。一维数组按其元素排序;二维数组按其行排序。对二维数组排序时,会更改数组中行的顺序,使数组某一列中的元素按升序或降序排列。如果排序成功,返回 1;否则返回 –1。
@@ -1821,17 +1656,17 @@
- Returns in radians the arc tangent of a numeric expression.
+ 返回数值表达式的反正切值(以弧度表示)。
- Specifies a numeric expression whose arc tangent ATAN( ) returns. nExpression can be any value. The value returned by ATAN( ) can range from –pi/2 through +pi/2 (–1.57079 to 1.57079). The number of decimal places displayed in the value returned by ATAN( ) is determined by SET DECIMALS.
+ 指定要由 ATAN( ) 返回其反正切值的数值表达式。nExpression 可以是任意值。ATAN( ) 返回的值范围为 –pi/2 到 +pi/2(–1.57079 到 1.57079)。ATAN( ) 返回值所显示的小数位数由 SET DECIMALS 决定。
- Numeric
+ 数值类型
- Use RTOD( ) to convert radians to degrees.
+ 使用 RTOD( ) 可将弧度转换为角度。
@@ -1864,26 +1699,22 @@
- Returns the line number of the first occurrence of a character expression or memo field within another character expression or memo field, without regard for the case (upper or lower) of the characters in either expression.
+ 返回一个字符表达式或备注字段在另一个字符表达式或备注字段中首次出现的行号,不考虑两个表达式中字符的大小写。
- Specifies the character expression that ATCLINE( ) searches for in cExpressionSearched.
+ 指定 ATCLINE( ) 在 cExpressionSearched 中搜索的字符表达式。
- Specifies the character expression cSearchExpression searches for.
- Both cSearchExpression and cExpressionSearched can be memo fields of any size. Use MLINE( ) to return the line containing the matching character expression.
- ATCLINE() offers a convenient way to search memo fields.
+ 指定 cSearchExpression 所搜索的字符表达式。cSearchExpression 和 cExpressionSearched 都可以是任意大小的备注字段。使用 MLINE( ) 可返回包含匹配字符表达式的行。ATCLINE() 为搜索备注字段提供了便捷的方式。
- Numeric
+ 数值类型
- If the search is successful, ATCLINE( ) returns the number of the line containing the first character expression. If the search is unsuccessful, ATCLINE( ) returns 0.
- The line number that ATCLINE( ) returns is determined by the value of SET MEMOWIDTH, even if cExpressionSearched isn't a memo field. For more information, see SET MEMOWIDTH.
- Use ATLINE( ) to perform a case-sensitive search.
+ 如果搜索成功,ATCLINE( ) 返回包含第一个字符表达式的行号。如果搜索不成功,ATCLINE( ) 返回 0。ATCLINE( ) 返回的行号由 SET MEMOWIDTH 的值决定,即使 cExpressionSearched 不是备注字段也是如此。有关详细信息,请参见 SET MEMOWIDTH。使用 ATLINE( ) 可执行区分大小写的搜索。
@@ -1908,27 +1739,22 @@
- Returns the line number of the first occurrence of a character expression or memo field within another character expression or memo field, counting from the first line.
+ 从第一行开始计数,返回一个字符表达式或备注字段在另一个字符表达式或备注字段中首次出现的行号。
- Specifies the character expression that X# looks for in cExpressionSearched.
+ 指定 X# 在 cExpressionSearched 中查找的字符表达式。
- Specifies the character expression that cSearchExpression searches for.
- Both cSearchExpression and cExpressionSearched can be memo fields of any size.
- Use MLINE( ) to return the line containing the matching character expression as a character string.
- ATLINE() offers a convenient way to search memo fields.
+ 指定 cSearchExpression 所搜索的字符表达式。cSearchExpression 和 cExpressionSearched 都可以是任意大小的备注字段。使用 MLINE( ) 可将包含匹配字符表达式的行作为字符串返回。ATLINE() 为搜索备注字段提供了便捷的方式。
- Numeric
+ 数值类型
- ATLINE( ) searches the second character expression for the occurrence of the first character expression. ATLINE( ) performs a case-sensitive search. Use ATCLINE( ) to perform a search that isn't case-sensitive.
- If the search is successful, ATLINE( ) returns the number of the line where the match occurs. If the search is unsuccessful, ATLINE( ) returns 0.
- The line number that ATLINE( ) returns is determined by the value of SET MEMOWIDTH, even if cExpressionSearched isn't a memo field. For more information, see SET MEMOWIDTH Command.
+ ATLINE( ) 在第二个字符表达式中搜索第一个字符表达式的出现位置。ATLINE( ) 执行区分大小写的搜索。使用 ATCLINE( ) 可执行不区分大小写的搜索。如果搜索成功,ATLINE( ) 返回匹配所在行的行号。如果搜索不成功,ATLINE( ) 返回 0。ATLINE( ) 返回的行号由 SET MEMOWIDTH 的值决定,即使 cExpressionSearched 不是备注字段也是如此。有关详细信息,请参见 SET MEMOWIDTH Command。
@@ -1953,24 +1779,22 @@
- Returns the arc tangent in all four quadrants from specified values.
+ 根据指定的值返回覆盖全部四个象限的反正切值。
- Specifies the y coordinate.
+ 指定 y 坐标。
- Specifies the x coordinate.
+ 指定 x 坐标。
- Numeric
+ 数值类型
- ATN2( ) returns the angle (in radians) between the line y = 0 and the line connecting the specified coordinates and the origin (0, 0) of the coordinate system.
- ATN2( ) returns a value between – pi/2 and +pi/2.
- You can convert the value returned by ATN2( ) to degrees with RTOD( ). You can specify the number of decimal places that are displayed in the result with SET DECIMALS.
+ ATN2( ) 返回直线 y = 0 与连接指定坐标和坐标系原点 (0, 0) 的直线之间的夹角(以弧度表示)。ATN2( ) 返回介于 – pi/2 和 +pi/2 之间的值。可以使用 RTOD( ) 将 ATN2( ) 返回的值转换为角度。可以使用 SET DECIMALS 指定结果中显示的小数位数。
@@ -1986,53 +1810,35 @@
- Places the information about classes in a class library into an array.
+ 将类库中类的信息放入数组。
- Specifies the name of the array in which the class information is placed. If the array you specify doesn't exist, X# automatically creates the array. If the array exists and isn't large enough to contain the class names and base classes, X# automatically increases the size of the array. If the array is larger than necessary, X# truncates the array.
- The array contains a row for each class in the class library, and each row contains 11 columns containing information about the class. The following table lists the class information in each column.
- Class name.
- OBJNAME
- 2
- Base class of the class.
- BASECLASS
- 3
- Parent class name of the class.
- 4
- Relative path and file name of the parent class library.
- CLASSLOC
- 5
- Relative path and file name of the bitmap for a custom class icon.
- RESERVED4
- 6
- Relative path and file name for a custom Project Manager or Class Browser class icon.
- RESERVED5
- 7
- ScaleMode of the class, Pixels or Foxels.
- RESERVED6
- 8
- Description of the class.
- RESERVED7
- 9
- Relative path and file name for the #INCLUDE file for the class.
- RESERVED8
- 10
- User-defined information for the class.
- USER
- Logical true (.T.) if the class is OLEPUBLIC, otherwise logical false (.F.).
- RESERVED2
+ 指定放置类信息的数组的名称。如果指定的数组不存在,X# 会自动创建该数组。如果数组存在但不足以容纳类名和基类,X# 会自动增大数组。如果数组大于所需大小,X# 会截断该数组。数组中类库的每个类对应一行,每行包含 11 列,用于存放该类的信息。下表列出了每列中的类信息。
+
+ 1 类名。 OBJNAME
+ 2 该类的基类。 BASECLASS
+ 3 该类的父类名称。 CLASS
+ 4 父类库的相对路径和文件名。 CLASSLOC
+ 5 自定义类图标位图的相对路径和文件名。 RESERVED4
+ 6 自定义项目管理器或类浏览器类图标的相对路径和文件名。 RESERVED5
+ 7 该类的 ScaleMode,Pixels 或 Foxels。 RESERVED6
+ 8 该类的说明。 RESERVED7
+ 9 该类的 #INCLUDE 文件的相对路径和文件名。 RESERVED8
+ 10 该类的用户定义信息。 USER
+ 11 如果该类是 OLEPUBLIC,则为逻辑真 (.T.),否则为逻辑假 (.F.)。 RESERVED2
+
- Specifies the name of the class library for which AVCXCLASSES( ) places class information into the array specified with ArrayName. cLibraryName can contain a path to the class library. An error is generated if the class library you specify doesn't exist.
+ 指定类库的名称,AVCXCLASSES( ) 将该类库的类信息放入由 ArrayName 指定的数组中。cLibraryName 可以包含类库的路径。如果指定的类库不存在,将产生错误。
- Numeric
+ 数值类型
- AVCXCLASSES( ) returns the number of rows in the array (the number of classes in the class library).
+ AVCXCLASSES( ) 返回数组中的行数(类库中的类数量)。
@@ -2073,15 +1879,13 @@
- Returns the number of the most recently chosen item from a menu defined with DEFINE POPUP or a menu item chosen from a X# menu.
+ 返回从使用 DEFINE POPUP 定义的菜单中最近选择的项的编号,或从 X# 菜单中选择的菜单项的编号。
- BAR( )Return Value
- Numeric
+ BAR( )返回值 数值类型
- Each item on a menu is assigned a number with DEFINE BAR. When a menu item is chosen from the menu, BAR( ) returns the number assigned to that item. A program can branch to other routines based on the value that BAR( ) returns.
- BAR( ) returns 0 if there is no active menu or if the user presses ESC to exit the menu.
+ 菜单上的每一项都通过 DEFINE BAR 分配一个编号。从菜单中选择某个菜单项时,BAR( ) 返回分配给该项的编号。程序可以根据 BAR( ) 返回的值转到其他例程。如果没有活动菜单,或用户按 ESC 退出菜单,BAR( ) 返回 0。
@@ -2144,32 +1948,32 @@
- Included for compatibility with dBASE.
+ 为与 dBASE 兼容而包含。
- Included for compatibility with dBASE.
+ 为与 dBASE 兼容而包含。
- Determines whether the value of an expression is inclusively between the values of two expressions of the same type.
+ 确定一个表达式的值是否(包含边界)介于两个相同类型表达式的值之间。
- Specifies an expression to evaluate.
+ 指定要计算的表达式。
- Specifies the lower value in the range.
+ 指定范围的下限值。
- Specifies the upper value in the range.
+ 指定范围的上限值。
- Logical or null. BETWEEN( ) returns True (.T.) if the value of the specified expression is equal to one of the values or greater than the lower value and less than the higher value of the two expressions. Otherwise, BETWEEN( ) returns False (.F.). BETWEEN( ) returns a null value if eLowValue or eHighValue is a null value.
+ 逻辑类型或 null。如果指定表达式的值等于这两个表达式中的某一个值,或者大于较小值且小于较大值,BETWEEN( ) 返回 True (.T.)。否则,BETWEEN( ) 返回 False (.F.)。如果 eLowValue 或 eHighValue 为 null 值,BETWEEN( ) 返回 null 值。
@@ -2185,96 +1989,61 @@
- Provides ability to execute user code (an object method) when an event occurs.
- With the first form of the syntax below, you can use BINDEVENT( ) to bind events, properties, or methods from native X# objects to other X# objects.
- With the second syntax variation below, you can bind to Windows Message (Win Msg) events.
- If you want to bind to events from Component Object Model (COM) objects, use the EVENTHANDLER( ) function.
+ 提供在事件发生时执行用户代码(对象方法)的能力。使用下面语法的第一种形式,可以使用 BINDEVENT( ) 将原生 X# 对象的事件、属性或方法绑定到其他 X# 对象。使用下面语法的第二种变体,可以绑定到 Windows 消息(Win Msg)事件。如果要绑定到组件对象模型(COM)对象的事件,请使用 EVENTHANDLER( ) 函数。
- Specifies the event source, which must be a valid X# object.
+ 指定事件源,它必须是有效的 X# 对象。
- Specifies the integer handle of the window that receives Windows Messages.
- If a value of 0 is passed, the specified event (nMessage) is trapped for all windows.
- You can use the hWnd Property (X#) to bind Windows Messages (events) received by _VFP, _SCREEN and instantiated form. ActiveX controls also have an hWnd property
+ 指定接收 Windows 消息的窗口的整数句柄。如果传入 0,则对所有窗口捕获指定的事件 (nMessage)。可以使用 hWnd 属性 (X#) 绑定 _VFP、_SCREEN 和已实例化窗体接收到的 Windows 消息(事件)。ActiveX 控件也具有 hWnd 属性
- Specifies the name of the event, method, or property you want to bind.
+ 指定要绑定的事件、方法或属性的名称。
- Specifies a valid Windows message that is trapped. See MSDN (the Microsoft Developer Network) for information about Windows messages.
+ 指定要捕获的有效 Windows 消息。有关 Windows 消息的信息,请参见 MSDN(Microsoft Developer Network)。
- Specifies the object, which must be a valid X# object, handling the event.
+ 指定处理该事件的对象,它必须是有效的 X# 对象。
- Specifies the method, or "delegate", that handles the event for oEventHandler.
- The delegate method must have the same parameters as the event specified in cEvent. You can call the AEVENTS( ) function to retrieve an object reference to the event source. If the delegate method does not have enough parameters to handle those passed by the event, X# generates an error.
- When trapping for Windows Message (Win Msg) events, the cDelegate method must include a PARAMETERS statement to accept four parameters that get passed to the method. The format of the parameters is identical to the format of the Windows WindowProc function. See MSDN (the Microsoft Developer Network) for information about the Windows WindowProc function. The method must return an integer value.
+ 指定为 oEventHandler 处理该事件的方法,即“委托”。委托方法必须具有与 cEvent 中指定的事件相同的参数。可以调用 AEVENTS( ) 函数来检索事件源的对象引用。如果委托方法没有足够的参数来处理事件传递的参数,X# 会产生错误。捕获 Windows 消息(Win Msg)事件时,cDelegate 方法必须包含 PARAMETERS 语句,以接受传递给该方法的四个参数。这些参数的格式与 Windows WindowProc 函数的格式相同。有关 Windows WindowProc 函数的信息,请参见 MSDN(Microsoft Developer Network)。该方法必须返回一个整数值。
- Specifies an additive bit flag you can set for the event binding operation.
- The nFlags parameter is ignored when a Windows message event binding is created.
- 0
- 000
- FoxPro object
- Call delegate code before event code. (Default)
- 1
- 001
- Call event code before delegate code.
- 2
- 010
- Do not trigger event (call delegate code) by simple method call.
- 3
- 011
- Call event code before delegate code. Do not trigger event (call delegate code) when simple method calls occur.
- 4
- 100
- Windows Message
- Prevents recursion of similar events while user event code is executing.
- The following table shows whether an event is raised when Bit 1 is off or on.
- Interactive
- YES
- Programmatic
- NO
- RAISEEVENT( )
+ 指定可为事件绑定操作设置的累加位标志。创建 Windows 消息事件绑定时会忽略 nFlags 参数。
+
+ 0 000 FoxPro 对象 在事件代码之前调用委托代码。(默认值)
+ 1 001 在委托代码之前调用事件代码。
+ 2 010 不通过简单方法调用触发事件(调用委托代码)。
+ 3 011 在委托代码之前调用事件代码。发生简单方法调用时不触发事件(调用委托代码)。
+ 4 100 Windows 消息 防止在用户事件代码执行期间发生类似事件的递归。
+
+下表显示了位 1 关闭或打开时是否引发事件。
+
+ 交互式 是
+ 编程方式 否
+ RAISEEVENT( )
+
- Numeric data type. BINDEVENT( ) returns the number of bindings for the object's event.
- BINDEVENT( ) always returns 1 when a Windows message event binding is created. No error detection is performed, so if invalid hWnd and nMessage values are specified, 1 is still returned and the binding remains in effect until it is released.
+ 数值类型。BINDEVENT( ) 返回对象事件的绑定数量。创建 Windows 消息事件绑定时,BINDEVENT( ) 始终返回 1。不执行错误检测,因此如果指定了无效的 hWnd 和 nMessage 值,仍然返回 1,并且该绑定会一直有效,直到被释放。
- You can bind to any valid X# object event, property, or method, including the Access and Assign methods. However, the event and delegate methods must be public, not protected or hidden, members of the class.
- You cannot bind to an event with parameters that are passed by reference. Though calling BINDEVENT( ) succeeds, raising the event, for example, using RAISEEVENT( ), fails.
- When you bind to a property, you should bind to it directly and not to the Assign method. If you bind directly to the Assign method, be aware that Access and Assign methods are marked as Protected and are not visible except within the class.
- If you bind to a property that has an Assign method, the delegate method might trigger twice. The first time is when the property assignment call is made. The second time is when the property is actually set, within the Assign method, to the parameter that is passed. The delegate method should be aware of this possibility.
- Normal rules of inheritance apply. If the delegate method does not contain any code, X# traverses up the parent hierarchy.
- An event handler is called when an event occurs or if it is called as a method. Calling the event as a method triggers the event unless you specify an nFlags value of 2 or 3.
- By default, X# calls the delegate method before the event. However, you can change the default behavior by using an nFlags setting.
- If you specify a property as the event you want to bind, X# binds that property to an implicit Assign method. When the value of that property changes, X# triggers an event.
- If an invalid parameter is passed, X# generates the error, "Function argument value, type, or count is invalid." However, if a problem occurs during the binding operation, X# does not generate an error. You can retrieve the return value of BINDEVENT( ) to check the number of bindings.
- Certain control events such as GotFocus, LostFocus, InteractiveChange, and ProgrammaticChange do not work if the second bit of the nFlags parameter is set, for example, nFlags set to 2. These events are treated as method calls internally by X#, even though they are considered events. The same behavior applies to the Refresh method of an object on a form that is called when the form's Refresh method is called. Certain events such as When and Valid require code in the event for it to occur.
-
- BINDEVENT( ) does not directly support the Value property because it is handled by X# in a special way. You should use the InteractiveChange ProgrammaticChange events instead. Additionally, the ActivePage property is not supported.
- If the original event contains a NODEFAULT command, X# still processes the event because it is possible that the delegate method is called before the event. NODEFAULT applies only to native X# events.
- If you make an exact duplicate BINDEVENT( ) call, X# disregards the call but still returns the number of bindings for the object's event. If you change the nFlags setting, you can call BINDEVENT( ) to rebind the event.
- When binding to Windows message (Win Msg) events, only one hWnd to Windows message pairing can exist. You can pass an hWnd value of 0 if you want to bind all windows to the same Windows message event. A Windows message event binding can be released with the UNBINDEVENTS( ) Function and the CLEAR Commands. Also, if the event handler object specified with the oEventHandler parameter no longer exists, the binding is released when its Windows message occurs.
- With a Windows message event binding, your user code will execute whenever an event occurs including scenarios in which a modal dialog is displayed. This is because the Window Procedure must always process the message and return. Since it is possible for recursion to occur with an event while your user code is executing, you may want to specify an nFlags value of 4 to prevent this from happening.
- A Windows message event binding should be used with care since your user code is bound to events being triggered by the Windows operating system and these events can occur at times when you do not expect them to.
+ 可以绑定到任何有效的 X# 对象事件、属性或方法,包括 Access 和 Assign 方法。但是,事件方法和委托方法必须是类的公共成员,而不能是受保护或隐藏的成员。不能绑定到通过引用传递参数的事件。虽然调用 BINDEVENT( ) 会成功,但引发该事件(例如使用 RAISEEVENT( ))会失败。绑定到属性时,应直接绑定到该属性,而不是绑定到 Assign 方法。如果直接绑定到 Assign 方法,请注意 Access 和 Assign 方法被标记为 Protected,除类内部外不可见。如果绑定到具有 Assign 方法的属性,委托方法可能会触发两次。第一次是在进行属性赋值调用时。第二次是在 Assign 方法内部将属性实际设置为所传递的参数时。委托方法应注意这种可能性。适用常规的继承规则。如果委托方法不包含任何代码,X# 会沿父级层次结构向上遍历。当事件发生或作为方法被调用时,会调用事件处理程序。将事件作为方法调用会触发该事件,除非指定 nFlags 值为 2 或 3。默认情况下,X# 在事件之前调用委托方法。但是,可以通过 nFlags 设置更改默认行为。如果指定属性作为要绑定的事件,X# 会将该属性绑定到隐式的 Assign 方法。当该属性的值更改时,X# 会触发一个事件。如果传入了无效参数,X# 会产生错误“Function argument value, type, or count is invalid.”。但是,如果在绑定操作期间出现问题,X# 不会产生错误。可以检索 BINDEVENT( ) 的返回值来检查绑定数量。某些控件事件(如 GotFocus、LostFocus、InteractiveChange 和 ProgrammaticChange)在设置了 nFlags 参数的第二位时(例如 nFlags 设置为 2)不起作用。X# 在内部将这些事件视为方法调用,尽管它们被视为事件。当调用窗体的 Refresh 方法时,窗体上对象的 Refresh 方法也适用相同的行为。某些事件(如 When 和 Valid)要求事件中包含代码才会发生。BINDEVENT( ) 不直接支持 Value 属性,因为 X# 以特殊方式处理它。应改用 InteractiveChange ProgrammaticChange 事件。此外,不支持 ActivePage 属性。如果原始事件包含 NODEFAULT 命令,X# 仍会处理该事件,因为委托方法可能在事件之前被调用。NODEFAULT 仅适用于原生 X# 事件。如果进行完全相同的 BINDEVENT( ) 调用,X# 会忽略该调用,但仍返回对象事件的绑定数量。如果更改 nFlags 设置,可以调用 BINDEVENT( ) 重新绑定事件。绑定到 Windows 消息(Win Msg)事件时,只能存在一个 hWnd 与 Windows 消息的配对。如果要将所有窗口绑定到同一个 Windows 消息事件,可以传入 hWnd 值 0。可以使用 UNBINDEVENTS( ) Function 和 CLEAR Commands 释放 Windows 消息事件绑定。此外,如果 oEventHandler 参数指定的事件处理程序对象已不存在,则在其 Windows 消息发生时会释放该绑定。对于 Windows 消息事件绑定,只要发生事件,用户代码就会执行,包括显示模式对话框的情况。这是因为窗口过程必须始终处理消息并返回。由于在用户代码执行期间事件可能发生递归,可以指定 nFlags 值为 4 以防止这种情况发生。使用 Windows 消息事件绑定时应谨慎,因为用户代码绑定到由 Windows 操作系统触发的事件,而这些事件可能在意料之外的时间发生。
@@ -2296,23 +2065,22 @@
- Determines whether the record pointer is positioned at the beginning of a table.
+ 确定记录指针是否位于表的开头。
- Specifies the work area number for a table open in another work area.
+ 指定在另一个工作区中打开的表的工作区编号。
- Specifies the table alias for a table open in another work area.
- If the table you want to test for a beginning-of-file condition is open in a work area other than the currently selected work area, use these optional arguments to specify the work area number or table alias for the table. If a table isn't open in the work area you specify, BOF( ) returns false (.F.).
+ 指定在另一个工作区中打开的表的表别名。如果要测试文件开头条件的表是在当前选定工作区之外的工作区中打开的,请使用这些可选参数指定该表的工作区编号或表别名。如果在您指定的工作区中没有打开表,BOF( ) 将返回 false (.F.)。
- Logical
+ 逻辑类型
- Use BOF( ) to test for a beginning-of-file condition for a table. BOF( ) returns true (.T.) if you have tried to move the record pointer to a position before the first record in the table.
+ 使用 BOF( ) 测试表的文件开头条件。如果您试图将记录指针移动到表中第一条记录之前的位置,BOF( ) 将返回 true (.T.)。
@@ -2339,296 +2107,69 @@
- Converts an expression from one data type to another.
+ 将表达式从一种数据类型转换为另一种数据类型。
- Specifies a data expression, usually in a SQL statement, that you want to convert to another data type. eExpression can be a field, calculated field, or other type of expression.
+ 指定要转换为另一种数据类型的数据表达式,通常用于 SQL 语句中。eExpression 可以是字段、计算字段或其他类型的表达式。
- Specifies the valid name of or letter representing the target data type name. cDataType can also be an expression that evaluates to a valid data type name or letter representing a valid data type.
- If you specify an expression for cDataType, you must enclose the expression you specify for cDataType with parentheses.
- Some field data types require that you specify a value for nFieldWidth, nPrecision, or both. The following table lists values for cDataType and whether nFieldWidth and nPrecision apply.
- W, Blob
- No
- C, Char, Character
- Yes
- Y, Currency
- D, Date
- T, DateTime
- B, Double
- F, Float
- Floating
- G, General
- I, Int, Integer
- L, Logical
- M, Memo
- N, Num, Numeric
- Q, Varbinary
- V, Varchar
+ 指定目标数据类型名称的有效名称或代表该名称的字母。cDataType 也可以是计算结果为有效数据类型名称或代表有效数据类型的字母的表达式。如果为 cDataType 指定表达式,则必须用括号将为 cDataType 指定的表达式括起来。某些字段数据类型要求为 nFieldWidth、nPrecision 或两者都指定值。下表列出了 cDataType 的取值,以及 nFieldWidth 和 nPrecision 是否适用。
+
+ cDataType nFieldWidth nPrecision
+ W, Blob 否
+ C, Char, Character 是
+ Y, Currency
+ D, Date
+ T, DateTime
+ B, Double
+ F, Float, Floating
+ G, General
+ I, Int, Integer
+ L, Logical
+ M, Memo
+ N, Num, Numeric
+ Q, Varbinary
+ V, Varchar
+
- Specifies the field width for certain data types. X# disregards nFieldWidth for the following data types: D, T, I, Y, L, M, G, and W. If nFieldWidth is not specified, default values are used, for example, as defined by the CREATE TABLE command.
+ 指定某些数据类型的字段宽度。对于以下数据类型,X# 会忽略 nFieldWidth:D、T、I、Y、L、M、G 和 W。如果未指定 nFieldWidth,则使用默认值,例如由 CREATE TABLE 命令定义的默认值。
- Specifies the number of decimal place precision for certain data types. X# disregards nPrecision for the following data types: C, D, T, I, Y, L, M, G, V, Q, and W.
- If nPrecision is not included for the Numeric or Float data type, the default is zero (0), which is no decimal places. If nPrecision is not included for the Double data type, nPrecision defaults to the number of decimal place precision set by the SET DECIMALS command. If nPrecision is not specified for any other data type, default values are used, for example, as defined by the CREATE TABLE command.
- NULL | NOT NULL
- Specifies whether to permit null values in the field.
- If one or more fields can contain null values, the maximum number of fields the table can contain is reduced from 255 to 254.
- If NULL or NOT NULL is not specified, it is inherited from the expression.
-
-
- The following table shows conversions supported by the CAST( ) function. The vertical axis lists the source data type, and the horizontal axis lists the target data type. The following letters describe the level of conversion supported:
- F - Full conversion without loss of data
- P - Partial conversion with possible loss of data
- N - Not supported
-
- C
-
- F
- P
- P
- P
- P
- P
- P
- P
- P
- F
- N
- F
- F
- F
-
- D
-
- F
- F
- F
- N
- N
- N
- N
- N
- N
- F
- N
- F
- N
- N
-
- T
-
- F
- P
- F
- N
- N
- N
- N
- N
- N
- F
- N
- F
- N
- N
-
- N
-
- F
- N
- N
- F
- F
- P
- F
- P
- P
- F
- N
- F
- N
- N
-
- F
-
- F
- N
- N
- F
- F
- P
- F
- P
- P
- F
- N
- F
- N
- N
-
- I
-
- F
- N
- N
- F
- F
- F
- F
- F
- P
- F
- N
- F
- N
- N
-
- B
-
- P
- N
- N
- P
- P
- P
- F
- P
- P
- F
- N
- P
- N
- N
-
- Y
-
- F
- N
- N
- P
- P
- P
- F
- F
- P
- F
- N
- F
- N
- N
-
- L
-
- F
- N
- N
- F
- F
- F
- F
- F
- F
- F
- N
- F
- N
- N
-
- M
-
- P
- P
- P
- P
- P
- P
- P
- P
- P
- F
- N
- P
- P
- F
-
- G
-
- N
- N
- N
- N
- N
- N
- N
- N
- N
- N
- F
- N
- N
- F
-
- V
-
- P
- P
- P
- P
- P
- P
- P
- P
- P
- F
- N
- F
- P
- P
-
- Q
-
- P
- N
- N
- N
- N
- N
- N
- N
- N
- F
- N
- P
- F
- F
-
- W
-
- P
- N
- N
- N
- N
- N
- N
- N
- N
- F
- F
- P
- P
- F
- If you specify decimal precision, conversions between numeric data types, for example, Numeric, Float, Currency, and Double, to Integer data type might result in loss of precision.
- For conversions to Character, Varchar, and Varbinary data types, if the specified field width is less than that of the original data, X# truncates values to fit the field width. For conversions to Character data type, if the specified width is greater than that of the original data, X# pads the field with spaces to the right of the value.
+ 指定某些数据类型的小数位精度。对于以下数据类型,X# 会忽略 nPrecision:C、D、T、I、Y、L、M、G、V、Q 和 W。如果未为 Numeric 或 Float 数据类型指定 nPrecision,则默认值为零 (0),即没有小数位。如果未为 Double 数据类型指定 nPrecision,则 nPrecision 默认为由 SET DECIMALS 命令设置的小数位精度。如果未为任何其他数据类型指定 nPrecision,则使用默认值,例如由 CREATE TABLE 命令定义的默认值。NULL | NOT NULL 指定是否允许字段中包含空值。如果有一个或多个字段可以包含空值,则表可以包含的最大字段数将从 255 减少到 254。如果未指定 NULL 或 NOT NULL,则从表达式继承该设置。
+
+
+ 下表显示了 CAST( ) 函数支持的转换。纵轴列出源数据类型,横轴列出目标数据类型。以下字母描述了所支持的转换级别:
+
+ F 完全转换,数据不丢失
+ P 部分转换,可能丢失数据
+ N 不支持
+
+
+ 源/目标 C D T N F I B Y L M G V Q W
+ C F P P P P P P P P F N F F F
+ D F F F N N N N N N F N F N N
+ T F P F N N N N N N F N F N N
+ N F N N F F P F P P F N F N N
+ F F N N F F P F P P F N F N N
+ I F N N F F F F F P F N F N N
+ B P N N P P P F P P F N P N N
+ Y F N N P P P F F P F N F N N
+ L F N N F F F F F F F N F N N
+ M P P P P P P P P P F N P P F
+ G N N N N N N N N N N F N N F
+ V P P P P P P P P P F N F P P
+ Q P N N N N N N N N F N P F F
+ W P N N N N N N N N F F P P F
+
+如果指定了小数精度,则在数值数据类型(例如 Numeric、Float、Currency 和 Double)与 Integer 数据类型之间进行转换时,可能会损失精度。对于转换为 Character、Varchar 和 Varbinary 数据类型,如果指定的字段宽度小于原始数据的宽度,X# 会截断值以适应字段宽度。对于转换为 Character 数据类型,如果指定的宽度大于原始数据的宽度,X# 会在值的右侧用空格填充字段。
@@ -2640,22 +2181,22 @@
- Returns the day of the week from a given Date or DateTime expression.
+ 从给定的 Date 或 DateTime 表达式返回星期几。
- Specifies the date from which CDOW( ) returns the day.
+ 指定 CDOW( ) 据以返回星期几的日期。
- Specifies the datetime from which CDOW( ) returns the day.
+ 指定 CDOW( ) 据以返回星期几的日期时间。
- Character
+ 字符类型
- CDOW( ) returns the name of the day of the week as a string in proper noun format.
+ CDOW( ) 以专有名词格式的字符串返回星期几的名称。
@@ -2760,17 +2301,16 @@
- Returns the character associated with the specified numeric ANSI code.
+ 返回与指定的数值 ANSI 代码相关联的字符。
- Specifies a number between 0 and 255 whose equivalent ANSI character CHR( ) returns.
- Use ASC( ) to return the ANSI value for a specified character.
+ 指定一个介于 0 和 255 之间的数字,CHR( ) 返回与其等效的 ANSI 字符。使用 ASC( ) 返回指定字符的 ANSI 值。
- Character
+ 字符类型
- CHR( ) returns a single character corresponding to the numeric position of the character in the character table of the current code page. CHR( ) can be used to send printer control codes to a printer.
+ CHR( ) 返回一个字符,该字符对应于其在当前代码页字符表中的数字位置。CHR( ) 可用于向打印机发送打印机控制代码。
@@ -2784,19 +2324,18 @@
- Determines whether or not a character is present in the keyboard buffer.
+ 确定键盘缓冲区中是否存在字符。
- Specifies the time in seconds that CHRSAW( ) waits before checking the keyboard buffer. The keyboard buffer is checked immediately if you omit nSeconds.
- Including nSeconds lets you use CHRSAW( ) for a variety of timed activities. For example, your program can close an application if a key hasn't been pressed for a specific number of seconds.
+ 指定 CHRSAW( ) 在检查键盘缓冲区之前等待的时间(以秒为单位)。如果省略 nSeconds,则立即检查键盘缓冲区。包含 nSeconds 后,可以将 CHRSAW( ) 用于各种定时活动。例如,如果在指定的秒数内没有按下任何键,程序可以关闭应用程序。
- Logical
+ 逻辑类型
- CHRSAW( ) returns True (.T.) if a character is present in the keyboard buffer, and False (.F.) if not. CHRSAW( ) doesn't affect the keyboard buffer contents.
+ 如果键盘缓冲区中存在字符,CHRSAW( ) 返回 True (.T.),否则返回 False (.F.)。CHRSAW( ) 不会影响键盘缓冲区的内容。
@@ -2887,30 +2426,29 @@
- Clears the marker from a cursor marked by SETRESULTSET( ) in the current data session.
+ 清除当前数据会话中由 SETRESULTSET( ) 标记的游标上的标记。
- CLEARRESULTSET( )Return Value
- Numeric. CLEARRESULTSET( ) returns the number of the work area for the previously marked cursor or zero (0) if no cursor is marked in the current data session.
+ CLEARRESULTSET( )返回值 数值类型。CLEARRESULTSET( ) 返回先前标记的游标的工作区编号;如果当前数据会话中没有标记游标,则返回零 (0)。
- CLEARRESULTSET( ) is supported in X# and the X# OLE DB Provider. You can use GETRESULTSET( ) in a database container (DBC) stored procedure or send it to the X# OLE DB Provider, assuming that the cursor has been previously opened by the OLE DB Provider.
+ X# 和 X# OLE DB Provider 支持 CLEARRESULTSET( ) 。假设游标先前已由 OLE DB Provider 打开,您可以在数据库容器 (DBC) 存储过程中使用 GETRESULTSET( ),或将其发送到 X# OLE DB Provider。
- Returns the name of the month from a given date or DateTime expression.
+ 从给定的日期或 DateTime 表达式返回月份的名称。
- Specifies the date expression from which CMONTH( ) returns the name of the month.
+ 指定 CMONTH( ) 据以返回月份名称的日期表达式。
- Character
+ 字符类型
- CMONTH( ) returns the name of the month as a string in proper noun format based on the current resource file you are using and not on the Windows locale. For more information, see Managing Files in an International Application.
+ CMONTH( ) 以专有名词格式的字符串返回月份的名称,该名称基于您当前使用的资源文件,而不是 Windows 区域设置。有关详细信息,请参阅“管理国际化应用程序中的文件”。
@@ -2924,16 +2462,16 @@
- Returns the number of menu items on a user-defined menu or the X# system menu.
+ 返回用户定义菜单或 X# 系统菜单上的菜单项数。
- Specifies the name of the menu for which CNTBAR( ) returns the number of menu items. For a list of the X# system menu names, see the System Menu Names topic.
+ 指定 CNTBAR( ) 返回其菜单项数的菜单名称。有关 X# 系统菜单名称的列表,请参阅“系统菜单名称”主题。
- Numeric
+ 数值类型
- If a user-defined menu is created with the PROMPT option in DEFINE POPUP, X# evaluates the number of menu items when you issue ACTIVATE POPUP. For such a menu, CNTBAR( ) returns a meaningful value only after you activate the menu. However, if the menu items in the menu are created with DEFINE BAR, CNTBAR( ) can determine the number of menu items before you issue ACTIVATE POPUP.
+ 如果使用 DEFINE POPUP 中的 PROMPT 选项创建用户定义菜单,则 X# 会在您发出 ACTIVATE POPUP 时计算菜单项数。对于这样的菜单,CNTBAR( ) 仅在激活菜单之后才返回有意义的值。但是,如果菜单中的菜单项是使用 DEFINE BAR 创建的,则 CNTBAR( ) 可以在发出 ACTIVATE POPUP 之前确定菜单项数。
@@ -3036,13 +2574,13 @@
- Returns the number of menu titles on a user-defined menu bar or the X# system menu bar.
+ 返回用户定义菜单栏或 X# 系统菜单栏上的菜单标题数。
- Specifies the name of the menu bar for which CNTPAD( ) returns the number of menu titles.
+ 指定 CNTPAD( ) 返回其菜单标题数的菜单栏名称。
- Numeric
+ 数值类型
? CNTPAD('_MSYSMENU')
@@ -3050,19 +2588,13 @@
- Included for backward compatibility. Use the CurrentX, CurrentY Properties.
-
- Returns the current column position of the cursor.
+ 为向后兼容而保留。请使用 CurrentX、CurrentY 属性。返回光标的当前列位置。
- Return value - Numeric
+ 返回值 - 数值类型
-
- COL() is especially useful for directing screen output to a column position relative to the current column position of the cursor.
-
- The special operator $ can be used in place of COL().
-
+
COL() 对于将屏幕输出定向到相对于光标当前列位置的某个列位置特别有用。
可以使用特殊运算符 $ 代替 COL()。
@@ -3090,44 +2622,33 @@
- Specifies how to pass arrays to COM objects.
+ 指定如何将数组传递给 COM 对象。
- Specifies an object reference to a COM object.
+ 指定对 COM 对象的对象引用。
- Specifies how to pass an array to a COM object specified with oObject.
- The following table lists the settings for nNewValue and how the to pass the array to the COM object.
- 0
- The array is a zero-based array and is passed by value.
- 1
- The array is a one-based array and is passed by value. Compatible with earlier versions of X#. (Default)
- 10
- The array is a zero-based array and is passed by reference.
- 11
- The array is a one-based array and is passed by reference.
- 100
- The array is a fixed size array and cannot be redimensioned.
- 1000
- Byte arrays are not converted to strings.
- To return the current setting, call COMARRAY( ) without an argument for the nNewValue parameter.
+ 指定如何将数组传递给由 oObject 指定的 COM 对象。下表列出了 nNewValue 的设置以及如何将数组传递给 COM 对象。
+
+ 0 数组是从零开始的数组,按值传递。
+ 1 数组是从一开始的数组,按值传递。与早期版本的 X# 兼容。(默认值)
+ 10 数组是从零开始的数组,按引用传递。
+ 11 数组是从一开始的数组,按引用传递。
+ 100 数组是固定大小的数组,不能重新调整大小。
+ 1000 字节数组不会转换为字符串。
+
+若要返回当前设置,请在调用 COMARRAY( ) 时不为 nNewValue 参数提供参数。
- Numeric. COMARRAY( ) returns the current setting.
+ 数值类型。COMARRAY( ) 返回当前设置。
- Use COMARRAY( ) only when you pass arrays to COM objects using the following syntax:
-
- codeoComObject.Method(@MyArray)/code
-
- If you omit the at sign (@), only the first element of the array passes to the COM object, and COMARRAY( ) has no effect. This behavior is the same as that in earlier versions of X#.
- When you use a byte array (VT_UI1) to communicate with a COM server, X# converts the byte array into a string. The additive nValue of 1000 retains the original proper type of the array and does not convert the result to a string.
- If a client passes a byte array by reference to a X# COM Server, the X# COM Server must also set the nValue additive to 1000. You can do this by putting the following call in the Init event of the X# COM Server:
+ 仅当使用以下语法将数组传递给 COM 对象时才使用 COMARRAY( ):codeoComObject.Method(@MyArray)/code 如果省略 at 符号 (@),则只有数组的第一个元素会传递给 COM 对象,并且 COMARRAY( ) 不起作用。此行为与早期版本的 X# 相同。当使用字节数组 (VT_UI1) 与 COM 服务器通信时,X# 会将字节数组转换为字符串。附加值 nValue 1000 会保留数组的原始正确类型,并且不会将结果转换为字符串。如果客户端将字节数组按引用传递给 X# COM Server,则 X# COM Server 也必须将 nValue 附加值设置为 1000。您可以通过在 X# COM Server 的 Init 事件中放入以下调用来实现:
COMARRAY(THIS,1000)
- The additive nValue of 100 makes it possible for you to prevent redimensioning of an array. You should check for possible errors after calling the server in case the server attempts to redimension the array. The following example shows how to prevent redimensioning of the array. To run this example, first build the class definition into a DLL named "t1.dll".
+ 附加值 nValue 100 使您能够防止数组被重新调整大小。在调用服务器之后,应检查是否可能出现错误,以防服务器尝试重新调整数组的大小。下面的示例演示如何防止重新调整数组的大小。若要运行此示例,请先将类定义生成到名为 "t1.dll" 的 DLL 中。
LOCAL loSvr, laTest
loSvr = NEWOBJECT("t1.arrayhandler")
@@ -3148,69 +2669,71 @@
- Returns registry information about a COM object such as a X# automation server.
+ 返回有关 COM 对象(例如 X# 自动化服务器)的注册表信息。
- An object reference to a COM or OLE object.
+ 对 COM 或 OLE 对象的对象引用。
- Specifies the type of information to return. The following table lists the values for nInfoType and the information returned.
- 1 (Default)
- The object's programmatic identifier (ProgID).A ProgID is a registry entry that can be associated with a CLSID.
- 2
- The object's VersionIndependentProgID.The VersionIndependentProgID associates a ProgID with a CLSID. It is used to determine the latest version of an object application, refers to the application's class, and does not change from version to version.
- 3
- The object's friendly name.
- 4
- The object's class identifier (CLSID). A CLSID is a globally unique identifier that identifies a COM class object.
- 5
- Type of object passed: Return value Description 1 X# object 2 ActiveX Control 3 COM Component 4 OLEBound object (General field)
+ 指定要返回的信息类型。下表列出了 nInfoType 的值以及返回的信息。
+
+ 1(默认值) 对象的编程标识符 (ProgID)。ProgID 是可以与 CLSID 关联的注册表项。
+ 2 对象的 VersionIndependentProgID。VersionIndependentProgID 将 ProgID 与 CLSID 关联起来。它用于确定对象应用程序的最新版本,引用应用程序的类,并且不会随版本变化。
+ 3 对象的友好名称。
+ 4 对象的类标识符 (CLSID)。CLSID 是标识 COM 类对象的全局唯一标识符。
+ 5 所传递对象的类型:
+
+ 返回值 说明
+ 1 X# 对象
+ 2 ActiveX 控件
+ 3 COM 组件
+ 4 OLEBound 对象(General 字段)
+
+
+
- Character
+ 字符类型
- COMCLASSINFO( ) returns the empty string if registry information isn't available for the object you specify. X# automation servers are COM objects, both .exe executable files and .dll dynamic link libraries you can create in the Project Manager.
- If you create an instance of an ActiveX control by using CREATEOBJECT( ) as in the following code, nInfoType returns 3 (COM Component) rather than 2.
+ 如果没有您所指定对象的注册表信息,COMCLASSINFO( ) 将返回空字符串。X# 自动化服务器是 COM 对象,既包括 .exe 可执行文件,也包括您可以在项目管理器中创建的 .dll 动态链接库。如果使用 CREATEOBJECT( ) 创建 ActiveX 控件的实例(如下面的代码所示),nInfoType 将返回 3(COM 组件)而不是 2。
X=CREATEOBJECT("MSComctlLib.treectrl.2")
- To return 2 (ActiveX control) you must use the object as such, as in the following code:
+ 若要返回 2(ActiveX 控件),必须按原样使用该对象,如下面的代码所示:
ox.addobject("oc","olecontrol","MSComctlLib.treectrl.2")
- Sets or returns the behavior setting of a COM object property.
+ 设置或返回 COM 对象属性的行为设置。
- Specifies a reference to a COM object. cProperty is not case sensitive.
- You must use the complete name of the COM object. If you do not provide eValue, COMPROP( ) returns the value of cProperty.
+ 指定对 COM 对象的引用。cProperty 不区分大小写。您必须使用 COM 对象的完整名称。如果不提供 eValue,COMPROP( ) 将返回 cProperty 的值。
- Specifies the name of the COM property to set. The following table lists possible values of cProperty.
- UTF8
- Determines whether UNICODE strings returned from a COM object are converted to ANSI. Conversion is performed by default.
- PUTREF
- Determines if initial object assignment is PROPERTY_PUT (default) or PUTREF.
+ 指定要设置的 COM 属性的名称。下表列出了 cProperty 的可能取值。
+
+ UTF8 确定从 COM 对象返回的 UNICODE 字符串是否转换为 ANSI。默认情况下执行转换。
+ PUTREF 确定初始对象赋值是 PROPERTY_PUT(默认值)还是 PUTREF。
+
- Specifies a value representing behavior to apply to the cProperty. The following table lists values for eValue.
- 0
- Apply default behavior.
- 1
- Apply nondefault behavior as described in the table for cProperty.
- For example, setting an eValue of 1 for UTF8 prevents the display of multi-byte characters as question marks. Setting an eValue of 1 for PUTREF causes X# to attempt object assignment as a PUTREF first and, only if that fails, attempt assignment as a PROPERTY_PUT. Object assignments to properties of some ActiveX controls or COM objects requires PUTREF, and X# defaults to PROPERTY_PUT.
+ 指定要应用于 cProperty 的行为值。下表列出了 eValue 的值。
+
+ 0 应用默认行为。
+ 1 应用 cProperty 表中所述的非默认行为。
+
+例如,将 UTF8 的 eValue 设置为 1 可防止多字节字符显示为问号。将 PUTREF 的 eValue 设置为 1 会使 X# 首先尝试以 PUTREF 方式进行对象赋值,仅当失败时才尝试以 PROPERTY_PUT 方式赋值。对某些 ActiveX 控件或 COM 对象的属性进行对象赋值需要 PUTREF,而 X# 默认使用 PROPERTY_PUT。
- COMPROP( ) returns the value of cProperty.
- The following example returns data from methods of an ADO recordset as UNICODE instead of allowing conversion to ANSI:
+ COMPROP( ) 返回 cProperty 的值。下面的示例以 UNICODE 形式返回 ADO 记录集方法中的数据,而不是允许转换为 ANSI:
LOCAL oConn AS adodb.Connection, oRS AS adodb.Recordset
LOCAL lcStr AS STRING
@@ -3228,43 +2751,40 @@
oConn.Close()
oConn=NULL
- In the following example, an ActiveX control is made to use PUTREF rather than PROPERTY_PUT:
+ 在下面的示例中,使 ActiveX 控件使用 PUTREF 而不是 PROPERTY_PUT:
=COMPROP(oForm.OLECONTROL1, 'PUTREF',1)
- Populates the COM exception structure with information that Automation clients can use to determine the source of Automation errors.
+ 使用自动化客户端可用于确定自动化错误来源的信息填充 COM 异常结构。
- Specifies the text for the source of the exception.
+ 指定异常来源的文本。
- Specifies the text for the description of the exception.
+ 指定异常描述的文本。
- COMRETURNERROR( ) allows X# Automation servers to populate the COM exception structure so that Automation clients can determine the cause of an error on the Automation server.
- Executing COMRETURNERROR( ) places the specified text in the COM exception structure, aborts executing the current method, and returns control to the client. The Automation server remains in memory and the client can call more Automation server methods.
- X# clients can use AERROR( ) to view the text placed on the COM exception structure.
- (For advanced users) COMReturnErrorInfo fills in a COM exception information structure. This is used only for IDispatch (late binding calls). If you call the server via early binding and the client passes a COM exception structure to the server, there is no error mechanism to return the error info unless the client does a QueryInterface on the ISupportsErrorInfo interface.
+ COMRETURNERROR( ) 允许 X# 自动化服务器填充 COM 异常结构,以便自动化客户端可以确定自动化服务器上错误的原因。执行 COMRETURNERROR( ) 会将指定的文本放入 COM 异常结构中,中止当前方法的执行,并将控制权返回给客户端。自动化服务器仍保留在内存中,客户端可以调用更多的自动化服务器方法。X# 客户端可以使用 AERROR( ) 查看放置在 COM 异常结构中的文本。(面向高级用户)COMReturnErrorInfo 填充 COM 异常信息结构。它仅用于 IDispatch(后期绑定调用)。如果通过早期绑定调用服务器,并且客户端将 COM 异常结构传递给服务器,则除非客户端对 ISupportsErrorInfo 接口执行 QueryInterface,否则没有返回错误信息的错误机制。
- Returns the cosine of a numeric expression.
+ 返回数值表达式的余弦值。
- Specifies a numeric expression whose cosine COS( ) returns. nExpression can be any value.
+ 指定要由 COS( ) 返回其余弦值的数值表达式。nExpression 可以是任意值。
- Numeric
+ 数值类型
- COS( ) returns the cosine of nExpression in radians. Use DTOR( ) to convert an angle from degrees to radians. The number of decimal places that COS( ) returns can be specified with SET DECIMALS. The value COS( ) returns ranges between –1 and 1.
+ COS( ) 返回 nExpression 的余弦值,单位为弧度。使用 DTOR( ) 将角度从度转换为弧度。COS( ) 返回的小数位数可以通过 SET DECIMALS 指定。COS( ) 返回的值介于 –1 和 1 之间。
@@ -3290,20 +2810,17 @@
- Converts character type data created in X# to a binary type character string you can pass to an ActiveX control or automation object.
+ 将在 X# 中创建的字符类型数据转换为可传递给 ActiveX 控件或自动化对象的二进制类型字符串。
- Specifies the character expression for which a binary type character string is returned.
+ 指定要为其返回二进制类型字符串的字符表达式。
- Character
+ 字符类型
- X# character strings can contain binary data. However, an ActiveX control or automation object character string (OLE VT_BSTR type data) cannot contain binary data. An ActiveX control or automation object passes binary data to applications such as X# as an array of VT_UI1 type data.
- X# automatically converts binary data passed from an ActiveX control or automation object as an array of VT_UI1 type data to a X# character string. X# internally marks this character string as binary data passed from an ActiveX control or automation object. When the character string is passed back to an ActiveX control or automation object, X# automatically converts the character string to an array of VT_UI1 type data the ActiveX control or automation object expects.
- Use CREATEBINARY( ) to convert character type data created in X# to a binary type character string you can pass to an ActiveX control or automation object. The minimum number of characters to which CREATEBINARY( ) can be abbreviated is 7.
- For more information about ActiveX controls and automation objects, see Sharing Information and Adding OLE.
+ X# 字符串可以包含二进制数据。但是,ActiveX 控件或自动化对象的字符串(OLE VT_BSTR 类型数据)不能包含二进制数据。ActiveX 控件或自动化对象将二进制数据作为 VT_UI1 类型数据的数组传递给 X# 等应用程序。X# 会自动将从 ActiveX 控件或自动化对象传递过来的、作为 VT_UI1 类型数据数组的二进制数据转换为 X# 字符串。X# 在内部将此字符串标记为从 ActiveX 控件或自动化对象传递而来的二进制数据。当该字符串被传回 ActiveX 控件或自动化对象时,X# 会自动将该字符串转换为 ActiveX 控件或自动化对象所期望的 VT_UI1 类型数据数组。使用 CREATEBINARY( ) 将在 X# 中创建的字符类型数据转换为可传递给 ActiveX 控件或自动化对象的二进制类型字符串。CREATEBINARY( ) 最少可以缩写为 7 个字符。有关 ActiveX 控件和自动化对象的详细信息,请参阅“共享信息和添加 OLE”。
@@ -3354,17 +2871,17 @@
- Converts a character expression to a date expression.
+ 将字符表达式转换为日期表达式。
- Specifies a character expression.
+ 指定一个字符表达式。
- Date data type. CTOD( ) returns a Date value.
+ Date 数据类型。CTOD( ) 返回 Date 值。
- CTOD() can create ambiguous Date values and generates a compilation error when SET STRICTDATE is set to 2. To create unambiguous Date values, use the DATE( ) function.
+ CTOD() 可能创建有歧义的 Date 值,并且当 SET STRICTDATE 设置为 2 时会产生编译错误。若要创建无歧义的 Date 值,请使用 DATE( ) 函数。
@@ -3378,17 +2895,17 @@
- Returns the current directory.
+ 返回当前目录。
- Specifies the drive or volume for which CURDIR( ) returns the current directory or folder. If you omit cExpression, the current default drive or volume is assumed. The empty string is returned if the drive or volume you specify in cExpression doesn't exist. Note that this argument is only included for earlier versions of X# and FoxPro running under Window 3.1 or MS-DOS.
+ 指定 CURDIR( ) 返回其当前目录或文件夹的驱动器或卷。如果省略 cExpression,则假定为当前默认驱动器或卷。如果您在 cExpression 中指定的驱动器或卷不存在,则返回空字符串。请注意,此参数仅为兼容早期版本的 X# 以及在 Windows 3.1 或 MS-DOS 下运行的 FoxPro 而保留。
- Character
+ 字符类型
- CURDIR( ) returns, as a character string, the current MS-DOS directory on a specified drive.
+ CURDIR( ) 以字符串形式返回指定驱动器上的当前 MS-DOS 目录。
@@ -3404,28 +2921,27 @@
- Returns the current system date, which is controlled by the operating system, or creates a year 2000-compliant Date value.
+ 返回由操作系统控制的当前系统日期,或创建符合 2000 年问题要求的 Date 值。
- Specifies the year returned in the year 2000-compliant Date value. nYear can be a value from 100 to 9999.
+ 指定在符合 2000 年问题要求的 Date 值中返回的年份。nYear 可以是 100 到 9999 之间的值。
- Specifies the month returned in the year 2000-compliant Date value. nMonth can be a value from 1 to 12.
+ 指定在符合 2000 年问题要求的 Date 值中返回的月份。nMonth 可以是 1 到 12 之间的值。
- Specifies the day returned in the year 2000-compliant Date value. nDay can be a value from 1 to 31.
+ 指定在符合 2000 年问题要求的 Date 值中返回的日。nDay 可以是 1 到 31 之间的值。
- Date
+ 日期类型
- DATE( ) returns the current system date if it is issued without the optional arguments. Include the optional arguments to return a year 2000-compliant Date value in the format set in the Regional tab of the Options dialog box. Any NULL parameter is replaced with the current system value.
- No X# commands or functions can directly change the system date.
+ 如果在不带可选参数的情况下发出 DATE( ),则返回当前系统日期。包含可选参数可返回符合 2000 年问题要求的 Date 值,其格式为“选项”对话框的“区域”选项卡中设置的格式。任何 NULL 参数都将替换为当前系统值。没有任何 X# 命令或函数可以直接更改系统日期。
@@ -3440,43 +2956,42 @@
- Returns the current date and time as a DateTime value, or creates a year 2000-compliant DateTime value.
+ 以 DateTime 值返回当前日期和时间,或创建符合 2000 年问题要求的 DateTime 值。
- Specifies the year returned in the year 2000-compliant DateTime value. nYear can be a value from 100 to 9999.
+ 指定在符合 2000 年问题要求的 DateTime 值中返回的年份。nYear 可以是 100 到 9999 之间的值。
- Specifies the month returned in the year 2000-compliant DateTime value. nMonth can be a value from 1 to 12.
+ 指定在符合 2000 年问题要求的 DateTime 值中返回的月份。nMonth 可以是 1 到 12 之间的值。
- Specifies the day returned in the year 2000-compliant DateTime value. nDay can be a value from 1 to 31.
+ 指定在符合 2000 年问题要求的 DateTime 值中返回的日。nDay 可以是 1 到 31 之间的值。
- Specifies the hours returned in the year 2000-compliant DateTime value. nHours can be a value from 0 (midnight) to 23 (11 P.M). Defaults to 0 if omitted.
+ 指定在符合 2000 年问题要求的 DateTime 值中返回的小时。nHours 可以是 0(午夜)到 23(晚上 11 点)之间的值。如果省略,则默认为 0。
- Specifies the minutes returned in the year 2000-compliant DateTime value. nMinutes can be a value from 0 to 59. Defaults to 0 if omitted.
+ 指定在符合 2000 年问题要求的 DateTime 值中返回的分钟。nMinutes 可以是 0 到 59 之间的值。如果省略,则默认为 0。
- Specifies the seconds returned in the year 2000-compliant DateTime value. nSeconds can be a value from 0 to 59. Defaults to 0 if omitted.
+ 指定在符合 2000 年问题要求的 DateTime 值中返回的秒。nSeconds 可以是 0 到 59 之间的值。如果省略,则默认为 0。
- DateTime
+ 日期时间类型
- DATETIME( ) returns the current system DateTime if it is issued without the optional arguments. Any NULL date parameters are replaced with current system values. A NULL time parameter is replaced with 12:00:00.
- Include the optional arguments to return a year 2000-compliant DateTime value in the format specified in the Regional tab of the Options dialog box.
+ 如果在不带可选参数的情况下发出 DATETIME( ),则返回当前系统 DateTime。任何 NULL 日期参数都将替换为当前系统值。NULL 时间参数将替换为 12:00:00。包含可选参数可返回符合 2000 年问题要求的 DateTime 值,其格式为“选项”对话框的“区域”选项卡中指定的格式。
@@ -3495,23 +3010,23 @@
- Returns the numeric day of the month for a given Date or DateTime expression.
+ 返回给定 Date 或 DateTime 表达式的月份中的日(数值)。
- Specifies a date from which DAY( ) returns a day of the month. dExpression can be a date literal, a Date-type variable, an array element, or a date field.
+ 指定 DAY( ) 从中返回月份中的日的日期。dExpression 可以是日期文字、Date 类型变量、数组元素或日期字段。
- Specifies a date or time from which DAY( ) returns a day of the month. dExpression can be a DateTime literal, a DateTime-type variable, an array element, or a DateTime field.
+ 指定 DAY( ) 从中返回月份中的日的日期或时间。dExpression 可以是 DateTime 文字、DateTime 类型变量、数组元素或 DateTime 字段。
- Numeric
+ 数值类型
- DAY( ) returns a number from 1 through 31.
+ DAY( ) 返回 1 到 31 之间的数字。
@@ -3525,24 +3040,22 @@
- Returns the name of a table open in a specified work area or a table name from a table alias.
+ 返回在指定工作区中打开的表的名称,或根据表别名返回表名称。
- Specifies the table alias.
+ 指定表别名。
- Specifies the work area number.
- If you omit cTableAlias and nWorkArea, DBF( ) returns the name of the table open in the current work area. DBF( ) returns an empty string if a table isn't open in the work area you specify. If a table doesn't have the alias you specify with cTableAlias, X# generates an error message.
- For information on creating an alias for a table, see USE.
+ 指定工作区编号。如果省略 cTableAlias 和 nWorkArea,DBF( ) 将返回当前工作区中打开的表的名称。DBF( ) 如果在您指定的工作区中没有打开表,将返回空字符串。如果没有表具有您通过 cTableAlias 指定的别名,X# 将生成错误消息。有关为表创建别名的信息,请参阅 USE。
- Character
+ 字符类型
- When SET FULLPATH is ON, DBF( ) returns the path to the table with the table name. When SET FULLPATH is OFF, DBF( ) returns the drive on which the table resides with the table name.
+ 当 SET FULLPATH 为 ON 时,DBF( ) 返回包含表名称的表路径。当 SET FULLPATH 为 OFF 时,DBF( ) 返回表所在的驱动器以及表名称。
@@ -3626,75 +3139,57 @@
- Ends an asynchronous dynamic data exchange (DDE) transaction.
+ 结束异步动态数据交换 (DDE) 事务。
- Specifies the transaction number returned by DDEExecute( ), DDEPoke( ),
- or DDERequest( ) when the transaction is sent to the server application.
+ 指定当事务被发送到服务器应用程序时,由 DDEExecute( )、DDEPoke( ) 或 DDERequest( ) 返回的事务编号。
- Logical
+ 逻辑类型
- An asynchronous transaction allows X# program execution to continue without waiting for the server application to respond to a data request.
- DDEExecute( ), DDEPoke( ), and DDERequest( ) wait for the period specified by DDESetOption( ) for a server application to respond,
- unless you specify a user-defined function to execute when the server application responds.
- Specifying a user-defined function to execute in these functions creates an asynchronous transaction.
- If DDEAbortTrans( ) is called before the server has processed the request, the user-defined function will not be called for the transaction.
- DDEAbortTrans( ) returns true (.T.) if the asynchronous transaction is successfully ended and returns false (.F.)
- if the asynchronous transaction cannot be ended. Use DDELastError( ) to determine why the transaction could not be ended.
+ 异步事务允许 X# 程序继续执行,而无需等待服务器应用程序响应数据请求。
DDEExecute( )、DDEPoke( ) 和 DDERequest( ) 会等待 DDESetOption( ) 指定的时间,以便服务器应用程序做出响应,除非您指定了在服务器应用程序响应时执行的用户定义函数。在这些函数中指定要执行的用户定义函数将创建异步事务。
如果在服务器处理请求之前调用了 DDEAbortTrans( ),则不会为该事务调用用户定义函数。
如果异步事务成功结束,DDEAbortTrans( ) 返回 true (.T.);如果无法结束异步事务,则返回 false (.F.)。使用 DDELastError( ) 可确定无法结束该事务的原因。
- Creates a notify link or an automatic link used in a dynamic data exchange (DDE).
+ 创建动态数据交换 (DDE) 中使用的通知链接或自动链接。
- Specifies the channel number.
+ 指定通道编号。
- Specifies the item name. For example, Microsoft Excel uses row and column notation to refer to cells in a worksheet.
- The item name R1C1 designates the cell in the first row and first column of the worksheet.
+ 指定项名称。例如,Microsoft Excel 使用行列表示法来引用工作表中的单元格。项名称 R1C1 表示工作表中第一行第一列的单元格。
- Specifies the user-defined function that is executed when a notify link or an automatic link is established and the item cItemName is modified.
- When the user-defined function is executed, it is passed the following six parameters in the order given below:
- Channel Number
- The channel number of the server application.
- Action
- ADVISE or TERMINATE.
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- The new data (automatic link) or the empty string (notify link).
- Format
- The data format; for example, CF_TEXT.
- Advise Status
- The link type (0 = manual, 1 = notify, 2 = automatic).
- The user-defined function should have six parameters in its LPARAMETER or PARAMETER statement to accept the values passed from the server application. If a notify link is established, the user-defined function is executed and the empty string is passed in the Data parameter. You can issue DDERequest( ) later to retrieve the data. If an automatic link is established, the user-defined function is executed and the data is passed in the Data parameter.
- The Action parameter contains ADVISE when the link is being updated by the server. The user-defined function is called, and the Action parameter contains TERMINATE when the link is closed by the client or server.
- Any value returned by the user-defined function is ignored.
+ 指定当建立通知链接或自动链接并且项 cItemName 被修改时执行的用户定义函数。执行该用户定义函数时,会按以下顺序向其传递六个参数:
+
+ Channel Number 服务器应用程序的通道编号。
+ Action ADVISE 或 TERMINATE。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 新数据(自动链接)或空字符串(通知链接)。
+ Format 数据格式;例如 CF_TEXT。
+ Advise Status 链接类型(0 = 手动,1 = 通知,2 = 自动)。
+
+用户定义函数的 LPARAMETER 或 PARAMETER 语句中应包含六个参数,以接收服务器应用程序传递的值。如果建立的是通知链接,则执行用户定义函数,并在 Data 参数中传递空字符串。您可以稍后发出 DDERequest( ) 来检索数据。如果建立的是自动链接,则执行用户定义函数,并在 Data 参数中传递数据。当服务器更新链接时,Action 参数包含 ADVISE。当客户端或服务器关闭链接时,将调用用户定义函数,并且 Action 参数包含 TERMINATE。用户定义函数返回的任何值都将被忽略。
- Specifies the link type in the following way:
- 0
- Manual
- 1
- Notify
- 2
- Automatic
- You can turn off notification from the server application by specifying 0 for nLinkType. If the item changes, the user-defined function is not executed.
+ 按以下方式指定链接类型:
+
+ 0 手动
+ 1 通知
+ 2 自动
+
+您可以通过为 nLinkType 指定 0 来关闭来自服务器应用程序的通知。如果项发生更改,则不会执行用户定义函数。
- Logical
+ 逻辑类型
- DDEAdvise( ) is used to create a notify link or an automatic link to an item name in a server application. When a notify link is created with DDEAdvise( ), the server application notifies X# that the item name has been modified. If an automatic link is created, the server application notifies X# that the item name has been modified and passes the new data to X#.
- Before you can create a link, you must establish a channel to the server application with DDEInitiate( ).
- You can also use DDEAdvise( ) to turn off notification from the server.
- DDEAdvise( ) returns a true value (.T.) if it executes successfully; otherwise, it returns false (.F.).
+ DDEAdvise( ) 用于创建指向服务器应用程序中某个项名称的通知链接或自动链接。使用 DDEAdvise( ) 创建通知链接时,服务器应用程序会通知 X# 该项名称已被修改。如果创建的是自动链接,服务器应用程序会通知 X# 该项名称已被修改,并将新数据传递给 X#。在创建链接之前,必须先使用 DDEInitiate( ) 建立到服务器应用程序的通道。您也可以使用 DDEAdvise( ) 关闭来自服务器的通知。如果执行成功,DDEAdvise( ) 返回 true 值 (.T.);否则返回 false (.F.)。
@@ -3726,54 +3221,41 @@
- Creates a notify link or an automatic link used in a dynamic data exchange (DDE).
+ 创建动态数据交换 (DDE) 中使用的通知链接或自动链接。
- Specifies the channel number.
+ 指定通道编号。
- Specifies the item name. For example, Microsoft Excel uses row and column notation to refer to cells in a worksheet.
- The item name R1C1 designates the cell in the first row and first column of the worksheet.
+ 指定项名称。例如,Microsoft Excel 使用行列表示法来引用工作表中的单元格。项名称 R1C1 表示工作表中第一行第一列的单元格。
- Specifies the user-defined function that is executed when a notify link or an automatic link is established and the item cItemName is modified.
- When the user-defined function is executed, it is passed the following six parameters in the order given below:
- Channel Number
- The channel number of the server application.
- Action
- ADVISE or TERMINATE.
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- The new data (automatic link) or the empty string (notify link).
- Format
- The data format; for example, CF_TEXT.
- Advise Status
- The link type (0 = manual, 1 = notify, 2 = automatic).
- The user-defined function should have six parameters in its LPARAMETER or PARAMETER statement to accept the values passed from the server application. If a notify link is established, the user-defined function is executed and the empty string is passed in the Data parameter. You can issue DDERequest( ) later to retrieve the data. If an automatic link is established, the user-defined function is executed and the data is passed in the Data parameter.
- The Action parameter contains ADVISE when the link is being updated by the server. The user-defined function is called, and the Action parameter contains TERMINATE when the link is closed by the client or server.
- Any value returned by the user-defined function is ignored.
+ 指定当建立通知链接或自动链接并且项 cItemName 被修改时执行的用户定义函数。执行该用户定义函数时,会按以下顺序向其传递六个参数:
+
+ Channel Number 服务器应用程序的通道编号。
+ Action ADVISE 或 TERMINATE。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 新数据(自动链接)或空字符串(通知链接)。
+ Format 数据格式;例如 CF_TEXT。
+ Advise Status 链接类型(0 = 手动,1 = 通知,2 = 自动)。
+
+用户定义函数的 LPARAMETER 或 PARAMETER 语句中应包含六个参数,以接收服务器应用程序传递的值。如果建立的是通知链接,则执行用户定义函数,并在 Data 参数中传递空字符串。您可以稍后发出 DDERequest( ) 来检索数据。如果建立的是自动链接,则执行用户定义函数,并在 Data 参数中传递数据。当服务器更新链接时,Action 参数包含 ADVISE。当客户端或服务器关闭链接时,将调用用户定义函数,并且 Action 参数包含 TERMINATE。用户定义函数返回的任何值都将被忽略。
- Specifies the link type in the following way:
- 0
- Manual
- 1
- Notify
- 2
- Automatic
- You can turn off notification from the server application by specifying 0 for nLinkType. If the item changes, the user-defined function is not executed.
+ 按以下方式指定链接类型:
+ 0 手动
+ 1 通知
+ 2 自动
+
您可以通过为 nLinkType 指定 0 来关闭来自服务器应用程序的通知。如果项发生更改,则不会执行用户定义函数。
- Logical
+ 逻辑类型
- DDEAdvise( ) is used to create a notify link or an automatic link to an item name in a server application. When a notify link is created with DDEAdvise( ), the server application notifies X# that the item name has been modified. If an automatic link is created, the server application notifies X# that the item name has been modified and passes the new data to X#.
- Before you can create a link, you must establish a channel to the server application with DDEInitiate( ).
- You can also use DDEAdvise( ) to turn off notification from the server.
- DDEAdvise( ) returns a true value (.T.) if it executes successfully; otherwise, it returns false (.F.).
+ DDEAdvise( ) 用于创建指向服务器应用程序中某个项名称的通知链接或自动链接。使用 DDEAdvise( ) 创建通知链接时,服务器应用程序会通知 X# 该项名称已被修改。如果创建的是自动链接,服务器应用程序会通知 X# 该项名称已被修改,并将新数据传递给 X#。在创建链接之前,必须先使用 DDEInitiate( ) 建立到服务器应用程序的通道。您也可以使用 DDEAdvise( ) 关闭来自服务器的通知。如果执行成功,DDEAdvise( ) 返回 true 值 (.T.);否则返回 false (.F.)。
@@ -3805,100 +3287,84 @@
- Enables or disables dynamic data exchange (DDE) processing or returns the status of DDE processing.
+ 启用或禁用动态数据交换 (DDE) 处理,或返回 DDE 处理的状态。
- Specify true (.T.) or false (.F.) to globally enable or disable DDE processing. DDEEnabled( ) returns true (.T.) if DDE processing is successfully enabled or disabled; otherwise false (.F.) is returned.
+ 指定 true (.T.) 或 false (.F.) 以全局启用或禁用 DDE 处理。如果成功启用或禁用 DDE 处理,DDEEnabled( ) 返回 true (.T.);否则返回 false (.F.)。
- Specifies the channel number for the channel whose DDE processing status DDEEnabled( ) returns. DDEEnabled( ) returns true (.T.) if DDE processing is enabled for the specified channel and returns false (.F.) if DDE processing is disabled.
+ 指定通道编号,DDEEnabled( ) 将返回该通道的 DDE 处理状态。如果为指定通道启用了 DDE 处理,DDEEnabled( ) 返回 true (.T.);如果禁用了 DDE 处理,则返回 false (.F.)。
- To enable DDE processing for a specific channel, include the channel number (nChannelNumber) and specify true (.T.) for lExpression2. To disable DDE processing for a specific channel, include the channel number (nChannelNumber) and specify false (.F.) for lExpression2.
+ 要为特定通道启用 DDE 处理,请包含通道编号 (nChannelNumber),并为 lExpression2 指定 true (.T.)。要为特定通道禁用 DDE 处理,请包含通道编号 (nChannelNumber),并为 lExpression2 指定 false (.F.)。
- Logical
+ 逻辑类型
- Using DDEEnabled( ), you can globally enable or disable processing. You can also enable or disable DDE processing for specific channels.
-
- DDEEnabled( ) can be used to protect critical code or disable links for short periods. When DDE processing is disabled, client requests are queued until DDE processing is enabled.
- If DDEEnabled( ) is issued without any of its optional arguments, the global DDE processing status is returned. DDEEnabled( ) returns true (.T.) if DDE processing has been globally enabled and false (.F.) if DDE processing has been globally disabled.
+ 使用 DDEEnabled( ),可以全局启用或禁用处理。您也可以为特定通道启用或禁用 DDE 处理。DDEEnabled( ) 可用于保护关键代码,或在短时间内禁用链接。禁用 DDE 处理时,客户端请求将排队等待,直到重新启用 DDE 处理。如果发出 DDEEnabled( ) 时不带任何可选参数,则返回全局 DDE 处理状态。如果已全局启用 DDE 处理,DDEEnabled( ) 返回 true (.T.);如果已全局禁用 DDE 处理,则返回 false (.F.)。
- Enables or disables dynamic data exchange (DDE) processing or returns the status of DDE processing.
+ 启用或禁用动态数据交换 (DDE) 处理,或返回 DDE 处理的状态。
- Specify true (.T.) or false (.F.) to globally enable or disable DDE processing. DDEEnabled( ) returns true (.T.) if DDE processing is successfully enabled or disabled; otherwise false (.F.) is returned.
+ 指定 true (.T.) 或 false (.F.) 以全局启用或禁用 DDE 处理。如果成功启用或禁用 DDE 处理,DDEEnabled( ) 返回 true (.T.);否则返回 false (.F.)。
- Specifies the channel number for the channel whose DDE processing status DDEEnabled( ) returns. DDEEnabled( ) returns true (.T.) if DDE processing is enabled for the specified channel and returns false (.F.) if DDE processing is disabled.
+ 指定通道编号,DDEEnabled( ) 将返回该通道的 DDE 处理状态。如果为指定通道启用了 DDE 处理,DDEEnabled( ) 返回 true (.T.);如果禁用了 DDE 处理,则返回 false (.F.)。
- To enable DDE processing for a specific channel, include the channel number (nChannelNumber) and specify true (.T.) for lExpression2. To disable DDE processing for a specific channel, include the channel number (nChannelNumber) and specify false (.F.) for lExpression2.
+ 要为特定通道启用 DDE 处理,请包含通道编号 (nChannelNumber),并为 lExpression2 指定 true (.T.)。要为特定通道禁用 DDE 处理,请包含通道编号 (nChannelNumber),并为 lExpression2 指定 false (.F.)。
- Logical
+ 逻辑类型
- Using DDEEnabled( ), you can globally enable or disable processing. You can also enable or disable DDE processing for specific channels.
-
- DDEEnabled( ) can be used to protect critical code or disable links for short periods. When DDE processing is disabled, client requests are queued until DDE processing is enabled.
- If DDEEnabled( ) is issued without any of its optional arguments, the global DDE processing status is returned. DDEEnabled( ) returns true (.T.) if DDE processing has been globally enabled and false (.F.) if DDE processing has been globally disabled.
+ 使用 DDEEnabled( ),可以全局启用或禁用处理。您也可以为特定通道启用或禁用 DDE 处理。DDEEnabled( ) 可用于保护关键代码,或在短时间内禁用链接。禁用 DDE 处理时,客户端请求将排队等待,直到重新启用 DDE 处理。如果发出 DDEEnabled( ) 时不带任何可选参数,则返回全局 DDE 处理状态。如果已全局启用 DDE 处理,DDEEnabled( ) 返回 true (.T.);如果已全局禁用 DDE 处理,则返回 false (.F.)。
- Sends a command to another application, using dynamic data exchange (DDE).
+ 使用动态数据交换 (DDE) 向另一个应用程序发送命令。
- Specifies the channel number.
+ 指定通道编号。
- Specifies the command you want to send to the other application. The format of the command is determined by the application you are sending it to. Consult the application's documentation for the correct syntax.
+ 指定要发送给另一个应用程序的命令。命令的格式由接收命令的应用程序决定。请查阅该应用程序的文档以了解正确的语法。
- Allows asynchronous command execution requests. If you omit cUDFName, a client application waits for the period specified with DDESetOption( ). If you specify a user-defined function with cUDFName, client program execution continues immediately after the command execution request is made.
- When the server application finishes executing the command, the user-defined function you specify with cUDFName is executed. The user-defined function is passed six parameters in the order shown in the following table.
- Channel Number
- The channel number of the server application.
- Action
- XACTCOMPLETE (successful execution).XACTFAIL (failed command execution).
- Item
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- The new data (REQUEST) or data passed (POKE or EXECUTED).
- Format
- The data format; for example, CF_TEXT.
- Transaction Number
- The transaction number returned by DDEExecute( ).
- Use DDEAbortTrans( ) to cancel an uncompleted transaction. If the transaction fails, you can use DDELastError( ) to determine why it failed.
- When you include cUDFName, DDEExecute( ) does not return a logical value. Instead, a transaction number is returned; if an error occurs, –1 is returned.
+ 允许异步命令执行请求。如果省略 cUDFName,客户端应用程序将等待 DDESetOption( ) 指定的时间。如果使用 cUDFName 指定了用户定义函数,则在发出命令执行请求后,客户端程序会立即继续执行。当服务器应用程序执行完命令后,将执行您通过 cUDFName 指定的用户定义函数。该用户定义函数按下表所示的顺序接收六个参数。
+ Channel Number 服务器应用程序的通道编号。
+ Action XACTCOMPLETE(执行成功)。XACTFAIL(命令执行失败)。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 新数据 (REQUEST) 或传递的数据 (POKE 或 EXECUTED)。
+ Format 数据格式;例如 CF_TEXT。
+ Transaction Number DDEExecute( ) 返回的事务编号。
+
使用 DDEAbortTrans( ) 可取消未完成的事务。如果事务失败,可以使用 DDELastError( ) 确定失败的原因。包含 cUDFName 时,DDEExecute( ) 不返回逻辑值,而是返回事务编号;如果发生错误,则返回 –1。
- Logical
+ 逻辑类型
- The command sent with DDEExecute( ) must be understood by the application. Before you can execute the command, you must establish a channel to the server application with DDEInitiate( ).
- For example, Microsoft Excel has an extensive set of macro commands, including DDE commands that let you request data from X# from within Microsoft Excel. If you establish a channel to Microsoft Excel, you can then use DDEExecute( ) to send macro commands to Excel from within X#.
- If the receiving application successfully executes the command, DDEExecute( ) returns true (.T.). If the receiving application cannot successfully execute the command or if the channel number you include is not valid, DDEExecute( ) returns false (.F.). If the optional asynchronous user-defined function cUDFName is included, a transaction number is returned. If an error occurs, DDEExecute( ) returns –1.
+ 通过 DDEExecute( ) 发送的命令必须能被接收应用程序理解。在执行命令之前,必须先使用 DDEInitiate( ) 建立到服务器应用程序的通道。例如,Microsoft Excel 具有一组丰富的宏命令,其中包括允许您在 Microsoft Excel 中向 X# 请求数据的 DDE 命令。如果建立了到 Microsoft Excel 的通道,则可以在 X# 中使用 DDEExecute( ) 向 Excel 发送宏命令。如果接收应用程序成功执行了该命令,DDEExecute( ) 返回 true (.T.)。如果接收应用程序无法成功执行该命令,或者您提供的通道编号无效,DDEExecute( ) 返回 false (.F.)。如果包含了可选的异步用户定义函数 cUDFName,则返回事务编号。如果发生错误,DDEExecute( ) 返回 –1。
@@ -3915,44 +3381,34 @@
- Sends a command to another application, using dynamic data exchange (DDE).
+ 使用动态数据交换 (DDE) 向另一个应用程序发送命令。
- Specifies the channel number.
+ 指定通道编号。
- Specifies the command you want to send to the other application. The format of the command is determined by the application you are sending it to. Consult the application's documentation for the correct syntax.
+ 指定要发送给另一个应用程序的命令。命令的格式由接收命令的应用程序决定。请查阅该应用程序的文档以了解正确的语法。
- Allows asynchronous command execution requests. If you omit cUDFName, a client application waits for the period specified with DDESetOption( ). If you specify a user-defined function with cUDFName, client program execution continues immediately after the command execution request is made.
- When the server application finishes executing the command, the user-defined function you specify with cUDFName is executed. The user-defined function is passed six parameters in the order shown in the following table.
- Channel Number
- The channel number of the server application.
- Action
- XACTCOMPLETE (successful execution).XACTFAIL (failed command execution).
- Item
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- The new data (REQUEST) or data passed (POKE or EXECUTED).
- Format
- The data format; for example, CF_TEXT.
- Transaction Number
- The transaction number returned by DDEExecute( ).
- Use DDEAbortTrans( ) to cancel an uncompleted transaction. If the transaction fails, you can use DDELastError( ) to determine why it failed.
- When you include cUDFName, DDEExecute( ) does not return a logical value. Instead, a transaction number is returned; if an error occurs, –1 is returned.
+ 允许异步命令执行请求。如果省略 cUDFName,客户端应用程序将等待 DDESetOption( ) 指定的时间。如果使用 cUDFName 指定了用户定义函数,则在发出命令执行请求后,客户端程序会立即继续执行。当服务器应用程序执行完命令后,将执行您通过 cUDFName 指定的用户定义函数。该用户定义函数按下表所示的顺序接收六个参数。
+ Channel Number 服务器应用程序的通道编号。
+ Action XACTCOMPLETE(执行成功)。XACTFAIL(命令执行失败)。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 新数据 (REQUEST) 或传递的数据 (POKE 或 EXECUTED)。
+ Format 数据格式;例如 CF_TEXT。
+ Transaction Number DDEExecute( ) 返回的事务编号。
+
使用 DDEAbortTrans( ) 可取消未完成的事务。如果事务失败,可以使用 DDELastError( ) 确定失败的原因。包含 cUDFName 时,DDEExecute( ) 不返回逻辑值,而是返回事务编号;如果发生错误,则返回 –1。
- Logical
+ 逻辑类型
- The command sent with DDEExecute( ) must be understood by the application. Before you can execute the command, you must establish a channel to the server application with DDEInitiate( ).
- For example, Microsoft Excel has an extensive set of macro commands, including DDE commands that let you request data from X# from within Microsoft Excel. If you establish a channel to Microsoft Excel, you can then use DDEExecute( ) to send macro commands to Excel from within X#.
- If the receiving application successfully executes the command, DDEExecute( ) returns true (.T.). If the receiving application cannot successfully execute the command or if the channel number you include is not valid, DDEExecute( ) returns false (.F.). If the optional asynchronous user-defined function cUDFName is included, a transaction number is returned. If an error occurs, DDEExecute( ) returns –1.
+ 通过 DDEExecute( ) 发送的命令必须能被接收应用程序理解。在执行命令之前,必须先使用 DDEInitiate( ) 建立到服务器应用程序的通道。例如,Microsoft Excel 具有一组丰富的宏命令,其中包括允许您在 Microsoft Excel 中向 X# 请求数据的 DDE 命令。如果建立了到 Microsoft Excel 的通道,则可以在 X# 中使用 DDEExecute( ) 向 Excel 发送宏命令。如果接收应用程序成功执行了该命令,DDEExecute( ) 返回 true (.T.)。如果接收应用程序无法成功执行该命令,或者您提供的通道编号无效,DDEExecute( ) 返回 false (.F.)。如果包含了可选的异步用户定义函数 cUDFName,则返回事务编号。如果发生错误,DDEExecute( ) 返回 –1。
@@ -3969,28 +3425,23 @@
- Establishes a dynamic data exchange (DDE) channel between X# and another Microsoft Windows-based application.
+ 在 X# 与另一个基于 Microsoft Windows 的应用程序之间建立动态数据交换 (DDE) 通道。
- Specifies the service name of the server application, which, in most cases, is the name of the executable file without its extension. The default service name for X# is X#. If you are establishing a channel to Microsoft Excel, cServiceName is Excel.
+ 指定服务器应用程序的服务名称,在大多数情况下,它是不带扩展名的可执行文件名。X# 的默认服务名称为 X#。如果要建立到 Microsoft Excel 的通道,则 cServiceName 为 Excel。
- Specifies the topic name. The topic is application-specific and must be understood by the application. For example, one topic supplied by most DDE servers is the System topic. See the application documentation for the service and topic names supported by the application.
+ 指定主题名称。主题特定于应用程序,并且必须能被该应用程序理解。例如,大多数 DDE 服务器提供的一个主题是 System 主题。有关应用程序支持的服务名称和主题名称,请参阅该应用程序的文档。
- Numeric
+ 数值类型
- DDEInitiate( ) establishes a DDE channel between X# and a DDE server application. Once a channel is established, X# can request data from the server by referring to the channel in subsequent DDE functions. X# acts as the client, requesting data from the server application through the channel.
- If the channel is successfully established, DDEInitiate( ) returns the channel number. Channel numbers are non-negative, and the number of channels you can establish is limited only by your system resources.
-
- DDEInitiate( ) returns –1 if the channel cannot be established. If the server application is not open, X# asks if you would like to open it. If you choose Yes, X# attempts to open the application. (You can use DDELastError( ) to determine why a channel cannot be established.)
- To avoid being asked whether you want to open the application, set the DDESetOption( ) SAFETY option. You can also use RUN with the /N option to start the application.
- A channel can be closed with DDETerminate( ).
+ DDEInitiate( ) 在 X# 与 DDE 服务器应用程序之间建立 DDE 通道。通道建立后,X# 可以在后续的 DDE 函数中通过引用该通道向服务器请求数据。X# 作为客户端,通过该通道向服务器应用程序请求数据。如果成功建立通道,DDEInitiate( ) 返回通道编号。通道编号为非负数,可建立的通道数量仅受系统资源限制。如果无法建立通道,DDEInitiate( ) 返回 –1。如果服务器应用程序未打开,X# 会询问您是否要打开它。如果选择“是”,X# 将尝试打开该应用程序。(您可以使用 DDELastError( ) 确定无法建立通道的原因。)要避免出现是否打开应用程序的询问,请设置 DDESetOption( ) 的 SAFETY 选项。您也可以使用带 /N 选项的 RUN 来启动应用程序。可以使用 DDETerminate( ) 关闭通道。
@@ -4004,28 +3455,23 @@
- Establishes a dynamic data exchange (DDE) channel between X# and another Microsoft Windows-based application.
+ 在 X# 与另一个基于 Microsoft Windows 的应用程序之间建立动态数据交换 (DDE) 通道。
- Specifies the service name of the server application, which, in most cases, is the name of the executable file without its extension. The default service name for X# is X#. If you are establishing a channel to Microsoft Excel, cServiceName is Excel.
+ 指定服务器应用程序的服务名称,在大多数情况下,它是不带扩展名的可执行文件名。X# 的默认服务名称为 X#。如果要建立到 Microsoft Excel 的通道,则 cServiceName 为 Excel。
- Specifies the topic name. The topic is application-specific and must be understood by the application. For example, one topic supplied by most DDE servers is the System topic. See the application documentation for the service and topic names supported by the application.
+ 指定主题名称。主题特定于应用程序,并且必须能被该应用程序理解。例如,大多数 DDE 服务器提供的一个主题是 System 主题。有关应用程序支持的服务名称和主题名称,请参阅该应用程序的文档。
- Numeric
+ 数值类型
- DDEInitiate( ) establishes a DDE channel between X# and a DDE server application. Once a channel is established, X# can request data from the server by referring to the channel in subsequent DDE functions. X# acts as the client, requesting data from the server application through the channel.
- If the channel is successfully established, DDEInitiate( ) returns the channel number. Channel numbers are non-negative, and the number of channels you can establish is limited only by your system resources.
-
- DDEInitiate( ) returns –1 if the channel cannot be established. If the server application is not open, X# asks if you would like to open it. If you choose Yes, X# attempts to open the application. (You can use DDELastError( ) to determine why a channel cannot be established.)
- To avoid being asked whether you want to open the application, set the DDESetOption( ) SAFETY option. You can also use RUN with the /N option to start the application.
- A channel can be closed with DDETerminate( ).
+ DDEInitiate( ) 在 X# 与 DDE 服务器应用程序之间建立 DDE 通道。通道建立后,X# 可以在后续的 DDE 函数中通过引用该通道向服务器请求数据。X# 作为客户端,通过该通道向服务器应用程序请求数据。如果成功建立通道,DDEInitiate( ) 返回通道编号。通道编号为非负数,可建立的通道数量仅受系统资源限制。如果无法建立通道,DDEInitiate( ) 返回 –1。如果服务器应用程序未打开,X# 会询问您是否要打开它。如果选择“是”,X# 将尝试打开该应用程序。(您可以使用 DDELastError( ) 确定无法建立通道的原因。)要避免出现是否打开应用程序的询问,请设置 DDESetOption( ) 的 SAFETY 选项。您也可以使用带 /N 选项的 RUN 来启动应用程序。可以使用 DDETerminate( ) 关闭通道。
@@ -4039,280 +3485,199 @@
- Returns an error number for the last dynamic data exchange (DDE) function.
-
-
- DDELastError( )Return Value
- Numeric
-
-
- You can use DDELastError( ) to help determine the cause of an error when a DDE function does not execute successfully.
-
- DDELastError( ) returns 0 if the last DDE function executed successfully. It returns a nonzero value if the last DDE function was unsuccessful. The following table lists the error numbers and their descriptions.
- 1
- Service busy
- 2
- Topic busy
- 3
- Channel busy
- 4
- No such service
- 5
- No such topic
- 6
- Bad channel
- 7
- Insufficient memory
- 8
- Acknowledge timeout
- 9
- Request timeout
- 10
- No DDEInitiate( )
- 11
- Client attempted server transaction
- 12
- Execute timeout
- 13
- Bad parameter
- 14
- Low memory
- 15
- Memory error
- 16
- Connect failure
- 17
- Request failure
- 18
- Poke timeout
- 19
- Could not display message
- 20
- Multiple synchronous transactions
- 21
- Server died
- 22
- Internal DDE error
- 23
- Advise timeout
- 24
- Invalid transaction identifier
- 25
- Unknown
+ 返回最后一个动态数据交换 (DDE) 函数的错误号。
+
+
+ DDELastError( )返回值 数值类型
+
+
+ 当 DDE 函数执行不成功时,可以使用 DDELastError( ) 来帮助确定错误原因。如果最后一个 DDE 函数执行成功,DDELastError( ) 返回 0;如果最后一个 DDE 函数执行失败,则返回非零值。下表列出了错误号及其说明。
+ 1 服务忙
+ 2 主题忙
+ 3 通道忙
+ 4 无此服务
+ 5 无此主题
+ 6 通道错误
+ 7 内存不足
+ 8 确认超时
+ 9 请求超时
+ 10 没有 DDEInitiate( )
+ 11 客户端尝试执行服务器事务
+ 12 执行超时
+ 13 参数错误
+ 14 内存不足
+ 15 内存错误
+ 16 连接失败
+ 17 请求失败
+ 18 Poke 超时
+ 19 无法显示消息
+ 20 多个同步事务
+ 21 服务器已终止
+ 22 内部 DDE 错误
+ 23 Advise 超时
+ 24 无效的事务标识符
+ 25 未知
+
- Returns an error number for the last dynamic data exchange (DDE) function.
-
-
- DDELastError( )Return Value
- Numeric
-
-
- You can use DDELastError( ) to help determine the cause of an error when a DDE function does not execute successfully.
-
- DDELastError( ) returns 0 if the last DDE function executed successfully. It returns a nonzero value if the last DDE function was unsuccessful. The following table lists the error numbers and their descriptions.
- 1
- Service busy
- 2
- Topic busy
- 3
- Channel busy
- 4
- No such service
- 5
- No such topic
- 6
- Bad channel
- 7
- Insufficient memory
- 8
- Acknowledge timeout
- 9
- Request timeout
- 10
- No DDEInitiate( )
- 11
- Client attempted server transaction
- 12
- Execute timeout
- 13
- Bad parameter
- 14
- Low memory
- 15
- Memory error
- 16
- Connect failure
- 17
- Request failure
- 18
- Poke timeout
- 19
- Could not display message
- 20
- Multiple synchronous transactions
- 21
- Server died
- 22
- Internal DDE error
- 23
- Advise timeout
- 24
- Invalid transaction identifier
- 25
- Unknown
+ 返回最后一个动态数据交换 (DDE) 函数的错误号。
+
+
+ DDELastError( )返回值 数值类型
+
+
+ 当 DDE 函数执行不成功时,可以使用 DDELastError( ) 来帮助确定错误原因。如果最后一个 DDE 函数执行成功,DDELastError( ) 返回 0;如果最后一个 DDE 函数执行失败,则返回非零值。下表列出了错误号及其说明。
+ 1 服务忙
+ 2 主题忙
+ 3 通道忙
+ 4 无此服务
+ 5 无此主题
+ 6 通道错误
+ 7 内存不足
+ 8 确认超时
+ 9 请求超时
+ 10 没有 DDEInitiate( )
+ 11 客户端尝试执行服务器事务
+ 12 执行超时
+ 13 参数错误
+ 14 内存不足
+ 15 内存错误
+ 16 连接失败
+ 17 请求失败
+ 18 Poke 超时
+ 19 无法显示消息
+ 20 多个同步事务
+ 21 服务器已终止
+ 22 内部 DDE 错误
+ 23 Advise 超时
+ 24 无效的事务标识符
+ 25 未知
+
- Sends data between client and server applications in a dynamic data exchange (DDE) conversation.
+ 在动态数据交换 (DDE) 会话中,在客户端应用程序与服务器应用程序之间发送数据。
- Specifies the channel number of the application data is sent to. If the channel number is a server channel, DDEPoke( ) sends the data in response to a request or a previously established notify or automatic link.
+ 指定数据所发送到的应用程序的通道号。如果该通道号是服务器通道,DDEPoke( ) 会将数据作为对请求或先前建立的通知链接或自动链接的响应发送。
- Specifies the item name to which data is sent. The item name is application-specific and must be understood by the application. For example, Microsoft Excel supports R1C1 as a valid item name that refers to the first cell in a worksheet.
+ 指定数据所发送到的项名称。项名称因应用程序而异,必须能被该应用程序识别。例如,Microsoft Excel 支持 R1C1 作为有效的项名称,它引用工作表中的第一个单元格。
- Specifies the data sent to the item name specified with cItemName.
+ 指定发送到 cItemName 所指定项名称的数据。
- Specifies the format used to send the data. The default format is CF_TEXT. In this format, fields are delimited with tabs and records are delimited with a carriage return and a linefeed.
+ 指定发送数据所使用的格式。默认格式为 CF_TEXT。在此格式中,字段以制表符分隔,记录以回车符和换行符分隔。
- Allows asynchronous data transfer. If cUDFName is omitted, a client waits for the period specified with DDESetOption( ). If you specify the name of a user-defined function with cUDFName, client program execution continues immediately after the request is made.
- When the data is available from the server application, the user-defined function specified with cUDFName is executed. The user-defined function is passed six parameters in this order:
- Channel Number
- The channel number of the server application.
- Action
- XACTCOMPLETE (successful transaction).XACTFAIL (failed transaction).
- Item
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- The new data (REQUEST) or data passed (POKE or EXECUTED).
- Format
- The data format; for example, CF_TEXT.
- Transaction Number
- The transaction number returned by DDEPoke( ).
- Use DDEAbortTrans( ) to cancel an uncompleted transaction. If the transaction fails, you can use DDELastError( ) to determine why it failed.
- When you include cUDFName, DDEPoke( ) returns a transaction number if successful or –1 if an error occurs.
+ 允许异步数据传输。如果省略 cUDFName,客户端将等待 DDESetOption( ) 所指定的时间。如果使用 cUDFName 指定了用户定义函数的名称,则在发出请求后客户端程序将立即继续执行。当服务器应用程序提供了数据后,将执行 cUDFName 所指定的用户定义函数。该用户定义函数按以下顺序接收六个参数:
+ Channel Number 服务器应用程序的通道号。
+ Action XACTCOMPLETE(事务成功)。XACTFAIL(事务失败)。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 新数据 (REQUEST) 或传递的数据 (POKE 或 EXECUTED)。
+ Format 数据格式;例如 CF_TEXT。
+ Transaction Number DDEPoke( ) 返回的事务号。
+
使用 DDEAbortTrans( ) 可取消未完成的事务。如果事务失败,可以使用 DDELastError( ) 确定失败原因。如果包含 cUDFName,DDEPoke( ) 在成功时返回事务号,发生错误时返回 –1。
- Logical
+ 逻辑类型
- DDEPoke( ) sends data as a character string to the item name in the application specified by the channel number.
- If the data is successfully sent, DDEPoke( ) returns true (.T.). If the data cannot be sent, DDEPoke( ) returns false (.F.). If the asynchronous user-defined function cUDFName is included, DDEPoke( ) returns a transaction number; if an error occurs, DDEPoke( ) returns –1.
+ DDEPoke( ) 将数据作为字符串发送到由通道号指定的应用程序中的项名称。如果数据发送成功,DDEPoke( ) 返回 true (.T.)。如果无法发送数据,DDEPoke( ) 返回 false (.F.)。如果包含异步用户定义函数 cUDFName,DDEPoke( ) 返回事务号;如果发生错误,DDEPoke( ) 返回 –1。
- Sends data between client and server applications in a dynamic data exchange (DDE) conversation.
+ 在动态数据交换 (DDE) 会话中,在客户端应用程序与服务器应用程序之间发送数据。
- Specifies the channel number of the application data is sent to. If the channel number is a server channel, DDEPoke( ) sends the data in response to a request or a previously established notify or automatic link.
+ 指定数据所发送到的应用程序的通道号。如果该通道号是服务器通道,DDEPoke( ) 会将数据作为对请求或先前建立的通知链接或自动链接的响应发送。
- Specifies the item name to which data is sent. The item name is application-specific and must be understood by the application. For example, Microsoft Excel supports R1C1 as a valid item name that refers to the first cell in a worksheet.
+ 指定数据所发送到的项名称。项名称因应用程序而异,必须能被该应用程序识别。例如,Microsoft Excel 支持 R1C1 作为有效的项名称,它引用工作表中的第一个单元格。
- Specifies the data sent to the item name specified with cItemName.
+ 指定发送到 cItemName 所指定项名称的数据。
- Specifies the format used to send the data. The default format is CF_TEXT. In this format, fields are delimited with tabs and records are delimited with a carriage return and a linefeed.
+ 指定发送数据所使用的格式。默认格式为 CF_TEXT。在此格式中,字段以制表符分隔,记录以回车符和换行符分隔。
- Allows asynchronous data transfer. If cUDFName is omitted, a client waits for the period specified with DDESetOption( ). If you specify the name of a user-defined function with cUDFName, client program execution continues immediately after the request is made.
- When the data is available from the server application, the user-defined function specified with cUDFName is executed. The user-defined function is passed six parameters in this order:
- Channel Number
- The channel number of the server application.
- Action
- XACTCOMPLETE (successful transaction).XACTFAIL (failed transaction).
- Item
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- The new data (REQUEST) or data passed (POKE or EXECUTED).
- Format
- The data format; for example, CF_TEXT.
- Transaction Number
- The transaction number returned by DDEPoke( ).
- Use DDEAbortTrans( ) to cancel an uncompleted transaction. If the transaction fails, you can use DDELastError( ) to determine why it failed.
- When you include cUDFName, DDEPoke( ) returns a transaction number if successful or –1 if an error occurs.
+ 允许异步数据传输。如果省略 cUDFName,客户端将等待 DDESetOption( ) 所指定的时间。如果使用 cUDFName 指定了用户定义函数的名称,则在发出请求后客户端程序将立即继续执行。当服务器应用程序提供了数据后,将执行 cUDFName 所指定的用户定义函数。该用户定义函数按以下顺序接收六个参数:
+ Channel Number 服务器应用程序的通道号。
+ Action XACTCOMPLETE(事务成功)。XACTFAIL(事务失败)。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 新数据 (REQUEST) 或传递的数据 (POKE 或 EXECUTED)。
+ Format 数据格式;例如 CF_TEXT。
+ Transaction Number DDEPoke( ) 返回的事务号。
+
使用 DDEAbortTrans( ) 可取消未完成的事务。如果事务失败,可以使用 DDELastError( ) 确定失败原因。如果包含 cUDFName,DDEPoke( ) 在成功时返回事务号,发生错误时返回 –1。
- Logical
+ 逻辑类型
- DDEPoke( ) sends data as a character string to the item name in the application specified by the channel number.
- If the data is successfully sent, DDEPoke( ) returns true (.T.). If the data cannot be sent, DDEPoke( ) returns false (.F.). If the asynchronous user-defined function cUDFName is included, DDEPoke( ) returns a transaction number; if an error occurs, DDEPoke( ) returns –1.
+ DDEPoke( ) 将数据作为字符串发送到由通道号指定的应用程序中的项名称。如果数据发送成功,DDEPoke( ) 返回 true (.T.)。如果无法发送数据,DDEPoke( ) 返回 false (.F.)。如果包含异步用户定义函数 cUDFName,DDEPoke( ) 返回事务号;如果发生错误,DDEPoke( ) 返回 –1。
- Requests data from a server application in a dynamic data exchange (DDE) conversation.
+ 在动态数据交换 (DDE) 会话中,从服务器应用程序请求数据。
- Specifies the channel number of the server application.
+ 指定服务器应用程序的通道号。
- Specifies the item name. The item name is application-specific and must be understood by the application. For example, Microsoft Excel uses row and column notation to refer to cells in a worksheet. The item name R1C1 designates the cell in the first row and first column of the worksheet.
+ 指定项名称。项名称因应用程序而异,必须能被该应用程序识别。例如,Microsoft Excel 使用行列表示法来引用工作表中的单元格。项名称 R1C1 表示工作表中第一行第一列的单元格。
- Specifies a format for the data requested. The default format is CF_TEXT. In this format, fields are delimited with tabs and records are delimited with a carriage return and a line feed.
+ 指定所请求数据的格式。默认格式为 CF_TEXT。在此格式中,字段以制表符分隔,记录以回车符和换行符分隔。
- Allows an asynchronous data transfer. If you omit cUDFName, X# waits for the data from the server for the period specified with DDESetOption( ). If you specify the name of a user-defined function with cUDFName, X# continues program execution immediately after the request is made.
- When the data is available from the server application, the user-defined function specified with cUDFName is executed. The user-defined function is passed six parameters in this order:
- Channel Number
- The channel number of the server application.
- Action
- XACTCOMPLETE (successful transaction).XACTFAIL (failed transaction).
- Item
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- The new data (REQUEST) or data passed (POKE or EXECUTED).
- Format
- The data format; for example, CF_TEXT.
- Transaction Number
- The transaction number returned by DDERequest( ).
- Use DDEAbortTrans( ) to cancel an uncompleted transaction. If the transaction fails, you can use DDELastError( ) to determine why it failed.
- When you include cUDFName, DDERequest( ) returns a transaction number equal to or greater than 0 if successful, or –1 if an error occurs.
+ 允许异步数据传输。如果省略 cUDFName,X# 将在 DDESetOption( ) 所指定的时间内等待来自服务器的数据。如果使用 cUDFName 指定了用户定义函数的名称,则在发出请求后 X# 将立即继续执行程序。当服务器应用程序提供了数据后,将执行 cUDFName 所指定的用户定义函数。该用户定义函数按以下顺序接收六个参数:
+ Channel Number 服务器应用程序的通道号。
+ Action XACTCOMPLETE(事务成功)。XACTFAIL(事务失败)。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 新数据 (REQUEST) 或传递的数据 (POKE 或 EXECUTED)。
+ Format 数据格式;例如 CF_TEXT。
+ Transaction Number DDERequest( ) 返回的事务号。
+
使用 DDEAbortTrans( ) 可取消未完成的事务。如果事务失败,可以使用 DDELastError( ) 确定失败原因。如果包含 cUDFName,DDERequest( ) 在成功时返回大于或等于 0 的事务号,发生错误时返回 –1。
- Character
+ 字符类型
- Before you can request data using DDERequest( ), you must establish a channel to the server application with DDEInitiate( ).
- If the request for data is successful, DDERequest( ) returns the data as a character string. If the request fails, DDERequest( ) returns an empty string and DDELastError( ) returns a nonzero value. If you include the asynchronous user-defined function cUDFName, DDERequest( ) returns a transaction number if successful, or –1 if an error occurs.
+ 在使用 DDERequest( ) 请求数据之前,必须先使用 DDEInitiate( ) 与服务器应用程序建立通道。如果数据请求成功,DDERequest( ) 以字符串形式返回数据。如果请求失败,DDERequest( ) 返回空字符串,并且 DDELastError( ) 返回非零值。如果包含异步用户定义函数 cUDFName,DDERequest( ) 在成功时返回事务号,发生错误时返回 –1。
@@ -4329,48 +3694,39 @@
- Requests data from a server application in a dynamic data exchange (DDE) conversation.
+ 在动态数据交换 (DDE) 会话中,从服务器应用程序请求数据。
- Specifies the channel number of the server application.
+ 指定服务器应用程序的通道号。
- Specifies the item name. The item name is application-specific and must be understood by the application. For example, Microsoft Excel uses row and column notation to refer to cells in a worksheet. The item name R1C1 designates the cell in the first row and first column of the worksheet.
+ 指定项名称。项名称因应用程序而异,必须能被该应用程序识别。例如,Microsoft Excel 使用行列表示法来引用工作表中的单元格。项名称 R1C1 表示工作表中第一行第一列的单元格。
- Specifies a format for the data requested. The default format is CF_TEXT. In this format, fields are delimited with tabs and records are delimited with a carriage return and a line feed.
+ 指定所请求数据的格式。默认格式为 CF_TEXT。在此格式中,字段以制表符分隔,记录以回车符和换行符分隔。
- Allows an asynchronous data transfer. If you omit cUDFName, X# waits for the data from the server for the period specified with DDESetOption( ). If you specify the name of a user-defined function with cUDFName, X# continues program execution immediately after the request is made.
- When the data is available from the server application, the user-defined function specified with cUDFName is executed. The user-defined function is passed six parameters in this order:
- Channel Number
- The channel number of the server application.
- Action
- XACTCOMPLETE (successful transaction).XACTFAIL (failed transaction).
- Item
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- The new data (REQUEST) or data passed (POKE or EXECUTED).
- Format
- The data format; for example, CF_TEXT.
- Transaction Number
- The transaction number returned by DDERequest( ).
- Use DDEAbortTrans( ) to cancel an uncompleted transaction. If the transaction fails, you can use DDELastError( ) to determine why it failed.
- When you include cUDFName, DDERequest( ) returns a transaction number equal to or greater than 0 if successful, or –1 if an error occurs.
+ 允许异步数据传输。如果省略 cUDFName,X# 将在 DDESetOption( ) 所指定的时间内等待来自服务器的数据。如果使用 cUDFName 指定了用户定义函数的名称,则在发出请求后 X# 将立即继续执行程序。当服务器应用程序提供了数据后,将执行 cUDFName 所指定的用户定义函数。该用户定义函数按以下顺序接收六个参数:
+ Channel Number 服务器应用程序的通道号。
+ Action XACTCOMPLETE(事务成功)。XACTFAIL(事务失败)。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 新数据 (REQUEST) 或传递的数据 (POKE 或 EXECUTED)。
+ Format 数据格式;例如 CF_TEXT。
+ Transaction Number DDERequest( ) 返回的事务号。
+
使用 DDEAbortTrans( ) 可取消未完成的事务。如果事务失败,可以使用 DDELastError( ) 确定失败原因。如果包含 cUDFName,DDERequest( ) 在成功时返回大于或等于 0 的事务号,发生错误时返回 –1。
- Character
+ 字符类型
- Before you can request data using DDERequest( ), you must establish a channel to the server application with DDEInitiate( ).
- If the request for data is successful, DDERequest( ) returns the data as a character string. If the request fails, DDERequest( ) returns an empty string and DDELastError( ) returns a nonzero value. If you include the asynchronous user-defined function cUDFName, DDERequest( ) returns a transaction number if successful, or –1 if an error occurs.
+ 在使用 DDERequest( ) 请求数据之前,必须先使用 DDEInitiate( ) 与服务器应用程序建立通道。如果数据请求成功,DDERequest( ) 以字符串形式返回数据。如果请求失败,DDERequest( ) 返回空字符串,并且 DDELastError( ) 返回非零值。如果包含异步用户定义函数 cUDFName,DDERequest( ) 在成功时返回事务号,发生错误时返回 –1。
@@ -4387,306 +3743,219 @@
- Changes or returns dynamic data exchange (DDE) settings.
+ 更改或返回动态数据交换 (DDE) 设置。
- Specifies the setting options.
- TIMEOUT
- nTimeoutValue (number of milliseconds)
- 2000
- The number of milliseconds DDE functions wait for the server application to respond; the current TIMEOUT value is returned if you omit nTimeoutValue.
- SAFETY
- lExpression(true (.T.) or false (.F.))
- Specifies whether a dialog is displayed when you use DDEInitiate( ) to establish a channel to a server application and the application does not respond; the current SAFETY setting is returned if you omit lExpression.
+ 指定设置选项。
+ TIMEOUT nTimeoutValue(毫秒数) 2000 DDE 函数等待服务器应用程序响应的毫秒数;如果省略 nTimeoutValue,则返回当前 TIMEOUT 值。
+ SAFETY lExpression(true (.T.) 或 false (.F.)) 指定当使用 DDEInitiate( ) 与服务器应用程序建立通道而该应用程序没有响应时,是否显示对话框;如果省略 lExpression,则返回当前 SAFETY 设置。
+
- Specifies the timeout value.
+ 指定超时值。
- Enables or disables dialog display.
+ 启用或禁用对话框显示。
- Logical or Numeric
+ 逻辑类型或数值类型
- Use DDESetOption( ) to change or return DDE settings. Two options, TIMEOUT and SAFETY, are available.
+ 使用 DDESetOption( ) 更改或返回 DDE 设置。可使用 TIMEOUT 和 SAFETY 两个选项。
- Changes or returns dynamic data exchange (DDE) settings.
+ 更改或返回动态数据交换 (DDE) 设置。
- Specifies the setting options.
- TIMEOUT
- nTimeoutValue (number of milliseconds)
- 2000
- The number of milliseconds DDE functions wait for the server application to respond; the current TIMEOUT value is returned if you omit nTimeoutValue.
- SAFETY
- lExpression(true (.T.) or false (.F.))
- Specifies whether a dialog is displayed when you use DDEInitiate( ) to establish a channel to a server application and the application does not respond; the current SAFETY setting is returned if you omit lExpression.
+ 指定设置选项。
+ TIMEOUT nTimeoutValue(毫秒数) 2000 DDE 函数等待服务器应用程序响应的毫秒数;如果省略 nTimeoutValue,则返回当前 TIMEOUT 值。
+ SAFETY lExpression(true (.T.) 或 false (.F.)) 指定当使用 DDEInitiate( ) 与服务器应用程序建立通道而该应用程序没有响应时,是否显示对话框;如果省略 lExpression,则返回当前 SAFETY 设置。
+
- Specifies the timeout value.
+ 指定超时值。
- Enables or disables dialog display.
+ 启用或禁用对话框显示。
- Logical or Numeric
+ 逻辑类型或数值类型
- Use DDESetOption( ) to change or return DDE settings. Two options, TIMEOUT and SAFETY, are available.
+ 使用 DDESetOption( ) 更改或返回 DDE 设置。可使用 TIMEOUT 和 SAFETY 两个选项。
- Creates, releases, or modifies DDE service names and settings.
+ 创建、释放或修改 DDE 服务名称及设置。
- Specifies the service name to create, release, modify, or return information about.
+ 指定要创建、释放、修改或返回其信息的服务名称。
- Specifies to create, release, or modify a service name or to return information about a service name. The following table lists the options you can specify with cOption, the default values for the options and a description of each option.
- DEFINE
- –
- Creates a new service name.
- RELEASE
- Releases an existing service name.
- ADVISE
- .F.
- Enables or disables client notification of changes to item names.
- EXECUTE
- Enables or disables command execution.
- POKE
- Enables or disables client pokes to the service.
- REQUEST
- .T.
- Enables or disables requests to the service name.
- FORMATS
- CF_TEXT
- Specifies supported data formats.
- DEFINE
- Creates a new service name. For example, the following command creates the service name codemyservice/code:
+ 指定创建、释放或修改服务名称,或返回有关服务名称的信息。下表列出了可以通过 cOption 指定的选项、这些选项的默认值以及各选项的说明。
+ 选项 默认值 说明
+ DEFINE – 创建新的服务名称。
+ RELEASE 释放现有的服务名称。
+ ADVISE .F. 启用或禁用客户端对项名称更改的通知。
+ EXECUTE 启用或禁用命令执行。
+ POKE 启用或禁用客户端向该服务发送 poke。
+ REQUEST .T. 启用或禁用对该服务名称的请求。
+ FORMATS CF_TEXT 指定支持的数据格式。
+
DEFINE 创建新的服务名称。例如,以下命令创建服务名称 myservice :
glNewService = DDESetService('myservice', 'DEFINE')
- RELEASE
- Releases an existing service name to free up system resources. When a service name is released, all of the service's topic names are also released.
- The following command releases the service name created in the previous example:
+ RELEASE 释放现有的服务名称以释放系统资源。释放服务名称时,该服务的所有主题名称也会一并释放。以下命令释放在上一个示例中创建的服务名称:
glRelease = DDESetService('myservice', 'RELEASE')
- To release the default X# service, issue this command:
+ 要释放默认的 X# 服务,请发出以下命令:
glRelFox = DDESetService('FoxPro', 'RELEASE')
- ADVISE
- Specifies whether a client is notified when data changes in an item name or specifies to return the current advise status for a service name. Refer to DDEAdvise( ) for additional information about advising clients.
- To enable client notification, specify true (.T.) for lExpression. Specifying false (.F.) for lExpression disables client notification.
- To return the current client notification status for the service name, omit lExpression. DDESetService( ) returns true if client notification is enabled for the service name; it returns false if client notification is disabled.
- EXECUTE
- Allows you to enable or disable command execution requests to a service name or to determine the current execute status for a service name.
- To enable client requests to execute a command, specify true (.T.) for lExpression. Specifying false (.F.) for lExpression disables client requests to execute a command. .F. is the default value.
- To return the current command execution status for the service name, omit lExpression. DDESetService( ) returns true if client command execution requests are enabled for the service name; otherwise, it returns false.
- The following commands enable command execution and disable data requests from client applications for the service name codemyservice/code. The current command execution status for codemyservice/code is then displayed:
+ ADVISE 指定当项名称中的数据更改时是否通知客户端,或指定返回服务名称的当前 advise 状态。有关通知客户端的更多信息,请参阅 DDEAdvise( )。要启用客户端通知,请为 lExpression 指定 true (.T.)。为 lExpression 指定 false (.F.) 将禁用客户端通知。要返回服务名称的当前客户端通知状态,请省略 lExpression。如果该服务名称启用了客户端通知,DDESetService( ) 返回 true;如果禁用了客户端通知,则返回 false。EXECUTE 允许启用或禁用对服务名称的命令执行请求,或确定服务名称的当前执行状态。要启用客户端执行命令的请求,请为 lExpression 指定 true (.T.)。为 lExpression 指定 false (.F.) 将禁用客户端执行命令的请求。默认值为 .F.。要返回服务名称的当前命令执行状态,请省略 lExpression。如果该服务名称启用了客户端命令执行请求,DDESetService( ) 返回 true;否则返回 false。以下命令为服务名称 myservice 启用命令执行并禁用来自客户端应用程序的数据请求,然后显示 myservice 的当前命令执行状态:
glExecute = DDESetService('myservice', 'EXECUTE', .T.)
glRequest = DDESetService('myservice', 'REQUEST', .F.)
? DDESetService('myservice', 'EXECUTE')
- POKE
- Allows you to enable or disable poke requests to the service name. You can also determine the current poke status for a service name. Refer to DDEPoke( ) for additional information about poking data to a server or a client.
- To enable client poke requests, specify true (.T.) for lExpression. Specifying false (.F.) for lExpression disables client poke requests. .F. is the default value.
- To return the current poke status for the service name, omit lExpression. DDESetService( ) returns true if poke requests are enabled for a service name; it returns false if poke requests are disabled.
- REQUEST
- Use REQUEST to enable or disable client requests to a service name or to return the current request status for the service name.
- To enable client requests to the service name, specify true (.T.) for lExpression. Specifying false (.F.) disables client requests to the service name. True (.T.) is the default value.
- To return the current request status for a service name, omit lExpression. DDESetService( ) returns true if client requests are enabled for the service name; it returns false if client requests are disabled.
- The following commands disable requests from client applications to the service name codemyservice/code and display the current request status for codemyservice/code:
+ POKE 允许启用或禁用对服务名称的 poke 请求。还可以确定服务名称的当前 poke 状态。有关向服务器或客户端 poke 数据的更多信息,请参阅 DDEPoke( )。要启用客户端 poke 请求,请为 lExpression 指定 true (.T.)。为 lExpression 指定 false (.F.) 将禁用客户端 poke 请求。默认值为 .F.。要返回服务名称的当前 poke 状态,请省略 lExpression。如果服务名称启用了 poke 请求,DDESetService( ) 返回 true;如果禁用了 poke 请求,则返回 false。REQUEST 使用 REQUEST 可启用或禁用客户端对服务名称的请求,或返回服务名称的当前请求状态。要启用客户端对服务名称的请求,请为 lExpression 指定 true (.T.)。指定 false (.F.) 将禁用客户端对服务名称的请求。默认值为 true (.T.)。要返回服务名称的当前请求状态,请省略 lExpression。如果服务名称启用了客户端请求,DDESetService( ) 返回 true;如果禁用了客户端请求,则返回 false。以下命令禁用客户端应用程序对服务名称 myservice 的请求,并显示 myservice 的当前请求状态:
glRequest = DDESetService('myservice', 'REQUEST', .F.)
? DDESetService('myservice', 'REQUEST')
- FORMATS [ cDataFormat]
- Specifies the data formats supported by the service name. Server requests for formats not specified with cDataFormat are rejected. When specifying data formats, include a list of the supported formats separated by commas. For example:
+ FORMATS [ cDataFormat] 指定服务名称支持的数据格式。对于 cDataFormat 中未指定的格式,服务器请求将被拒绝。指定数据格式时,请包含以逗号分隔的受支持格式列表。例如:
=DDESetService('myservice', 'FORMATS', 'CF_TEXT, CF_SYLK')
- If you omit cDataFormat, only the CF_TEXT format is supported.
+ 如果省略 cDataFormat,则仅支持 CF_TEXT 格式。
- Specifies the state of the REQUEST, EXECUTE, POKE, or ADVISE options. Specify true (.T.) for lExpression to enable the option or false (.F.) to disable it.
+ 指定 REQUEST、EXECUTE、POKE 或 ADVISE 选项的状态。为 lExpression 指定 true (.T.) 以启用该选项,或指定 false (.F.) 以禁用该选项。
- Logical
+ 逻辑类型
- X# can act as a dynamic data exchange (DDE) server to send data to client Microsoft Windows-based applications. DDESetService( ) is used to create, release, or modify service names and settings in X#. Each service name can have a set of topic names created with DDESetTopic( ). Client applications request data from DDE topic names.
-
- DDESetService( ) returns true (.T.) if the service name is successfully created, released, or modified. If the service name cannot be created, released, or modified, DDESetService( ) returns false (.F.).
-
- DDESetService( ) can also be used to return information about a service name. X# has the default service name FoxPro. The X# service name has one topic name called System. The following table lists all the item names supported by the System topic.
- Topics
- A list of available topic names
- Formats
- A list of supported formats
- Status
- Busy or Ready
- SysItems
- A list of item names
- You can use DDESetTopic( ) to modify the FoxPro service name or to release it. For information about manipulating X# service names, see the DDESetTopic( ) options.
+ X# 可以充当动态数据交换 (DDE) 服务器,向基于 Microsoft Windows 的客户端应用程序发送数据。DDESetService( ) 用于在 X# 中创建、释放或修改服务名称及设置。每个服务名称可以拥有一组使用 DDESetTopic( ) 创建的主题名称。客户端应用程序从 DDE 主题名称请求数据。如果服务名称成功创建、释放或修改,DDESetService( ) 返回 true (.T.)。如果无法创建、释放或修改服务名称,DDESetService( ) 返回 false (.F.)。DDESetService( ) 还可用于返回有关服务名称的信息。X# 具有默认服务名称 FoxPro。X# 服务名称有一个名为 System 的主题名称。下表列出了 System 主题支持的所有项名称。
+ Topics 可用主题名称列表
+ Formats 支持的格式列表
+ Status Busy 或 Ready
+ SysItems 项名称列表
+
可以使用 DDESetTopic( ) 修改 FoxPro 服务名称或将其释放。有关操作 X# 服务名称的信息,请参阅 DDESetTopic( ) 选项。
- Creates, releases, or modifies DDE service names and settings.
+ 创建、释放或修改 DDE 服务名称和设置。
- Specifies the service name to create, release, modify, or return information about.
+ 指定要创建、释放、修改或返回其信息的服务名称。
- Specifies to create, release, or modify a service name or to return information about a service name. The following table lists the options you can specify with cOption, the default values for the options and a description of each option.
- DEFINE
- –
- Creates a new service name.
- RELEASE
- Releases an existing service name.
- ADVISE
- .F.
- Enables or disables client notification of changes to item names.
- EXECUTE
- Enables or disables command execution.
- POKE
- Enables or disables client pokes to the service.
- REQUEST
- .T.
- Enables or disables requests to the service name.
- FORMATS
- CF_TEXT
- Specifies supported data formats.
- DEFINE
- Creates a new service name. For example, the following command creates the service name codemyservice/code:
+ 指定要创建、释放或修改服务名称,或返回服务名称的信息。下表列出了可以与 cOption 一起指定的选项、各选项的默认值以及每个选项的说明。
+
+ 选项 默认值 说明
+ DEFINE – 创建新的服务名称。
+ RELEASE 释放现有的服务名称。
+ ADVISE .F. 启用或禁用客户端对项名称更改的通知。
+ EXECUTE 启用或禁用命令执行。
+ POKE 启用或禁用客户端向服务发送 poke 请求。
+ REQUEST .T. 启用或禁用对服务名称的请求。
+ FORMATS CF_TEXT 指定支持的数据格式。
+
+DEFINE 创建新的服务名称。例如,下面的命令创建服务名称myservice :
glNewService = DDESetService('myservice', 'DEFINE')
- RELEASE
- Releases an existing service name to free up system resources. When a service name is released, all of the service's topic names are also released.
- The following command releases the service name created in the previous example:
+ RELEASE 释放现有的服务名称以释放系统资源。释放服务名称时,该服务的所有主题名称也会一并释放。下面的命令释放在上一个示例中创建的服务名称:
glRelease = DDESetService('myservice', 'RELEASE')
- To release the default X# service, issue this command:
+ 要释放默认的 X# 服务,请发出以下命令:
glRelFox = DDESetService('FoxPro', 'RELEASE')
- ADVISE
- Specifies whether a client is notified when data changes in an item name or specifies to return the current advise status for a service name. Refer to DDEAdvise( ) for additional information about advising clients.
- To enable client notification, specify true (.T.) for lExpression. Specifying false (.F.) for lExpression disables client notification.
- To return the current client notification status for the service name, omit lExpression. DDESetService( ) returns true if client notification is enabled for the service name; it returns false if client notification is disabled.
- EXECUTE
- Allows you to enable or disable command execution requests to a service name or to determine the current execute status for a service name.
- To enable client requests to execute a command, specify true (.T.) for lExpression. Specifying false (.F.) for lExpression disables client requests to execute a command. .F. is the default value.
- To return the current command execution status for the service name, omit lExpression. DDESetService( ) returns true if client command execution requests are enabled for the service name; otherwise, it returns false.
- The following commands enable command execution and disable data requests from client applications for the service name codemyservice/code. The current command execution status for codemyservice/code is then displayed:
+ ADVISE 指定当项名称中的数据发生更改时是否通知客户端,或指定返回服务名称的当前通知状态。有关通知客户端的更多信息,请参阅 DDEAdvise( )。要启用客户端通知,请为 lExpression 指定 true (.T.)。为 lExpression 指定 false (.F.) 则禁用客户端通知。要返回服务名称的当前客户端通知状态,请省略 lExpression。如果服务名称的客户端通知已启用,DDESetService( ) 返回 true;如果已禁用,则返回 false。 EXECUTE 允许您启用或禁用对服务名称的命令执行请求,或确定服务名称的当前执行状态。要启用客户端执行命令的请求,请为 lExpression 指定 true (.T.)。为 lExpression 指定 false (.F.) 则禁用客户端执行命令的请求。.F. 为默认值。要返回服务名称的当前命令执行状态,请省略 lExpression。如果服务名称的客户端命令执行请求已启用,DDESetService( ) 返回 true;否则返回 false。下面的命令为服务名称myservice 启用命令执行并禁用来自客户端应用程序的数据请求,然后显示myservice 的当前命令执行状态:
glExecute = DDESetService('myservice', 'EXECUTE', .T.)
glRequest = DDESetService('myservice', 'REQUEST', .F.)
? DDESetService('myservice', 'EXECUTE')
- POKE
- Allows you to enable or disable poke requests to the service name. You can also determine the current poke status for a service name. Refer to DDEPoke( ) for additional information about poking data to a server or a client.
- To enable client poke requests, specify true (.T.) for lExpression. Specifying false (.F.) for lExpression disables client poke requests. .F. is the default value.
- To return the current poke status for the service name, omit lExpression. DDESetService( ) returns true if poke requests are enabled for a service name; it returns false if poke requests are disabled.
- REQUEST
- Use REQUEST to enable or disable client requests to a service name or to return the current request status for the service name.
- To enable client requests to the service name, specify true (.T.) for lExpression. Specifying false (.F.) disables client requests to the service name. True (.T.) is the default value.
- To return the current request status for a service name, omit lExpression. DDESetService( ) returns true if client requests are enabled for the service name; it returns false if client requests are disabled.
- The following commands disable requests from client applications to the service name codemyservice/code and display the current request status for codemyservice/code:
+ POKE 允许您启用或禁用对服务名称的 poke 请求。您还可以确定服务名称的当前 poke 状态。有关向服务器或客户端 poke 数据的更多信息,请参阅 DDEPoke( )。要启用客户端 poke 请求,请为 lExpression 指定 true (.T.)。为 lExpression 指定 false (.F.) 则禁用客户端 poke 请求。.F. 为默认值。要返回服务名称的当前 poke 状态,请省略 lExpression。如果服务名称的 poke 请求已启用,DDESetService( ) 返回 true;如果已禁用,则返回 false。 REQUEST 使用 REQUEST 启用或禁用客户端对服务名称的请求,或返回服务名称的当前请求状态。要启用客户端对服务名称的请求,请为 lExpression 指定 true (.T.)。指定 false (.F.) 则禁用客户端对服务名称的请求。True (.T.) 为默认值。要返回服务名称的当前请求状态,请省略 lExpression。如果服务名称的客户端请求已启用,DDESetService( ) 返回 true;如果已禁用,则返回 false。下面的命令禁用客户端应用程序对服务名称myservice 的请求,并显示myservice 的当前请求状态:
glRequest = DDESetService('myservice', 'REQUEST', .F.)
? DDESetService('myservice', 'REQUEST')
- FORMATS [ cDataFormat]
- Specifies the data formats supported by the service name. Server requests for formats not specified with cDataFormat are rejected. When specifying data formats, include a list of the supported formats separated by commas. For example:
+ FORMATS [ cDataFormat] 指定服务名称支持的数据格式。对于未用 cDataFormat 指定的格式,服务器请求将被拒绝。指定数据格式时,请包含以逗号分隔的受支持格式列表。例如:
=DDESetService('myservice', 'FORMATS', 'CF_TEXT, CF_SYLK')
- If you omit cDataFormat, only the CF_TEXT format is supported.
+ 如果省略 cDataFormat,则仅支持 CF_TEXT 格式。
- Specifies the state of the REQUEST, EXECUTE, POKE, or ADVISE options. Specify true (.T.) for lExpression to enable the option or false (.F.) to disable it.
+ 指定 REQUEST、EXECUTE、POKE 或 ADVISE 选项的状态。为 lExpression 指定 true (.T.) 以启用该选项,或指定 false (.F.) 以禁用该选项。
- Logical
+ 逻辑类型
- X# can act as a dynamic data exchange (DDE) server to send data to client Microsoft Windows-based applications. DDESetService( ) is used to create, release, or modify service names and settings in X#. Each service name can have a set of topic names created with DDESetTopic( ). Client applications request data from DDE topic names.
-
- DDESetService( ) returns true (.T.) if the service name is successfully created, released, or modified. If the service name cannot be created, released, or modified, DDESetService( ) returns false (.F.).
-
- DDESetService( ) can also be used to return information about a service name. X# has the default service name FoxPro. The X# service name has one topic name called System. The following table lists all the item names supported by the System topic.
- Topics
- A list of available topic names
- Formats
- A list of supported formats
- Status
- Busy or Ready
- SysItems
- A list of item names
- You can use DDESetTopic( ) to modify the FoxPro service name or to release it. For information about manipulating X# service names, see the DDESetTopic( ) options.
+ X# 可以充当动态数据交换 (DDE) 服务器,向基于 Microsoft Windows 的客户端应用程序发送数据。DDESetService( ) 用于在 X# 中创建、释放或修改服务名称和设置。每个服务名称可以拥有一组使用 DDESetTopic( ) 创建的主题名称。客户端应用程序从 DDE 主题名称请求数据。如果服务名称成功创建、释放或修改,DDESetService( ) 返回 true (.T.)。如果无法创建、释放或修改服务名称,DDESetService( ) 返回 false (.F.)。DDESetService( ) 还可用于返回服务名称的信息。X# 具有默认服务名称 FoxPro。X# 服务名称有一个名为 System 的主题名称。下表列出了 System 主题支持的所有项名称。
+
+ Topics 可用主题名称的列表
+ Formats 支持的格式列表
+ Status Busy 或 Ready
+ SysItems 项名称的列表
+
+您可以使用 DDESetTopic( ) 修改 FoxPro 服务名称或将其释放。有关操作 X# 服务名称的信息,请参阅 DDESetTopic( ) 选项。
- Creates or releases a topic name from a service name in a dynamic data exchange (DDE) conversation.
+ 在动态数据交换 (DDE) 会话中,从服务名称创建或释放主题名称。
- Specifies the service name. Additional service names can be created with DDESetService( ).
+ 指定服务名称。可以使用 DDESetService( ) 创建其他服务名称。
- Specifies the topic name to create or release. If you include cUDFName, DDESetTopic( ) creates the topic name cTopicName. If you omit cUDFName, the topic name cTopicName is released. If cTopicName is an empty string, the user-defined function specified with cUDFName is executed for any topic name that is not explicitly declared.
+ 指定要创建或释放的主题名称。如果包含 cUDFName,DDESetTopic( ) 将创建主题名称 cTopicName。如果省略 cUDFName,则释放主题名称 cTopicName。如果 cTopicName 为空字符串,则对于任何未显式声明的主题名称,都将执行 cUDFName 指定的用户定义函数。
- Specifies the name of the user-defined function executed when a client application makes a request to the topic name. If you omit cUDFName, the topic name cTopicName is released from the service name.
- When the user-defined function is executed, it is passed the following six parameters in the order given below:
- Channel Number
- The client channel number.
- Action
- ADVISE, EXECUTE, INITIATE, POKE, REQUEST, or TERMINATE.
- Item
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- Data from the client.
- Format
- The data format; for example, CF_TEXT.
- Advise Status
- The link type (0 = manual, 2 = notify or automatic).
- The values of the Item, Data, and Advise Status parameters depend on the Action parameter. The following table lists the Action parameter values and the values contained in the Item, Data, and Advise Status parameters. A dash (–) indicates that the parameter value is the empty string.
- Topic name
- Item name
- New data
- New command
- Link type
- If the user-defined function successfully handles the client request, the user-defined function should return true (.T.). If the request cannot be handled or an error occurs, the user-defined function should return false (.F.). If false is returned when the Action parameter value is INITIATE, the client topic name request is rejected. If false is returned when the value is POKE, REQUEST, or EXECUTE, the request is ignored. If false is returned when the value is ADVISE, the client request for a notify or automatic link is rejected.
+ 指定当客户端应用程序向主题名称发出请求时所执行的用户定义函数的名称。如果省略 cUDFName,则从服务名称中释放主题名称 cTopicName。执行用户定义函数时,会按以下顺序向其传递六个参数:
+
+ Channel Number 客户端通道号。
+ Action ADVISE、EXECUTE、INITIATE、POKE、REQUEST 或 TERMINATE。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 来自客户端的数据。
+ Format 数据格式;例如 CF_TEXT。
+ Advise Status 链接类型(0 = 手动,2 = 通知或自动)。
+
+Item、Data 和 Advise Status 参数的值取决于 Action 参数。下表列出了 Action 参数的值以及 Item、Data 和 Advise Status 参数中包含的值。破折号 (–) 表示该参数值为空字符串。
+Topic name
+Item name
+New data
+New command
+Link type
+如果用户定义函数成功处理了客户端请求,则应返回 true (.T.)。如果无法处理请求或发生错误,则应返回 false (.F.)。如果 Action 参数值为 INITIATE 时返回 false,则客户端的主题名称请求将被拒绝。如果值为 POKE、REQUEST 或 EXECUTE 时返回 false,则该请求将被忽略。如果值为 ADVISE 时返回 false,则客户端对通知或自动链接的请求将被拒绝。
- Logical
+ 逻辑类型
- After a topic name is created, any client requests to the topic name cause X# to execute the user-defined function specified with cUDFName. The user-defined function is passed a set of parameters whose values are determined by the client request. The user-defined function return value is passed to the client with DDEPoke( ). The return value is a logical value indicating whether the topic name can provide the service requested by the client.
-
- DDESetTopic( ) returns true (.T.) if it successfully creates or releases the topic name. It returns false (.F.) if the topic name cannot be created or released. Use DDELastError( ) to determine why a topic name cannot be created or released.
+ 创建主题名称后,客户端对该主题名称的任何请求都会使 X# 执行 cUDFName 指定的用户定义函数。传递给用户定义函数的一组参数,其值由客户端请求决定。用户定义函数的返回值通过 DDEPoke( ) 传递给客户端。返回值是一个逻辑值,指示该主题名称是否能够提供客户端所请求的服务。如果成功创建或释放主题名称,DDESetTopic( ) 返回 true (.T.)。如果无法创建或释放主题名称,则返回 false (.F.)。使用 DDELastError( ) 可确定无法创建或释放主题名称的原因。
- The following example creates a basic sample server called codemyserver/code that supports X# command execution from a client application. The client application makes requests to codemyserver/code through the DO topic, and macro substitution is used to execute the client's command.
+ 下面的示例创建一个名为codemyserver/code的基本示例服务器,它支持来自客户端应用程序的 X# 命令执行。客户端应用程序通过 DO 主题向codemyserver/code发出请求,并使用宏替换来执行客户端的命令。
*** Set X# up as a DDE server ***
= DDESetService('myserver', 'DEFINE')
@@ -4715,7 +3984,7 @@
ENDIF
RETURN glResult
- After running this example program, you have set up X# service, which other applications can access. If you have Microsoft Excel, you can run the following Excel macro:
+ 运行此示例程序后,您已经建立了 X# 服务,其他应用程序可以访问该服务。如果您安装了 Microsoft Excel,则可以运行以下 Excel 宏:
gnMyChan = INITIATE("myserver","DO")
=EXECUTE(MyChan,"WAIT WINDOW 'Hi, this is EXCEL speaking'")
@@ -4725,52 +3994,45 @@
- Creates or releases a topic name from a service name in a dynamic data exchange (DDE) conversation.
+ 在动态数据交换 (DDE) 会话中,从服务名称创建或释放主题名称。
- Specifies the service name. Additional service names can be created with DDESetService( ).
+ 指定服务名称。可以使用 DDESetService( ) 创建其他服务名称。
- Specifies the topic name to create or release. If you include cUDFName, DDESetTopic( ) creates the topic name cTopicName. If you omit cUDFName, the topic name cTopicName is released. If cTopicName is an empty string, the user-defined function specified with cUDFName is executed for any topic name that is not explicitly declared.
+ 指定要创建或释放的主题名称。如果包含 cUDFName,DDESetTopic( ) 将创建主题名称 cTopicName。如果省略 cUDFName,则释放主题名称 cTopicName。如果 cTopicName 为空字符串,则对于任何未显式声明的主题名称,都将执行 cUDFName 指定的用户定义函数。
- Specifies the name of the user-defined function executed when a client application makes a request to the topic name. If you omit cUDFName, the topic name cTopicName is released from the service name.
- When the user-defined function is executed, it is passed the following six parameters in the order given below:
- Channel Number
- The client channel number.
- Action
- ADVISE, EXECUTE, INITIATE, POKE, REQUEST, or TERMINATE.
- Item
- The item name; for example, R1C1 for a Microsoft Excel worksheet cell.
- Data
- Data from the client.
- Format
- The data format; for example, CF_TEXT.
- Advise Status
- The link type (0 = manual, 2 = notify or automatic).
- The values of the Item, Data, and Advise Status parameters depend on the Action parameter. The following table lists the Action parameter values and the values contained in the Item, Data, and Advise Status parameters. A dash (–) indicates that the parameter value is the empty string.
- Topic name
- Item name
- New data
- New command
- Link type
- If the user-defined function successfully handles the client request, the user-defined function should return true (.T.). If the request cannot be handled or an error occurs, the user-defined function should return false (.F.). If false is returned when the Action parameter value is INITIATE, the client topic name request is rejected. If false is returned when the value is POKE, REQUEST, or EXECUTE, the request is ignored. If false is returned when the value is ADVISE, the client request for a notify or automatic link is rejected.
+ 指定当客户端应用程序向主题名称发出请求时所执行的用户定义函数的名称。如果省略 cUDFName,则从服务名称中释放主题名称 cTopicName。执行用户定义函数时,会按以下顺序向其传递六个参数:
+
+ Channel Number 客户端通道号。
+ Action ADVISE、EXECUTE、INITIATE、POKE、REQUEST 或 TERMINATE。
+ Item 项名称;例如,Microsoft Excel 工作表单元格的 R1C1。
+ Data 来自客户端的数据。
+ Format 数据格式;例如 CF_TEXT。
+ Advise Status 链接类型(0 = 手动,2 = 通知或自动)。
+
+Item、Data 和 Advise Status 参数的值取决于 Action 参数。下表列出了 Action 参数的值以及 Item、Data 和 Advise Status 参数中包含的值。破折号 (–) 表示该参数值为空字符串。
+Topic name
+Item name
+New data
+New command
+Link type
+如果用户定义函数成功处理了客户端请求,则应返回 true (.T.)。如果无法处理请求或发生错误,则应返回 false (.F.)。如果 Action 参数值为 INITIATE 时返回 false,则客户端的主题名称请求将被拒绝。如果值为 POKE、REQUEST 或 EXECUTE 时返回 false,则该请求将被忽略。如果值为 ADVISE 时返回 false,则客户端对通知或自动链接的请求将被拒绝。
- Logical
+ 逻辑类型
- After a topic name is created, any client requests to the topic name cause X# to execute the user-defined function specified with cUDFName. The user-defined function is passed a set of parameters whose values are determined by the client request. The user-defined function return value is passed to the client with DDEPoke( ). The return value is a logical value indicating whether the topic name can provide the service requested by the client.
-
- DDESetTopic( ) returns true (.T.) if it successfully creates or releases the topic name. It returns false (.F.) if the topic name cannot be created or released. Use DDELastError( ) to determine why a topic name cannot be created or released.
+ 创建主题名称后,客户端对该主题名称的任何请求都会使 X# 执行 cUDFName 指定的用户定义函数。传递给用户定义函数的一组参数,其值由客户端请求决定。用户定义函数的返回值通过 DDEPoke( ) 传递给客户端。返回值是一个逻辑值,指示该主题名称是否能够提供客户端所请求的服务。如果成功创建或释放主题名称,DDESetTopic( ) 返回 true (.T.)。如果无法创建或释放主题名称,则返回 false (.F.)。使用 DDELastError( ) 可确定无法创建或释放主题名称的原因。
- The following example creates a basic sample server called codemyserver/code that supports X# command execution from a client application. The client application makes requests to codemyserver/code through the DO topic, and macro substitution is used to execute the client's command.
+ 下面的示例创建一个名为codemyserver/code的基本示例服务器,它支持来自客户端应用程序的 X# 命令执行。客户端应用程序通过 DO 主题向codemyserver/code发出请求,并使用宏替换来执行客户端的命令。
*** Set X# up as a DDE server ***
= DDESetService('myserver', 'DEFINE')
@@ -4799,7 +4061,7 @@
ENDIF
RETURN glResult
- After running this example program, you have set up X# service, which other applications can access. If you have Microsoft Excel, you can run the following Excel macro:
+ 运行此示例程序后,您已经建立了 X# 服务,其他应用程序可以访问该服务。如果您安装了 Microsoft Excel,则可以运行以下 Excel 宏:
gnMyChan = INITIATE("myserver","DO")
=EXECUTE(MyChan,"WAIT WINDOW 'Hi, this is EXCEL speaking'")
@@ -4809,60 +4071,53 @@
- Closes a dynamic data exchange (DDE) channel established with DDEInitiate( ).
+ 关闭使用 DDEInitiate( ) 建立的动态数据交换 (DDE) 通道。
- Specifies the channel number to close.
+ 指定要关闭的通道号。
- Specifies the service name to close.
+ 指定要关闭的服务名称。
- Logical
+ 逻辑类型
- If the channel is successfully closed, DDETerminate( ) returns true (.T.). If the channel cannot be closed, DDETerminate( ) returns false (.F.).
- Be sure to close channels as soon as they are no longer needed to conserve system resources.
- All channels are automatically closed if you exit X# by choosing Exit from the File menu or by issuing QUIT in the Command window or from within a program.
+ 如果通道成功关闭,DDETerminate( ) 返回 true (.T.)。如果无法关闭通道,DDETerminate( ) 返回 false (.F.)。请务必在不再需要通道时尽快将其关闭,以节省系统资源。如果通过从 File 菜单选择 Exit 退出 X#,或在 Command 窗口中或程序内发出 QUIT,所有通道都会自动关闭。
- Closes a dynamic data exchange (DDE) channel established with DDEInitiate( ).
+ 关闭使用 DDEInitiate( ) 建立的动态数据交换 (DDE) 通道。
- Specifies the channel number to close.
+ 指定要关闭的通道号。
- Specifies the service name to close.
+ 指定要关闭的服务名称。
- Logical
+ 逻辑类型
- If the channel is successfully closed, DDETerminate( ) returns true (.T.). If the channel cannot be closed, DDETerminate( ) returns false (.F.).
- Be sure to close channels as soon as they are no longer needed to conserve system resources.
- All channels are automatically closed if you exit X# by choosing Exit from the File menu or by issuing QUIT in the Command window or from within a program.
+ 如果通道成功关闭,DDETerminate( ) 返回 true (.T.)。如果无法关闭通道,DDETerminate( ) 返回 false (.F.)。请务必在不再需要通道时尽快将其关闭,以节省系统资源。如果通过从 File 菜单选择 Exit 退出 X#,或在 Command 窗口中或程序内发出 QUIT,所有通道都会自动关闭。
- Returns a logical value that indicates whether the current record is marked for deletion.
+ 返回一个逻辑值,指示当前记录是否已标记为删除。
- Logical
+ 逻辑类型
- If the record is marked for deletion, DELETED( ) returns true (.T.); otherwise, DELETED( ) returns false (.F.).
- Records can be marked for deletion with DELETE and DELETE – SQL, and they can be unmarked with RECALL.
- Rushmore Query Optimization optimizes queries that test the deleted status of records if the table is indexed on DELETED( ).
- For information on using Rushmore to optimize queries, see SET OPTIMIZE and Using Rushmore Query Optimization to Speed Data Access.
+ 如果记录已标记为删除,DELETED( ) 返回 true (.T.);否则,DELETED( ) 返回 false (.F.)。可以使用 DELETE 和 DELETE – SQL 将记录标记为删除,并可以使用 RECALL 取消标记。如果表在 DELETED( ) 上建立了索引,Rushmore 查询优化会优化测试记录删除状态的查询。有关使用 Rushmore 优化查询的信息,请参阅 SET OPTIMIZE 和 Using Rushmore Query Optimization to Speed Data Access。
@@ -4933,56 +4188,51 @@
- Locates the specified directory.
+ 查找指定的目录。
- Specifies the name of the directory to locate. If you do not include an absolute path for the directory you specify, X# searches for the directory relative to the X# default directory.
+ 指定要查找的目录名称。如果您指定的目录不包含绝对路径,X# 将相对于 X# 默认目录搜索该目录。
- Specifies the kind of value DIRECTORY( ) returns when the directory exists but might be marked with the Hidden or System attribute. The following table lists the values for nFlags.
- 0
- DIRECTORY( ) returns False (.F.) if the directory exists but is marked with a Hidden or System attribute. (Default)
- 1
- DIRECTORY( ) returns True (.T.) if the directory exists, regardless of its attributes. Setting nFlags to 1 allows you to check for hidden or system files.
+ 指定当目录存在但可能被标记为 Hidden 或 System 属性时,DIRECTORY( ) 返回的值的类型。下表列出了 nFlags 的值。
+
+ 0 如果目录存在但被标记为 Hidden 或 System 属性,DIRECTORY( ) 返回 False (.F.)。(默认值)
+ 1 如果目录存在,无论其属性如何,DIRECTORY( ) 都返回 True (.T.)。将 nFlags 设置为 1 可让您检查隐藏文件或系统文件。
+
- Logical data type. DIRECTORY( ) returns True (.T.) if the specified directory is found on the disk; otherwise, it returns False (.F.).
+ 逻辑类型。如果在磁盘上找到指定的目录,DIRECTORY( ) 返回 True (.T.);否则返回 False (.F.)。
- The SET DEFAULT command specifies the X# default directory.
- You can use the ADIR( ) function to determine specific attributes for the directory.
- You can use the CD and CHDIR commands to switch to hidden files and directories.
+ SET DEFAULT 命令指定 X# 默认目录。您可以使用 ADIR( ) 函数确定目录的特定属性。您可以使用 CD 和 CHDIR 命令切换到隐藏文件和目录。
- Retrieves the number of bytes with the specified type that are available on the default or specified hard disk drive or volume.
+ 检索默认或指定硬盘驱动器或卷上具有指定类型的可用字节数。
- Specifies the name of the hard disk drive or volume for which the available space is returned. If you omit cVolumeName, the available space is returned for the default disk drive or volume.
+ 指定要返回其可用空间的硬盘驱动器或卷的名称。如果省略 cVolumeName,则返回默认磁盘驱动器或卷的可用空间。
- Specifies the type of hard disk space to retrieve. The following table lists the values for nType.
- 1
- Total amount of space on the hard disk drive.
- 2
- Total amount of free space on the hard disk drive. (Default)
- 3
- Total amount of free space available to the user associated with the calling thread.
+ 指定要检索的硬盘空间类型。下表列出了 nType 的值。
+
+ 1 硬盘驱动器上的总空间量。
+ 2 硬盘驱动器上的可用空间总量。(默认值)
+ 3 与调用线程关联的用户可用的空闲空间总量。
+
- Numeric. DISKSPACE( ) returns the number of bytes with the type specified. If the hard disk is full, DISKSPACE( ) returns a value of 0 or -1. If an error occurs when reading the hard disk drive or volume, DISKSPACE( ) can also return a value of –1.
- The return value of DISKSPACE( ) might not be accurate for large network drives on some networks. Additionally, DISKSPACE( ) may return -1 for certain long named directories on Windows 98.
+ 数值类型。DISKSPACE( ) 返回指定类型的字节数。如果硬盘已满,DISKSPACE( ) 返回 0 或 -1。如果读取硬盘驱动器或卷时发生错误,DISKSPACE( ) 也可能返回 –1。在某些网络上,对于大型网络驱动器,DISKSPACE( ) 的返回值可能不准确。此外,对于 Windows 98 上某些长名称目录,DISKSPACE( ) 可能返回 -1。
- You can use DISKSPACE( ) to determine if sufficient space is available to back up files or to execute commands such as SORT that require additional disk space for temporary work files.
- You can specify the default disk drive or volume using the SET DEFAULT command.
+ 您可以使用 DISKSPACE( ) 确定是否有足够的空间来备份文件,或执行需要额外磁盘空间存放临时工作文件的命令(例如 SORT)。您可以使用 SET DEFAULT 命令指定默认磁盘驱动器或卷。
@@ -5036,20 +4286,13 @@
- Executes the parent class event or method of the same name from within a subclass.
- For example, if you place DODEFAULT( ) in the Click event of a subclass, X# executes the Click event of the parent class. The scope resolution operator (::), unlike DODEFAULT( ), executes a parent class event or method of a different name.
- You can place DODEFAULT( ) only within an event or method.
+ 在子类中执行父类中同名的事件或方法。例如,如果将 DODEFAULT( ) 放在子类的 Click 事件中,X# 将执行父类的 Click 事件。与 DODEFAULT( ) 不同,作用域解析运算符 (::) 可以执行名称不同的父类事件或方法。DODEFAULT( ) 只能放在事件或方法内。
- Character, Numeric, Currency, Date, DateTime, Logical, or Memo
+ Character、Numeric、Currency、Date、DateTime、Logical 或 Memo
- The value that DODEFAULT( ) returns is determined by the return value of the event or method.
- In versions prior to X# 8.0, you could not call DODEFAULT( ) in a method that did not exist in the parent class without X# generating an error, "Property name is not found (Error 1734)", returning True (.T.), and disregarding DODEFAULT( ) and any passed parameters. However, X# now disregards this and does not generate an error, but the following results still occur:
- X# disregards any parameters that are passed because no code is executed.
- X# always returns True (.T.), which is the default behavior for any procedure without an explicit RETURN statement.
- This behavior affects the following scenarios:
- Custom methods that are defined in a class. For example, the line, codex.Test()/code, generated an error prior to X# 8.0 but no longer does:
+ DODEFAULT( ) 返回的值由事件或方法的返回值决定。在 X# 8.0 之前的版本中,如果在父类中不存在的方法里调用 DODEFAULT( ),X# 会生成错误 "Property name is not found (Error 1734)",返回 True (.T.),并忽略 DODEFAULT( ) 和任何传递的参数。但是,X# 现在会忽略该情况且不生成错误,不过仍会出现以下结果:X# 会忽略传递的任何参数,因为没有代码被执行。X# 始终返回 True (.T.),这是任何没有显式 RETURN 语句的过程的默认行为。此行为影响以下场景: 在类中定义的自定义方法。例如,代码行codex.Test()/code在 X# 8.0 之前会产生错误,但现在不会了:
CLEAR
x=CREATEOBJECT("s1")
@@ -5067,7 +4310,7 @@
ENDPROC
ENDDEFINE
- Native methods that are marked with the HIDDEN key word in the parent class. For example:
+ 在父类中用 HIDDEN 关键字标记的本机方法。例如:
CLEAR
x=CREATEOBJECT("s2")
@@ -5089,7 +4332,7 @@
ENDPROC
ENDDEFINE
- Starting in X# 7.0, calling a native method in a base class that contains DODEFAULT( ) does not cause an error. For example:
+ 从 X# 7.0 开始,在基类中调用包含 DODEFAULT( ) 的本机方法不会导致错误。例如:
CLEAR
x=CREATEOBJECT("s1")
@@ -5107,40 +4350,34 @@
- Returns a numeric day-of-the-week value from a Date or DateTime expression.
+ 从 Date 或 DateTime 表达式返回表示星期几的数值。
- Specifies the Date expression from which DOW( ) returns the day number.
+ 指定 DOW( ) 据以返回天数的 Date 表达式。
- Specifies the DateTime expression from which DOW( ) returns the day number.
+ 指定 DOW( ) 据以返回天数的 DateTime 表达式。
- Specifies the first day of the week. nFirstDayOfWeek may be one of the following values.
- 0
- DOW( ) uses whatever day is currently selected in the Week Starts On list box, which appears on the Regional Tab in the Options dialog box.
- 1
- Sunday. This is the default when nFirstDayOfWeek is omitted, and is the first day of the week used in earlier FoxPro versions.
- 2
- Monday
- 3
- Tuesday
- 4
- Wednesday
- 5
- Thursday
- 6
- Friday
- 7
- Saturday
+ 指定一周的第一天。nFirstDayOfWeek 可以是以下值之一。
+
+ 0 DOW( ) 使用 Options 对话框的 Regional 选项卡上显示的 Week Starts On 列表框中当前选定的日期。
+ 1 星期日。省略 nFirstDayOfWeek 时这是默认值,也是早期 FoxPro 版本中使用的一周的第一天。
+ 2 星期一
+ 3 星期二
+ 4 星期三
+ 5 星期四
+ 6 星期五
+ 7 星期六
+
- Numeric
+ 数值类型
@@ -5153,27 +4390,24 @@
- Returns a Character-type date from a Date or DateTime expression.
+ 从 Date 或 DateTime 表达式返回字符类型的日期。
- Specifies a Date-type variable, array element, or field for which DTOC( ) returns a Character-type date.
+ 指定 DTOC( ) 返回其字符类型日期的 Date 类型变量、数组元素或字段。
- Specifies a DateTime-type variable, array element, or field for which DTOC( ) returns a Character-type date.
- 1
- Returns the date in a format suitable for indexing. This is particularly useful for maintaining the table records in chronological sequence.
- For example, to order table records in entry sequence, you could issue this command:
+ 指定 DTOC( ) 返回其字符类型日期的 DateTime 类型变量、数组元素或字段。1 返回适合用于索引的日期格式。这对于使表记录保持按时间顺序排列特别有用。例如,要按录入顺序对表记录排序,可以执行以下命令:
INDEX ON DTOC(gdInvDate, 1) + gnInvTime TAG Timeindx
- codegdInvDate/code and codegnInvTime/code are fields containing the date and time when the data was entered in the record.
+ codegdInvDate/code 和 codegnInvTime/code 是包含该记录数据录入日期和时间的字段。
- Character
+ 字符类型
- DTOC( ) returns a character string corresponding to a Date or DateTime expression. The date format is determined by SET CENTURY and SET DATE.
+ DTOC( ) 返回与 Date 或 DateTime 表达式对应的字符串。日期格式由 SET CENTURY 和 SET DATE 决定。
@@ -5189,18 +4423,17 @@
- Converts degrees to radians.
+ 将角度转换为弧度。
- Specifies the numeric expression whose value you want to convert to radians. An angle expressed in a degree:minute:second format should be converted to its decimal equivalent.
+ 指定要转换为弧度的数值表达式。以 度:分:秒 格式表示的角度应先转换为其等效的十进制值。
- Numeric
+ 数值类型
- DTOR( ) converts the value of a numeric expression given in degrees to an equivalent value in radians. DTOR( ) is useful for working with the X# trigonometric functions: ACOS( ), ASIN( ), COS( ), SIN( ), TAN( ).
- Use RTOD( ) to convert radians to degrees.
+ DTOR( ) 将以度为单位的数值表达式的值转换为等效的弧度值。DTOR( ) 对于使用 X# 三角函数很有用:ACOS( )、ASIN( )、COS( )、SIN( )、TAN( )。使用 RTOD( ) 可将弧度转换为角度。
@@ -5215,23 +4448,22 @@
- Returns a character-string date in a yyyymmdd format from a specified Date or DateTime expression.
+ 从指定的 Date 或 DateTime 表达式返回 yyyymmdd 格式的字符串日期。
- Specifies the Date expression DTOS( ) converts to an eight-digit character string.
+ 指定 DTOS( ) 要转换为八位字符串的 Date 表达式。
- Specifies the DateTime expression DTOS( ) converts to an eight-digit character string.
+ 指定 DTOS( ) 要转换为八位字符串的 DateTime 表达式。
- Character
+ 字符类型
- This function is useful for indexing tables on a Date or DateTime field. It is equivalent to DTOC( ) when its optional 1 argument is included.
- The character string returned by DTOS( ) isn't affected by SET DATE or SET CENTURY.
+ 此函数可用于对 Date 或 DateTime 字段的表建立索引。当包含其可选的 1 参数时,它等效于 DTOC( )。DTOS( ) 返回的字符串不受 SET DATE 或 SET CENTURY 的影响。
@@ -5248,7 +4480,7 @@
指定从中返回 DateTime 值的日期表达式。
- DateTime
+ 日期时间类型
DToT( ) 返回的 DateTime 值的格式取决于当前的 SET DATE 和 SET MARK 设置。如果没有提供世纪,则默认为二十世纪。
@@ -5264,155 +4496,92 @@
- Opens the X# editor and, optionally positions the cursor.
+ 打开 X# 编辑器,并可选地定位光标。
- Specifies the valid shortcut ID.
+ 指定有效的快捷方式 ID。
- Specifies the name of the file to open. If the file is already open, X# activates it.
+ 指定要打开的文件名。如果该文件已经打开,X# 将激活它。
- Specifies the line at which to position the cursor. If you use 0, the cursor is positioned at the last location saved in the resource file. If you provide an invalid or non-existent nlineno, the cursor is positioned at the beginning of the current file. A negative nlineno value will generate an error.
+ 指定光标定位的行。如果使用 0,光标将定位在资源文件中最后保存的位置。如果提供了无效或不存在的 nlineno,光标将定位在当前文件的开头。nlineno 为负值将产生错误。
- Specifies the name of a class or data environment to be edited. If you open a class file (.vcx) without naming a class, the Class Designer opens instead of the editor.
+ 指定要编辑的类或数据环境的名称。如果打开类文件 (.vcx) 而未指定类名,则会打开类设计器而不是编辑器。
- Specifies the name of a method to be edited. Use a valid object-referenced method in the form cObject.nMethodName.
+ 指定要编辑的方法的名称。请使用形如 cObject.nMethodName 的有效对象引用方法。
- Specifies the name of a procedure to be edited in a class type file (.vcx, .scx, .frx, .lbx).
-
-
- Logical. Returns true (.T.) if the target file opens successfully, otherwise returns error codes according to the following table:
- 0
- Successful file opening.
- 132, 705
- File in use. Cannot be opened.
- 200
- File not opened due to invalid object reference. Verify the presence of cMethodName in the object referenced by the cClassName parameter.
- 901, 925
- File opened but invalid object reference in cMethodName. Check the reference in the cMethodName parameter. Use a reference such as MyForm.MyList.CLICK. Forms and classes return 925; reports return 901.
-
-
- You can pass cShortCutID without any additional information and have the editor open at that location. The cShortCutID is the unique ID value for a shortcut record stored in the Foxtask system table (_VFP.FoxTask). The Task List application uses this table to ensure that it can get the latest line position of the shortcut. X# maintains, internally, current shortcut information, but only writes line position updates to Foxtask when a file is saved.
- The file extension determines which X# editor opens, according to the following table:
- PRG
- Text Editor
- MODIFY COMMAND
- MPR
- Text Editor
- MODIFY COMMAND
- QPR
- Text Editor
- MODIFY COMMAND
- TXT
- Text Editor
- MODIFY FILE
- SCX
- Code Editor
- MODIFY FORM
- VCX
- Code Editor
- MODIFY CLASS
- FRX
- Code Editor
- MODIFY REPORT
- LBX
- Code Editor
- MODIFY LABEL
- MNX
- Menu Editor
- MODIFY MENU
- DBC
- Stored Procedures
- MODIFY PROCEDURE
- <other>
- Text Editor
- MODIFY FILE
- Program (.prg), database (.dbc stored procedures) and text files support only the nLineNo parameter.
- Menu file (.mnx) are opened as text files without reference to objects or to line numbers.
+ 指定要在类类型文件 (.vcx, .scx, .frx, .lbx) 中编辑的过程的名称。
+
+
+ 逻辑类型。如果目标文件成功打开,则返回 true (.T.),否则按下表返回错误代码:
+
+ 0 文件成功打开。
+ 132, 705 文件正在使用,无法打开。
+ 200 由于对象引用无效,文件未打开。请验证 cClassName 参数所引用的对象中是否存在 cMethodName。
+ 901, 925 文件已打开,但 cMethodName 中的对象引用无效。请检查 cMethodName 参数中的引用。请使用诸如 MyForm.MyList.CLICK 的引用。表单和类返回 925;报表返回 901。
+
+
+
+ 您可以只传递 cShortCutID 而不带任何其他信息,编辑器将在该位置打开。cShortCutID 是存储在 Foxtask 系统表 (_VFP.FoxTask) 中的快捷方式记录的唯一 ID 值。任务列表应用程序使用此表来确保能够获取快捷方式的最新行位置。X# 在内部维护当前的快捷方式信息,但仅在保存文件时才将行位置更新写入 Foxtask。文件扩展名决定打开哪个 X# 编辑器,如下表所示:
+
+ PRG 文本编辑器 MODIFY COMMAND
+ MPR 文本编辑器 MODIFY COMMAND
+ QPR 文本编辑器 MODIFY COMMAND
+ TXT 文本编辑器 MODIFY FILE
+ SCX 代码编辑器 MODIFY FORM
+ VCX 代码编辑器 MODIFY CLASS
+ FRX 代码编辑器 MODIFY REPORT
+ LBX 代码编辑器 MODIFY LABEL
+ MNX 菜单编辑器 MODIFY MENU
+ DBC 存储过程 MODIFY PROCEDURE
+ <other> 文本编辑器 MODIFY FILE
+
+程序 (.prg)、数据库 (.dbc 存储过程) 和文本文件仅支持 nLineNo 参数。菜单文件 (.mnx) 作为文本文件打开,不引用对象或行号。
- Determines whether an expression evaluates to empty.
+ 确定表达式的计算结果是否为空。
- Specifies the expression that EMPTY( ) evaluates. You can specify an expression with Character, Numeric, Date, Varbinary, Blob, or Logical type, or the name of a Memo or General field in an open table.
+ 指定 EMPTY( ) 要计算的表达式。您可以指定 Character、Numeric、Date、Varbinary、Blob 或 Logical 类型的表达式,或者指定打开的表中 Memo 或 General 字段的名称。
- Logical. EMPTY( ) returns True (.T.) if the expression eExpression evaluates to empty; otherwise, EMPTY( ) returns False (.F.).
- When expression types evaluate to the values in the following table, EMPTY( ) returns True (.T.).
-
- Blob
-
- Empty (0h) or contains only zero bytes, for example, 0h00, 0h000000, and so on
-
- Character
-
- Empty string, spaces, tabs, carriage returns, linefeeds, or any combination of these
-
- Currency
-
- 0
-
- Date
-
- Empty, for example, CTOD('')
-
- DateTime
-
- Empty, for example, CTOT('')
-
- Double
-
- 0
-
- Float
-
- 0
-
- General
-
- Empty (no OLE object)
-
- Integer
-
- 0
-
- Logical
-
- False (.F.)
-
- Memo
-
- Empty (no contents)
-
- Numeric
-
- 0
-
- Varbinary
-
- Empty (0h) or contains only zero bytes, for example, 0h00, 0h000000, and so on
+ 逻辑类型。如果表达式 eExpression 的计算结果为空,EMPTY( ) 返回 True (.T.);否则,EMPTY( ) 返回 False (.F.)。当表达式类型的计算结果为下表中的值时,EMPTY( ) 返回 True (.T.)。
+
+ Blob 为空 (0h) 或仅包含零字节,例如 0h00、0h000000 等
+ 字符类型 空字符串、空格、制表符、回车符、换行符或它们的任意组合
+ 货币类型 0
+ 日期类型 为空,例如 CTOD('')
+ 日期时间类型 为空,例如 CTOT('')
+ 双精度类型 0
+ 浮点类型 0
+ 通用类型 为空(无 OLE 对象)
+ 整数类型 0
+ 逻辑类型 False (.F.)
+ 备注类型 为空(无内容)
+ 数值类型 0
+ Varbinary 为空 (0h) 或仅包含零字节,例如 0h00、0h000000 等
+
- You cannot use EMPTY( ) to determine whether a variable object reference is empty. For example, a variable can contain an object reference for a form. If the form is closed by clicking Close from the form's pop-up menu or by issuing CLEAR WINDOWS, the variable contains the null value.
- The following program example demonstrates how to use TYPE( ) and ISNULL( ) to determine if a variable object reference is valid.
+ 不能使用 EMPTY( ) 来确定变量的对象引用是否为空。例如,变量可以包含对某个表单的对象引用。如果通过单击表单弹出菜单中的“关闭”或执行 CLEAR WINDOWS 关闭了该表单,则该变量包含 null 值。下面的程序示例演示了如何使用 TYPE( ) 和 ISNULL( ) 来确定变量的对象引用是否有效。
goMyForm = CREATEOBJECT('Form')
WAIT WINDOW IIF(TYPE('goMyForm') = 'O' AND !ISNULL(goMyForm), ;
@@ -5438,24 +4607,22 @@
- Determines whether the record pointer is positioned past the last record in the current or specified table.
+ 确定记录指针是否位于当前表或指定表的最后一条记录之后。
- Specifies the work area number of the table.
+ 指定表的工作区编号。
- Specifies the alias of the table.
- EOF( ) returns false (.F.) if a table isn't open in the work area you specify.
- If you do not specify a work area or alias, the table that is open in the currently selected work area is tested for the end of the table condition.
+ 指定表的别名。如果在您指定的工作区中没有打开表,EOF( ) 返回 false (.F.)。如果未指定工作区或别名,则对当前选定工作区中打开的表测试是否处于表尾条件。
- Logical
+ 逻辑类型
- EOF( ) returns true (.T.) if the record pointer reaches the end of the table file (EOF). The end of the table is reached when the record pointer passes the last record in the table. For example, when a FIND, LOCATE, or SEEK is unsuccessful, X# moves the record pointer past the last record, and EOF( ) returns true (.T.). EOF( ) returns false (.F.) if the record pointer isn't at the end of the table.
+ 如果记录指针到达表文件的末尾 (EOF),EOF( ) 返回 true (.T.)。当记录指针越过表中的最后一条记录时,即到达表尾。例如,当 FIND、LOCATE 或 SEEK 不成功时,X# 会将记录指针移到最后一条记录之后,EOF( ) 返回 true (.T.)。如果记录指针不在表尾,EOF( ) 返回 false (.F.)。
@@ -5483,16 +4650,13 @@
- Returns the error number for the error that triggered an ON ERROR routine.
+ 返回触发 ON ERROR 例程的错误的错误号。
- ERROR( )Return Value
- Numeric
+ ERROR( )返回值 数值类型
- ERROR( ) returns the number of the most recent error. An ON ERROR routine must be active for ERROR( ) to return a value other than 0.
- When an error is trapped during program execution, the error type can be returned by ERROR( ) in an ON ERROR routine. The corresponding error message can be returned by MESSAGE( ).
- The value ERROR( ) returns is reset by RETURN or RETRY.
+ ERROR( ) 返回最近一次错误的编号。必须有活动的 ON ERROR 例程,ERROR( ) 才会返回非 0 的值。当程序执行期间捕获到错误时,ERROR( ) 可在 ON ERROR 例程中返回错误类型。相应的错误消息可由 MESSAGE( ) 返回。ERROR( ) 返回的值会被 RETURN 或 RETRY 重置。
@@ -5513,19 +4677,17 @@
- Evaluates a character expression and returns the result.
+ 计算字符表达式并返回结果。
- Specifies the expression to evaluate. cExpression can be a literal character string, or a valid X# expression, variable, array element, or field of any data type, enclosed in quotation marks. cExpression cannot exceed 255 characters.
- Whenever possible, use EVALUATE( ) or a name expression to replace macro substitution using the & Command. EVALUATE and name expressions execute faster than macro substitution.
+ 指定要计算的表达式。cExpression 可以是字符串字面量,也可以是用引号括起来的任意数据类型的有效 X# 表达式、变量、数组元素或字段。cExpression 不能超过 255 个字符。只要可能,请使用 EVALUATE( ) 或名称表达式来替代使用 & 命令的宏替换。EVALUATE 和名称表达式的执行速度比宏替换更快。
- Character, Numeric, Currency, Date, DateTime, Logical, or Memo
+ Character、Numeric、Currency、Date、DateTime、Logical 或 Memo
- EVALUATE( ) is similar to TYPE( ) but returns the result of an expression instead of the expression type. An expression containing EVALUATE( ) cannot be optimized by Rushmore Query Optimization.
- Including the EVALUATE( ) function in the WHERE clause of a SQL query can return incorrect data.
+ EVALUATE( ) 类似于 TYPE( ),但返回的是表达式的结果而不是表达式的类型。包含 EVALUATE( ) 的表达式无法被 Rushmore 查询优化所优化。在 SQL 查询的 WHERE 子句中包含 EVALUATE( ) 函数可能会返回不正确的数据。
@@ -5537,29 +4699,27 @@
- Binds a COM server event to implemented interface methods on a X# object.
- For information about binding events from native X# objects, see Event Binding for X# Objects.
+ 将 COM 服务器事件绑定到 X# 对象上已实现的接口方法。有关绑定原生 X# 对象事件的信息,请参见 Event Binding for X# Objects。
- Specifies the object reference to the object whose events are to be bound. oCOMObject must be a valid COM object.
+ 指定要绑定其事件的对象的对象引用。oCOMObject 必须是有效的 COM 对象。
- Specifies the object reference to the X# object that contains user-defined method code, which maps to corresponding COM object events. The class must implement the events interface for the particular COM object being passed in the first parameter. For example, you must implement the RecordsetEvents interface to bind to an ADO Recordset object.
+ 指定包含用户定义方法代码的 X# 对象的对象引用,这些方法映射到相应的 COM 对象事件。该类必须实现第一个参数中传入的特定 COM 对象的事件接口。例如,要绑定到 ADO Recordset 对象,必须实现 RecordsetEvents 接口。
- X# automatically releases the COM object when it goes out of scope. By passing this parameter with a value of .T., you can release the event binding while both objects remain in scope.
+ 当 COM 对象超出作用域时,X# 会自动释放它。通过传递值为 .T. 的此参数,可以在两个对象仍在作用域内时释放事件绑定。
- Logical data type. EVENTHANDLER( ) returns True (.T.) if successful and False (.F.) if unsuccessful.
+ 逻辑数据类型。如果成功,EVENTHANDLER( ) 返回 True (.T.);如果失败,则返回 False (.F.)。
- You can bind a single COM object to several X# objects, or you can bind several COM objects to the same X# object.
- Event handling is automatically unbound when either the X# or the COM object is released. You can explicitly call the EVENTHANDLER( ) function and pass the lUnbind parameter to unbind objects without releasing object references.
+ 您可以将单个 COM 对象绑定到多个 X# 对象,也可以将多个 COM 对象绑定到同一个 X# 对象。当 X# 对象或 COM 对象被释放时,事件处理会自动解除绑定。您也可以显式调用 EVENTHANDLER( ) 函数并传递 lUnbind 参数,在不释放对象引用的情况下解除对象的绑定。
@@ -5615,17 +4775,17 @@
- Returns the value of ex where x is a specified numeric expression.
+ 返回 ex 的值,其中 x 是指定的数值表达式。
- Specifies the exponent, ix/i, in the exponential expression ie/ix.
+ 指定指数 ix/i,即指数表达式 ie/ix 中的指数。
- Numeric
+ 数值类型
- The value of e, the base of natural logarithms, is approximately 2.71828. The number of decimal places returned by EXP( ) is specified with SET DECIMALS.
+ e(自然对数的底)的值约为 2.71828。EXP( ) 返回的小数位数由 SET DECIMALS 指定。
@@ -5649,63 +4809,57 @@
- Changes the size of a file opened with a low-level file function.
+ 更改使用低级文件函数打开的文件的大小。
- Specifies the file handle of the file whose size you wish to change. The file handle is returned by FOPEN( ) when you open the file or by FCREATE( ) when you create the file. If a file is opened with FOPEN( ), it must be opened with write or read/write privileges to be able to change its size.
+ 指定要更改其大小的文件的文件句柄。文件句柄在打开文件时由 FOPEN( ) 返回,或在创建文件时由 FCREATE( ) 返回。如果使用 FOPEN( ) 打开文件,则必须以写入或读/写权限打开,才能更改其大小。
- Specifies the new file size in bytes. If nNewFileSize is less than the original file size, the file is truncated. If nNewFileSize is greater than the original file size, the file size is increased.
+ 指定以字节为单位的新文件大小。如果 nNewFileSize 小于原始文件大小,则文件将被截断。如果 nNewFileSize 大于原始文件大小,则文件大小将增加。
- Numeric
+ 数值类型
- Use FCHSIZE( ) to increase the file's size or truncate the file after a specified byte.
- When a file's size is increased, X# allocates sectors for the file on the drive where the file is opened. Since FCHSIZE( ) does not initialize the new file space, the space can contain previous data. Be sure to manage the new file space.
- The final size of the file in bytes is returned. X# returns –1 if FCHSIZE( ) is unable to change the file size if, for example, an invalid file handle is specified because of insufficient disk space, or if the file is read-only.
- This function can be used to truncate a file to length 0.
+ 使用 FCHSIZE( ) 可以增加文件的大小,或在指定字节之后截断文件。增加文件大小时,X# 会在打开该文件的驱动器上为文件分配扇区。由于 FCHSIZE( ) 不会初始化新的文件空间,该空间可能包含以前的数据。请务必管理好新的文件空间。函数返回文件最终的字节大小。如果 FCHSIZE( ) 无法更改文件大小,例如由于指定了无效的文件句柄、磁盘空间不足或文件为只读,X# 将返回 –1。此函数可用于将文件截断为长度 0。
- Flushes and closes a file or communication port opened with a low-level file function.
+ 刷新并关闭使用低级文件函数打开的文件或通信端口。
- Specifies the file handle of the low-level file to close. The numeric file handle is returned when you create the file with FCREATE( ) or open the file with FOPEN( ).
+ 指定要关闭的低级文件的文件句柄。数值型文件句柄在使用 FCREATE( ) 创建文件或使用 FOPEN( ) 打开文件时返回。
- Logical
+ 逻辑类型
- If the file is successfully closed, FCLOSE( ) returns true (.T.) and releases the file handle. If the file cannot be closed, FCLOSE( ) returns false (.F.).
- CLOSE ALL also closes low-level files.
+ 如果文件成功关闭,FCLOSE( ) 返回 true (.T.) 并释放该文件句柄。如果无法关闭文件,FCLOSE( ) 返回 false (.F.)。CLOSE ALL 也会关闭低级文件。
- Returns the number of fields in a table.
+ 返回表中的字段数。
- Specifies the work area of the table for which FCOUNT( ) returns the number of fields.
- FCOUNT( ) returns 0 if a table isn't open in the work area you specify.
+ 指定 FCOUNT( ) 要返回其字段数的表所在的工作区。如果在您指定的工作区中没有打开表,FCOUNT( ) 返回 0。
- Specifies the alias of the table for which FCOUNT( ) returns the number of fields.
- X# generates an error message if you specify a table alias that doesn't exist.
+ 指定 FCOUNT( ) 要返回其字段数的表的别名。如果指定的表别名不存在,X# 将生成错误消息。
- Numeric
+ 数值类型
- If you omit the optional arguments, FCOUNT( ) returns the number of fields in the table open in the currently selected work area.
+ 如果省略可选参数,FCOUNT( ) 返回当前选定工作区中打开的表的字段数。
@@ -5722,50 +4876,38 @@
- Creates and opens a low-level file.
+ 创建并打开低级文件。
- Specifies the name of the file to create. You can include a drive designator and path with the file name. If a drive designator or path isn't included, the file is created in the default directory.
- X# does not recognize a path name properly if a disk or directory name contains an exclamation point (!).
+ 指定要创建的文件的名称。文件名中可以包含驱动器标识符和路径。如果未包含驱动器标识符或路径,文件将在默认目录中创建。如果磁盘名或目录名包含感叹号 (!),X# 无法正确识别路径名。
- Specifies the attributes of the file created. The following table lists the file attributes you can specify.
- nFileAttribute
- 0
- (Default) Read/write
- 1
- Read-only
- 2
- Hidden
- 3
- Read-only/Hidden
- 4
- System
- 5
- Read-only/System
- 6
- System/Hidden
- 7
- Read-only/Hidden/System
- Note that a file created with nFileAttribute other than 0 cannot be written to with FPUTS( ) or FWRITE( ) until the file is closed and opened again.
- Use DISPLAY STATUS or LIST STATUS to display or print information about files created and opened with FCREATE( ). DISPLAY STATUS and LIST STATUS give the following information about each file opened or created with a low-level file function:
- The drive, directory, and file name
- The file handle number
- The file pointer position
- The read/write attributes
+ 指定所创建文件的属性。下表列出了可以指定的文件属性。
+
+ nFileAttribute 文件属性
+ 0 (默认值)读/写
+ 1 只读
+ 2 隐藏
+ 3 只读/隐藏
+ 4 系统
+ 5 只读/系统
+ 6 系统/隐藏
+ 7 只读/隐藏/系统
+
+请注意,使用非 0 的 nFileAttribute 创建的文件,在关闭并重新打开之前,无法使用 FPUTS( ) 或 FWRITE( ) 写入。使用 DISPLAY STATUS 或 LIST STATUS 可显示或打印有关使用 FCREATE( ) 创建和打开的文件的信息。DISPLAY STATUS 和 LIST STATUS 会给出使用低级文件函数打开或创建的每个文件的以下信息:
+驱动器、目录和文件名
+文件句柄编号
+文件指针位置
+读/写属性
- Numeric
+ 数值类型
- If a file with the name you specify already exists, it is overwritten without warning.
-
- FCREATE( ) assigns a file handle number to the file, which you can use to identify the file in other X# low-level file functions. FCREATE( ) returns the file handle number when a file is created, or returns –1 if the file cannot be created.
- Assign the file handle number to a memory variable so you can access the file by the variable in other low-level file functions.
- You cannot open a communication port with FCREATE( ). Use FOPEN( ) to open a communication port.
+ 如果已存在具有您指定名称的文件,它将被覆盖且不会给出警告。FCREATE( ) 为文件分配一个文件句柄编号,您可以在其他 X# 低级文件函数中使用它来标识该文件。创建文件时,FCREATE( ) 返回文件句柄编号;如果无法创建文件,则返回 –1。请将文件句柄编号赋给内存变量,以便在其他低级文件函数中通过该变量访问文件。不能使用 FCREATE( ) 打开通信端口。请使用 FOPEN( ) 打开通信端口。
@@ -5788,23 +4930,22 @@
- Returns the last modification Date or DateTime for a file.
+ 返回文件的最后修改 Date 或 DateTime。
- Specifies the name of the file whose last modification date FDATE( ) returns. cFileName can include a path with the file name. If a path is not included with the file name, X# searches for the file in the default directory and in any directories or folders specified with SET PATH.
+ 指定 FDATE( ) 要返回其最后修改日期的文件的名称。cFileName 可以包含带路径的文件名。如果文件名不包含路径,X# 将在默认目录以及使用 SET PATH 指定的任何目录或文件夹中搜索该文件。
- Specifies that FDATE( ) returns the last modification date or DateTime of the file specified with cFileName. If nType is 0, the last modification date is returned. Including 0 is identical to omitting nType. If nType is 1, the last modification DateTime is returned.
+ 指定 FDATE( ) 返回由 cFileName 指定的文件的最后修改日期还是 DateTime。如果 nType 为 0,则返回最后修改日期。包含 0 与省略 nType 相同。如果 nType 为 1,则返回最后修改的 DateTime。
- Date
+ 日期类型
- The Date or DateTime value that FDATE( ) returns is assigned to the file by the operating system.
- Use LUPDATE( ) to determine the last modification date for an open table.
+ FDATE( ) 返回的 Date 或 DateTime 值由操作系统分配给文件。使用 LUPDATE( ) 可确定打开的表的最后修改日期。
? FDATE('FOXUSER.DBF', 1) && Displays the last modification DateTime
@@ -5812,17 +4953,17 @@
- Determines whether the file pointer is positioned at the end of a file.
+ 确定文件指针是否位于文件末尾。
- Specifies the file handle number of the file to check for the end-of-file condition. FEOF( ) always returns true (.T.) if you specify a file handle number of a communication port opened with FOPEN( ).
+ 指定要检查文件结束条件的文件的文件句柄编号。如果指定的是使用 FOPEN( ) 打开的通信端口的文件句柄编号,FEOF( ) 始终返回 true (.T.)。
- Logical
+ 逻辑类型
- This low-level file function returns true (.T.) if the file pointer is positioned at the end of a file opened with a low-level file function. FEOF( ) returns false (.F.) if the file pointer isn't at the end of the file.
+ 如果文件指针位于使用低级文件函数打开的文件的末尾,此低级文件函数返回 true (.T.)。如果文件指针不在文件末尾,FEOF( ) 返回 false (.F.)。
@@ -5843,54 +4984,45 @@
- Returns a number corresponding to the most recent low-level file function error.
+ 返回与最近一次低级文件函数错误对应的数字。
- FERROR( )Return Value
- Numeric
+ FERROR( )返回值 数值类型
- FERROR( ) returns 0 if a low-level file function executes successfully. A positive value is returned if a function doesn't execute successfully. The following table lists each error number returned by FERROR( ) and the cause of the error.
- 2
- File not found
- 4
- Too many files open (out of file handles)
- 5
- Access denied
- 6
- Invalid file handle given
- 8
- Out of memory
- 25
- Seek error (can't seek before the start of a file)
- 29
- Disk full
- 31
- Error opening file
+ 如果低级文件函数执行成功,FERROR( ) 返回 0。如果函数执行不成功,则返回正值。下表列出了 FERROR( ) 返回的每个错误号及错误原因。
+
+ 2 文件未找到
+ 4 打开的文件过多(文件句柄用尽)
+ 5 拒绝访问
+ 6 给定的文件句柄无效
+ 8 内存不足
+ 25 查找错误(无法在文件开头之前查找)
+ 29 磁盘已满
+ 31 打开文件时出错
+
- Flushes to disk a file opened with a low-level function.
+ 将使用低级函数打开的文件刷新到磁盘。
- Specifies the file handle of the file to flush to disk.
+ 指定要刷新到磁盘的文件的文件句柄。
- If you specify a logical true (.T.) for lForce, Windows is used to immediately flush the file to disk.
- If you specify a logical false (.F.) (the default if lForce is omitted), X# flushes the file to disk at its earliest opportunity.
+ 如果为 lForce 指定逻辑真 (.T.),则使用 Windows 立即将文件刷新到磁盘。如果指定逻辑假 (.F.)(省略 lForce 时的默认值),X# 会在最早的时机将文件刷新到磁盘。
- Logical
+ 逻辑类型
- FFLUSH( ) also releases the memory used by the file's buffer.
- FLUSH is different from the FFLUSH( ) function. FLUSH doesn't operate on low-level files but rather on tables and indexes.
+ FFLUSH( ) 还会释放文件缓冲区所使用的内存。FLUSH 与 FFLUSH( ) 函数不同。FLUSH 不对低级文件操作,而是对表和索引操作。
@@ -5912,25 +5044,22 @@
- Returns a series of bytes from a file or a communication port opened with a low-level file function until it encounters a carriage return.
+ 从使用低级文件函数打开的文件或通信端口返回一系列字节,直到遇到回车符为止。
- Specifies the numeric file handle of the file or communication port from which FGETS( ) returns data.
+ 指定 FGETS( ) 从中返回数据的文件或通信端口的数值型文件句柄。
- Specifies the number of bytes FGETS( ) returns. FGETS( ) returns nBytes bytes unless a carriage return is encountered first. FGETS( ) returns data between the starting file-pointer position and the carriage return if a carriage return is encountered within nBytes bytes.
- FGETS( ) returns a maximum of 8192 bytes. If you omit nBytes, FGETS( )returns 254 bytes by default.
+ 指定 FGETS( ) 返回的字节数。除非先遇到回车符,否则 FGETS( ) 返回 nBytes 个字节。如果在 nBytes 个字节内遇到回车符,FGETS( ) 返回起始文件指针位置与回车符之间的数据。FGETS( ) 最多返回 8192 个字节。如果省略 nBytes,FGETS( ) 默认返回 254 个字节。
- Character
+ 字符类型
- You can read a file line by line by issuing a series of FGETS( ).
-
- FGETS( ) returns a series of bytes as a character string. Data is returned starting from the current file's pointer position and continuing until a carriage return is encountered. The file pointer is then positioned on the byte immediately following the carriage return. The carriage return is not returned as part of the string, and line feeds are discarded.
+ 您可以通过发出一系列 FGETS( ) 来逐行读取文件。FGETS( ) 以字符串形式返回一系列字节。数据从当前文件的指针位置开始返回,直到遇到回车符为止。然后文件指针定位在紧跟回车符之后的字节上。回车符不会作为字符串的一部分返回,换行符会被丢弃。
@@ -6014,28 +5143,26 @@
- Locates the specified file.
+ 定位指定的文件。
- Specifies the name of the file to locate. cFileName must include the file extension. You can include a path with the file name to search for a file in a directory or on a drive other than the current directory or drive.
- If you do not include a path with the file name, X# searches in the default directory for the file. If it cannot find the file in the default directory, X# searches along the X# path, which is established with SET PATH.
+ 指定要定位的文件的名称。cFileName 必须包含文件扩展名。您可以在文件名中包含路径,以便在当前目录或驱动器以外的目录或驱动器中搜索文件。如果文件名中未包含路径,X# 将在默认目录中搜索该文件。如果在默认目录中找不到该文件,X# 将沿使用 SET PATH 建立的 X# 路径进行搜索。
- Specifies the kind of value FILE( ) returns when the file exists but might be marked with the Hidden or System attribute. The following table lists the values for nFlags.
- 0
- FILE( ) returns False (.F.) if the file exists but is marked with a Hidden or System attribute. (Default)
- 1
- FILE( ) returns True (.T.) if the file exists, regardless of its file attributes. Setting nFlags to 1 allows you to check for hidden or system files.
+ 指定当文件存在但可能被标记为 Hidden 或 System 属性时 FILE( ) 返回的值的种类。下表列出了 nFlags 的值。
+
+ 0 如果文件存在但被标记为 Hidden 或 System 属性,FILE( ) 返回 False (.F.)。(默认值)
+ 1 只要文件存在,无论其文件属性如何,FILE( ) 都返回 True (.T.)。将 nFlags 设置为 1 可让您检查隐藏文件或系统文件。
+
- Logical data type. FILE( ) returns True (.T.) if the specified file is included in an application or found on a disk; otherwise, it returns False (.F.).
+ 逻辑数据类型。如果指定的文件包含在应用程序中或在磁盘上找到,FILE( ) 返回 True (.T.);否则返回 False (.F.)。
- You can use the ADIR( ) function to retrieve specific attributes for the file.
- You can use the CD and CHDIR commands to switch to hidden files and directories.
+ 您可以使用 ADIR( ) 函数检索文件的特定属性。您可以使用 CD 和 CHDIR 命令切换到隐藏的文件和目录。
@@ -6120,18 +5247,17 @@
- Returns the name of the function key (F1, F2, F3 ...) from the key's corresponding function key number.
+ 返回与按键对应的功能键编号所对应的功能键名称(F1、F2、F3 ...)。
- Specifies the function key number. The value of nFunctionKeyNumber should be from 0 through the number of function keys minus 1. FKLABEL( ) returns the empty string if nFunctionKeyNumber is greater than the number of function keys minus 1. The number of function keys can be determined with FKMAX( ).
+ 指定功能键编号。nFunctionKeyNumber 的值应为 0 到功能键数量减 1 之间。如果 nFunctionKeyNumber 大于功能键数量减 1,FKLABEL( ) 返回空字符串。功能键的数量可以通过 FKMAX( ) 确定。
- Character
+ 字符类型
- Function keys can be programmed with SET FUNCTION.
- The value returned by FKLABEL( ) is affected by SET COMPATIBLE. When COMPATIBLE is set to FOXPLUS (the default), FKLABEL( ) returns the function keys. When COMPATIBLE is set to DB4, FKLABEL( ) returns the function key and function key combinations (F1, CTRL+F1, SHIFT+F1, F2, CTRL+F2, SHIFT+F2, ...).
+ 功能键可以通过 SET FUNCTION 进行编程。FKLABEL( ) 返回的值受 SET COMPATIBLE 影响。当 COMPATIBLE 设置为 FOXPLUS(默认值)时,FKLABEL( ) 返回功能键。当 COMPATIBLE 设置为 DB4 时,FKLABEL( ) 返回功能键及功能键组合(F1、CTRL+F1、SHIFT+F1、F2、CTRL+F2、SHIFT+F2、...)。
@@ -6154,14 +5280,13 @@
- Returns the number of programmable function keys or function key combinations on your keyboard.
+ 返回键盘上可编程的功能键或功能键组合的数量。
- FKMAX( )Return Value
- Numeric
+ FKMAX( )返回值 数值类型
- The value returned by FKMAX( ) is affected by SET COMPATIBLE. When SET COMPATIBLE is set to FOXPLUS (the default), FKMAX( ) returns the number of function keys. When SET COMPATIBLE is set to DB4, FKMAX( ) returns the number of function key and function key combinations (F1, CTRL+F1, SHIFT+F1, F2, CTRL+F2, SHIFT+F2, ...).
+ FKMAX( ) 返回的值受 SET COMPATIBLE 影响。当 SET COMPATIBLE 设置为 FOXPLUS(默认值)时,FKMAX( ) 返回功能键的数量。当 SET COMPATIBLE 设置为 DB4 时,FKMAX( ) 返回功能键及功能键组合的数量(F1、CTRL+F1、SHIFT+F1、F2、CTRL+F2、SHIFT+F2、...)。
@@ -6192,30 +5317,22 @@
- Attempts to lock the current or specified table.
+ 尝试锁定当前表或指定的表。
- Specifies the work area of the table that FLOCK( ) attempts to lock. Omitting nWorkArea or cTableAlias causes FLOCK( ) to attempt locking the table that is open in the currently selected work area.
+ 指定 FLOCK( ) 尝试锁定的表所在的工作区。如果省略 nWorkArea 或 cTableAlias,FLOCK( ) 将尝试锁定当前选定工作区中打开的表。
- Specifies the alias of the table that FLOCK( ) attempts to lock.
- X# generates an error message if you specify a table alias that does not exist.
+ 指定 FLOCK( ) 尝试锁定的表的别名。如果指定的表别名不存在,X# 会生成错误消息。
- Logical. FLOCK( ) returns True (.T.) if the table is successfully locked. Otherwise, it returns False (.F.) under the following conditions:
- The table or a record in the table is already locked by another user.
- A table is not open in the work area you specify.
- If FLOCK() fails to lock a table and returns False (.F.), FLOCK() does not generate an error. As a result, you cannot use FLOCK() to trigger an ON ERROR routine.
+ 逻辑类型。如果表被成功锁定,FLOCK( ) 返回 True (.T.)。否则,在以下情况下返回 False (.F.):该表或表中的某条记录已被其他用户锁定;在您指定的工作区中没有打开表。如果 FLOCK() 未能锁定表并返回 False (.F.),FLOCK() 不会生成错误。因此,您不能使用 FLOCK() 来触发 ON ERROR 例程。
- When a table is locked, the table is available for both read and write access by the user who placed the lock. Other users on the network have read-only access to the table. For information on how to lock a table and prevent access to it by other users, see SET EXCLUSIVE Command and USE Command.
- A table remains locked until it is unlocked by the user who placed the lock. The table can be unlocked by issuing UNLOCK, closing the table, or quitting X#. Tables can be closed with USE, CLEAR ALL, or CLOSE DATABASES.
- By default, FLOCK( ) attempts to lock a table once. Use SET REPROCESS to automatically retry a table lock when the first attempt fails. SET REPROCESS determines the number of lock attempts, or the length of time during which lock attempts are made when the initial lock attempt is unsuccessful. For more information, see SET REPROCESS Command.
- You can establish relations between two or more tables with SET RELATION. Placing a file lock on a table that is related to one or more tables doesn't place a file lock on the related tables. You must explicitly place and remove locks on the related tables.
- For additional information about record and file locking and sharing tables on a network, see Programming for Shared Access.
+ 当表被锁定时,加锁的用户可以对该表进行读写访问。网络上的其他用户只能以只读方式访问该表。有关如何锁定表并阻止其他用户访问的信息,请参见 SET EXCLUSIVE 命令和 USE 命令。表会一直保持锁定状态,直到加锁的用户将其解锁。可以通过执行 UNLOCK、关闭表或退出 X# 来解锁表。可以使用 USE、CLEAR ALL 或 CLOSE DATABASES 关闭表。默认情况下,FLOCK( ) 只尝试锁定表一次。使用 SET REPROCESS 可以在首次尝试失败时自动重试表锁定。SET REPROCESS 确定首次锁定尝试失败后的锁定尝试次数,或进行锁定尝试的持续时间。有关更多信息,请参见 SET REPROCESS 命令。您可以使用 SET RELATION 在两个或多个表之间建立关系。对与一个或多个表相关联的表加文件锁,并不会对相关表加文件锁。您必须显式地对相关表加锁和解锁。有关记录锁定、文件锁定以及在网络上共享表的更多信息,请参见共享访问编程。
@@ -6241,14 +5358,14 @@
- Returns the nearest integer that is less than or equal to the specified numeric expression.
+ 返回小于或等于指定数值表达式的最接近的整数。
- Specifies the numeric expression for which FLOOR( ) returns the nearest integer that is less than or equal to the numeric expression.
+ 指定数值表达式,FLOOR( ) 返回小于或等于该数值表达式的最接近的整数。
- Numeric
+ 数值类型
@@ -6276,44 +5393,35 @@
- Opens a file for use with low-level file functions.
+ 打开文件以供低级文件函数使用。
- Specifies the name of the file to open. cFileName can include a path to open files in directories, folders, drives, or volumes not in the current X# search path. If a path isn't included, X# searches for the file in the following locations:
- Default directory
- Path established with SET PATH
- X# will not recognize a path name properly if a disk or directory name contains an exclamation point (!).
+ 指定要打开的文件的名称。cFileName 可以包含路径,以打开不在当前 X# 搜索路径中的目录、文件夹、驱动器或卷中的文件。如果未包含路径,X# 会在以下位置搜索该文件:
+默认目录
+通过 SET PATH 设置的路径
+如果磁盘或目录名称中包含感叹号 (!),X# 将无法正确识别路径名。
- Specifies read/write privileges or a buffering scheme for the file you open. The following table lists each number you can include in nAttribute, and the read/write file privileges and buffering scheme it establishes.
- 0
- (Default) Read-only
- Buffered
- 1
- Write-only
- 2
- Read and Write
- 10
- Unbuffered
- 11
- 12
- If nAttribute isn't included, or if nAttribute evaluates to 0, the file is opened as read-only and is buffered.
- X# will not recognize a path name properly if a disk or directory name contains an exclamation point (!).
+ 指定所打开文件的读/写权限或缓冲方案。下表列出了可以在 nAttribute 中包含的每个数字,以及它所确定的文件读/写权限和缓冲方案。
+
+ nAttribute 读/写权限 缓冲方案
+ 0 (默认值)只读 缓冲
+ 1 只写
+ 2 读写
+ 10 无缓冲
+ 11
+ 12
+
+如果未包含 nAttribute,或者 nAttribute 的计算结果为 0,则文件以只读方式打开并使用缓冲。如果磁盘或目录名称中包含感叹号 (!),X# 将无法正确识别路径名。
- Numeric
+ 数值类型
- If FOPEN( ) successfully opens the file, the file handle number of the file is returned. FOPEN( ) returns –1 if the file cannot be opened.
- Assign the file handle number to a memory variable so you can access the file by the memory variable in other low-level file functions.
- The following information about files opened with FOPEN( ) can be displayed or sent to a printer with DISPLAY STATUS or LIST STATUS.
- Drive and directory or volume and folder, and file name
- File handle number
- File pointer position
- Read/write attributes
+ 如果 FOPEN( ) 成功打开文件,则返回该文件的文件句柄号。如果无法打开文件,FOPEN( ) 返回 –1。将文件句柄号赋给内存变量,以便在其他低级文件函数中通过该内存变量访问文件。可以使用 DISPLAY STATUS 或 LIST STATUS 显示或发送到打印机的、与通过 FOPEN( ) 打开的文件有关的信息包括:驱动器和目录,或卷和文件夹,以及文件名;文件句柄号;文件指针位置;读/写属性。
@@ -6400,27 +5508,22 @@
- Determines whether the most recently executed CONTINUE, FIND, LOCATE, or SEEK command was successful or if the record pointer was moved in a related table.
- You can use FOUND( ) to determine if a child table has a record that matches the parent record.
+ 确定最近执行的 CONTINUE、FIND、LOCATE 或 SEEK 命令是否成功,或者记录指针在相关表中是否发生了移动。您可以使用 FOUND( ) 确定子表中是否存在与父记录匹配的记录。
- Specifies the work area of the table that the most recent CONTINUE, FIND, LOCATE, or SEEK command was called on.
+ 指定最近一次调用 CONTINUE、FIND、LOCATE 或 SEEK 命令所针对的表所在的工作区。
- Specifies the alias of the table that the most recent CONTINUE, FIND, LOCATE, or SEEK command was called on.
- If you specify a table alias that does not exist, X# generates an error message.
+ 指定最近一次调用 CONTINUE、FIND、LOCATE 或 SEEK 命令所针对的表的别名。如果指定的表别名不存在,X# 会生成错误消息。
- Logical. FOUND( ) returns True (.T.) if the most recent CONTINUE, FIND, LOCATE, or SEEK command was successful; otherwise, it returns False (.F.). If a table is not open in the work area you specify, FOUND( ) returns False. When FOUND( ) encounters an end-of-file, which can be determined by the EOF( ) function, it always returns False.
+ 逻辑类型。如果最近的 CONTINUE、FIND、LOCATE 或 SEEK 命令成功,FOUND( ) 返回 True (.T.);否则返回 False (.F.)。如果在您指定的工作区中没有打开表,FOUND( ) 返回 False。当 FOUND( ) 遇到文件结束(可通过 EOF( ) 函数确定)时,它始终返回 False。
- If you call FOUND( ) without arguments, FOUND( ) is called on the table open in the currently selected work area.
- The following example locates and counts all customers whose Country field in the Customer table contains "GERMANY". CLOSE DATABASES closes all databases, and OPEN DATABASE opens the sample X# database, TestData.dbc. USE opens the Customer table.
-
- STORE stores a value of 0 in the variable gnCount. LOCATE searches for the first record in which the Country field contains the value "GERMANY". The DO WHILE loop increments the variable gnCount by 1 and uses CONTINUE to perform another LOCATE operation. When there are no more matching records, the total number of customers is displayed.
+ 如果不带参数调用 FOUND( ),则对当前选定工作区中打开的表调用 FOUND( )。以下示例定位并统计 Customer 表中 Country 字段包含 "GERMANY" 的所有客户。CLOSE DATABASES 关闭所有数据库,OPEN DATABASE 打开 X# 示例数据库 TestData.dbc。USE 打开 Customer 表。STORE 将值 0 存储到变量 gnCount 中。LOCATE 搜索 Country 字段包含值 "GERMANY" 的第一条记录。DO WHILE 循环将变量 gnCount 加 1,并使用 CONTINUE 执行另一次 LOCATE 操作。当没有更多匹配的记录时,显示客户总数。
CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\TestData')
@@ -6437,45 +5540,44 @@
- Writes a character string, carriage return, and line feed to a file opened with a low-level file function.
+ 将字符串、回车符和换行符写入使用低级文件函数打开的文件。
- Specifies the file handle number for the file to which FPUTS( ) writes data.
+ 指定 FPUTS( ) 向其写入数据的文件的文件句柄号。
- Specifies the character expression that FPUTS( ) writes to the file.
+ 指定 FPUTS( ) 写入文件的字符表达式。
- Specifies the number of characters in cExpression to write to the file.
- FPUTS( ) writes the entire character expression cExpression to the file if you omit nCharactersWritten. If you include nCharactersWritten, nCharactersWritten characters are written to the file. If nCharactersWritten is less than the number of characters in cExpression, only nCharactersWritten characters are written to the file. All of cExpression is written to the file if nCharactersWritten is equal to or greater than the number of characters in cExpression.
+ 指定要写入文件的 cExpression 中的字符数。如果省略 nCharactersWritten,FPUTS( ) 会将整个字符表达式 cExpression 写入文件。如果包含 nCharactersWritten,则写入文件的是 nCharactersWritten 个字符。如果 nCharactersWritten 小于 cExpression 中的字符数,则只有 nCharactersWritten 个字符被写入文件。如果 nCharactersWritten 等于或大于 cExpression 中的字符数,则整个 cExpression 都会被写入文件。
- Numeric
+ 数值类型
- FPUTS( ) returns the number of bytes written to the file. Zero is returned if FPUTS( ) cannot write to the file for any reason.
+ FPUTS( ) 返回写入文件的字节数。如果 FPUTS( ) 由于任何原因无法写入文件,则返回零。
- Returns a specified number of bytes from a file opened with a low-level function.
+ 从使用低级函数打开的文件中返回指定数量的字节。
- Specifies the file handle number for the file from which FREAD( ) returns data. You can obtain nFileHandle from the return value of successful FOPEN( ) or FCREATE( ) statements.
+ 指定 FREAD( ) 从中返回数据的文件的文件句柄号。您可以从成功的 FOPEN( ) 或 FCREATE( ) 语句的返回值中获得 nFileHandle。
- Specifies the number of bytes returned by FREAD( ) with a limit of 65,535 bytes. FREAD( ) returns data starting from the current file pointer position and continues until it returns nBytes bytes or until it encounters the end of the file.
+ 指定 FREAD( ) 返回的字节数,上限为 65,535 字节。FREAD( ) 从当前文件指针位置开始返回数据,直到返回 nBytes 个字节或遇到文件结尾为止。
- Character
+ 字符类型
@@ -6499,33 +5601,32 @@
- Moves the file pointer in a file opened with a low-level file function.
+ 移动使用低级文件函数打开的文件中的文件指针。
- Specifies the file handle for the file in which FSEEK( ) moves the file pointer. A file handle number is returned by FCREATE( ) or FOPEN( ) when the file is created or opened.
+ 指定 FSEEK( ) 在其中移动文件指针的文件的文件句柄。创建或打开文件时,FCREATE( ) 或 FOPEN( ) 会返回文件句柄号。
- Specifies the number of bytes to move the file pointer. The file pointer is moved toward the end of the file if nBytesMoved is positive. The file pointer is moved toward the beginning of the file if nBytesMoved is negative.
+ 指定文件指针要移动的字节数。如果 nBytesMoved 为正数,文件指针向文件末尾方向移动。如果 nBytesMoved 为负数,文件指针向文件开头方向移动。
- Moves the file pointer to a relative position in the file. By default, the file pointer is moved relative to the beginning of the file. You can also move the file pointer relative to the current file pointer or the end of the file by including nRelativePosition. The following table lists values for nRelativePosition and from where the file pointer is moved.
- 0
- (Default) The beginning of the file.
- 1
- The current file pointer position.
- 2
- The end of the file.
+ 将文件指针移动到文件中的相对位置。默认情况下,文件指针相对于文件开头移动。通过包含 nRelativePosition,您也可以相对于当前文件指针位置或文件末尾移动文件指针。下表列出了 nRelativePosition 的值以及文件指针的移动起点。
+
+ 0 (默认值)文件开头。
+ 1 当前文件指针位置。
+ 2 文件末尾。
+
- Numeric
+ 数值类型
- After moving the file pointer, FSEEK( ) returns the number of bytes the file pointer is positioned from the beginning of the file. The file pointer can also be moved with FREAD( ) and FWRITE( ).
+ 移动文件指针后,FSEEK( ) 返回文件指针相对于文件开头所处位置的字节数。也可以使用 FREAD( ) 和 FWRITE( ) 移动文件指针。
@@ -6548,53 +5649,43 @@
- Returns the size in bytes of a specified field or file.
+ 返回指定字段或文件的大小(以字节为单位)。
- Specifies the name of the field.
+ 指定字段的名称。
- Specifies the work area of the table for which FSIZE( ) returns a field size.
- FSIZE( ) returns 0 if a table isn't open in the work area you specify.
+ 指定 FSIZE( ) 返回其字段大小的表所在的工作区。如果在您指定的工作区中没有打开表,FSIZE( ) 返回 0。
- Specifies the alias of the table for which FSIZE( ) returns a field size.
- X# generates an error message if you specify a table alias that doesn't exist.
+ 指定 FSIZE( ) 返回其字段大小的表的别名。如果指定的表别名不存在,X# 会生成错误消息。
- Specifies a file for which FSIZE( ) returns the size in bytes.
+ 指定 FSIZE( ) 返回其大小(以字节为单位)的文件。
- Numeric
+ 数值类型
- The current setting of SET COMPATIBLE determines if FSIZE( ) returns the size of a field or a file. If SET COMPATIBLE is set to OFF or FOXPLUS (the default), FSIZE( ) returns the size of a field. If SET COMPATIBLE is set to ON or DB4, FSIZE( ) returns the size of a file.
- The following table shows the default size (in bytes) for each fixed-length field type.
- Currency
- 8
- Date
- 8
- DateTime
- 8
- Double
- 8
- Integer
- 4
- Logical
- 1
- Memo
- 4
- General
- 4
- The size of a field can be displayed with DISPLAY STRUCTURE and LIST STRUCTURE.
- If you omit the optional nWorkArea and cTableAlias arguments, FSIZE( ) returns the field size for a field in the current table and work area.
+ SET COMPATIBLE 的当前设置决定 FSIZE( ) 返回的是字段的大小还是文件的大小。如果 SET COMPATIBLE 设置为 OFF 或 FOXPLUS(默认值),FSIZE( ) 返回字段的大小。如果 SET COMPATIBLE 设置为 ON 或 DB4,FSIZE( ) 返回文件的大小。下表显示了每种固定长度字段类型的默认大小(以字节为单位)。
+
+ 货币类型 8
+ 日期类型 8
+ 日期时间类型 8
+ 双精度类型 8
+ 整数类型 4
+ 逻辑类型 1
+ 备注类型 4
+ 通用类型 4
+
+可以使用 DISPLAY STRUCTURE 和 LIST STRUCTURE 显示字段的大小。如果省略可选的 nWorkArea 和 cTableAlias 参数,FSIZE( ) 返回当前表和工作区中字段的大小。
@@ -6610,17 +5701,17 @@
- Returns the last modification time for a file.
+ 返回文件的最后修改时间。
- Specifies the name of the file whose last modification time FTIME( ) returns. cFileName can include a path with the file name. If a path is not included with the file name, X# searches for the file in the default directory and in any directories or folders specified with SET PATH.
+ 指定 FTIME( ) 返回其最后修改时间的文件的名称。cFileName 可以包含带有文件名的路径。如果文件名中未包含路径,X# 会在默认目录以及通过 SET PATH 指定的任何目录或文件夹中搜索该文件。
- Character
+ 字符类型
- The time that FTIME( ) returns is assigned to the file by the operating system.
+ FTIME( ) 返回的时间由操作系统分配给文件。
? FTIME('FOXUSER.DBF') && Displays the last modification time
@@ -6628,46 +5719,44 @@
- Writes a character string to a file opened with a low-level file function.
+ 将字符串写入使用低级文件函数打开的文件。
- Specifies the file handle number for the file to which FWRITE( ) writes.
+ 指定 FWRITE( ) 向其写入的文件的文件句柄号。
- Specifies the character expression that FWRITE( ) writes to the file specified with nFileHandle.
+ 指定 FWRITE( ) 写入由 nFileHandle 指定的文件的字符表达式。
- FWRITE( ) writes the entire character expression to the file unless you include nCharactersWritten. When you include nCharactersWritten, nCharactersWritten characters are written to the file. If nCharactersWritten is less than the number of characters in cExpression, only nCharactersWritten characters are written to the file. All of the characters in cExpression are written to the file if nCharactersWritten is equal to or greater than the number of characters in cExpression.
+ 除非包含 nCharactersWritten,否则 FWRITE( ) 会将整个字符表达式写入文件。包含 nCharactersWritten 时,写入文件的是 nCharactersWritten 个字符。如果 nCharactersWritten 小于 cExpression 中的字符数,则只有 nCharactersWritten 个字符被写入文件。如果 nCharactersWritten 等于或大于 cExpression 中的字符数,则 cExpression 中的所有字符都会被写入文件。
- Numeric
+ 数值类型
- Unlike FPUTS( ), FWRITE( ) doesn't place a carriage return and a line feed at the end of the character string.
- FWRITE( ) returns the number of bytes written to the file. If FWRITE( ) can't write to the file for any reason, 0 is returned.
+ 与 FPUTS( ) 不同,FWRITE( ) 不会在字符串末尾添加回车符和换行符。FWRITE( ) 返回写入文件的字节数。如果 FWRITE( ) 由于任何原因无法写入文件,则返回 0。
- Returns the number of an item on a menu defined with DEFINE POPUP or the X# system menu.
+ 返回使用 DEFINE POPUP 定义的菜单或 X# 系统菜单上某个菜单项的编号。
- Specifies the menu item.
+ 指定菜单项。
- Specifies a position on the menu. nMenuPosition can range from 1 through the number of items within the menu.
- 1 corresponds to the first item on the menu, 2 to the second item, and so on.
+ 指定菜单上的位置。nMenuPosition 的范围可以是 1 到菜单中的菜单项数量。1 对应菜单上的第一项,2 对应第二项,依此类推。
- Numeric
+ 数值类型
- Use GETBAR( ) to determine which item occupies a specific position on a menu. This function is useful when items on a menu are added, removed, or rearranged. Use DEFINE BAR to add an item to a menu or RELEASE BAR to remove an item. The position of items in a menu can be changed if MOVER is included when the menu is created with DEFINE POPUP.
+ 使用 GETBAR( ) 确定哪个菜单项位于菜单上的特定位置。当菜单上的项被添加、删除或重新排列时,此函数非常有用。使用 DEFINE BAR 添加菜单项,使用 RELEASE BAR 删除菜单项。如果使用 DEFINE POPUP 创建菜单时包含了 MOVER,则可以更改菜单中各项的位置。
@@ -6693,19 +5782,17 @@
- Returns the contents of the specified MS-DOS environment variable.
+ 返回指定的 MS-DOS 环境变量的内容。
- Specifies the name of the environment variable. The empty string is returned if the environment variable you specify doesn't exist.
- You can locate the Windows directory with the WINDIR environmental variable, which Windows sets when it starts.
+ 指定环境变量的名称。如果您指定的环境变量不存在,则返回空字符串。可以使用 WINDIR 环境变量找到 Windows 目录,该变量在 Windows 启动时设置。
- Character
+ 字符类型
- Two environment variables are always available: COMSPEC and PATH. You can create your own environment variables with the command shell SET command.
- For additional information on creating environment variables, see the Windows product documentation.
+ 始终有两个环境变量可用:COMSPEC 和 PATH。您可以使用命令外壳的 SET 命令创建自己的环境变量。有关创建环境变量的更多信息,请参见 Windows 产品文档。
@@ -6716,38 +5803,36 @@
- Provides access to COM object properties, methods, and events through early binding.
+ 通过早期绑定提供对 COM 对象的属性、方法和事件的访问。
- Specifies the target COM object.
+ 指定目标 COM 对象。
- Specifies the GUID of the target interface of oObject. cIID can be an interface such as "IContextState" or it can be a GUID, such as "{94631BEC-EE81-479A-AE64-A6CFC37B4799}". If it's "IDispatch", then GetInterface() returns an IDispatch (late-bound) reference to the object. If cIID is not specified, then GetInterface() will return the early binding interface for the object.
+ 指定 oObject 的目标接口的 GUID。cIID 可以是接口,例如 "IContextState",也可以是 GUID,例如 "{94631BEC-EE81-479A-AE64-A6CFC37B4799}"。如果是 "IDispatch",则 GetInterface() 返回该对象的 IDispatch(晚期绑定)引用。如果未指定 cIID,则 GetInterface() 将返回该对象的早期绑定接口。
- Specifies the interface name.
+ 指定接口名称。
- Specifies the name of the type library containing the oObject class.
+ 指定包含 oObject 类的类型库的名称。
- Specifies the name of the program to be used to lookup the type library.
- COM Object Interface reference
+ 指定用于查找类型库的程序的名称。COM 对象接口参考
- GetInterface( ) applies only to COM objects. If you use native X# objects, GetInterface( ) generates an error. GetInterface( ) returns an early-bound Object reference.
- When a DLL is built on a Windows 95, Windows 98, or Windows Me platform, X# does not include the type library inside the DLL. When you use GETINTERFACE( ) and refer to a DLL built on one of these platforms, you must use the Type Library name instead of the DLL name as in the following code:
+ GetInterface( ) 仅适用于 COM 对象。如果使用原生 X# 对象,GetInterface( ) 会生成错误。GetInterface( ) 返回早期绑定的 Object 引用。当 DLL 在 Windows 95、Windows 98 或 Windows Me 平台上构建时,X# 不会在 DLL 中包含类型库。当您使用 GETINTERFACE( ) 并引用在这些平台之一上构建的 DLL 时,必须使用类型库名称而不是 DLL 名称,如下面的代码所示:
oX = GETINTERFACE(x, "Imyclass", "myclass1.TLB")
- You can use the following code for a DLL built on Windows XP, Windows 2000, or Windows NT:
+ 对于在 Windows XP、Windows 2000 或 Windows NT 上构建的 DLL,可以使用以下代码:
oX = GETINTERFACE(x, "Imyclass", "myclass1.DLL")
@@ -6775,22 +5860,22 @@
- Returns the menu title for a given position on the menu bar.
+ 返回菜单栏上指定位置的菜单标题。
- Specifies the menu bar name.
+ 指定菜单栏名称。
- Specifies a position on the menu bar. nMenuPosition can range from 1 (the leftmost menu title on the menu bar) through the number of menu titles on the menu bar.
+ 指定菜单栏上的位置。nMenuPosition 的范围可以是 1(菜单栏上最左侧的菜单标题)到菜单栏上的菜单标题数量。
- Character
+ 字符类型
- Menu names on a titles bar can be added, removed, or rearranged. Use DEFINE PAD to add a menu name to a title bar or RELEASE PAD to remove a menu title.
+ 标题栏上的菜单名称可以被添加、删除或重新排列。使用 DEFINE PAD 向标题栏添加菜单名称,使用 RELEASE PAD 删除菜单标题。
@@ -6805,37 +5890,37 @@
- Returns the current value for a property or program code for an event or method at design time.
+ 在设计时返回属性的当前值,或事件或方法的程序代码。
- Specifies the object for which a property value or event or method program code is returned. oObjectName can be any expression that evaluates to an object, such as an object reference, an object memory variable, or an object array element.
+ 指定要返回其属性值或事件或方法程序代码的对象。oObjectName 可以是任何计算结果为对象的表达式,例如对象引用、对象内存变量或对象数组元素。
- Specifies the class for which a property value or event or method program code is returned.
+ 指定要返回其属性值或事件或方法程序代码的类。
- Specifies the property whose value is returned.
+ 指定要返回其值的属性。
- Specifies the event for which program code is returned.
+ 指定要返回其程序代码的事件。
- Specifies the method for which program code is returned.
+ 指定要返回其程序代码的方法。
- Character, Currency, Date, DateTime, Numeric, or Logical
+ 字符类型、货币类型、日期类型、日期时间类型、数值类型 或 逻辑类型
- In X# 6.0 and later, using GETPEM( ) to return method code is supported only during an interactive X# session. You can, however, obtain method code from an object by using its Class property, as in the following code:
+ 在 X# 6.0 及更高版本中,仅在交互式 X# 会话期间支持使用 GETPEM( ) 返回方法代码。不过,您可以通过对象的 Class 属性从对象获取方法代码,如下面的代码所示:
LOCAL oObject, lcCode
oObject = NEWOBJECT("_form", HOME()+"ffc\_base.vcx")
@@ -6936,40 +6021,36 @@
- Returns the number of bytes in the header of the current or specified table file.
+ 返回当前表文件或指定表文件头中的字节数。
- Numeric
+ 数值类型
- A table header contains information about the table itself, such as the field names and sizes and the presence of a memo file or structural index.
+ 表头包含有关表本身的信息,例如字段名称和大小,以及是否存在备注文件或结构索引。
- Returns the names of the X# and Visual Studio directories.
+ 返回 X# 和 Visual Studio 目录的名称。
- Specifies that HOME( ) returns the name of a specific X# or Visual Studio directory. Omitting nLocation is identical to HOME(0).
- The following table lists the values for nLocation and the directory that HOME( ) returns. The directories listed below assume that you chose the default installation directory when you installed X# or Visual Studio.
- 0 or omitted
- The directory from which X# was started
- 1
- The directory in which X# is installed
- 2
- The directory containing the X# samples. This directory is identical to the samples directory in the _SAMPLES system variable.
- Visual Studio Common directory
- X# Graphics directory
- 5
- Visual Studio MSDN directory
- Visual Studio Tools directory
- 7
- X# subdirectory in the user's X# Application Data directory
- X# Projects subdirectory in the user's X# My Documents directory. This directory is the default location for new projects and files created by X#.
+ 指定 HOME( ) 返回特定的 X# 或 Visual Studio 目录的名称。省略 nLocation 等同于 HOME(0)。下表列出了 nLocation 的值以及 HOME( ) 返回的目录。下面列出的目录假定您在安装 X# 或 Visual Studio 时选择了默认安装目录。
+
+ 0 或省略 启动 X# 的目录
+ 1 安装 X# 的目录
+ 2 包含 X# 示例的目录。该目录与 _SAMPLES 系统变量中的示例目录相同。
+ 3 Visual Studio Common 目录
+ 4 X# Graphics 目录
+ 5 Visual Studio MSDN 目录
+ 6 Visual Studio Tools 目录
+ 7 用户的 X# Application Data 目录中的 X# 子目录
+ 8 用户的 X# My Documents 目录中的 X# Projects 子目录。该目录是由 X# 创建的新项目和文件的默认位置。
+
- Character data type. HOME( ) returns the names of specific X# and Visual Studio directories.
+ 字符类型数据。HOME( ) 返回特定的 X# 和 Visual Studio 目录的名称。
@@ -7110,21 +6191,17 @@
- Returns one of two values depending on the value of a logical expression.
+ 根据逻辑表达式的值返回两个值之一。
- Specifies the logical expression that IIF( ) evaluates.
-
- eExpression1, eExpression2
- If lExpression evaluates to True (.T.), eExpression1 is returned and eExpression2 is not evaluated. If lExpression evaluates to False (.F.) or null (.NULL.), eExpression2 is returned and eExpression1 is not evaluated.
+ 指定 IIF( ) 计算的逻辑表达式。eExpression1, eExpression2 如果 lExpression 的计算结果为 True (.T.),则返回 eExpression1,并且不计算 eExpression2。如果 lExpression 的计算结果为 False (.F.) 或 null (.NULL.),则返回 eExpression2,并且不计算 eExpression1。
- Character, Numeric, Currency, Date, or DateTime
+ 字符类型、数值类型、货币类型、日期类型 或 日期时间类型
- This function, also known as Immediate IF, evaluates a logical expression and then returns one of two expressions. If the logical expression evaluates to True (.T.), IIF( ) returns the first expression. If the logical expression evaluates to False (.F.) or null (.NULL.), IIF( ) returns the second expression.
- This function can be used in place of IF ... ENDIF for simple conditional expressions, and is especially useful in report and label expressions that conditionally specify field contents. The IIF( ) function also executes faster than an equivalent IF ... ENDIF.
+ 此函数也称为立即 IF,它计算逻辑表达式,然后返回两个表达式之一。如果逻辑表达式的计算结果为 True (.T.),IIF( ) 返回第一个表达式。如果逻辑表达式的计算结果为 False (.F.) 或 null (.NULL.),IIF( ) 返回第二个表达式。对于简单的条件表达式,此函数可以代替 IF ... ENDIF 使用,在有条件地指定字段内容的报表和标签表达式中尤其有用。IIF( ) 函数的执行速度也比等效的 IF ... ENDIF 更快。
@@ -7140,420 +6217,119 @@
- Returns a number corresponding to the first mouse click or key press in the type-ahead buffer.
+ 返回与类型提前缓冲区中第一次鼠标单击或按键相对应的数字。
- Specifies the number of seconds to wait for a keystroke. If you do not specify a value for nSeconds, INKEY( ) returns a value for a keystroke immediately. If nSeconds is 0, INKEY( ) waits indefinitely for a keystroke.
+ 指定等待击键的秒数。如果未指定 nSeconds 的值,INKEY( ) 会立即返回击键的值。如果 nSeconds 为 0,INKEY( ) 会无限期等待击键。
- Shows or hides the cursor, or checks for a mouse click.
- The following table lists values for cHideCursor.
- Show cursor.
- Hide cursor.
- M
- Check for a mouse click.
- E
- Expand the keyboard macro if a keyboard macro is assigned to a key or key combination. To return successive values for each keystroke in a macro, execute INKEY( ) repeatedly with E included.
- If both S and H are included in cHideCursor, the latter character specified takes precedence. You can combine values for cHideCursor, for example, to check for a mouse click and show the cursor, include M and S. To check for a mouse click and hide the cursor, include H and M. INKEY( ) disregards characters other than S, H, M, and E in cHideCursor.
-
-
- Numeric. INKEY( ) returns 0 if a key has not been pressed. If several keys are present in the type-ahead buffer, INKEY( ) returns the value of the first key entered in the buffer. INKEY( ) also returns the following values according to certain conditions:
- If M is included for cHideCursor, INKEY( ) returns the value 151.
- If E is included, INKEY( ) returns a value corresponding to the first keystroke assigned to the keyboard macro. If you omit E, INKEY( ) returns the value for the key or key combination that triggers the keyboard macro.
- For single keys and key combinations using the SHIFT, CTRL, and ALT keys, the following table lists the return values for INKEY( ). A dash (–) indicates that the key combination returns no value.
- F1
- 28
- 84
- 94
- 104
- F2
- –1
- 85
- 95
- 105
- F3
- –2
- 86
- 96
- 106
- F4
- –3
- 87
- 97
- 107
- F5
- –4
- 88
- 98
- 108
- F6
- –5
- 89
- 99
- 109
- F7
- –6
- 90
- 100
- 110
- F8
- –7
- 91
- 101
- 111
- F9
- –8
- 92
- 102
- 112
- F10
- –9
- 93
- 103
- 113
- F11
- 133
- 135
- 137
- 139
- F12
- 134
- 136
- 138
- 140
- 1
- 49
- 33
- –
- 120
- 2
- 50
- 64
- –
- 121
- 3
- 51
- 35
- –
- 122
- 4
- 52
- 36
- –
- 123
- 5
- 53
- 37
- –
- 124
- 6
- 54
- 94
- –
- 125
- 7
- 55
- 38
- –
- 126
- 8
- 56
- 42
- –
- 127
- 9
- 57
- 40
- –
- 128
- 0
- 48
- 41
- –
- 19
- a
- 97
- 65
- 1
- 30
- b
- 98
- 66
- 2
- 48
- c
- 99
- 67
- 3
- 46
- d
- 100
- 68
- 4
- 32
- e
- 101
- 69
- 5
- 18
- f
- 102
- 70
- 6
- 33
- g
- 103
- 71
- 7
- 34
- h
- 104
- 72
- 127
- 35
- I
- 105
- 73
- 9
- 23
- j
- 106
- 74
- 10
- 36
- k
- 107
- 75
- 11
- 37
- l
- 108
- 76
- 12
- 38
- m
- 109
- 77
- 13
- 50
- n
- 110
- 78
- 14
- 49
- o
- 111
- 79
- 15
- 24
- p
- 112
- 80
- 16
- 25
- q
- 113
- 81
- 17
- 16
- r
- 114
- 82
- 18
- 19
- s
- 115
- 83
- 19
- 31
- t
- 116
- 84
- 20
- 20
- u
- 117
- 85
- 21
- 22
- v
- 118
- 86
- 22
- 47
- w
- 119
- 87
- 23
- 17
- x
- 120
- 88
- 24
- 45
- y
- 121
- 89
- 25
- 21
- z
- 122
- 90
- 26
- 44
- INS
- 22
- 22
- 146
- 162
- HOME
- 1
- 55
- 29
- 151
- DEL
- 7
- 7
- 147
- 163
- END
- 6
- 49
- 23
- 159
- PAGE UP
- 18
- 57
- 31
- 153
- PAGE DOWN
- 3
- 51
- 30
- 161
- UP ARROW
- 5
- 56
- 141
- 152
- DOWN ARROW
- 24
- 50
- 145
- 160
- RIGHT ARROW
- 4
- 54
- 2
- 157
- LEFT ARROW
- 19
- 52
- 26
- 155
- ESC
- 27
- –/27
- –*/27
- –*/1
- ENTER
- 13
- 13
- 10
- –/166
- BACKSPACE
- 127
- 127
- 127
- 14
- TAB
- 9
- 15
- 148/*
- *
- SPACEBAR
- 32
- 32
- 32/–
- 57
- ` or ~
- 96
- 126
-
- 41
- - or _
- 45
- 95
-
-
- = or +
- 61
- 43
-
- 13
- [ or {
- 91
- 123
- 27
- 26
- ] or }
- 93
- 125
- 29
- 27
- \ or |
- 92
- 124
- 28
- 43
- ; or :
- 59
- 58
-
- 39
- ' or "
- 39
- 34
-
- 40
- , or <
- 44
- 60
-
- 51
- . or >
- 46
- 62
-
- 52
- / or ?
- 47
- 63
-
- 53
- * Keystroke reserved by Windows.
+ 显示或隐藏游标,或检查鼠标单击。下表列出了 cHideCursor 的值。
+
+ S 显示游标。
+ H 隐藏游标。
+ M 检查鼠标单击。
+ E 如果键盘宏已分配给某个键或组合键,则展开该键盘宏。若要返回宏中每次击键的连续值,请在包含 E 的情况下重复执行 INKEY( )。
+
+如果 cHideCursor 中同时包含 S 和 H,则以后指定的字符为准。可以组合 cHideCursor 的值,例如,若要检查鼠标单击并显示游标,请包含 M 和 S。若要检查鼠标单击并隐藏游标,请包含 H 和 M。INKEY( ) 会忽略 cHideCursor 中除 S、H、M 和 E 之外的字符。
+
+
+ 数值类型。如果未按下任何键,INKEY( ) 返回 0。如果键入缓冲区中存在多个键,INKEY( ) 返回缓冲区中最先输入的键的值。INKEY( ) 还会根据特定条件返回以下值:如果 cHideCursor 中包含 M,INKEY( ) 返回值 151。如果包含 E,INKEY( ) 返回与分配给键盘宏的第一次击键相对应的值。如果省略 E,INKEY( ) 返回触发键盘宏的键或组合键的值。对于单个键以及使用 SHIFT、CTRL 和 ALT 键的组合键,下表列出了 INKEY( ) 的返回值。短横线 (–) 表示该组合键不返回任何值。
+
+ 按键 单独按键 SHIFT+按键 CTRL+按键 ALT+按键
+ F1 28 84 94 104
+ F2 –1 85 95 105
+ F3 –2 86 96 106
+ F4 –3 87 97 107
+ F5 –4 88 98 108
+ F6 –5 89 99 109
+ F7 –6 90 100 110
+ F8 –7 91 101 111
+ F9 –8 92 102 112
+ F10 –9 93 103 113
+ F11 133 135 137 139
+ F12 134 136 138 140
+ 1 49 33 – 120
+ 2 50 64 – 121
+ 3 51 35 – 122
+ 4 52 36 – 123
+ 5 53 37 – 124
+ 6 54 94 – 125
+ 7 55 38 – 126
+ 8 56 42 – 127
+ 9 57 40 – 128
+ 0 48 41 – 19
+ a 97 65 1 30
+ b 98 66 2 48
+ c 99 67 3 46
+ d 100 68 4 32
+ e 101 69 5 18
+ f 102 70 6 33
+ g 103 71 7 34
+ h 104 72 127 35
+ I 105 73 9 23
+ j 106 74 10 36
+ k 107 75 11 37
+ l 108 76 12 38
+ m 109 77 13 50
+ n 110 78 14 49
+ o 111 79 15 24
+ p 112 80 16 25
+ q 113 81 17 16
+ r 114 82 18 19
+ s 115 83 19 31
+ t 116 84 20 20
+ u 117 85 21 22
+ v 118 86 22 47
+ w 119 87 23 17
+ x 120 88 24 45
+ y 121 89 25 21
+ z 122 90 26 44
+ INS 22 22 146 162
+ HOME 1 55 29 151
+ DEL 7 7 147 163
+ END 6 49 23 159
+ PAGE UP 18 57 31 153
+ PAGE DOWN 3 51 30 161
+ UP ARROW 5 56 141 152
+ DOWN ARROW 24 50 145 160
+ RIGHT ARROW 4 54 2 157
+ LEFT ARROW 19 52 26 155
+ ESC 27 –/27 –*/27 –*/1
+ ENTER 13 13 10 –/166
+ BACKSPACE 127 127 127 14
+ TAB 9 15 148/* *
+ SPACEBAR 32 32 32/– 57
+ ` 或 ~ 96 126 41
+ - 或 _ 45 95
+ = 或 + 61 43 13
+ [ 或 { 91 123 27 26
+ ] 或 } 93 125 29 27
+ \ 或 | 92 124 28 43
+ ; 或 : 59 58 39
+ ' 或 " 39 34 40
+ , 或 < 44 60 51
+ . 或 > 46 62 52
+ / 或 ? 47 63 53
+
+* Windows 保留的击键。
- Determines whether an expression matches another expression in a set of expressions.
+ 确定一个表达式是否与一组表达式中的另一个表达式匹配。
- Specifies the expression INLIST( ) searches for in the set of expressions.
-
- eExpression2[, eExpression3...]
- Specifies the set of expressions to search. You must include at least one expression (eExpression2), and can include up to 25 expressions (eExpression2, eExpression3, and so on).
- All the expressions in the set of expressions must be of the same data type.
+ 指定 INLIST( ) 在表达式集合中搜索的表达式。eExpression2[, eExpression3...] 指定要搜索的表达式集合。必须至少包含一个表达式 (eExpression2),最多可包含 25 个表达式 (eExpression2、eExpression3 等)。表达式集合中的所有表达式必须具有相同的数据类型。
- Logical or null value
+ 逻辑类型或 null 值
- INLIST( ) returns true (.T.) if it finds the expression in the set of expressions; otherwise INLIST( ) returns false (.F.). The null value is returned if eExpression1 is the null value. The null value is also returned if eExpression1 is not the null value, eExpression1 does not match another expression, and at least one of the other expressions is the null value.
+ 如果在表达式集合中找到该表达式,INLIST( ) 返回 true (.T.);否则 INLIST( ) 返回 false (.F.)。如果 eExpression1 为 null 值,则返回 null 值。如果 eExpression1 不是 null 值,eExpression1 与其他表达式均不匹配,并且其他表达式中至少有一个为 null 值,也会返回 null 值。
@@ -7575,14 +6351,14 @@
- Evaluates a numeric expression and returns the integer portion of the expression.
+ 计算数值表达式并返回该表达式的整数部分。
- Specifies the numeric expression for which INT( ) returns the integer portion.
+ 指定 INT( ) 返回其整数部分的数值表达式。
- Numeric
+ 数值类型
@@ -7597,17 +6373,17 @@
- Determines whether the leftmost character in a character expression is alphabetic.
+ 确定字符表达式最左边的字符是否为字母。
- Specifies the character expression that ISALPHA( ) evaluates. Any characters after the first character in cExpression are ignored.
+ 指定 ISALPHA( ) 计算的字符表达式。cExpression 中第一个字符之后的所有字符都将被忽略。
- Logical
+ 逻辑类型
- ISALPHA( ) returns true (.T.) if the leftmost character in the specified character expression is an alphabetic character; otherwise ISALPHA( ) returns false (.F.).
+ 如果指定字符表达式最左边的字符是字母,ISALPHA( ) 返回 true (.T.);否则 ISALPHA( ) 返回 false (.F.)。
@@ -7637,17 +6413,17 @@
- Determines whether the leftmost character of the specified character expression is a digit (0 through 9).
+ 确定指定字符表达式最左边的字符是否为数字 (0 到 9)。
- Specifies the character expression that ISDIGIT( ) tests. Any characters after the first character in cExpression are ignored.
+ 指定 ISDIGIT( ) 测试的字符表达式。cExpression 中第一个字符之后的所有字符都将被忽略。
- Logical
+ 逻辑类型
- ISDIGIT( ) returns true (.T.) if the leftmost character of the specified character expression is a digit (0 through 9); otherwise, ISDIGIT( ) returns false (.F.).
+ 如果指定字符表达式最左边的字符是数字 (0 到 9),ISDIGIT( ) 返回 true (.T.);否则,ISDIGIT( ) 返回 false (.F.)。
@@ -7683,33 +6459,32 @@
- Returns true (.T.) if the first byte of the first character in a character expression is the lead byte of a double-byte character.
+ 如果字符表达式中第一个字符的第一个字节是双字节字符的首字节,则返回 true (.T.)。
- Specifies the character expression that ISLEADBYTE( ) evaluates. Any bytes after the first byte in the first character in cExpression are ignored.
+ 指定 ISLEADBYTE( ) 计算的字符表达式。cExpression 中第一个字符的第一个字节之后的所有字节都将被忽略。
- Logical
+ 逻辑类型
- ISLEADBYTE( ) returns true (.T.) if the first byte of the first character in a character expression is the lead byte in a double-byte character. If ISLEADBYTE( ) returns false (.F.), the character being tested is a single-byte character.
- This function is useful for manipulating double-byte character sets for languages such as Hiragana and Katakana.
+ 如果字符表达式中第一个字符的第一个字节是双字节字符的首字节,ISLEADBYTE( ) 返回 true (.T.)。如果 ISLEADBYTE( ) 返回 false (.F.),则被测试的字符是单字节字符。此函数适用于处理日语平假名和片假名等语言的双字节字符集。
- Determines whether the leftmost character of the specified character expression is a lowercase alphabetic character.
+ 确定指定字符表达式最左边的字符是否为小写字母。
- Specifies the character expression that ISLOWER( ) tests. ISLOWER( ) ignores any characters after the first character in cExpression.
+ 指定 ISLOWER( ) 测试的字符表达式。ISLOWER( ) 会忽略 cExpression 中第一个字符之后的所有字符。
- Logical
+ 逻辑类型
- ISLOWER( ) returns true (.T.) if the leftmost character in the specified character expression is a lowercase alphabetic character; otherwise, ISLOWER( ) returns false (.F.).
+ 如果指定字符表达式最左边的字符是小写字母,ISLOWER( ) 返回 true (.T.);否则,ISLOWER( ) 返回 false (.F.)。
@@ -7883,34 +6658,30 @@
- Returns an integer corresponding to the last key pressed.
+ 返回与最后按下的键相对应的整数。
- LASTKEY( )Return Value
- Numeric
+ LASTKEY( )返回值 数值类型
- The values returned by LASTKEY( ) are the same as the values returned by INKEY( ). See INKEY( ) for a list of keys and their return values.
-
- LASTKEY( ) is updated when you move between controls.
+ LASTKEY( ) 返回的值与 INKEY( ) 返回的值相同。有关键及其返回值的列表,请参见 INKEY( )。在控件之间移动时,LASTKEY( ) 会被更新。
- Returns a specified number of characters from a character expression, starting with the leftmost character.
+ 从字符表达式中返回指定数量的字符,从最左边的字符开始。
- Specifies the character expression that LEFT( ) returns characters from.
+ 指定 LEFT( ) 从中返回字符的字符表达式。
- Specifies the number of characters returned from the character expression. If nExpression is greater than the length of cExpression, all of the character expression is returned. If nExpression is negative or 0, LEFT( ) returns an empty string.
- LEFT( ) uses a starting position of 1 and is identical to SUBSTR( ).
+ 指定从字符表达式返回的字符数。如果 nExpression 大于 cExpression 的长度,则返回整个字符表达式。如果 nExpression 为负数或 0,LEFT( ) 返回空字符串。LEFT( ) 使用起始位置 1,等同于 SUBSTR( )。
- Character. LEFT( ) returns a character string.
+ 字符类型。LEFT( ) 返回一个字符串。
@@ -7945,14 +6716,14 @@
- Determines the number of characters in a character expression, indicating the length of the expression.
+ 确定字符表达式中的字符数,即表达式的长度。
- Specifies the character expression for which LEN( ) returns the number of characters.
+ 指定 LEN( ) 返回其字符数的字符表达式。
- Numeric. LEN( ) returns the number of characters in a character expression.
+ 数值类型。LEN( ) 返回字符表达式中的字符数。
@@ -7986,25 +6757,23 @@
- Determines if a character expression matches another character expression.
+ 确定一个字符表达式是否与另一个字符表达式匹配。
- Specifies the character expression that LIKE( ) compares with cExpression2. cExpression1 can contain the wildcards such as * and ?. The question mark (?) matches any single character in cExpression2 and the asterisk (*) matches any number of characters. You can mix any number of wildcards in any combination in cExpression1.
+ 指定 LIKE( ) 与 cExpression2 进行比较的字符表达式。cExpression1 可以包含 * 和 ? 等通配符。问号 (?) 匹配 cExpression2 中的任意单个字符,星号 (*) 匹配任意数量的字符。可以在 cExpression1 中以任意组合混合使用任意数量的通配符。
- Specifies the character expression LIKE( ) compares with cExpression1. cExpression2 must match cExpression1 letter for letter in order for LIKE( ) to return true (.T.).
+ 指定 LIKE( ) 与 cExpression1 进行比较的字符表达式。cExpression2 必须与 cExpression1 逐字母完全匹配,LIKE( ) 才会返回 true (.T.)。
- Logical
+ 逻辑类型
- LIKE( ) returns true (.T.) if cExpression1 matches cExpression2; otherwise, it returns false (.F.).
-
- SET COMPATIBLE determines how LIKE( ) evaluates cExpression1 and cExpression2. If SET COMPATIBLE is set to ON or DB4, cExpression1 and cExpression2 have all trailing blanks removed before they are compared. If SET COMPATIBLE is set to OFF or FOXPLUS, any trailing blanks in cExpression1 and cExpression2 are used in the comparison.
+ 如果 cExpression1 与 cExpression2 匹配,LIKE( ) 返回 true (.T.);否则返回 false (.F.)。SET COMPATIBLE 决定 LIKE( ) 如何计算 cExpression1 和 cExpression2。如果 SET COMPATIBLE 设置为 ON 或 DB4,则在比较之前会删除 cExpression1 和 cExpression2 的所有尾随空格。如果 SET COMPATIBLE 设置为 OFF 或 FOXPLUS,则 cExpression1 和 cExpression2 中的任何尾随空格都会参与比较。
@@ -8050,17 +6819,17 @@
- Returns the natural logarithm (base e) of the specified numeric expression.
+ 返回指定数值表达式的自然对数 (以 e 为底)。
- Specifies the numeric expression for which LOG( ) returns the value of x in the equation e^x = nExpression. nExpression must be greater than 0.
+ 指定数值表达式,LOG( ) 返回方程 e^x = nExpression 中 x 的值。nExpression 必须大于 0。
- Numeric
+ 数值类型
- The base for the natural logarithm is the constant e. The number of decimal places returned in the result is specified with SET DECIMALS.
+ 自然对数的底是常数 e。结果中返回的小数位数由 SET DECIMALS 指定。
@@ -8073,17 +6842,17 @@
- Returns the common logarithm (base 10) of the specified numeric expression.
+ 返回指定数值表达式的常用对数 (以 10 为底)。
- Specifies the numeric expression for which LOG10( ) returns the value of x in the equation 10^x = nExpression. nExpression must be greater than 0.
+ 指定数值表达式,LOG10( ) 返回方程 10^x = nExpression 中 x 的值。nExpression 必须大于 0。
- Numeric
+ 数值类型
- The base for the common logarithm is 10. The number of decimal places returned in the result is specified with SET DECIMALS.
+ 常用对数的底是 10。结果中返回的小数位数由 SET DECIMALS 指定。
@@ -8097,17 +6866,17 @@
- Returns a specified character expression in lowercase letters.
+ 以小写字母返回指定的字符表达式。
- Specifies the character expression LOWER( ) converts.
+ 指定 LOWER( ) 要转换的字符表达式。
- Character
+ 字符类型
- LOWER( ) converts all uppercase letters (A – Z) in the character expression to lowercase (a – z). All other characters in the character expression remain unchanged.
+ LOWER( ) 将字符表达式中的所有大写字母 (A – Z) 转换为小写字母 (a – z)。字符表达式中的所有其他字符保持不变。
@@ -8119,27 +6888,23 @@
- Removes all leading spaces or parsing characters from the specified character expression, or all leading zero (0) bytes from the specified binary expression.
+ 从指定的字符表达式中删除所有前导空格或解析字符,或从指定的二进制表达式中删除所有前导零 (0) 字节。
- Specifies an expression of Character or Varbinary type to remove leading spaces or 0 bytes from, respectively.
+ 指定 Character 或 Varbinary 类型的表达式,分别从中删除前导空格或 0 字节。
- Specifies if trimming is case-sensitive when one or more parse characters (cParseChar, cParseChar2, … are included. Trimming is case-sensitive if nFlags is zero or is omitted. Trimming is case-insensitive if nFlags 1.
-
- cParseChar [, cParseChar2 [, ...]]
- Specifies one or more character strings that are trimmed from the beginning of cExpression. If cParseChar isn't included, then leading spaces or 0 bytes are removed from Expression.
- Note The maximum number of strings permitted in cParseChar is 23.
+ 指定在包含一个或多个解析字符 (cParseChar、cParseChar2、…) 时,修剪是否区分大小写。如果 nFlags 为零或被省略,则修剪区分大小写。如果 nFlags 为 1,则修剪不区分大小写。cParseChar [, cParseChar2 [, ...]] 指定从 cExpression 开头修剪的一个或多个字符串。如果未包含 cParseChar,则从 Expression 中删除前导空格或 0 字节。Note cParseChar 中允许的最大字符串数为 23。
- Character or Varbinary. LTRIM( ) returns the specified expression without leading spaces or parsing characters, or 0 bytes.
+ Character 或 Varbinary。LTRIM( ) 返回不含前导空格、解析字符或 0 字节的指定表达式。
- LTRIM( ) is particularly useful for removing the leading spaces that are inserted when you use the STR( ) function to convert a Numeric value to a Character string.
+ LTRIM( ) 特别适用于删除使用 STR( ) 函数将 Numeric 值转换为 Character 字符串时插入的前导空格。
@@ -8153,14 +6918,13 @@
- Returns the date on which a table was last updated.
+ 返回表最后一次更新的日期。
- Date
+ 日期类型
- This function is useful in update procedures.
- LUPDATE( ) queries Windows to determine the date a table was last updated. However, the last two digits of the year the table was last updated are stored the table header.
+ 此函数适用于更新过程。LUPDATE( ) 向 Windows 查询以确定表最后一次更新的日期。但是,表最后一次更新的年份的最后两位数字存储在表头中。
@@ -8174,10 +6938,10 @@
- Evaluates a set of expressions and returns the expression with the maximum value.
+ 计算一组表达式并返回具有最大值的表达式。
- Character, Numeric, Currency, Double, Float, Date, or DateTime
+ 字符类型、数值类型、Currency、Double、Float、Date 或 DateTime
@@ -8202,51 +6966,42 @@
- Returns the column position of the mouse pointer in the main X# window or a user-defined window or form.
+ 返回鼠标指针在 X# 主窗口或用户定义的窗口或窗体中的列位置。
- Specifies the name of the window or form whose mouse-pointer column position MCOL( ) returns.
+ 指定 MCOL( ) 返回其鼠标指针列位置的窗口或窗体的名称。
- Specifies that the column position of the mouse pointer is returned for the currently active window or form.
+ 指定返回鼠标指针在当前活动窗口或窗体中的列位置。
- Specifies the unit of measurement for the value MCOL( ) returns. The following table lists the settings for nScaleMode.
- 0
- Foxels. A foxel is equivalent to the average height and width of a character based on the current font of the form in which an object is contained. (Default)
- 3
- Pixels. A pixel is the smallest element that can be displayed on a screen or printer. Pixels are screen-dependent.
+ 指定 MCOL( ) 返回值的度量单位。下表列出了 nScaleMode 的设置。
+
+ 0 Foxels。一个 foxel 相当于基于对象所在窗体的当前字体的字符的平均高度和宽度。(默认值)
+ 3 Pixels。像素是屏幕或打印机上可以显示的最小元素。像素取决于屏幕。
+
- Numeric. MCOL( ) returns the column position of the mouse pointer in the main X# window, user-defined window, or form.
- If you omit cWindowName, and there is no active user-defined window or form, MCOL( ) returns the mouse pointer's column position in the main X# window. If you omit cWindowName, and there is an active user-defined window or form, MCOL( ) returns the mouse pointer's column position in the active user-defined window or form. MCOL( ) returns –1 if the mouse pointer is positioned outside the user-defined window or form, if no mouse driver is loaded, or there is no output window.
+ 数值类型。MCOL( ) 返回鼠标指针在 X# 主窗口、用户定义窗口或窗体中的列位置。如果省略 cWindowName,并且没有活动的用户定义窗口或窗体,MCOL( ) 返回鼠标指针在 X# 主窗口中的列位置。如果省略 cWindowName,并且存在活动的用户定义窗口或窗体,MCOL( ) 返回鼠标指针在活动的用户定义窗口或窗体中的列位置。如果鼠标指针位于用户定义窗口或窗体之外、未加载鼠标驱动程序或没有输出窗口,MCOL( ) 返回 –1。
- Using the MCOL( ) function without the optional argument 0 may affect the behavior of code on forms when the Form AllowOutput property IS set to false (.F.). For example, the placement of a shortcut menu that is defined in the RightClick event may not display in the proper location if you use the MCOL( ) and MROW( ) functions to determine where the menu is displayed. In this case, be sure to include 0 in the MCOL( ) and MROW( ) functions.
+ 当 Form 的 AllowOutput 属性设置为 false (.F.) 时,使用不带可选参数 0 的 MCOL( ) 函数可能会影响窗体上代码的行为。例如,如果使用 MCOL( ) 和 MROW( ) 函数确定快捷菜单的显示位置,则在 RightClick 事件中定义的快捷菜单可能无法显示在正确的位置。在这种情况下,请务必在 MCOL( ) 和 MROW( ) 函数中包含 0。
- Included for backward compatibility. Use the Click, MouseDown, MouseUp, and RightClick events instead.
-
- Determines whether or not the mouse button is pressed.
+ 为向后兼容而保留。请改用 Click、MouseDown、MouseUp 和 RightClick 事件。确定鼠标按钮是否被按下。
- Return value - Logical
+ 返回值 - 逻辑类型
-
- MDOWN() returns a true (.T.) or false (.F.) value depending on whether or not the mouse button is pressed.
-
- In FoxPro for MS-DOS and FoxPro for Windows, MDOWN() returns values for just the left mouse button.
-
- If the mouse button is depressed when MDOWN() is executed, true (.T.) is returned. If the mouse button isn't depressed when MDOWN() is executed, false (.F.) is returned.
-
+
MDOWN() 根据鼠标按钮是否被按下,返回 true (.T.) 或 false (.F.)。
在 FoxPro for MS-DOS 和 FoxPro for Windows 中,MDOWN() 仅返回鼠标左键的值。
如果执行 MDOWN() 时鼠标按钮被按下,则返回 true (.T.)。如果执行 MDOWN() 时鼠标按钮未被按下,则返回 false (.F.)。
@@ -8324,17 +7079,17 @@
- Returns the number of lines in a memo field.
+ 返回备注字段中的行数。
- Specifies the name of the memo field. If the memo field is in a table that isn't open in the current work area, preface the memo field name with the table alias and a period.
+ 指定备注字段的名称。如果备注字段所在的表未在当前工作区中打开,请在备注字段名称前加上表别名和一个句点。
- Numeric
+ 数值类型
- The number of lines in a memo field is determined by the current value of SET MEMOWIDTH.
+ 备注字段中的行数由 SET MEMOWIDTH 的当前值决定。
@@ -8374,30 +7129,24 @@
- Returns the amount of memory available to run an external program.
+ 返回可用于运行外部程序的内存量。
- MEMORY( )Return Value
- Numeric
+ MEMORY( )返回值 数值类型
- In X#, MEMORY( ) always returns 640.
- MEMORY( ) is similar to SYS(12), with two exceptions:
-
- MEMORY( ) returns the amount of available memory in kilobytes; SYS(12) returns the amount of memory in bytes.
- MEMORY( ) returns a numeric expression. SYS(12) returns its value as a character string.
+ 在 X# 中,MEMORY( ) 始终返回 640。MEMORY( ) 与 SYS(12) 类似,但有两点不同:MEMORY( ) 以千字节为单位返回可用内存量;SYS(12) 以字节为单位返回内存量。MEMORY( ) 返回数值表达式。SYS(12) 以字符串形式返回其值。
- Returns the current error message or the program line that caused the error.
+ 返回当前错误消息或导致错误的程序行。
- Character. MESSAGE( ) returns the current error message as a character string or the contents of the program line causing the error.
+ 字符类型。MESSAGE( ) 以字符串形式返回当前错误消息,或导致错误的程序行的内容。
- Unlike ERROR( ), MESSAGE( ) is not reset by RETURN or RETRY.
+ 与 ERROR( ) 不同,MESSAGE( ) 不会被 RETURN 或 RETRY 重置。
@@ -8639,10 +7388,10 @@
- Evaluates a set of expressions and returns the expression with the minimum value.
+ 计算一组表达式并返回具有最小值的表达式。
- Character, Numeric, Currency, Double, Float, Date, or DateTime
+ 字符类型、数值类型、Currency、Double、Float、Date 或 DateTime
@@ -8686,32 +7435,28 @@
- Returns a specific line from a Memo field as a character string.
- MLINE( ) is primarily a text processing function; therefore, the results from processing binary values might not be as expected. For example, MLINE( ) might return different results depending on the SET MEMOWIDTH setting. MLINE( ) might interpret binary values as line breaks or truncate binary values unexpectedly. It is recommended that you use the ALINES( ) function instead to manipulate binary values.
+ 以字符串形式返回 Memo 字段中的特定行。MLINE( ) 主要是一个文本处理函数;因此,处理二进制值的结果可能不符合预期。例如,根据 SET MEMOWIDTH 设置的不同,MLINE( ) 可能返回不同的结果。MLINE( ) 可能会将二进制值解释为换行符,或意外截断二进制值。建议改用 ALINES( ) 函数来处理二进制值。
- Specifies the name of the memo field from which MLINE( ) returns a line. If the memo field is in a table open in a non-current work area, preface the memo field name with a period and the table alias.
+ 指定 MLINE( ) 从中返回行的备注字段的名称。如果备注字段所在的表在非当前工作区中打开,请在备注字段名称前加上句点和表别名。
- Specifies the number of the line to return from the memo field. If nLineNumber is negative, 0, or greater than the number of lines in the memo field, MLINE( ) returns an empty string.
- MLINE( ) trims any trailing spaces from the line specified with nLineNumber.
+ 指定要从备注字段返回的行号。如果 nLineNumber 为负数、0 或大于备注字段中的行数,MLINE( ) 返回空字符串。MLINE( ) 会修剪 nLineNumber 所指定行的所有尾随空格。
- Specifies the number of characters from the beginning of the memo field after which MLINE( ) returns the specified line.
- The _MLINE system variable is typically used for nNumberOfCharacters. _MLINE is automatically adjusted each time MLINE( ) is called. In recursive procedures that return lines from large memo fields, you can obtain the best performance by including _MLINE as nNumberOfCharacters. For more information, see _MLINE System Variable.
+ 指定从备注字段开头起的字符数,MLINE( ) 在这些字符之后返回指定的行。_MLINE 系统变量通常用于 nNumberOfCharacters。每次调用 MLINE( ) 时,_MLINE 都会自动调整。在从大型备注字段返回行的递归过程中,将 _MLINE 作为 nNumberOfCharacters 可获得最佳性能。有关更多信息,请参见 _MLINE 系统变量。
- Character or Varbinary. MLINE( ) returns a character string from a specific line in a Memo field. When using MLINE( ) with binary values, such as Varbinary and Blob, the return value has type Varbinary.
+ Character 或 Varbinary。MLINE( ) 返回 Memo 字段中特定行的字符串。对 Varbinary 和 Blob 等二进制值使用 MLINE( ) 时,返回值的类型为 Varbinary。
- The length and number of the lines in a memo field are determined by the current value of SET MEMOWIDTH (the default line length is 50 characters). If a carriage return is encountered, no additional characters are returned. The current _WRAP setting determines how the memo field line is displayed.
- When searching a memo field for a character string, you can use ATLINE( ) or ATCLINE( ) to return the line number of the line in which the character string is found. Use this line number in MLINE( ) to return the contents of the line from the memo field.
+ 备注字段中行的长度和数量由 SET MEMOWIDTH 的当前值决定 (默认行长度为 50 个字符)。如果遇到回车符,则不再返回其他字符。当前的 _WRAP 设置决定备注字段行的显示方式。在备注字段中搜索字符串时,可以使用 ATLINE( ) 或 ATCLINE( ) 返回该字符串所在行的行号。在 MLINE( ) 中使用此行号可返回备注字段中该行的内容。
@@ -8755,22 +7500,22 @@
- Divides one numeric expression by another numeric expression and returns the remainder.
+ 将一个数值表达式除以另一个数值表达式并返回余数。
- Specifies the dividend. The number of decimal places in nDividend determines the number of decimal places in the return value.
+ 指定被除数。nDividend 中的小数位数决定返回值中的小数位数。
- Specifies the divisor. A positive number is returned if nDivisor is positive, and a negative number is returned if nDivisor is negative.
+ 指定除数。如果 nDivisor 为正数,则返回正数;如果 nDivisor 为负数,则返回负数。
- Numeric
+ 数值类型
- The modulus function MOD( ) and the % operator return identical results.
+ 取模函数 MOD( ) 与 % 运算符返回相同的结果。
@@ -8785,22 +7530,22 @@
- Returns the number of the month for a given Date or DateTime expression.
+ 返回给定 Date 或 DateTime 表达式的月份数。
- Specifies the Date expression for which you want MONTH( ) to return the month number.
+ 指定要让 MONTH( ) 返回其月份数的 Date 表达式。
- Specifies the DateTime expression for which you want MONTH( ) to return the month number.
+ 指定要让 MONTH( ) 返回其月份数的 DateTime 表达式。
- Numeric
+ 数值类型
- MONTH( ) returns a number from 1 through 12. January is month 1, and December is month 12.
+ MONTH( ) 返回 1 到 12 之间的数字。一月为 1,十二月为 12。
@@ -8815,50 +7560,47 @@
- Determines whether a menu item on a user-defined or X# system menu is marked.
+ 确定用户定义菜单或 X# 系统菜单上的菜单项是否被标记。
- Specifies the name of the menu containing the menu item. The menu can be a X# system menu (such as _MFILE, MEDIT, or _MDATA).
+ 指定包含该菜单项的菜单的名称。该菜单可以是 X# 系统菜单 (如 _MFILE、MEDIT 或 _MDATA)。
- Specifies the number of a menu item in a user-defined menu. A menu item's number is specified when the menu item is created with DEFINE BAR.
+ 指定用户定义菜单中菜单项的编号。菜单项的编号在使用 DEFINE BAR 创建菜单项时指定。
- Specifies the name of a X# system menu item. For example, the following command displays a logical value specifying if the New menu item on the File menu is marked.
+ 指定 X# 系统菜单项的名称。例如,以下命令显示一个逻辑值,指定“文件”菜单上的“新建”菜单项是否被标记。
? MRKBAR('_MFILE', _MFI_NEW)
- Logical
+ 逻辑类型
- Use SET MARK OF to mark or unmark a menu item.
- If the specified menu item is marked, MRKBAR( ) returns true (.T.); otherwise, MRKBAR( ) returns false (.F.).
- For an example of using MRKBAR( ), see CNTBAR( ).
+ 使用 SET MARK OF 标记或取消标记菜单项。如果指定的菜单项被标记,MRKBAR( ) 返回 true (.T.);否则,MRKBAR( ) 返回 false (.F.)。有关使用 MRKBAR( ) 的示例,请参见 CNTBAR( )。
- Determines whether a menu title on a user-defined menu bar or on the X# system menu bar is marked.
+ 确定用户定义菜单栏或 X# 系统菜单栏上的菜单标题是否被标记。
- Specifies the name of the menu bar containing the menu title.
+ 指定包含该菜单标题的菜单栏的名称。
- Specifies the name of the menu title.
+ 指定菜单标题的名称。
- Logical
+ 逻辑类型
- Use SET MARK OF to mark or unmark a menu title.
- If the specified menu title is marked, MRKPAD( ) returns true (.T.); otherwise, MRKPAD( ) returns false (.F.).
+ 使用 SET MARK OF 来标记或取消标记菜单标题。如果指定的菜单标题已被标记,MRKPAD( ) 返回 true (.T.);否则,MRKPAD( ) 返回 false (.F.)。
@@ -8897,36 +7639,31 @@
- Returns the row position of the mouse pointer in the main X# window or in a user-defined window or form.
+ 返回鼠标指针在 X# 主窗口或用户定义的窗口或窗体中的行位置。
- Specifies the name of a window whose mouse-pointer row position MROW( ) returns.
+ 指定一个窗口的名称,MROW( ) 返回鼠标指针在该窗口中的行位置。
- Specifies that the row position of the mouse pointer is returned for the currently active window or form.
+ 指定返回鼠标指针在当前活动窗口或窗体中的行位置。
- Specifies the unit of measurement for the value MROW( ) returns. The settings for nScaleMode are:
- 0
- Foxels. (Default)
- A foxel is equivalent to the average height and width of a character based on the current font of the form in which an object is contained.
- 3
- Pixels.
- A pixel is the smallest element that can be displayed on a screen or printer. Pixels are screen-dependent.
+ 指定 MROW( ) 返回值的度量单位。nScaleMode 的设置如下:
+
+ 0 Foxels。(默认值) 一个 foxel 相当于基于包含对象的窗体的当前字体的字符平均高度和宽度。
+ 3 像素。 像素是屏幕或打印机上可以显示的最小元素。像素与屏幕相关。
+
- Numeric. MROW( ) returns the following under specific conditions:
- If there is no active user-defined window, and you omit the optional argument, MROW( ) returns the main X# window row position of the mouse pointer.
- If there is an active user-defined window, and you omit the optional argument, MROW( ) returns the mouse-pointer row coordinate relative to the active user-defined window.
- If the mouse pointer is positioned outside the user-defined window or if no mouse driver is loaded and there is no output window, MROW( ) returns a value of -1.
+ 数值类型。MROW( ) 在特定条件下返回以下值:如果没有活动的用户定义窗口,并且省略了可选参数,MROW( ) 返回鼠标指针在 X# 主窗口中的行位置。如果存在活动的用户定义窗口,并且省略了可选参数,MROW( ) 返回鼠标指针相对于活动用户定义窗口的行坐标。如果鼠标指针位于用户定义窗口之外,或者没有加载鼠标驱动程序且没有输出窗口,MROW( ) 返回 -1。
- Using the MROW( ) function without the optional argument 0 may affect the behavior of code on forms when the Form AllowOutput property IS set to false (.F.). For example, the placement of a shortcut menu that is defined in the RightClick event may not display in the proper location if you use the MROW( ) and MCOL( ) functions to determine where the menu is displayed. In this case, be sure to include 0 in the MROW( ) and MCOL( ) functions.
+ 当 Form 的 AllowOutput 属性设置为 false (.F.) 时,使用不带可选参数 0 的 MROW( ) 函数可能会影响窗体上代码的行为。例如,如果使用 MROW( ) 和 MCOL( ) 函数来确定菜单的显示位置,则在 RightClick 事件中定义的快捷菜单可能无法显示在正确的位置。在这种情况下,请务必在 MROW( ) 和 MCOL( ) 函数中包含 0。
@@ -8957,17 +7694,17 @@
- Returns the name of the window over which the mouse pointer is positioned.
+ 返回鼠标指针所在窗口的名称。
- Specifies a window name. If the mouse pointer is positioned over the specified window, MWINDOW( ) returns true (.T.); otherwise, MWINDOW( ) returns false (.F.).
+ 指定窗口名称。如果鼠标指针位于指定的窗口上,MWINDOW( ) 返回 true (.T.);否则,MWINDOW( ) 返回 false (.F.)。
- Character, Logical
+ 字符类型、逻辑类型
- If you omit the optional window name, MWINDOW( ) returns the name of the window over which the mouse pointer is positioned, or an empty string if the mouse pointer is positioned over the main X# window or over any other window that is not part of X#.
+ 如果省略可选的窗口名称,MWINDOW( ) 返回鼠标指针所在窗口的名称;如果鼠标指针位于 X# 主窗口上或位于不属于 X# 的任何其他窗口上,则返回空字符串。
@@ -9028,21 +7765,17 @@
- Included for backward compatibility. Use the TabIndex Property for controls instead.
- Returns the object number of an @ ... GET control.
+ 为向后兼容而保留。请改用控件的 TabIndex 属性。返回 @ ... GET 控件的对象编号。
- Return value - Numeric
+ 返回值 - 数值类型
-
- You can use @ ... GET and @ ...EDIT to create controls, sometimes called objects. These controls are fields, check boxes, lists, popups; invisible, push, and radio buttons; spinners and text-editing regions. OBJNUM() returns a number that corresponds to a control's creation order in a set of controls.
-
+
可以使用 @ ... GET 和 @ ...EDIT 创建控件,有时也称为对象。这些控件包括字段、复选框、列表、弹出菜单;不可见按钮、命令按钮和单选按钮;微调控件以及文本编辑区域。OBJNUM() 返回一个数字,该数字对应于控件在一组控件中的创建顺序。
- The following example creates a window and places radio buttons in the window so you can move the record pointer through an open table. If a table isn't open, the Open dialog is displayed so you can select a table to open.
-
+ 下面的示例创建一个窗口,并在窗口中放置单选按钮,以便在已打开的表中移动记录指针。如果没有打开表,则会显示“打开”对话框,以便选择要打开的表。
@@ -9199,32 +7932,29 @@
- Returns a position or dimension of a control or object relative to its form.
+ 返回控件或对象相对于其窗体的位置或尺寸。
- Specifies the name of the control or object for which the form position is returned.
+ 指定要返回其窗体位置的控件或对象的名称。
- Specifies which form position or dimension of the control or object is returned. The following table lists the values for nPosition and the corresponding position or dimension returned.
- 1
- Top
- 2
- Left
- 3
- Width
- 4
- Height
+ 指定返回控件或对象的哪个窗体位置或尺寸。下表列出了 nPosition 的值以及返回的相应位置或尺寸。
+
+ 1 Top
+ 2 Left
+ 3 Width
+ 4 Height
+
- Numeric
+ 数值类型
- OBJTOCLIENT( ) returns the position or dimension of a control or object relative to the client area of the form on which it resides. For example, a control or object can be placed on a page in a page frame, and the page frame is placed on a form. The Top, Left, Width, and Height properties return the position or dimension of a control or object relative to the page on which it is placed. However, you can use OBJTOCLIENT( ) to determine the position or dimension of a control or object relative to the form on which the page is placed.
- The value returned by OBJTOCLIENT( ) is in pixels.
+ OBJTOCLIENT( ) 返回控件或对象相对于其所在窗体的客户区的位置或尺寸。例如,控件或对象可以放置在页框的某一页上,而页框放置在窗体上。Top、Left、Width 和 Height 属性返回控件或对象相对于其所在页的位置或尺寸。但是,可以使用 OBJTOCLIENT( ) 来确定控件或对象相对于该页所在窗体的位置或尺寸。OBJTOCLIENT( ) 返回的值以像素为单位。
@@ -9359,42 +8089,35 @@
- Included for backward compatibility. Use the Name Property (X#) for controls instead.
-
- Returns the name of the memory variable, array element or field associated with an object.
+ 为向后兼容而保留。请改用控件的 Name 属性 (X#)。返回与对象关联的内存变量、数组元素或字段的名称。
- Returns - Character
+ 返回 - 字符类型
-
- You can use @ ... GET and @ ... EDIT to create controls which are also called objects. Controls that are considered objects are fields, check boxes, lists, popups, invisible, push, and radio buttons, spinners and text editing regions. OBJVAR() returns the name of the memory variable, array element or field in which one of these stores a value.
-
- Memory variable and array element names returned by OBJVAR() are prefaced with M and a period (M.). Field names returned by OBJVAR() are prefaced by the table alias and a period.
-
-
+
可以使用 @ ... GET 和 @ ... EDIT 创建控件,这些控件也称为对象。被视为对象的控件包括字段、复选框、列表、弹出菜单、不可见按钮、命令按钮和单选按钮、微调控件以及文本编辑区域。OBJVAR() 返回其中某个控件用于存储值的内存变量、数组元素或字段的名称。
OBJVAR() 返回的内存变量和数组元素名称以 M 和一个句点 (M.) 作为前缀。OBJVAR() 返回的字段名称以表别名和一个句点作为前缀。
- Returns the number of times a character expression occurs within another character expression.
+ 返回一个字符表达式在另一个字符表达式中出现的次数。
- Specifies a character expression that OCCURS( ) searches for within cExpressionSearched.
+ 指定 OCCURS( ) 在 cExpressionSearched 中搜索的字符表达式。
- Specifies the character expression OCCURS( ) searches for cSearchExpression.
+ 指定 OCCURS( ) 在 cSearchExpression 中搜索的字符表达式。
- Numeric
+ 数值类型
- OCCURS( ) returns 0 (zero) if cSearchExpression isn't found within cExpressionSearched.
+ 如果在 cExpressionSearched 中未找到 cSearchExpression,OCCURS( ) 返回 0(零)。
@@ -9409,49 +8132,36 @@
- Included for backward compatibility. Use the CPCONVERT( ) Function instead.
-
- Converts each character in a character expression to the corresponding character in the ANSI character set.
+ 为向后兼容而保留。请改用 CPCONVERT( ) 函数。将字符表达式中的每个字符转换为 ANSI 字符集中对应的字符。
- Return value - Character
+ 返回值 - 字符类型
-
- OEMTOANSI() is supported in FoxPro for Windows and FoxPro for Macintosh.
-
- Use OEMTOANSI() to move data from FoxPro for MS-DOS to FoxPro for Windows and FoxPro for Macintosh.
-
+
FoxPro for Windows 和 FoxPro for Macintosh 支持 OEMTOANSI()。
使用 OEMTOANSI() 可将数据从 FoxPro for MS-DOS 移植到 FoxPro for Windows 和 FoxPro for Macintosh。
- Returns the command assigned to each of these event-handling commands: ON ERROR, ON ESCAPE, ON KEY LABEL, or ON PAGE.
+ 返回分配给下列各事件处理命令的命令:ON ERROR、ON ESCAPE、ON KEY LABEL 或 ON PAGE。
- Specifies one of the event-handling commands. Here are the commands and corresponding character expressions to use with ON( ):
- cONCommand
- ON ERROR
- ON ESCAPE
- ON KEY LABEL
- ON PAGE
- For example, to return the command currently assigned to ON ERROR, use the following:
+ 指定其中一个事件处理命令。以下是可与 ON( ) 一起使用的命令及相应的字符表达式:cONCommand ON ERROR ON ESCAPE ON KEY LABEL ON PAGE 例如,要返回当前分配给 ON ERROR 的命令,请使用以下代码:
? ON('ERROR')
- Used in ON KEY LABEL to specify a key or key combination to which the command is assigned. Specify KEY in cONCommand and the key label name of the key or key combination in KeyLabelName. For a complete list of key label names, see ON KEY LABEL.
- For example, to return the command currently assigned to the F7 function key with ON KEY LABEL, use the following:
+ 在 ON KEY LABEL 中使用,用于指定被分配命令的某个键或组合键。在 cONCommand 中指定 KEY,并在 KeyLabelName 中指定该键或组合键的键标签名称。有关键标签名称的完整列表,请参见 ON KEY LABEL。例如,要返回通过 ON KEY LABEL 当前分配给 F7 功能键的命令,请使用以下代码:
? ON('KEY', 'F7')
- Character
+ 字符类型
- When an event occurs that is trapped by one of the event-handling commands, the command assigned by the event-handling command executes. ON( ) returns the command you assigned to an event-handling command. ON( ) returns an empty string if a command isn't currently assigned to the event-handling command you specify.
+ 当发生被某个事件处理命令捕获的事件时,将执行由该事件处理命令分配的命令。ON( ) 返回分配给事件处理命令的命令。如果当前没有向您指定的事件处理命令分配命令,ON( ) 返回空字符串。
@@ -9505,61 +8215,48 @@
- Returns the name and version number of the operating system under which X# is running.
+ 返回 X# 所运行的操作系统的名称和版本号。
- Specifies the item to return, according to the following table.
- nValues
-
- 1
- Specifies that the name and version number of the operating system is returned.
- 2
- DBCS Support. If DBCS (double-byte character sets) are supported, "DBCS" is returned. Otherwise, an empty string is returned
- 3
- Identifies the major version number of the operating system. For example, for Windows 2000, the major version number is 5.
- 4
- Identifies the minor version number of the operating system. For example, for Windows 2000, the minor version number is 0.
- Identifies the build number of the operating system.
- 6
- Identifies the operating system platform.
- 7
- Contains a string, such as "Service Pack 3", that indicates the latest Service Pack installed on the system. If no Service Pack has been installed, the string is empty.
- 8
- Identifies the major version number of the latest Service Pack installed on the system. For example, for Service Pack 3, the major version number is 3. If no Service Pack has been installed, the value is zero.
- 9
- Identifies the minor version number of the latest Service Pack installed on the system. For example, for Service Pack 3, the minor version number is 0.
- 10
- A set of bit flags that identify the product suites available on the system. See Product Suite bit flag table below for values.
- 11
- Indicates additional information about the system. See Product Type settings table below for values.
- Microsoft Small Business Server is installed.
- Windows 2000 Advanced Server or Windows Server 2003, Enterprise Edition, is installed.
- Microsoft BackOffice components are installed.
- 16
- Terminal Services are installed.
- 32
- Microsoft Small Business Server is installed with the restrictive client license in force.
- 64
- Windows Embedded NT is installed
- 128
- Windows 2000 or Windows Server 2003, Datacenter Edition, is installed.
- 256
- Terminal Services is installed, but only one interactive session is supported.
- 512
- Windows XP Home Edition is installed.
- 1024
- Windows Server 2003, Web Edition, is installed.
- The system is running Windows NT 4.0 Workstation, Windows 2000 Professional, Windows XP Home Edition, or Windows XP Professional.
- The system is a domain controller.
- The system is a server.
-
-
- Character
-
-
- If you omit the optional argument, this function returns the underlying operating system name and its version number.
- Some nValues are not applicable to some operating systems. In such cases, the OS( ) function returns "0" or "", an empty string.
+ 根据下表指定要返回的项目。
+
+ nValues 说明
+ 1 指定返回操作系统的名称和版本号。
+ 2 DBCS 支持。如果支持 DBCS(双字节字符集),则返回 "DBCS"。否则返回空字符串。
+ 3 标识操作系统的主版本号。例如,对于 Windows 2000,主版本号为 5。
+ 4 标识操作系统的次版本号。例如,对于 Windows 2000,次版本号为 0。
+ 5 标识操作系统的内部版本号。
+ 6 标识操作系统平台。
+ 7 包含一个字符串,例如 "Service Pack 3",指示系统上安装的最新 Service Pack。如果未安装 Service Pack,则该字符串为空。
+ 8 标识系统上安装的最新 Service Pack 的主版本号。例如,对于 Service Pack 3,主版本号为 3。如果未安装 Service Pack,则值为零。
+ 9 标识系统上安装的最新 Service Pack 的次版本号。例如,对于 Service Pack 3,次版本号为 0。
+ 10 一组位标志,用于标识系统上可用的产品套件。其值请参见下面的 Product Suite 位标志表。
+ 11 指示有关系统的附加信息。其值请参见下面的 Product Type 设置表。
+
+
+ 1 已安装 Microsoft Small Business Server。
+ 2 已安装 Windows 2000 Advanced Server 或 Windows Server 2003, Enterprise Edition。
+ 4 已安装 Microsoft BackOffice 组件。
+ 16 已安装终端服务。
+ 32 已安装 Microsoft Small Business Server,并强制执行受限客户端许可。
+ 64 已安装 Windows Embedded NT
+ 128 已安装 Windows 2000 或 Windows Server 2003, Datacenter Edition。
+ 256 已安装终端服务,但仅支持一个交互式会话。
+ 512 已安装 Windows XP Home Edition。
+ 1024 已安装 Windows Server 2003, Web Edition。
+
+
+ 1 系统正在运行 Windows NT 4.0 Workstation、Windows 2000 Professional、Windows XP Home Edition 或 Windows XP Professional。
+ 2 系统是域控制器。
+ 3 系统是服务器。
+
+
+
+ 字符类型
+
+
+ 如果省略可选参数,此函数返回底层操作系统的名称及其版本号。某些 nValues 不适用于某些操作系统。在这种情况下,OS( ) 函数返回 "0" 或 ""(空字符串)。
@@ -9571,24 +8268,22 @@
- Returns as an uppercase character string the menu title most recently chosen from a menu bar, or returns a logical value indicating if a menu title is defined for an active menu bar.
+ 以大写字符串形式返回最近从菜单栏中选择的菜单标题,或者返回一个逻辑值,指示活动菜单栏中是否定义了某个菜单标题。
- Specifies the name of a menu title in a menu bar. Include this argument to test if the menu title is defined for an active menu bar. A logical true (.T.) is returned if the menu title is defined; otherwise a logical false (.F.) is returned.
+ 指定菜单栏中某个菜单标题的名称。包含此参数可测试活动菜单栏中是否定义了该菜单标题。如果已定义该菜单标题,则返回逻辑 true (.T.);否则返回逻辑 false (.F.)。
- Specifies the name of the menu bar containing the menu title cMenuTitle. If cMenuBarName is omitted, the menu title is assumed to be in the currently active menu bar.
+ 指定包含菜单标题 cMenuTitle 的菜单栏的名称。如果省略 cMenuBarName,则假定该菜单标题位于当前活动的菜单栏中。
- Character or Logical
+ 字符类型或逻辑类型
- A menu bar must be defined and active for PAD( ) to return a menu title. Menu bars are created and activated with DEFINE MENU and ACTIVATE MENU.
- You can also use PAD( ) with the X# system menu bar.
- PAD( ) (issued without any of its optional arguments) returns an empty string if a menu bar isn't defined and active or you issue PAD( ) from the Command window.
+ 必须定义并激活菜单栏,PAD( ) 才能返回菜单标题。菜单栏通过 DEFINE MENU 创建,并通过 ACTIVATE MENU 激活。也可以将 PAD( ) 与 X# 系统菜单栏一起使用。如果菜单栏未定义且未激活,或者从命令窗口发出 PAD( ),则不带任何可选参数的 PAD( ) 返回空字符串。
@@ -9621,23 +8316,14 @@
- Returns the text of a menu title.
+ 返回菜单标题的文本。
- Character.
+ 字符类型
- Specifies the menu title (pad) name or internal system menu title name.
-
- Specifies the name of the menu bar containing the menu title or internal system menu bar name.
- When cMenuBarName is omitted the currenctly active menu bar is used as the second parameter.
- When no menu bar is active and cMenuBarName is omitted an error is generated.
- Menu bars are created with DEFINE MENU, which creates the menu bar, and DEFINE PAD, which creates the menu titles in the menu bar.
- PADPROMPT( ) also works with the X# menu system. A menu bar doesn't have to be active for PADPROMPT( ) to return the text for a menu title.
- br
- If a menu title was created using the backslash and less-than characters (\<) to create an access key, or a backslash (\) to disable the menu title,
- PADPROMPT( ) returns only the text of the menu title; it doesn't include the special characters.
+ 指定菜单标题(pad)名称或内部系统菜单标题名称。指定包含该菜单标题的菜单栏的名称或内部系统菜单栏名称。省略 cMenuBarName 时,将当前活动的菜单栏用作第二个参数。当没有活动的菜单栏且省略了 cMenuBarName 时,将产生错误。菜单栏通过 DEFINE MENU 创建(它创建菜单栏),菜单标题通过 DEFINE PAD 在菜单栏中创建。PADPROMPT( ) 也适用于 X# 菜单系统。菜单栏不必处于活动状态,PADPROMPT( ) 即可返回菜单标题的文本。br 如果菜单标题使用反斜杠和小于号 (\<) 创建了访问键,或使用反斜杠 (\) 禁用了菜单标题,则 PADPROMPT( ) 仅返回菜单标题的文本;不包括这些特殊字符。
@@ -9651,17 +8337,13 @@
- Returns the number of parameters passed to the most recently called program, procedure, or user-defined function.
+ 返回传递给最近调用的程序、过程或用户定义函数的参数个数。
- PARAMETERS( )Return Value
- Numeric
+ PARAMETERS( )返回值 数值类型
- PARAMETERS( ) is useful for determining how many parameters are passed to a program, procedure, or user-defined function.
- The value returned by PARAMETERS() is reset every time a program, procedure, or user-defined function is called or when ON KEY LABEL is executed. Unlike PARAMETERS(), the PCOUNT() function does not get reset, so PCOUNT() may be preferable in most programming situations.
- Example 1 calls a procedure and displays in a wait window the number of parameters passed.
- Example 2 uses a procedure to display the average of 4 values.
+ PARAMETERS( ) 可用于确定传递给程序、过程或用户定义函数的参数个数。每次调用程序、过程或用户定义函数,或执行 ON KEY LABEL 时,PARAMETERS() 返回的值都会被重置。与 PARAMETERS() 不同,PCOUNT() 函数不会被重置,因此在大多数编程场合中 PCOUNT() 可能更合适。示例 1 调用一个过程,并在等待窗口中显示传递的参数个数。示例 2 使用一个过程显示 4 个值的平均值。
* Example 1
DO testpar WITH 1,2,3
@@ -9700,17 +8382,14 @@
- Returns the number of parameters passed to the current program, procedure, or user-defined function.
+ 返回传递给当前程序、过程或用户定义函数的参数个数。
- PCOUNT( )Return Value
- Numeric
+ PCOUNT( )返回值 数值类型
- PCOUNT( ) is useful for determining how many parameters are passed to the current program, procedure, or user-defined function.
- Example 1 calls a procedure and displays in a wait window the number of parameters passed.
- Example 2 uses a procedure to display the average of 4 values.
+ PCOUNT( ) 可用于确定传递给当前程序、过程或用户定义函数的参数个数。示例 1 调用一个过程,并在等待窗口中显示传递的参数个数。示例 2 使用一个过程显示 4 个值的平均值。
DO testpar WITH 1,2,3
PROCEDURE testpar
@@ -9749,85 +8428,68 @@
- Retrieves an attribute for a property, event, method, or object.
+ 检索属性、事件、方法或对象的特性。
- Specifies the object for which the property, event, method, or object attribute to return. oObjectName can be any expression that evaluates to an object, such as an object reference, an object memory variable, or an object array element.
- If oObjectName is a container object such as a form, you can determine attributes for objects in the container object.
+ 指定要返回其属性、事件、方法或对象特性的对象。oObjectName 可以是任何计算结果为对象的表达式,例如对象引用、对象内存变量或对象数组元素。如果 oObjectName 是容器对象(如窗体),则可以确定容器对象中各对象的特性。
- Specifies the class for which the property, event, or method attribute to return.
+ 指定要返回其属性、事件或方法特性的类。
- Specifies the property for which the attribute to return.
+ 指定要返回其特性的属性。
- Specifies the event for which the attribute to return.
+ 指定要返回其特性的事件。
- Specifies the method for which the attribute to return.
+ 指定要返回其特性的方法。
- Specifies the object for which the attribute to return.
- For example, you can use the AddObject method to add an object to a container object, and then use PEMSTATUS( ) to return information about the object added to the container object.
+ 指定要返回其特性的对象。例如,可以使用 AddObject 方法将对象添加到容器对象,然后使用 PEMSTATUS( ) 返回有关添加到容器对象的对象的信息。
- Specifies a numeric value that determines the property, event, or method attribute to return.
- The following table lists the values for nAttribute and the corresponding property, event, or method attribute returned.
- 0
- Changed.
- If the property value, method, or event has changed, PEMSTATUS( ) returns a logical True (.T.). Otherwise, PEMSTATUS( ) returns logical False (.F.).
- 1
- Read-only (properties only).
- If the property is read-only, PEMSTATUS( ) returns a logical True (.T.). Otherwise, PEMSTATUS( ) returns a logical False (.F.).
- 2
- Protected.
- If the property, event, or method is protected, PEMSTATUS( ) returns a logical True (.T.). Otherwise, PEMSTATUS( ) returns a logical False (.F.).
- 3
- Type.
- PEMSTATUS( ) returns a character string, for example, Property, Event, Method, or Object, indicating whether cProperty, cEvent, cMethod or cObject is a property, event, method or object.
- 4
- User-defined.
- If the property, event, or method is a user-defined property, event, or method, PEMSTATUS( ) returns a logical True (.T.). Otherwise, PEMSTATUS( ) returns a logical False (.F.).
- 5
- Defined property, event, method, or object.
- If the property, event, method, or object exists for oObjectName or cClassName, PEMSTATUS( ) returns a logical True (.T.). Otherwise, or for hidden native properties, PEMSTATUS( ) returns a logical False (.F.).
- 6
- Inherited property, event, method, or object.
- If the property, event, method, or object for oObjectName or cClassName was inherited from another object or class, PEMSTATUS( ) returns logical True (.T.). Otherwise, PEMSTATUS( ) returns a logical False (.F.).
+ 指定一个数值,用于确定要返回的属性、事件或方法的特性。下表列出了 nAttribute 的值以及返回的相应属性、事件或方法特性。
+
+ 0 已更改。 如果属性值、方法或事件已更改,PEMSTATUS( ) 返回逻辑 True (.T.)。否则,PEMSTATUS( ) 返回逻辑 False (.F.)。
+ 1 只读(仅限属性)。 如果属性为只读,PEMSTATUS( ) 返回逻辑 True (.T.)。否则,PEMSTATUS( ) 返回逻辑 False (.F.)。
+ 2 受保护。 如果属性、事件或方法是受保护的,PEMSTATUS( ) 返回逻辑 True (.T.)。否则,PEMSTATUS( ) 返回逻辑 False (.F.)。
+ 3 类型。 PEMSTATUS( ) 返回一个字符串,例如 Property、Event、Method 或 Object,指示 cProperty、cEvent、cMethod 或 cObject 是属性、事件、方法还是对象。
+ 4 用户定义。 如果属性、事件或方法是用户定义的属性、事件或方法,PEMSTATUS( ) 返回逻辑 True (.T.)。否则,PEMSTATUS( ) 返回逻辑 False (.F.)。
+ 5 已定义的属性、事件、方法或对象。 如果 oObjectName 或 cClassName 存在该属性、事件、方法或对象,PEMSTATUS( ) 返回逻辑 True (.T.)。否则,或对于隐藏的原生属性,PEMSTATUS( ) 返回逻辑 False (.F.)。
+ 6 继承的属性、事件、方法或对象。 如果 oObjectName 或 cClassName 的属性、事件、方法或对象继承自另一个对象或类,PEMSTATUS( ) 返回逻辑 True (.T.)。否则,PEMSTATUS( ) 返回逻辑 False (.F.)。
+
- Character or Logical. PEMSTATUS( ) returns a character string or logical value for the attribute specified.
+ 字符类型或逻辑类型。PEMSTATUS( ) 返回指定特性的字符串或逻辑值。
- PEMSTATUS( ) does not detect for changes in specific array elements if the array is passed.
+ 如果传递的是数组,PEMSTATUS( ) 不会检测数组中特定元素的更改。
- Returns the numeric constant pi.
+ 返回数值常量 pi。
- PI( )Return Value
- Numeric
+ PI( )返回值 数值类型
- The numeric constant pi (3.141592) is the ratio of the circumference of a circle to its diameter.
- The number of decimal places displayed in the value returned by PI( ) is determined by SET DECIMALS.
+ 数值常量 pi (3.141592) 是圆的周长与其直径之比。PI( ) 返回值所显示的小数位数由 SET DECIMALS 决定。
@@ -9841,30 +8503,28 @@
- Returns as a string the name of the active menu, or a logical value indicating if a menu has been defined.
+ 以字符串形式返回活动菜单的名称,或者返回一个逻辑值,指示是否已定义某个菜单。
- Returns a logical value indicating if cMenuName has been defined. POPUP( ) returns true (.T.) if the menu you specify has been defined; otherwise POPUP( ) returns false (.F.).
+ 返回一个逻辑值,指示 cMenuName 是否已定义。如果指定的菜单已定义,POPUP( ) 返回 true (.T.);否则 POPUP( ) 返回 false (.F.)。
- Character or Logical
+ 字符类型或逻辑类型
- POPUP( ) returns the name of the active menu as a character string if you omit the optional cMenuName argument. A menu must be defined and active for POPUP( ) to return its name. Menus are created and activated with DEFINE POPUP and ACTIVATE POPUP. The menu can also be a X# system menu. POPUP( ) returns an empty string if a menu isn't defined and active or you issue POPUP( ) from the Command window.
+ 如果省略可选的 cMenuName 参数,POPUP( ) 以字符串形式返回活动菜单的名称。必须定义并激活菜单,POPUP( ) 才能返回其名称。菜单通过 DEFINE POPUP 创建,并通过 ACTIVATE POPUP 激活。该菜单也可以是 X# 系统菜单。如果菜单未定义且未激活,或者从命令窗口发出 POPUP( ),POPUP( ) 返回空字符串。
- Returns the status of the printer. Included for backward compatibility.
+ 返回打印机的状态。为向后兼容而保留。
- PRINTSTATUS( )Return Value
- Logical value. For versions of X# running on Windows, PRINTSTATUS( ) always returns True (.T.) if the printer is connected through the Windows Control Panel.
- In prior versions, if the printer or print device is online, PRINTSTATUS( ) returns True (.T.); otherwise, it returns False (.F.).
+ PRINTSTATUS( )返回值 逻辑值。对于运行在 Windows 上的 X# 版本,如果打印机通过 Windows 控制面板连接,PRINTSTATUS( ) 始终返回 True (.T.)。在早期版本中,如果打印机或打印设备处于联机状态,PRINTSTATUS( ) 返回 True (.T.);否则返回 False (.F.)。
- PRINTSTATUS( ) functions similarly to SYS(13). For more information, see SYS(13) - Printer Status.
+ PRINTSTATUS( ) 的功能与 SYS(13) 类似。有关详细信息,请参见 SYS(13) - Printer Status。
@@ -9881,38 +8541,36 @@
- Returns the text of a menu item.
+ 返回菜单项的文本。
- Specifies the menu name.
+ 指定菜单名称。
- Specifies the number of the menu item whose text PRMBAR( ) returns. For example, if nMenuItemNumber is 1, the text of the first menu item is returned; if nMenuItemNumber is 2, the text of the second menu item is returned, and so on. The expression must be at least 1 and no greater than the number of menu items in the menu.
+ 指定 PRMBAR( ) 返回其文本的菜单项编号。例如,如果 nMenuItemNumber 为 1,则返回第一个菜单项的文本;如果 nMenuItemNumber 为 2,则返回第二个菜单项的文本,依此类推。该表达式必须至少为 1,且不大于菜单中的菜单项数。
- Character
+ 字符类型
- Menus are created with DEFINE POPUP, which creates the menu, and DEFINE BAR, which creates the menu items in the menu. PRMBAR( ) also works with a X# system menu. PRMBAR( ) returns the text that appears on the menu item. The menu doesn't have to be active.
- If a menu item was created using the backslash and less-than characters (\<) to create an access key, or a backslash (\) to disable the menu item, PRMBAR( ) returns only the menu item text; it doesn't include these special characters. PRMBAR( ) returns an empty string when a menu item is a separator created with the backslash and dash (\-) characters.
+ 菜单通过 DEFINE POPUP 创建(它创建菜单),菜单项通过 DEFINE BAR 在菜单中创建。PRMBAR( ) 也适用于 X# 系统菜单。PRMBAR( ) 返回菜单项上显示的文本。菜单不必处于活动状态。如果菜单项使用反斜杠和小于号 (\<) 创建了访问键,或使用反斜杠 (\) 禁用了菜单项,则 PRMBAR( ) 仅返回菜单项文本;不包括这些特殊字符。当菜单项是使用反斜杠和短划线 (\-) 字符创建的分隔符时,PRMBAR( ) 返回空字符串。
- Returns the text of a menu title.
+ 返回菜单标题的文本。
- Specifies the name of the menu bar containing the menu title.
+ 指定包含该菜单标题的菜单栏的名称。
- Specifies the menu title.
+ 指定菜单标题。
- Character
+ 字符类型
- Menu bars are created with DEFINE MENU, which creates the menu bar, and DEFINE PAD, which creates the menu titles in the menu bar. PRMPAD( ) also works with the X# menu system. A menu bar doesn't have to be active for PRMPAD( ) to return the text for a menu title.
- If a menu title was created using the backslash and less-than characters (\<) to create an access key, or a backslash (\) to disable the menu title, PRMPAD( ) returns only the text of the menu title; it doesn't include the special characters.
+ 菜单栏通过 DEFINE MENU 创建(它创建菜单栏),菜单标题通过 DEFINE PAD 在菜单栏中创建。PRMPAD( ) 也适用于 X# 菜单系统。菜单栏不必处于活动状态,PRMPAD( ) 即可返回菜单标题的文本。如果菜单标题使用反斜杠和小于号 (\<) 创建了访问键,或使用反斜杠 (\) 禁用了菜单标题,则 PRMPAD( ) 仅返回菜单标题的文本;不包括这些特殊字符。
@@ -9934,30 +8592,26 @@
- Returns the text for a menu title chosen from a menu bar or for a menu item chosen from a menu.
+ 返回从菜单栏中选择的菜单标题或从菜单中选择的菜单项的文本。
- PROMPT( )Return Value
- Character
+ PROMPT( )返回值 字符类型
- PROMPT( ) returns the text of the menu title last chosen from a menu bar or the menu item last chosen from a menu. The menu bar or menu can be user-defined or a X# system menu bar or menu. If a menu bar or menu isn't active or you press ESC to exit a menu bar or menu, PROMPT( ) returns an empty string.
- A menu bar is created with DEFINE MENU, and each menu title in the menu bar is created with DEFINE PAD. A menu is created with DEFINE POPUP, and the menu items in the menu are created with DEFINE BAR.
-
- MENU( ) and POPUP( ) can be used to return the name of the menu bar or menu from which the menu title or menu item is chosen.
+ PROMPT( ) 返回最后从菜单栏中选择的菜单标题或最后从菜单中选择的菜单项的文本。菜单栏或菜单可以是用户定义的,也可以是 X# 系统菜单栏或菜单。如果菜单栏或菜单未处于活动状态,或者按 ESC 退出了菜单栏或菜单,PROMPT( ) 将返回空字符串。菜单栏使用 DEFINE MENU 创建,菜单栏中的每个菜单标题使用 DEFINE PAD 创建。菜单使用 DEFINE POPUP 创建,菜单中的菜单项使用 DEFINE BAR 创建。MENU( ) 和 POPUP( ) 可用于返回选择菜单标题或菜单项所在的菜单栏或菜单的名称。
- Returns from a character expression a string capitalized as appropriate for proper names.
+ 从字符表达式中返回按专有名称规则大写首字母的字符串。
- Specifies the character expression from which PROPER( ) returns a capitalized character string.
+ 指定 PROPER( ) 据以返回首字母大写字符串的字符表达式。
- Character
+ 字符类型
@@ -10004,17 +8658,14 @@
- Returns a random number between 0 and 1.
+ 返回 0 到 1 之间的随机数。
- Specifies the seed value that determines the sequence of values RAND( ) returns.
- RAND( ) returns the same sequence of random numbers if you use the same seed value for nSeedValue the first time you issue RAND( ) followed by subsequent RAND( ) function calls without nSeedValue.
- If nSeedValue is negative the first time you issued RAND( ), a seed value from the system clock is used. To achieve the most random sequence of numbers, issue RAND( ) initially with a negative argument and then issue RAND( ) without an argument.
- If you omit nSeedValue, RAND( ) uses a default seed value of 100,001.
+ 指定决定 RAND( ) 返回值序列的种子值。如果第一次调用 RAND( ) 时为 nSeedValue 使用相同的种子值,随后调用 RAND( ) 函数时不带 nSeedValue,则 RAND( ) 将返回相同的随机数序列。如果第一次调用 RAND( ) 时 nSeedValue 为负数,则使用系统时钟的种子值。若要获得最随机的数字序列,请首先使用负数参数调用 RAND( ),然后不带参数调用 RAND( )。如果省略 nSeedValue,RAND( ) 将使用默认种子值 100,001。
- Numeric
+ 数值类型
@@ -10068,29 +8719,27 @@
- Returns the numeric position of the last (rightmost) occurrence of a character string within another character string.
+ 返回一个字符串在另一个字符串中最后一次(最右侧)出现的数值位置。
- Specifies the character expression that RAT( ) looks for in cExpressionSearched. The character expression can refer to a memo field of any size.
+ 指定 RAT( ) 在 cExpressionSearched 中查找的字符表达式。该字符表达式可以引用任意大小的备注字段。
- Specifies the character expression that RAT( ) searches. The character expression can refer to a memo field of any size.
+ 指定 RAT( ) 在其中进行搜索的字符表达式。该字符表达式可以引用任意大小的备注字段。
- Specifies which occurrence, starting from the right and moving left, of cSearchExpression RAT( ) searches for in cExpressionSearched. By default, RAT( ) searches for the last occurrence of cSearchExpression (nOccurrence = 1). If nOccurrence is 2, RAT( ) searches for the next to last occurrence, and so on.
+ 指定 RAT( ) 在 cExpressionSearched 中搜索 cSearchExpression 的第几次出现(从右向左计数)。默认情况下,RAT( ) 搜索 cSearchExpression 的最后一次出现(nOccurrence = 1)。如果 nOccurrence 为 2,RAT( ) 将搜索倒数第二次出现,依此类推。
- Numeric
+ 数值类型
- RAT( ), the reverse of the AT( ) function, searches the character expression in cExpressionSearched starting from the right and moving left, looking for the last occurrence of the string specified in cSearchExpression.
- RAT( ) returns an integer indicating the position of the first character in cSearchExpression in cExpressionSearched. RAT( ) returns 0 if cSearchExpression isn't found in cExpressionSearched, or if nOccurrence is greater than the number of times cSearchExpression occurs in cExpressionSearched.
- The search performed by RAT( ) is case-sensitive.
+ RAT( ) 与 AT( ) 函数相反,它从右向左搜索 cExpressionSearched 中的字符表达式,查找 cSearchExpression 所指定字符串的最后一次出现。RAT( ) 返回一个整数,表示 cSearchExpression 的第一个字符在 cExpressionSearched 中的位置。如果在 cExpressionSearched 中未找到 cSearchExpression,或者 nOccurrence 大于 cSearchExpression 在 cExpressionSearched 中出现的次数,则 RAT( ) 返回 0。RAT( ) 执行的搜索区分大小写。
@@ -10129,27 +8778,22 @@
- Returns the line number of the last occurrence of a character expression within another character expression or memo field, counting from the last line.
+ 返回一个字符表达式在另一个字符表达式或备注字段中最后一次出现的行号,从最后一行开始计数。
- Specifies the character expression that RATLINE( ) looks for in cExpressionSearched.
+ 指定 RATLINE( ) 在 cExpressionSearched 中查找的字符表达式。
- Specifies the character expression that RATLINE( ) searches. The character expressions cSearchExpression and cExpressionSearched can be memo fields of any size.
- Use MLINE( ) to return the line containing cSearchExpression.
- RATLINE() offers a convenient way to search memo fields.
+ 指定 RATLINE( ) 在其中进行搜索的字符表达式。字符表达式 cSearchExpression 和 cExpressionSearched 可以是任意大小的备注字段。使用 MLINE( ) 返回包含 cSearchExpression 的行。RATLINE() 提供了一种搜索备注字段的便捷方式。
- Numeric
+ 数值类型
- RATLINE( ), the reverse of the ATLINE( ) function, searches a character expression cExpressionSearched, starting with the last character in cExpressionSearched, for the occurrence of cSearchExpression.
- If the search is successful, RATLINE( ) returns the number of the line where the match occurs. If the search is unsuccessful, RATLINE( ) returns 0.
- The search performed by RATLINE( ) is case-sensitive.
- The line number that RATLINE() returns is determined by the value of SET MEMOWIDTH, even if cExpressionSearched isn't a memo field. For more information, see SET MEMOWIDTH.
+ RATLINE( ) 与 ATLINE( ) 函数相反,它从 cExpressionSearched 的最后一个字符开始搜索字符表达式 cExpressionSearched,查找 cSearchExpression 的出现。如果搜索成功,RATLINE( ) 返回匹配所在的行号。如果搜索失败,RATLINE( ) 返回 0。RATLINE( ) 执行的搜索区分大小写。即使 cExpressionSearched 不是备注字段,RATLINE() 返回的行号也由 SET MEMOWIDTH 的值决定。有关更多信息,请参见 SET MEMOWIDTH。
@@ -10164,24 +8808,17 @@
- Included for backward compatibility. Use the Form Designer instead of READ.
-
- Returns the current READ level.
+ 仅为向后兼容而保留。请使用窗体设计器代替 READ。返回当前 READ 级别。
- Return value - Numeric
+ 返回值 - 数值类型
-
- Nested READs are created by issuing @ ... GETS and a READ in a routine that's executed during an active READ. READs can be nested to five levels.
-
- Use RDLEVEL() to return the level of the current READ command. RDLEVEL() returns a value of 0, 1, 2, 3, 4 or 5, depending on how deep the current READ is nested. RDLEVEL() returns 0 if no READ is executing.
-
+
嵌套 READ 是通过在活动 READ 期间执行的例程中发出 @ ... GETS 和 READ 创建的。READ 最多可嵌套五级。
使用 RDLEVEL() 返回当前 READ 命令的级别。根据当前 READ 的嵌套深度,RDLEVEL() 返回 0、1、2、3、4 或 5。如果没有正在执行的 READ,RDLEVEL() 返回 0。
- In the following example, pressing CTRL+Z at any time displays the current READ level using RDLEVEL(). You can advance to the next READ level by pressing Enter or you can move back a READ level by pressing Esc. Note the use of the VALID clause with @ ... GET and a UDF to create nested READs.
-
+ 在下面的示例中,随时按 CTRL+Z 都会使用 RDLEVEL() 显示当前 READ 级别。按 Enter 可前进到下一个 READ 级别,按 Esc 可返回上一个 READ 级别。请注意,示例中将 VALID 子句与 @ ... GET 及 UDF 结合使用来创建嵌套 READ。
@@ -10225,52 +8862,38 @@
- Included for backward compatibility with READ. Use the Form Designer instead of READ.
-
- Returns a value corresponding to the key pressed to exit certain editing commands, or a value indicating how the last READ was terminated.
+ 仅为与 READ 向后兼容而保留。请使用窗体设计器代替 READ。返回与退出某些编辑命令所按的键相对应的值,或指示上一次 READ 如何终止的值。
- Return value - Numeric
+ 返回值 - 数值类型
-
- If READKEY() is issued without the optional numeric expression expN, the value returned represents the key pressed to exit from these editing commands: APPEND, BROWSE, CHANGE, CREATE, EDIT, INSERT, MODIFY and READ.
-
- An integer between 0 and 36, or between 256 and 292, is returned. The value returned is between 0 and 36 if the data was not modified. The value returned is between 256 and 292 if the data was modified.
-
- Values Returned by READKEY
-
- Key(s) No Update Update Meaning
- Code Code
- ------ --------- ------ -------
-
- Backspace
- Left Arrow 0 256 Back 1
- Ctrl+H char.
- Ctrl+S
+
如果发出 READKEY() 时不带可选的数值表达式 expN,则返回值表示退出以下编辑命令时所按的键:APPEND、BROWSE、CHANGE、CREATE、EDIT、INSERT、MODIFY 和 READ。
返回 0 到 36 之间或 256 到 292 之间的整数。如果数据未被修改,返回值在 0 到 36 之间。如果数据已被修改,返回值在 256 到 292 之间。
READKEY 返回的值
+
+ 按键 未更新代码 已更新代码 含义
+ Backspace
左箭头
Ctrl+H
Ctrl+S 0 256 后退 1 个字符。
+
- Returns the number of records in the current or specified table.
+ 返回当前表或指定表中的记录数。
- Specifies the work area number for a table open in another work area.
- RECCOUNT( ) returns 0 if a table isn't open in the work area you specify.
+ 指定在另一个工作区中打开的表的工作区编号。如果指定的工作区中未打开表,RECCOUNT( ) 返回 0。
- Specifies the table alias for a table open in another work area.
+ 指定在另一个工作区中打开的表的表别名。
- Numeric
+ 数值类型
- The value RECCOUNT( ) returns isn't affected by SET DELETED and SET FILTER.
- RECCOUNT( ) without the optional arguments nWorkArea or cTableAlias returns the number of records in the table in the currently selected work area.
+ RECCOUNT( ) 返回的值不受 SET DELETED 和 SET FILTER 的影响。不带可选参数 nWorkArea 或 cTableAlias 的 RECCOUNT( ) 返回当前选定工作区中表的记录数。
@@ -10292,27 +8915,22 @@
- Returns the current record number in the current or specified table.
+ 返回当前表或指定表中的当前记录号。
- Specifies the work area number for a table open in another work area. RECNO( ) returns 0 if a table isn't open in the work area you specify.
+ 指定在另一个工作区中打开的表的工作区编号。如果指定的工作区中未打开表,RECNO( ) 返回 0。
- Specifies the table alias for a table open in another work area.
+ 指定在另一个工作区中打开的表的表别名。
- Numeric
+ 数值类型
- The current record is the record on which the record pointer is positioned.
- RECNO( ) returns negative numbers for records appended in a table buffer.
- RECNO( ) returns a value that is one greater than the number of records in the table if the record pointer is positioned beyond the last record in the table. RECNO( ) returns 1 if the record pointer is positioned before the first record in the table or the table has no records. If a table has no records, EOF( ) always returns true (.T.).
- RECNO( ) issued without the optional arguments nWorkArea or cTableAlias returns the current record number for the table in the currently selected work area.
- If you have issued SEEK unsuccessfully in an indexed table, you can specify 0 for nWorkArea to use "soft seek" logic to return the record number of the closest matching record. RECNO(0) returns 0 if a close match cannot be found. X# generates an error message if you issue GO RECNO(0) when a close match isn't found.
- Avoid using RECNO( ) in the index expression for a table buffered cursor. Because RECNO( ) changes for new records when they are committed by TABLEUPDATE( ), index corruption could occur.
+ 当前记录是记录指针所定位的记录。对于在表缓冲区中追加的记录,RECNO( ) 返回负数。如果记录指针定位在表的最后一条记录之后,RECNO( ) 返回的值比表中的记录数大 1。如果记录指针定位在表的第一条记录之前,或者表中没有记录,RECNO( ) 返回 1。如果表中没有记录,EOF( ) 始终返回 true (.T.)。不带可选参数 nWorkArea 或 cTableAlias 发出 RECNO( ) 时,返回当前选定工作区中表的当前记录号。如果在已建立索引的表中 SEEK 未成功,可以为 nWorkArea 指定 0,使用“soft seek”逻辑返回最接近匹配记录的记录号。如果找不到接近的匹配项,RECNO(0) 返回 0。如果在找不到接近匹配项时发出 GO RECNO(0),X# 会生成错误消息。请避免在表缓冲游标的索引表达式中使用 RECNO( )。由于新记录通过 TABLEUPDATE( ) 提交时 RECNO( ) 会发生变化,可能会导致索引损坏。
@@ -10334,23 +8952,23 @@
- Returns the size (width) of a table record.
+ 返回表记录的大小(宽度)。
- Specifies the work area number for a table open in another work area. RECSIZE( ) returns 0 if a table isn't open in the work area you specify.
+ 指定在另一个工作区中打开的表的工作区编号。如果指定的工作区中未打开表,RECSIZE( ) 返回 0。
- Specifies the table alias for a table open in another work area.
+ 指定在另一个工作区中打开的表的表别名。
- Numeric
+ 数值类型
- RECSIZE( ) issued without the optional arguments nWorkArea or cTableAlias returns the record size for the table in the currently selected work area.
+ 不带可选参数 nWorkArea 或 cTableAlias 发出 RECSIZE( ) 时,返回当前选定工作区中表的记录大小。
@@ -10456,22 +9074,22 @@
- Returns a character string that contains a specified character expression repeated a specified number of times.
+ 返回一个字符串,其中包含重复指定次数的指定字符表达式。
- Specifies the character expression that is replicated.
+ 指定要重复的字符表达式。
- Specifies the number of times the character expression is replicated.
+ 指定字符表达式被重复的次数。
- Character
+ 字符类型
- In X#, the maximum length of the resulting character string is restricted by the amount of available memory.
+ 在 X# 中,结果字符串的最大长度受可用内存大小的限制。
@@ -10482,24 +9100,24 @@
- Returns a single color value from a set of red, green, and blue color components.
+ 从一组红、绿、蓝颜色分量中返回单个颜色值。
- Specifies the intensity of the red color component. nRedValue can range from 0 to 255. Zero is the minimum color intensity; 255 is the maximum color intensity.
+ 指定红色分量的强度。nRedValue 的取值范围为 0 到 255。0 是最小颜色强度;255 是最大颜色强度。
- Specifies the intensity of the green color component. nGreenValue can range from 0 to 255.
+ 指定绿色分量的强度。nGreenValue 的取值范围为 0 到 255。
- Specifies the intensity of the blue color component. nBlueValue can range from 0 to 255.
+ 指定蓝色分量的强度。nBlueValue 的取值范围为 0 到 255。
- The value returned by RGB( ) can be used to set color properties such as BackColor and ForeColor.
+ RGB( ) 返回的值可用于设置颜色属性,例如 BackColor 和 ForeColor。
@@ -10514,22 +9132,22 @@
- Returns the specified number of rightmost characters from a character string.
+ 返回字符串中指定数量的最右侧字符。
- Specifies the character expression whose rightmost characters are returned.
+ 指定要返回其最右侧字符的字符表达式。
- Specifies the number of characters returned from the character expression. RIGHT( ) returns the entire character expression if nCharacters is greater than the length of cExpression. RIGHT( ) returns an empty string if nCharacters is negative or 0.
+ 指定从字符表达式中返回的字符数。如果 nCharacters 大于 cExpression 的长度,RIGHT( ) 返回整个字符表达式。如果 nCharacters 为负数或 0,RIGHT( ) 返回空字符串。
- Character
+ 字符类型
- Characters are returned beginning with the last character on the right and continuing for a specified number of characters.
+ 从最右侧的最后一个字符开始,返回指定数量的字符。
@@ -10562,34 +9180,17 @@
- Attempts to lock a table record or records.
+ 尝试锁定一条或多条表记录。
- Specifies that RLOCK( ) attempts to lock multiple records. The character expression cRecordNumberList specifies one or more record numbers, separated by commas, that RLOCK( ) attempts to lock. For example, to attempt record locks on the first four records in a table, cRecordNumberList should contain 1, 2, 3, 4.
- To lock multiple records, you must have SET MULTILOCKS on and you must include the work area number (nWorkArea) or alias (cTableAlias) of the table in which you attempt to lock multiple records.
- You can also lock multiple records by moving the record pointer to the record you would like to lock, issuing RLOCK( ) or LOCK( ) and then repeating this process for additional records.
- In X#, you can specify 0 as a record number. Specifying 0 lets you attempt to lock the table header.
- Keep the table header locked for as short a time as possible because other users cannot add records to the table when the table header is locked.
- Release the table header lock with UNLOCK RECORD 0, UNLOCK, or UNLOCK ALL.
- If all the records specified in cRecordNumberList are successfully locked, RLOCK( ) returns true (.T.). If one or more of the records specified in cRecordNumberList cannot be locked, RLOCK( ) returns false (.F.) and locks none of the records. In either case, existing record locks remain in place. Multiple record locking is an additive process — placing additional record locks doesn't release existing record locks.
- From a performance perspective, it is always faster to lock the entire table than to lock even a small number of records.
+ 指定 RLOCK( ) 尝试锁定多条记录。字符表达式 cRecordNumberList 指定 RLOCK( ) 尝试锁定的一个或多个记录号,以逗号分隔。例如,若要尝试锁定表中的前四条记录,cRecordNumberList 应包含 1, 2, 3, 4。若要锁定多条记录,必须启用 SET MULTILOCKS,并且必须包含尝试锁定多条记录的表的工作区编号 (nWorkArea) 或别名 (cTableAlias)。也可以先将记录指针移到要锁定的记录,发出 RLOCK( ) 或 LOCK( ),然后对其他记录重复此过程,从而锁定多条记录。在 X# 中,可以将 0 指定为记录号。指定 0 可尝试锁定表头。请尽可能缩短表头被锁定的时间,因为表头被锁定时,其他用户无法向该表添加记录。使用 UNLOCK RECORD 0、UNLOCK 或 UNLOCK ALL 释放表头锁。如果 cRecordNumberList 中指定的所有记录都成功锁定,RLOCK( ) 返回 true (.T.)。如果 cRecordNumberList 中指定的一条或多条记录无法锁定,RLOCK( ) 返回 false (.F.),并且不锁定任何记录。无论哪种情况,现有的记录锁都保持不变。多记录锁定是累加的过程——添加更多记录锁不会释放现有的记录锁。从性能角度来看,锁定整个表总是比锁定少量记录更快。
- Logical
+ 逻辑类型
- RLOCK( ) is identical to LOCK( ).
- Changes to explicitly locked records aren't saved until the record is unlocked or the record pointer is moved.
- If the lock or locks are successfully placed, RLOCK( ) returns true (.T.). Locked records are available for both read and write access by the user who placed the locks and for read-only access to all other users on the network.
- Executing RLOCK( ) doesn't guarantee that the attempted record lock or locks are successfully placed. A record lock cannot be placed on a record already locked by another user or in a table locked by another user. If the record lock or locks cannot be placed for any reason, RLOCK( ) returns false (.F.).
- By default, RLOCK( ) makes one attempt to lock a record. Use SET REPROCESS to automatically retry a record lock when the first attempt fails. SET REPROCESS controls the number of lock attempts or the length of time lock attempts are made when the initial lock attempt is unsuccessful. For more information about SET REPROCESS and table locking, see SET REPROCESS.
- SET MULTILOCKS determines whether you can lock multiple records in a table. If SET MULTILOCKS is off (the default), you can lock only a single record in a table. If SET MULTILOCKS is on, you can lock multiple records in a table. For more information, see SET MULTILOCKS.
- A table record can be unlocked only by the user who placed the lock. Record locks can be released by issuing UNLOCK, closing the table, or exiting X#.
- UNLOCK can be used to release record locks in the current work area, a specific work area or in all work areas. For more information, see UNLOCK.
- Switching SET MULTILOCKS from ON to OFF or from OFF to ON implicitly performs UNLOCK ALL. All record locks in all work areas are released.
- To close tables, use USE, CLEAR ALL, or CLOSE DATABASES.
- For more information about record and file locking and sharing tables on a network, see Programming for Shared Access.
+ RLOCK( ) 与 LOCK( ) 相同。对显式锁定的记录所做的更改在记录被解锁或记录指针移动之前不会保存。如果成功加上了一个或多个锁,RLOCK( ) 返回 true (.T.)。已锁定的记录对加锁的用户可读可写,对网络上的所有其他用户为只读。执行 RLOCK( ) 并不保证一定能成功加上所尝试的记录锁。无法对已被其他用户锁定的记录,或已被其他用户锁定的表中的记录加记录锁。如果由于任何原因无法加上记录锁,RLOCK( ) 返回 false (.F.)。默认情况下,RLOCK( ) 只尝试锁定记录一次。可使用 SET REPROCESS 在第一次尝试失败时自动重试记录锁定。SET REPROCESS 控制初次锁定尝试失败后的锁定尝试次数或尝试持续时间。有关 SET REPROCESS 和表锁定的更多信息,请参见 SET REPROCESS。SET MULTILOCKS 决定是否可以锁定表中的多条记录。如果 SET MULTILOCKS 为 off(默认值),则只能锁定表中的单条记录。如果 SET MULTILOCKS 为 on,则可以锁定表中的多条记录。有关更多信息,请参见 SET MULTILOCKS。表记录只能由加锁的用户解锁。可以通过发出 UNLOCK、关闭表或退出 X# 来释放记录锁。UNLOCK 可用于释放当前工作区、特定工作区或所有工作区中的记录锁。有关更多信息,请参见 UNLOCK。将 SET MULTILOCKS 从 ON 切换为 OFF 或从 OFF 切换为 ON 会隐式执行 UNLOCK ALL,所有工作区中的所有记录锁都会被释放。若要关闭表,请使用 USE、CLEAR ALL 或 CLOSE DATABASES。有关记录和文件锁定以及在网络上共享表的更多信息,请参见 Programming for Shared Access。
@@ -10613,24 +9214,23 @@
- Returns a numeric expression rounded to a specified number of decimal places.
+ 返回四舍五入到指定小数位数的数值表达式。
- Specifies the numeric expression whose value is to be rounded.
+ 指定要四舍五入的数值表达式。
- Specifies the number of decimal places nExpression is rounded to.
- If nDecimalPlaces is negative, ROUND( ) returns a whole number containing zeros equal in number to nDecimalPlaces to the left of the decimal point. For example, if nDecimalPlaces is –2, the first and second digits to the left of the decimal point in the value are 0.
+ 指定 nExpression 四舍五入到的小数位数。如果 nDecimalPlaces 为负数,ROUND( ) 将返回一个整数,其小数点左侧的零的个数等于 nDecimalPlaces 的绝对值。例如,如果 nDecimalPlaces 为 –2,则该值小数点左侧的第一位和第二位数字为 0。
- Numeric data type. ROUND( ) returns a value rounded to the nearest decimal position as specified by nDecimalPlaces.
+ 数值类型。ROUND( ) 返回按 nDecimalPlaces 指定的小数位四舍五入后的值。
- ROUND( ) disregards the number of decimal places specified by the SET DECIMALS command. To display a larger number of decimal places than specified by nDecimalPlaces in ROUND( ), use SET FIXED ON with SET DECIMALS.
+ ROUND( ) 忽略 SET DECIMALS 命令指定的小数位数。若要显示比 ROUND( ) 中 nDecimalPlaces 指定的更多小数位,请将 SET FIXED ON 与 SET DECIMALS 结合使用。
@@ -10650,19 +9250,13 @@
- Included for backward compatibility. Use the CurrentX, CurrentY Properties.
-
- Returns the current row position of the cursor.
+ 仅为向后兼容而保留。请使用 CurrentX、CurrentY 属性。返回光标的当前行位置。
- Return value - Numeric
+ 返回值 - 数值类型
-
- ROW() is especially useful for directing screen output to a position relative to the current row position of the cursor.
-
- The special operator $ can be used in place of the ROW() function.
-
+
ROW() 特别适用于将屏幕输出定向到相对于光标当前行位置的位置。
可以使用特殊运算符 $ 代替 ROW() 函数。
@@ -10690,18 +9284,17 @@
- Converts radians to its equivalent in degrees.
- You can use RTOD( ) when working with the X# trigonometric functions COS( ), SIN( ), and TAN( ).
+ 将弧度转换为等效的度数。在使用 X# 三角函数 COS( )、SIN( ) 和 TAN( ) 时,可以使用 RTOD( )。
- Specifies a numeric expression representing a radian value.
+ 指定表示弧度值的数值表达式。
- Numeric data type. RTOD( ) returns the number of degrees converted from the number of radians.
+ 数值类型。RTOD( ) 返回由弧度转换得到的度数。
- To convert degrees to radians, use the DTOR( ) function.
+ 若要将度数转换为弧度,请使用 DTOR( ) 函数。
@@ -10715,26 +9308,22 @@
- Removes all trailing spaces or parsing characters from the specified character expression, or all trailing zero (0) bytes from the specified binary expression.
+ 从指定的字符表达式中删除所有尾随空格或解析字符,或从指定的二进制表达式中删除所有尾随的零 (0) 字节。
- Specifies an expression of Character or Varbinary type to remove all trailing spaces or 0 bytes from, respectively.
+ 指定 Character 或 Varbinary 类型的表达式,分别从中删除所有尾随空格或 0 字节。
- Specifies if trimming is case-sensitive when one or more parse characters (cParseChar, cParseChar2, … are included. Trimming is case-sensitive if nFlags is zero or is omitted. Trimming is case-insensitive if nFlags 1.
-
- cParseChar [, cParseChar2 [, ...]]
- Specifies one or more character strings that are trimmed from the end of cExpression. If cParseChar isn't included, then trailing spaces or 0 bytes are removed from Expression.
- Note The maximum number of strings permitted in cParseChar is 23.
+ 指定在包含一个或多个解析字符(cParseChar、cParseChar2、…)时,裁剪是否区分大小写。如果 nFlags 为零或省略,则裁剪区分大小写。如果 nFlags 为 1,则裁剪不区分大小写。cParseChar [, cParseChar2 [, ...]] 指定从 cExpression 末尾裁剪的一个或多个字符串。如果未包含 cParseChar,则从 Expression 中删除尾随空格或 0 字节。注意 cParseChar 中允许的最大字符串数为 23。
- Character or Varbinary. RTRIM( ) returns the specified expression without trailing spaces or parsing characters, or 0 bytes.
+ Character 或 Varbinary。RTRIM( ) 返回不带尾随空格、解析字符或 0 字节的指定表达式。
- You can use RTRIM( ) to ensure that trailing spaces or leading and trailing zero (0) bytes are removed from data entered by a user. RTRIM( ) is identical to TRIM( ).
+ 可以使用 RTRIM( ) 确保从用户输入的数据中删除尾随空格或前导及尾随的零 (0) 字节。RTRIM( ) 与 TRIM( ) 相同。
@@ -10748,14 +9337,13 @@
- Returns the number of columns available in the main X# window.
+ 返回 X# 主窗口中可用的列数。
- SCOLS( )Return Value
- Numeric
+ SCOLS( )返回值 数值类型
- The value returned by SCOLS( ) depends on the current display mode. Display modes can be changed with SET DISPLAY.
+ SCOLS( ) 返回的值取决于当前的显示模式。可以使用 SET DISPLAY 更改显示模式。
@@ -10780,438 +9368,161 @@
- Returns the status of various SET commands.
+ 返回各种 SET 命令的状态。
- Specifies a character expression of the SET command for which you want to return information. The current setting of the specified command is returned as a character or numeric string.
+ 指定要返回其信息的 SET 命令的字符表达式。指定命令的当前设置将作为字符或数值字符串返回。
1 | cExpression| 2 | 3 | 4
- SET command Value returned
- ALTERNATE
- ON or OFF
-
- ALTERNATE, 1
- FileName
-
- ANSI
- ON or OFF
-
- ASSERTS
- ON or OFF
-
- AUTOINCERROR
- ON or OFF
-
- AUTOSAVE
- ON or OFF
-
- BELL, 1
- cWAVFileName
-
- BLOCKSIZE
- nBlockSize
-
- BROWSEIME
- ON or OFF
-
- CARRY
- ON or OFF
-
- CENTURY
- ON or OFF
-
- CENTURY, 1
- nCentury
-
- CENTURY, 2
- ROLLOVER nYear
-
- CENTURY, 3
- System Regional Calendar setting
-
- CLASSLIB
- cClassLibName
-
- CLOCK
- ON or OFF
-
- CLOCK, 1
- nRow and nColumn
-
- COLLATE
- ON or OFF
-
- COLOR OF SCHEME
- cR, cG, cB
-
- COLOR SET
- cNameOfColorSet
-
- COMPATIBLE
- ON or OFF
-
- COMPATIBLE, 1
- PROMPT or NOPROMPT
-
- CONFIRM
- ON or OFF
-
- CONSOLE
- ON or OFF
-
- COVERAGE
- ON or OFF
-
- COVERAGE, 1
- FileName
-
- CPCOMPILE
- nCodePage
-
- CPDIALOG
- ON or OFF
-
- CURRENCY
- LEFT or RIGHT
-
- CURRENCY, 1
- cCurrencySymbol
-
- CURSOR
- ON or OFF
-
- DATABASE
- cDatabase
-
- DATASESSION
- nDataSession
-
- DATE
- AMERICAN, ANSI, BRITISH/FRENCH, GERMAN, ITALIAN, JAPAN, USA, MDY, DMY, or YMD
-
- DATE, 1
- Date Ordering:0 – MDY1 – DMY2 – YMD
-
- DEBUG
- ON or OFF
-
- DEBUGOUT
- cFileName
-
- DECIMALS
- nDecimals
-
- DEFAULT
- cDirectory
-
- DELETED
- ON or OFF
-
- DELIMITERS
- ON or OFF
-
- DELIMITERS, 1
- cDelimiters
-
- DEVELOPMENT
- ON or OFF
-
- DEVICE
- SCREEN, PRINTER, or FILE
-
- DEVICE, 1
- cFileName
-
- DIRECTORY
- cDirectory
-
- DOHISTORY
- ON or OFF
-
- ENGINEBEHAVIOR
- nVersionNumber
-
- ESCAPE
- ON or OFF
-
- EVENTLIST
- comma delimited list of events
-
- EVENTTRACKING
- ON or OFF
-
- EVENTTRACKING, 1
- FileName
-
- EXACT
- ON or OFF
-
- EXCLUSIVE
- ON or OFF
-
- FDOW
- nDayofWeek
-
- FIELDS
- ON or OFF
-
- FIELDS, 1
- FieldName1, FieldName2, ...
-
- FIELDS, 2
- LOCAL or GLOBAL
-
- FILTER
- cFilterExpression
-
- FIXED
- ON or OFF
-
- FULLPATH
- ON or OFF
-
- FWEEK
- nWeekNumber
-
- HEADINGS
- ON or OFF
-
- HELP
- ON or OFF
-
- HELP, 1
- cFileName
-
- HELP, 2
- cCollectionURL
-
- HELP, 3
- SYSTEM
-
- HOURS
- 12 or 24
-
- INDEX
- cIndexExpression
-
- KEY
- eExpression2, eExpression3
-
- KEY, 1
- eExpression2
-
- KEY, 2
- eExpression3
-
- KEYCOMP
- DOS or WINDOWS
-
- LIBRARY
- cNameOfLibrary
-
- LOCK
- ON or OFF
-
- LOGERRORS
- ON or OFF
-
- MACKEY
- cKey
-
- MARGIN
- nMargin
-
- MEMOWIDTH
- nWidth
-
- MESSAGE
- nRow
-
- MESSAGE, 1
- cMessageText
-
- MOUSE
- ON or OFF
-
- MOUSE, 1
- nSensitivity
-
- MULTILOCKS
- ON or OFF
-
- NEAR
- ON or OFF
-
- NOCPTRANS
- comma delimited list of fields
-
- NOTIFY
- ON or OFF
-
- NOTIFY, 1
- ON or OFF
-
- NULL
- ON or OFF
-
- NULLDISPLAY
- cDisplayString
-
- ODOMETER
- nNumberOfRecords
-
- OLEOBJECT
- ON or OFF
-
- OPTIMIZE
- ON or OFF
-
- ORDER
- TAG TagName OF CDXFileName, IDXFileName, or blank
-
- PALETTE
- ON or OFF
-
- PATH
- cPath
-
- PDSETUP
- cPrinterDriverName
-
- POINT
- cDecimalPtChar
-
- PRINTER
- ON or OFF
-
- PRINTER, 1
- FileName or PortName
-
- PRINTER, 2
- Default Windows printer name
-
- PRINTER, 3
- Default Visual FoxPro printer name(specified in the Visual FoxPro Print or Print Setup dialog boxes)
-
- PROCEDURE
- cPathAndName
-
- READBORDER
- ON or OFF
-
- REFRESH
- nSeconds1
-
- REFRESH, 1
- nseconds2
-
- REPORTBEHAVIOR
- nVersionNumber
-
- REPROCESS
- Current session setting
-
- REPROCESS, 1
- System session setting
-
- REPROCESS, 2
- Current session setting type
-
- 0 is returned if REPROCESS is set to attempts.
-
- 1 is returned if REPROCESS is set to seconds.
-
- REPROCESS, 3
- System session setting type
-
- 0 is returned if REPROCESS is set to attempts.
-
- 1 is returned if REPROCESS is set to seconds.
-
- RESOURCE
- ON or OFF
-
- RESOURCE, 1
- FileName
-
- SAFETY
- ON or OFF
-
- SECONDS
- ON or OFF
-
- SEPARATOR
- cSeparatorChar
-
- SPACE
- ON or OFF
-
- SQLBUFFERING
- ON or OFF
-
- STATUS
- ON or OFF
-
- STATUS BAR
- ON or OFF
-
- STRICTDATE
- ON or OFF
-
- SYSFORMATS
- ON or OFF
-
- SYSMENU
- ON, OFF, or AUTOMATIC
-
- TABLEPROMPT
- ON or OFF
-
- TABLEVALIDATE
- nLevel
-
- TALK
- ON or OFF
-
- TALK, 1
- WINDOW, NOWINDOW or WindowName
-
- TEXTMERGE
- ON or OFF
-
- TEXTMERGE, 1
- cLeftDelimiter and cRightDelimiter
-
- TEXTMERGE, 2
- cFileName
-
- TEXTMERGE, 3
- SHOW/NOSHOW
-
- TEXTMERGE, 4
- Evaluate source of TEXT ... ENDTEXT call and return TEXTMERGE nesting level.
-
- TOPIC
- cHelpTopicName | lExpression
-
- TOPIC, 1
- NContextID
-
- UDFPARMS
- VALUE or REFERENCE
-
- UNIQUE
- ON or OFF
-
-
-
- SET( ) recognizes the 4-character abbreviation for all X# SET keywords, with the exception of HELPFILTER, which can be abbreviated to 5 characters. For example, you can use STAT and PRIN for SET STATUS SET PRINTER, respectively.
- The SET( ) function is identical to SYS(2001).
+
+ SET 命令 返回值
+ ALTERNATE ON 或 OFF
+ ALTERNATE, 1 FileName
+ ANSI ON 或 OFF
+ ASSERTS ON 或 OFF
+ AUTOINCERROR ON 或 OFF
+ AUTOSAVE ON 或 OFF
+ BELL, 1 cWAVFileName
+ BLOCKSIZE nBlockSize
+ BROWSEIME ON 或 OFF
+ CARRY ON 或 OFF
+ CENTURY ON 或 OFF
+ CENTURY, 1 nCentury
+ CENTURY, 2 ROLLOVER nYear
+ CENTURY, 3 系统区域日历设置
+ CLASSLIB cClassLibName
+ CLOCK ON 或 OFF
+ CLOCK, 1 nRow 和 nColumn
+ COLLATE ON 或 OFF
+ COLOR OF SCHEME cR, cG, cB
+ COLOR SET cNameOfColorSet
+ COMPATIBLE ON 或 OFF
+ COMPATIBLE, 1 PROMPT 或 NOPROMPT
+ CONFIRM ON 或 OFF
+ CONSOLE ON 或 OFF
+ COVERAGE ON 或 OFF
+ COVERAGE, 1 FileName
+ CPCOMPILE nCodePage
+ CPDIALOG ON 或 OFF
+ CURRENCY LEFT 或 RIGHT
+ CURRENCY, 1 cCurrencySymbol
+ CURSOR ON 或 OFF
+ DATABASE cDatabase
+ DATASESSION nDataSession
+ DATE AMERICAN、ANSI、BRITISH/FRENCH、GERMAN、ITALIAN、JAPAN、USA、MDY、DMY 或 YMD
+ DATE, 1 日期顺序:
+ 0 MDY
+ 1 DMY
+ 2 YMD
+
+ DEBUG ON 或 OFF
+ DEBUGOUT cFileName
+ DECIMALS nDecimals
+ DEFAULT cDirectory
+ DELETED ON 或 OFF
+ DELIMITERS ON 或 OFF
+ DELIMITERS, 1 cDelimiters
+ DEVELOPMENT ON 或 OFF
+ DEVICE SCREEN、PRINTER 或 FILE
+ DEVICE, 1 cFileName
+ DIRECTORY cDirectory
+ DOHISTORY ON 或 OFF
+ ENGINEBEHAVIOR nVersionNumber
+ ESCAPE ON 或 OFF
+ EVENTLIST 以逗号分隔的事件列表
+ EVENTTRACKING ON 或 OFF
+ EVENTTRACKING, 1 FileName
+ EXACT ON 或 OFF
+ EXCLUSIVE ON 或 OFF
+ FDOW nDayofWeek
+ FIELDS ON 或 OFF
+ FIELDS, 1 FieldName1, FieldName2, ...
+ FIELDS, 2 LOCAL 或 GLOBAL
+ FILTER cFilterExpression
+ FIXED ON 或 OFF
+ FULLPATH ON 或 OFF
+ FWEEK nWeekNumber
+ HEADINGS ON 或 OFF
+ HELP ON 或 OFF
+ HELP, 1 cFileName
+ HELP, 2 cCollectionURL
+ HELP, 3 SYSTEM
+ HOURS 12 或 24
+ INDEX cIndexExpression
+ KEY eExpression2, eExpression3
+ KEY, 1 eExpression2
+ KEY, 2 eExpression3
+ KEYCOMP DOS 或 WINDOWS
+ LIBRARY cNameOfLibrary
+ LOCK ON 或 OFF
+ LOGERRORS ON 或 OFF
+ MACKEY cKey
+ MARGIN nMargin
+ MEMOWIDTH nWidth
+ MESSAGE nRow
+ MESSAGE, 1 cMessageText
+ MOUSE ON 或 OFF
+ MOUSE, 1 nSensitivity
+ MULTILOCKS ON 或 OFF
+ NEAR ON 或 OFF
+ NOCPTRANS 以逗号分隔的字段列表
+ NOTIFY ON 或 OFF
+ NOTIFY, 1 ON 或 OFF
+ NULL ON 或 OFF
+ NULLDISPLAY cDisplayString
+ ODOMETER nNumberOfRecords
+ OLEOBJECT ON 或 OFF
+ OPTIMIZE ON 或 OFF
+ ORDER TAG TagName OF CDXFileName、IDXFileName 或空白
+ PALETTE ON 或 OFF
+ PATH cPath
+ PDSETUP cPrinterDriverName
+ POINT cDecimalPtChar
+ PRINTER ON 或 OFF
+ PRINTER, 1 FileName 或 PortName
+ PRINTER, 2 默认 Windows 打印机名称
+ PRINTER, 3 默认 Visual FoxPro 打印机名称(在 Visual FoxPro 的“打印”或“打印设置”对话框中指定)
+ PROCEDURE cPathAndName
+ READBORDER ON 或 OFF
+ REFRESH nSeconds1
+ REFRESH, 1 nseconds2
+ REPORTBEHAVIOR nVersionNumber
+ REPROCESS 当前会话设置
+ REPROCESS, 1 系统会话设置
+ REPROCESS, 2 当前会话设置类型
如果 REPROCESS 设置为尝试次数,则返回 0。
如果设置为秒数,则返回 1。
+ REPROCESS, 3 系统会话设置类型
如果 REPROCESS 设置为尝试次数,则返回 0。
如果设置为秒数,则返回 1。
+ RESOURCE ON 或 OFF
+ RESOURCE, 1 FileName
+ SAFETY ON 或 OFF
+ SECONDS ON 或 OFF
+ SEPARATOR cSeparatorChar
+ SPACE ON 或 OFF
+ SQLBUFFERING ON 或 OFF
+ STATUS ON 或 OFF
+ STATUS BAR ON 或 OFF
+ STRICTDATE ON 或 OFF
+ SYSFORMATS ON 或 OFF
+ SYSMENU ON、OFF 或 AUTOMATIC
+ TABLEPROMPT ON 或 OFF
+ TABLEVALIDATE nLevel
+ TALK ON 或 OFF
+ TALK, 1 WINDOW、NOWINDOW 或 WindowName
+ TEXTMERGE ON 或 OFF
+ TEXTMERGE, 1 cLeftDelimiter 和 cRightDelimiter
+ TEXTMERGE, 2 cFileName
+ TEXTMERGE, 3 SHOW/NOSHOW
+ TEXTMERGE, 4 计算 TEXT ... ENDTEXT 调用的来源并返回 TEXTMERGE 嵌套级别。
+ TOPIC cHelpTopicName | lExpression
+ TOPIC, 1 NContextID
+ UDFPARMS VALUE 或 REFERENCE
+ UNIQUE ON 或 OFF
+
+SET( ) 可识别所有 X# SET 关键字的 4 个字符缩写,HELPFILTER 除外,它可以缩写为 5 个字符。例如,可以分别使用 STAT 和 PRIN 表示 SET STATUS SET PRINTER。SET( ) 函数与 SYS(2001) 相同。
@@ -11239,15 +9550,14 @@
- Returns the sine of an angle.
+ 返回角度的正弦值。
- Specifies an angle whose sine SIN( ) returns. nExpression can assume any value and the value returned by SIN( ) ranges between –1 and 1.
- nExpression is specified in radians. Use DTOR( ) to convert an angle from degrees to radians. The number of decimal places displayed by SIN( ) can be specified with SET DECIMALS.
+ 指定 SIN( ) 返回其正弦值的角度。nExpression 可以取任意值,SIN( ) 返回的值介于 –1 和 1 之间。nExpression 以弧度为单位指定。使用 DTOR( ) 可将角度从度转换为弧度。SIN( ) 显示的小数位数可通过 SET DECIMALS 指定。
- Numeric
+ 数值类型
@@ -11260,58 +9570,57 @@
- Determines if a menu item is enabled or disabled with SET SKIP OF.
+ 确定菜单项是否已通过 SET SKIP OF 启用或禁用。
- Specifies the name of the menu that contains the item.
+ 指定包含该菜单项的菜单名称。
- Specifies the number of the menu item whose status (enabled or disabled) SKPBAR( ) returns. The menu item number is assigned when the menu item is created with DEFINE BAR.
+ 指定 SKPBAR( ) 返回其状态(启用或禁用)的菜单项编号。菜单项编号是在使用 DEFINE BAR 创建菜单项时分配的。
- Logical
+ 逻辑类型
- SKPBAR( ) returns true (.T.) if the menu item is disabled, and false (.F.) if the menu item is enabled.
+ 如果菜单项被禁用,SKPBAR( ) 返回 true (.T.);如果菜单项已启用,则返回 false (.F.)。
- Determines whether a menu title is enabled or disabled with SET SKIP OF.
+ 确定菜单标题是否已通过 SET SKIP OF 启用或禁用。
- Specifies the name of the menu bar that contains the menu title.
+ 指定包含该菜单标题的菜单栏名称。
- Specifies the name of the menu title whose status (enabled or disabled) SKPPAD( ) returns.
+ 指定 SKPPAD( ) 返回其状态(启用或禁用)的菜单标题名称。
- Logical
+ 逻辑类型
- SKPPAD( ) returns true (.T.) if the menu title is disabled, and false (.F.) if the menu title is enabled.
+ 如果菜单标题被禁用,SKPPAD( ) 返回 true (.T.);如果菜单标题已启用,则返回 false (.F.)。
- Returns a phonetic representation of the specified character expression.
+ 返回指定字符表达式的语音表示。
- Specifies the character expression SOUNDEX( ) evaluates.
+ 指定 SOUNDEX( ) 要计算的字符表达式。
- Character
+ 字符类型
- SOUNDEX( ) returns a four-character string. By comparing the results SOUNDEX( ) returns for two character expressions, you can determine if the two expressions are phonetically similar, indicating that they sound alike. This can be useful when searching for duplicate records in a table.
- SOUNDEX( ) isn't case sensitive and generally disregards vowels.
+ SOUNDEX( ) 返回一个四字符的字符串。通过比较 SOUNDEX( ) 对两个字符表达式返回的结果,可以确定这两个表达式在语音上是否相似,即发音是否相近。这在表中搜索重复记录时非常有用。SOUNDEX( ) 不区分大小写,并且通常忽略元音。
@@ -11323,14 +9632,14 @@
- Returns a character string composed of a specified number of spaces.
+ 返回由指定数量的空格组成的字符串。
- Specifies the number of spaces that SPACE( ) returns. The maximum value of nSpaces is limited only by memory in X#.
+ 指定 SPACE( ) 返回的空格数量。nSpaces 的最大值在 X# 中仅受内存限制。
- Character
+ 字符类型
@@ -12302,17 +10611,17 @@
- Returns the square root of the specified numeric expression.
+ 返回指定数值表达式的平方根。
- Specifies the numeric expression SQRT( ) evaluates. nExpression cannot be negative.
+ 指定 SQRT( ) 要计算的数值表达式。nExpression 不能为负数。
- Numeric
+ 数值类型
- The number of decimal places in the value returned by SQRT( ) is the larger of the current decimal place setting and the number of decimal places contained in nExpression. The current decimal place setting is specified with SET DECIMALS.
+ SQRT( ) 返回值的小数位数取当前小数位数设置与 nExpression 所含小数位数中较大的一个。当前小数位数设置通过 SET DECIMALS 指定。
@@ -12324,14 +10633,13 @@
- Returns the number of rows available in the main X# window.
+ 返回 X# 主窗口中可用的行数。
- SROWS( )Return Value
- Numeric
+ SROWS( )返回值 数值类型
- In X# for Windows, the value returned by SROWS( ) depends on the current display mode. The display mode can be changed with SET DISPLAY.
+ 在 X# for Windows 中,SROWS( ) 返回的值取决于当前的显示模式。显示模式可以通过 SET DISPLAY 更改。
@@ -12342,37 +10650,28 @@
- Returns the character equivalent of a numeric expression.
+ 返回数值表达式的字符等价形式。
- Specifies the numeric expression to evaluate.
+ 指定要计算的数值表达式。
- Specifies the length of the character string returned. If nLength is omitted, nLength defaults to 10 characters.
- If the expression contains a decimal point, the length includes one character for the decimal point and one character for each digit in the character string.
+ 指定返回的字符串的长度。如果省略 nLength,则 nLength 默认为 10 个字符。如果表达式包含小数点,则长度包括小数点占用的一个字符以及字符串中每个数字占用的一个字符。
- Specifies the number of decimal places in the character string returned. To specify the number of decimal places using nDecimalPlaces, you must include nLength. If nDecimalPlaces is omitted, the number of decimal places defaults to zero (0).
- X# contains a limit of 16 digits of precision in numeric calculations. For more information about numeric precision in X#, see X# System Capacities.
+ 指定返回的字符串中的小数位数。要使用 nDecimalPlaces 指定小数位数,必须同时包含 nLength。如果省略 nDecimalPlaces,则小数位数默认为零 (0)。X# 在数值计算中限制为 16 位有效数字精度。有关 X# 中数值精度的更多信息,请参阅 X# System Capacities。
- Character data type. STR( ) returns a character string equivalent to the specified numeric expression.
- Depending on certain conditions, STR( ) can return the following:
- If you specify fewer decimal places than exist in nExpression, the return value is rounded up. To round results to the nearest decimal place instead of upward, include the ROUND( ) function. For more information, see ROUND( ) Function.
- If nExpression is an integer, and nLength is less than the number of digits in nExpression, STR( ) returns a string of asterisks, indicating numeric overflow.
- If nExpression contains a decimal point, and nLength is equal to or less than the number of digits to the left of the decimal point, STR( ) returns a string of asterisks, indicating numeric overflow.
- If nLength is greater than the length of the value evaluated by nExpression, STR( ) returns a character string padded with leading spaces.
- If nExpression has Numeric or Float type, and nLength is less than the number of digits in nExpression, and , STR( ) returns a value using scientific notation.
- In the following example, STR( ) evaluates 1.154994 as a character expression, specifies a length of 8 characters and the same number of decimal places that the specified expression contains, and displays 1.154994 using the ? command.
+ 字符类型。STR( ) 返回与指定数值表达式等价的字符串。根据不同条件,STR( ) 可能返回以下结果:如果指定的小数位数少于 nExpression 中实际存在的小数位数,则返回值会向上舍入。若要四舍五入到最接近的小数位而不是向上舍入,请使用 ROUND( ) 函数。有关更多信息,请参阅 ROUND( ) Function。如果 nExpression 是整数,并且 nLength 小于 nExpression 的位数,STR( ) 返回一个由星号组成的字符串,表示数值溢出。如果 nExpression 包含小数点,并且 nLength 等于或小于小数点左侧的位数,STR( ) 返回一个由星号组成的字符串,表示数值溢出。如果 nLength 大于 nExpression 所计算值的长度,STR( ) 返回以前导空格填充的字符串。如果 nExpression 为 Numeric 或 Float 类型,并且 nLength 小于 nExpression 的位数,并且 , STR( ) 返回使用科学记数法表示的值。在下面的示例中,STR( ) 将 1.154994 作为字符表达式进行计算,指定长度为 8 个字符,小数位数与指定表达式包含的小数位数相同,并使用 ? 命令显示 1.154994。
? STR(1.154995,8,6)
- In the following example, STR( ) evaluates 1.154994 as a character expression and specifies a length of 8 characters and 2 decimal places, four fewer decimal places than the specified expression contains. STR( ) displays 1.16 using the ? command, which represents 1.154994 rounded upward.
+ 在下面的示例中,STR( ) 将 1.154994 作为字符表达式进行计算,并指定长度为 8 个字符、2 位小数,比指定表达式包含的小数位数少四位。STR( ) 使用 ? 命令显示 1.16,即 1.154994 向上舍入后的结果。
? STR(1.154995,8,2)
- In the following example, STR( ) includes the ROUND( ) function, evaluates 1.154994 as a character expression, and specifies a length of 8 characters 2 decimal places, four fewer decimal places than the specified expression contains. STR( ) displays 1.15 using the ? command, which represents 1.154994, rounded to the nearest significant digit.
+ 在下面的示例中,STR( ) 包含 ROUND( ) 函数,将 1.154994 作为字符表达式进行计算,并指定长度为 8 个字符、2 位小数,比指定表达式包含的小数位数少四位。STR( ) 使用 ? 命令显示 1.15,即 1.154994 四舍五入到最接近的有效数字后的结果。
? STR(ROUND(1.154995,2),8,2)
@@ -12455,44 +10754,27 @@
- Searches a character expression or memo field for a second character expression or memo field and replaces each occurrence with a third character expression or memo field. You can specify where the replacement begins and how many replacements are made.
+ 在字符表达式或备注字段中搜索第二个字符表达式或备注字段,并将每次出现的内容替换为第三个字符表达式或备注字段。可以指定替换开始的位置以及替换的次数。
- Specifies the character expression to search. cSearched can be a memo field, a blob field, or a varbinary expression.
+ 指定要搜索的字符表达式。cSearched 可以是备注字段、blob 字段或 varbinary 表达式。
- Specifies the character expression to search for in cSearched. The search is case-sensitive. cExpressionSought can be a memo field, a blob field, or a varbinary expression.
- cReplacement
- Specifies the character expression to replace every occurrence of cExpressionSought in cSearched. Omitting cReplacement replaces every occurrence of cExpressionSought with an empty string. cReplacement can also be a memo field, a blob field, or a varbinary expression.
- nStartOccurrence
- Specifies which occurrence of cExpressionSought to replace first.
- For example, if nStartOccurrence is 4, replacement begins with the fourth occurrence of cExpressionSought in cSearched and the first three occurrences of cExpressionSought remain unchanged. Omitting nStartOccurrence defaults the occurrence where replacement begins to the first occurrence of cExpressionSought.
- nNumberOfOccurrences
- Specifies the number of occurrences of cExpressionSought to replace. Omitting nNumberOfOccurrences replaces all occurrences of cExpressionSought, starting with the occurrence specified with nStartOccurrence.
- If you need to specify only the nFlags setting along with the required parameters, specify empty string for the cReplacement and –1 for the optional numeric parameters you want disregarded.
- nFlags
- Specifies the case-sensitivity of a search according to the following values.
- The following table lists the values for nFlags:
+ 指定要在 cSearched 中搜索的字符表达式。搜索区分大小写。cExpressionSought 可以是备注字段、blob 字段或 varbinary 表达式。cReplacement 指定用于替换 cSearched 中每次出现的 cExpressionSought 的字符表达式。省略 cReplacement 时,会将每次出现的 cExpressionSought 替换为空字符串。cReplacement 也可以是备注字段、blob 字段或 varbinary 表达式。nStartOccurrence 指定首先替换 cExpressionSought 的第几次出现。例如,如果 nStartOccurrence 为 4,则从 cSearched 中 cExpressionSought 的第四次出现开始替换,前三次出现保持不变。省略 nStartOccurrence 时,替换默认从 cExpressionSought 的第一次出现开始。nNumberOfOccurrences 指定要替换的 cExpressionSought 的出现次数。省略 nNumberOfOccurrences 时,将从 nStartOccurrence 指定的出现位置开始替换所有出现的内容。如果除必需参数外只需要指定 nFlags 设置,请为 cReplacement 指定空字符串,并为要忽略的可选数值参数指定 –1。nFlags 根据以下值指定搜索的大小写敏感性。下表列出了 nFlags 的值:
- 0
- Search is case-sensitive and replacement is performed with exact cReplacement text. (Default)
- This setting specifies the original behavior for STRTRAN( ) in versions prior to X# 7.0.br
- You can also specify default behavior by passing –1 as the nFlags value.
-
- Search is case-insensitive and replacement is performed with exact cReplacement text.
- 2
- Search is case-sensitive and replacement is performed with the case of cReplacement changed to match the case of the string found.
- 3
- Search is case-insensitive and replacement is performed with the case of cReplacement changed to match the case of the string found.
- The case of cReplacement changes only if the string found is all uppercase, lowercase, or proper case.
+
+ 0 搜索区分大小写,并使用 cReplacement 的原文进行替换。(默认)
此设置指定 X# 7.0 之前版本中 STRTRAN( ) 的原始行为。
也可以通过传入 –1 作为 nFlags 的值来指定默认行为。
+ 1 搜索不区分大小写,并使用 cReplacement 的原文进行替换。
+ 2 搜索区分大小写,并将 cReplacement 的大小写更改为与所找到的字符串的大小写一致后进行替换。
+ 3 搜索不区分大小写,并将 cReplacement 的大小写更改为与所找到的字符串的大小写一致后进行替换。
仅当找到的字符串全部为大写、全部为小写或首字母大写时,cReplacement 的大小写才会更改。
+
- Character or Varbinary.br
- STRTRAN( ) returns the resulting character or varbinary string. The Result data type is derived by the first parameter data type.
+ 字符类型或 Varbinary。.br STRTRAN( ) 返回结果字符串或 varbinary 字符串。结果的数据类型由第一个参数的数据类型决定。
@@ -12511,29 +10793,29 @@
- Returns a character string created by replacing a specified number of characters in a character expression with another character expression.
+ 返回一个字符串,该字符串通过将字符表达式中指定数量的字符替换为另一个字符表达式而生成。
- Specify the character expression in which the replacement occurs.
+ 指定发生替换的字符表达式。
- Specifies the position in cExpression where the replacement begins.
+ 指定 cExpression 中开始替换的位置。
- Specifies the number of characters to be replaced. If nCharactersReplaced is 0, the replacement string cReplacement is inserted into cExpression.
+ 指定要替换的字符数。如果 nCharactersReplaced 为 0,则替换字符串 cReplacement 会被插入到 cExpression 中。
- Specifies the replacement character expression. If cReplacement is the empty string, the number of characters specified by nCharactersReplaced are removed from cExpression.
+ 指定用于替换的字符表达式。如果 cReplacement 为空字符串,则会从 cExpression 中删除 nCharactersReplaced 指定数量的字符。
- Character
+ 字符类型
@@ -12579,29 +10861,27 @@
- Returns a character string from the given character expression or memo field, starting at a specified position in the character expression or memo field and continuing for a specified number of characters.
+ 从给定的字符表达式或备注字段中返回一个字符串,从字符表达式或备注字段中的指定位置开始,持续指定数量的字符。
- Specifies the character expression or memo field from which the character string is returned.
+ 指定返回字符串所来自的字符表达式或备注字段。
- Specifies the position in the character expression or memo field cExpression from where the character string is returned. The first character of cExpression is position 1.
- If nStartPosition is greater than the number of characters in cExpression, SUBSTR( ) returns an empty string ("").
+ 指定在字符表达式或备注字段 cExpression 中开始返回字符串的位置。cExpression 的第一个字符位置为 1。如果 nStartPosition 大于 cExpression 中的字符数,SUBSTR( ) 返回空字符串 ("")。
- Specifies the number of characters to return from cExpression. If you omit nCharactersReturned, characters are returned until the end of the character expression is reached.
+ 指定从 cExpression 返回的字符数。如果省略 nCharactersReturned,则返回字符直到字符表达式末尾。
- Character. SUBSTR( ) returns a character string.
- SUBSTR( ) will not return a value for a memo field when issued in the Debug window. To return a value in the Debug window, place the memo field name within ALLTRIM( ), and place ALLTRIM( ) within SUBSTR( ).
+ 字符类型。SUBSTR( ) 返回一个字符串。在调试窗口中执行时,SUBSTR( ) 不会返回备注字段的值。若要在调试窗口中返回值,请将备注字段名放在 ALLTRIM( ) 中,并将 ALLTRIM( ) 放在 SUBSTR( ) 中。
- When using SUBSTR( ) with memo fields in a SQL SELECT command, include the PADR( ) function in SUBSTR( ) so that empty or variable length memo fields produce consistent results when converted to character strings.
+ 在 SQL SELECT 命令中对备注字段使用 SUBSTR( ) 时,请在 SUBSTR( ) 中包含 PADR( ) 函数,以便空的或可变长度的备注字段在转换为字符串时产生一致的结果。
@@ -12731,14 +11011,14 @@
- This trigonometric function returns the tangent of an angle.
+ 此三角函数返回角度的正切值。
- Specifies the angle in radians for which TAN( ) returns the tangent. To convert an angle from degrees to radians, use DTOR( ). The number of decimal places returned by TAN( ) can be specified with SET DECIMALS.
+ 指定 TAN( ) 返回其正切值的角度(以弧度为单位)。若要将角度从度转换为弧度,请使用 DTOR( )。TAN( ) 返回的小数位数可通过 SET DECIMALS 指定。
- Numeric
+ 数值类型
@@ -12781,74 +11061,55 @@
- Returns a character string from an expression in a format determined by a format code.
- Using TRANSFORM( ) with a large negative number that contains a decimal might result in numeric overflow when that number is passed in as a memory variable. You should use the STR( ) function instead with such numbers.
+ 按格式代码确定的格式,从表达式返回一个字符串。当大的负数包含小数并作为内存变量传入时,使用 TRANSFORM( ) 可能会导致数值溢出。对于此类数值,应改用 STR( ) 函数。
- Specifies the expression to format.
+ 指定要格式化的表达式。
- Specifies one or more format codes that determine how to format the expression.
- The following table lists the available format codes for cFormatCodes.
- @B
- Left-justifies Numeric data within the display region.
- @C
- Appends a CR to positive Currency or Numeric values to indicate a credit.
- @D
- Converts Date and DateTime values to the current SET DATE format.
- @E
- Converts Date and DateTime values to a BRITISH date format.
- @L
- Pads numeric data with leading zeroes.
- @R
- The transformation uses a format mask. The mask characters are not stored to the transformed value. Use only with character or numeric data. Mask characters include:
- 9 or # Represents a character or number.
- ! Converts lower-case letters to uppercase letters.
- X# does not display specified mask characters that exceed the converted string length of the passed expression.
- @T
- Trims leading and trailing spaces from character values.
- @X
- Appends DB to negative currency or numeric values to indicate a debit.
- @YL
- Use Long Date system setting.
- @YS
- Use Short Date system setting.
- @Z
- If 0, converts currency or numeric values to spaces.
- @(
- Encloses negative currency or numeric values in parentheses.
- @^
- Converts currency or numeric values to scientific notation.
- @0
- Converts numeric or currency values to their hexadecimal equivalents. The numeric or currency value must be positive and less than 4,294,967,296.
- @!
- Converts an entire character string to uppercase.
- @$
- Adds the current currency symbol specified by SET CURRENCY to currency and numeric values. By default, the symbol is placed immediately before or after the value. However, the currency symbol and its placement (specified with SET CURRENCY), the separator character (specified with SET SEPARATOR) and the decimal character (specified with SET POINT) can all be changed.
- Specifies the width of character values. For example, if cFormatCodes is 'XX', 2 characters are returned.
- Converts logical True (.T.) and False (.F.) values to Y and N, respectively.
- Converts a lowercase character to uppercase in the corresponding position in a character string.
- Specifies the decimal point position in currency and numeric values.
- Separates digits to the left of the decimal point in currency and numeric values.
- Specifies width of numeric values.
- For example, if cFormatCodes is '999.99', the numeric characters are formatted with three characters to the left of the decimal point, and two characters to the right.
- When specifying cFormatCodes for numeric values, the format code must be at least the size of the value you want to display.
- The following example shows the results when the format code is missing, less than, and equal to the size of the value you want to display.
+ 指定一个或多个格式代码,用于确定如何格式化表达式。下表列出了 cFormatCodes 可用的格式代码。
+
+ @B 在显示区域内左对齐 Numeric 数据。
+ @C 在正的 Currency 或 Numeric 值后追加 CR,表示贷方。
+ @D 将 Date 和 DateTime 值转换为当前 SET DATE 格式。
+ @E 将 Date 和 DateTime 值转换为 BRITISH 日期格式。
+ @L 用前导零填充数值数据。
+ @R 转换使用格式掩码。掩码字符不会存储到转换后的值中。仅用于字符或数值数据。掩码字符包括:
+ 9 或 # 表示一个字符或数字。
+ ! 将小写字母转换为大写字母。
+
X# 不显示超出传入表达式转换后字符串长度的指定掩码字符。
+ @T 去除字符值的前导和尾随空格。
+ @X 在负的货币或数值后追加 DB,表示借方。
+ @YL 使用长日期系统设置。
+ @YS 使用短日期系统设置。
+ @Z 如果为 0,则将货币或数值转换为空格。
+ @( 将负的货币或数值括在圆括号中。
+ @^ 将货币或数值转换为科学记数法。
+ @0 将数值或货币值转换为其十六进制等价形式。数值或货币值必须为正数且小于 4,294,967,296。
+ @! 将整个字符串转换为大写。
+ @$ 将 SET CURRENCY 指定的当前货币符号添加到货币和数值中。默认情况下,该符号紧接在值之前或之后。但是,货币符号及其位置(通过 SET CURRENCY 指定)、分隔符(通过 SET SEPARATOR 指定)和小数点字符(通过 SET POINT 指定)都可以更改。
+ X 指定字符值的宽度。例如,如果 cFormatCodes 为 'XX',则返回 2 个字符。
+ Y 将逻辑 True (.T.) 和 False (.F.) 值分别转换为 Y 和 N。
+ ! 将字符串中对应位置的小写字符转换为大写。
+ . 指定货币和数值中小数点的位置。
+ , 分隔货币和数值中小数点左侧的数字。
+ 9 指定数值的宽度。
例如,如果 cFormatCodes 为 '999.99',则数值字符的格式为小数点左侧三个字符、右侧两个字符。
为数值指定 cFormatCodes 时,格式代码的大小必须至少与要显示的值的大小相同。
以下示例显示了格式代码缺失、小于以及等于要显示的值的大小时的结果。
+
CREATE CURSOR myCursor (col1 n(5,2))
INSERT INTO myCursor VALUES (-555.5)
@@ -12859,44 +11120,30 @@
* A format code same size as value returns -556.00
? TRANSFORM(myCursor.col1,'9999.99' )
- When the expression value is longer than the width of the numeric field, X# forces the value to fit by performing the following steps:
- Truncate decimal places and round the remaining decimal portion of the field.
- If the value does not fit, store the field contents using scientific notation.
- If the value still does not fit, replace the field contents with asterisks.
- For more information about format codes, see InputMask Property and Format Property.
- If you omit cFormatCodes, X# performs a default transformation on eExpression. The following table describes the transformation performed for each data type eExpression can assume.
- Blob
-
- Outputs character string representation of the binary value without the hexadecimal prefix. For example, the following line of code outputs the character string "FEOAF2":
+ 当表达式的值长于数值字段的宽度时,X# 会通过执行以下步骤强制该值适合字段:截断小数位并对字段中剩余的小数部分进行舍入。如果值仍然放不下,则使用科学记数法存储字段内容。如果值仍然放不下,则用星号替换字段内容。有关格式代码的更多信息,请参阅 InputMask Property 和 Format Property。如果省略 cFormatCodes,X# 会对 eExpression 执行默认转换。下表描述了对 eExpression 可能采用的每种数据类型所执行的转换。Blob 输出二进制值的字符串表示形式,不带十六进制前缀。例如,以下代码行输出字符串 "FEOAF2":
TRANSFORM(0hFE0AF2)
- For binary values, TRANSFORM( ) disregards format codes except for those that restrict width. For example, the following lines of code output "FE0A":
+ 对于二进制值,TRANSFORM( ) 会忽略格式代码,但限制宽度的格式代码除外。例如,以下代码行输出 "FE0A":
TRANSFORM(0hFE0AF2, "XXXX")
TRANSFORM(0hFE0AF2, "9999")
TRANSFORM(0hFE0AF2, "####")
- For those format codes that restrict width, the maximum output length is 255 characters.
- Character
- Performs no transformation.
- Transformation is determined by the settings specified in the Regional tab of the Options dialog box.
- Performs a DTOC( ) transformation on the date.
- Performs a TTOC( ) transformation on the date time.
- General
- Returns "Gen" if the General field contains an object or "gen" if the General field does not contain an object.
- Logical
- Transforms logical True (.T.) and False (.F.) values to the character strings ".T." and ".F." respectively.
- Memo
- Numeric (includes Double, Float, or Integer data types)
- Removes trailing zeros from the decimal portion of a numeric value when all the numbers following the decimal point are zeros.
- If the numeric value is a whole number, a decimal point is not included in the transformed value, for example, 4.0 is transformed to 4.
- If the numeric value is less than one but greater than negative one, zero is included before the decimal point, for example, .4 is transformed to 0.4.
- Object
- Returns the character string "(Object)".
- Varbinary
- For binary values, TRANSFORM( ) disregards format codes except for those that restrict width. For example, the following lines of code output "FE0A":
+ 对于限制宽度的格式代码,最大输出长度为 255 个字符。
+
+ 字符类型 不执行转换。
+ 货币类型 转换由 Options 对话框的 Regional 选项卡中指定的设置决定。
+ 日期类型 对日期执行 DTOC( ) 转换。
+ 日期时间类型 对日期时间执行 TTOC( ) 转换。
+ 通用类型 如果 General 字段包含对象,则返回 "Gen";如果 General 字段不包含对象,则返回 "gen"。
+ 逻辑类型 将逻辑 True (.T.) 和 False (.F.) 值分别转换为字符串 ".T." 和 ".F."。
+ 备注类型
+ 数值类型(包括 双精度类型、浮点类型 或 整数类型) 当小数点后的所有数字均为零时,删除数值小数部分的尾随零。
如果数值是整数,则转换后的值中不包含小数点,例如 4.0 转换为 4。
如果数值小于 1 但大于 -1,则小数点前包含零,例如 .4 转换为 0.4。
+ Object 返回字符串 "(Object)"。
+ Varbinary 对于二进制值,TRANSFORM( ) 会忽略格式代码,但限制宽度的格式代码除外。例如,以下代码行输出 "FE0A":
+
- Character data type. TRANSFORM( ) returns character string from an expression in a format determined by a format code.
+ 字符类型。TRANSFORM( ) 按格式代码确定的格式,从表达式返回字符串。
@@ -12909,27 +11156,23 @@
- Removes all trailing spaces or parsing characters from the specified character expression, or all trailing zero (0) bytes from the specified binary expression.
+ 从指定的字符表达式中删除所有尾随空格或解析字符,或从指定的二进制表达式中删除所有尾随的零 (0) 字节。
- Specifies an expression of Character or Varbinary type to remove all trailing spaces or 0 bytes from, respectively.
+ 指定 Character 或 Varbinary 类型的表达式,分别从中删除所有尾随空格或 0 字节。
- Specifies if trimming is case-sensitive when one or more parse characters (cParseChar, cParseChar2, … are included. Trimming is case-sensitive if nFlags is zero or is omitted. Trimming is case-insensitive if nFlags 1.
-
- cParseChar [, cParseChar2 [, ...]]
- Specifies one or more character strings that are trimmed from the end of cExpression. If cParseChar isn't included, then trailing spaces or 0 bytes are removed from Expression.
- Note The maximum number of strings permitted in cParseChar is 23.
+ 指定包含一个或多个解析字符(cParseChar、cParseChar2、…)时,修剪是否区分大小写。如果 nFlags 为零或被省略,则修剪区分大小写。如果 nFlags 为 1,则修剪不区分大小写。cParseChar [, cParseChar2 [, ...]] 指定从 cExpression 末尾修剪的一个或多个字符串。如果未包含 cParseChar,则从 Expression 中删除尾随空格或 0 字节。Note cParseChar 中允许的最大字符串数为 23。
- Character or Varbinary. TRIM( ) returns the specified expression without trailing spaces or parsing characters, or 0 bytes.
+ 字符类型或 Varbinary。TRIM( ) 返回不含尾随空格、解析字符或 0 字节的指定表达式。
- TRIM( ) is identical to RTRIM( ).
+ TRIM( ) 与 RTRIM( ) 完全相同。
@@ -12969,80 +11212,43 @@
- Returns the data type of an expression.
- VARTYPE( ) is similar to the TYPE( ) function, but VARTYPE( ) is faster and does not require quotation marks ("") to enclose the specified expression.
+ 返回表达式的数据类型。VARTYPE( ) 类似于 TYPE( ) 函数,但 VARTYPE( ) 速度更快,并且不需要用引号 ("") 将指定的表达式括起来。
- Specifies the expression, which can be a variable, array, field, memo field, or other expression, for which the data type is returned.
- You must pass the expression as a character string by enclosing the expression with quotation marks (""). If you do not enclose the expression with quotation marks, TYPE( ) evaluates the contents of the expression.
+ 指定要返回其数据类型的表达式,可以是变量、数组、字段、备注字段或其他表达式。必须通过用引号 ("") 将表达式括起来,将其作为字符串传入。如果不用引号将表达式括起来,TYPE( ) 会计算该表达式的内容。
- Include the optional parameter 1 to determine if cExpression is an array or a Collection Class. COM objects are not supported with the 1 parameter.
+ 包含可选参数 1 可确定 cExpression 是数组还是 Collection Class。1 参数不支持 COM 对象。
- Character. TYPE( ) returns a character representing the data type of the specified expression.
- The following table lists the character values that TYPE( ) returns and their corresponding data types.
- A
-
- Array (only returned when the optional 1 parameter is included)
-
- C
-
- Character, Varchar, Varchar (Binary)
- If the optional 1 parameter is included, a return value of C indicates that the data type is a collection.
- D
-
- Date
-
- G
-
- General
-
- L
-
- Logical
-
- M
-
- Memo
-
- N
-
- Numeric, Float, Double, or Integer
- O
- Object
- Q
-
- Varbinary
-
- S
- Screen
- The Screen type is created when using the SAVE SCREEN command. For more information, see SAVE SCREEN Command.
- T
-
- DateTime
-
- U
- Undefined type of expression or cannot evaluate expression.
- If the optional 1 parameter is included, a return value of U indicates that the data type is not an array.
- W
-
- Blob
-
- Y
-
- Currency
+ 字符类型。TYPE( ) 返回表示指定表达式数据类型的字符。下表列出了 TYPE( ) 返回的字符值及其对应的数据类型。
+
+ A Array(仅在包含可选的 1 参数时返回)
+ C 字符类型、Varchar、Varchar (Binary)
如果包含可选的 1 参数,返回值 C 表示数据类型为集合。
+ D 日期类型
+ G 通用类型
+ L 逻辑类型
+ M 备注类型
+ N 数值类型、浮点类型、双精度类型 或 整数类型
+ O Object
+ Q Varbinary
+ S Screen
使用 SAVE SCREEN 命令时会创建 Screen 类型。有关更多信息,请参阅 SAVE SCREEN Command。
+ T 日期时间类型
+ U 表达式的类型未定义或无法计算表达式。
如果包含可选的 1 参数,返回值 U 表示数据类型不是数组。
+ W Blob
+ Y 货币类型
+
- If you pass an array as a parameter to TYPE( ), the data type returned corresponds to the first element in the array. If you want to check the data type for a specific array element, you must specify that element in the parameter. For example:
+ 如果将数组作为参数传递给 TYPE( ),则返回的数据类型对应于数组中的第一个元素。如果要检查特定数组元素的数据类型,必须在参数中指定该元素。例如:
? TYPE("myarray[3]")
- You can also use the TYPE( ) function to check if a memory variable is an array. For example:
+ 也可以使用 TYPE( ) 函数检查内存变量是否为数组。例如:
? TYPE("myarray[1]")#"U"
- TYPE( ) cannot be used to evaluate UDFs (user-defined functions).
+ TYPE( ) 不能用于计算 UDF(用户定义函数)。
@@ -13065,63 +11271,54 @@
- You can use UNBINDEVENTS( ) to unbind, or detach, an event that was originally bound to a X# object using BINDEVENT( ). To detach events from Component Object Model (COM) objects, use the EVENTHANDLER( ) function. There are three versions of the syntax.
+ 可以使用 UNBINDEVENTS( ) 解除(分离)最初使用 BINDEVENT( ) 绑定到 X# 对象的事件。若要从组件对象模型 (COM) 对象分离事件,请使用 EVENTHANDLER( ) 函数。该函数有三种语法形式。
- Specifies the event source, which must be a valid X# object.
+ 指定事件源,必须是有效的 X# 对象。
- Specifies an object reference, which can be used as the event source or event handler.
+ 指定对象引用,可用作事件源或事件处理程序。
- Specifies the name of the event, method, or property you want to unbind.
+ 指定要解除绑定的事件、方法或属性的名称。
- Specifies the object that is handling the event.
+ 指定处理该事件的对象。
- Specifies the delegate method handling the event for oEventHandler.
+ 指定为 oEventHandler 处理该事件的委托方法。
- Specifies the integer handle of the window for which events are unbound.
- If hWnd is 0, all hWnds are unbound.
- If the nMessage parameter isn't included, then all Windows message bindings for the window handle hWnd are unbound.
+ 指定要解除事件绑定的窗口的整数句柄。如果 hWnd 为 0,则解除所有 hWnd 的绑定。如果未包含 nMessage 参数,则解除窗口句柄 hWnd 的所有 Windows 消息绑定。
- Specifies a valid Windows message (Win Msg) that is unbound. See MSDN (the Microsoft Developer Network) for information about Windows messages.
+ 指定要解除绑定的有效 Windows 消息 (Win Msg)。有关 Windows 消息的信息,请参阅 MSDN(Microsoft 开发人员网络)。
- Numeric data type. UNBINDEVENTS( ) returns the number of events that are unbound if unbinding succeeds. UNBINDEVENTS( ) returns a value of 0 if no events exist for unbinding. X# generates an error if UNBINDEVENTS( ) fails to unbind events that are available for unbinding.
+ 数值类型。如果解除绑定成功, UNBINDEVENTS( ) 返回已解除绑定的事件数。如果不存在可解除绑定的事件,UNBINDEVENTS( ) 返回 0。如果 UNBINDEVENTS( ) 未能解除可解除绑定的事件,X# 将生成错误。
- The following table describes the ways you can use UNBINDEVENTS( ).
-
- codeUNBINDEVENTS(oEventSource, cEvent, oEventHandler, cDelegate)/code
-
- Unbinds a specific event from an event handler.
-
- codeUNBINDEVENTS(oEventObject)/code
-
- Unbinds all events associated with this object. This includes events that are bound to it as an event source and its delegate methods that serve as event handlers.
-
- codeUNBINDEVENTS(hWnd [, nMessage])/code
-
- Unbinds all or specific Windows Message (Win Msg) events.
- If an event is occurring, and UNBINDEVENTS( ) or the delegate method handling the event is called, the event and its delegate method finish running before UNBINDEVENTS( ) unbinds the event.
- You can call the AEVENTS( ) function retrieve information about all the events and delegate methods attached to a particular object.
+ 下表描述了使用 UNBINDEVENTS( ) 的方式。
+
+ UNBINDEVENTS(oEventSource, cEvent, oEventHandler, cDelegate) 从事件处理程序解除特定事件的绑定。
+ UNBINDEVENTS(oEventObject) 解除与此对象关联的所有事件的绑定。这包括以该对象为事件源绑定的事件,以及作为事件处理程序的委托方法。
+ UNBINDEVENTS(hWnd [, nMessage]) 解除所有或特定 Windows 消息 (Win Msg) 事件的绑定。
+
+如果某个事件正在发生,并且调用了 UNBINDEVENTS( ) 或处理该事件的委托方法,则该事件及其委托方法会先运行完毕,然后 UNBINDEVENTS( ) 才会解除该事件的绑定。
+可以调用 AEVENTS( ) 函数来检索附加到特定对象的所有事件和委托方法的信息。
@@ -13146,35 +11343,29 @@
- Included for backward compatibility. Use the InteractiveChange Event or ProgrammaticChange Event instead.
-
- Returns true (.T.) if you changed any data during the most recent READ.
+ 为向后兼容而保留。请改用 InteractiveChange 事件或 ProgrammaticChange 事件。如果在最近一次 READ 期间更改了任何数据,则返回 true (.T.)。
- Return value - Logical
+ 返回值 - 逻辑类型
-
- UPDATED() returns true if the data in a field, spinner or text editing region was changed or if a choice was made from a check box; an invisible, push or radio button; a list; or a popup.
-
- UPDATED() returns false (.F.) if the data in a field, spinner or text-editing region wasn't changed or no choices were made from a check box, an invisible, push or radio button, a list, or a popup during the most recent READ. UPDATED() returns false if a control was updated from within a program (for example, with REPLACE or SHOW GETS).
-
+
如果字段、微调控件或文本编辑区域中的数据已更改,或者从复选框、不可见按钮、命令按钮或选项按钮、列表或弹出菜单中做出了选择,则 UPDATED() 返回 true。
如果在最近一次 READ 期间,字段、微调控件或文本编辑区域中的数据未更改,或者未从复选框、不可见按钮、命令按钮或选项按钮、列表或弹出菜单中做出任何选择,则 UPDATED() 返回 false (.F.)。如果控件是在程序内部更新的(例如使用 REPLACE 或 SHOW GETS),则 UPDATED() 返回 false。
- Returns the specified character expression in uppercase.
+ 返回指定字符表达式的大写形式。
- Specifies the character expression UPPER( ) converts to uppercase.
+ 指定 UPPER( ) 要转换为大写的字符表达式。
- Character
+ 字符类型
- Each lowercase letter (a – z) in the character expression is converted to uppercase (A – Z) in the returned string. This is true for high-ASCII characters as well, even if the current font does not display them as lowercase accented characters.
+ 字符表达式中的每个小写字母 (a – z) 都会在返回的字符串中转换为大写字母 (A – Z)。对于高位 ASCII 字符也是如此,即使当前字体不将它们显示为带重音符号的小写字符。
@@ -13185,13 +11376,13 @@
- Determines if an alias is in use or a table is open in a specific work area.
+ 确定别名是否正在使用,或者表是否已在特定工作区中打开。
- Logical
+ 逻辑类型
- USED( ) can determine if an alias is in use or if a table is open in a specific work area.
+ USED( ) 可以确定别名是否正在使用,或者表是否已在特定工作区中打开。
@@ -13211,15 +11402,14 @@
- Returns a numeric or currency value from a character expression composed of numbers. You can use VAL( ) to convert the character strings returned by the X# SYS( ) functions to numeric values.
+ 从由数字组成的字符表达式返回数值或货币值。可以使用 VAL( ) 将 X# SYS( ) 函数返回的字符串转换为数值。
- Specifies a character expression composed of up to 16 numbers. Rounding occurs if more than 16 numbers are included in cExpression.
- If the first character of cExpression is a dollar sign ($),VAL( ) returns a currency value. In all other situations VAL( ) returns a numeric value.
+ 指定由最多 16 个数字组成的字符表达式。如果 cExpression 中包含的数字超过 16 个,则会进行舍入。如果 cExpression 的第一个字符是美元符号 ($),VAL( ) 返回货币值。在所有其他情况下,VAL( ) 返回数值。
- Numeric or Currency data type. VAL( ) returns the numbers in the character expression from left to right until a non-numeric character is encountered. Leading blanks are ignored. VAL( ) returns 0 if the first character of the character expression is not a number, a dollar sign ($), a plus sign (+), or minus sign (-). You can control the result of VAL( ) by issuing the SET DECIMALS command before using the VAL( ) function.
+ 数值或货币类型。VAL( ) 从左到右返回字符表达式中的数字,直到遇到非数字字符为止。前导空格将被忽略。如果字符表达式的第一个字符不是数字、美元符号 ($)、加号 (+) 或减号 (-),VAL( ) 返回 0。可以在使用 VAL( ) 函数之前发出 SET DECIMALS 命令来控制 VAL( ) 的结果。
@@ -13234,21 +11424,13 @@
- Included for backward compatibility in X#. Use the ControlSource Property or Name Property (X#) instead.
-
- Returns in uppercase the name of the memory variable, array element, or field used to create the current @ ... GET field or control.
+ 在 X# 中为向后兼容而保留。请改用 ControlSource 属性或 Name 属性 (X#)。以大写形式返回用于创建当前 @ ... GET 字段或控件的内存变量、数组元素或字段的名称。
- Return value - Character
+ 返回值 - 字符类型
-
- Controls include check boxes, fields, invisible, push or radio buttons, lists, popups, spinners, and text-editing regions.
-
- If a Browse, Change or Edit window is active, the name of the current field is returned with the first letter of the field name capitalized.
-
- VARREAD() is identical to SYS(18). Both can be used to pass the current field or control name to a procedure that in turn can provide context-sensitive help, as in the following example.
-
+
控件包括复选框、字段、不可见按钮、命令按钮或选项按钮、列表、弹出菜单、微调控件和文本编辑区域。
如果 Browse、Change 或 Edit 窗口处于活动状态,则返回当前字段的名称,且字段名称的首字母大写。
VARREAD() 与 SYS(18) 相同。两者都可用于将当前字段或控件名称传递给某个过程,该过程进而可以提供上下文相关的帮助,如下例所示。
@@ -13308,43 +11490,44 @@
- Returns information about the X# version you are using.
+ 返回有关所用 X# 版本的信息。
- Specifies that VERSION( ) returns additional information about X#. If you omit nExpression, VERSION( ) returns the X# version number.
- The following table lists values for nExpression and the additional X# information returned.
- 1
- X# date and serial number.
- 2
- X# version type:
- 0 - Run time version
- 1 - Standard Edition (earlier versions)
- 2 - Professional Edition (earlier versions)
- 3
- Localized X# language. The following two character values indicate the language for which X# is localized:
- 00 - English
- 07 - Russian
- 33 - French
- 34 - Spanish
- 39 - Czech
- 48 - German
- 55 - Korean 42 - Czechbr49 - Germanbr82 - Korean
- 86 - Simplified Chinese
- 88 - Traditional Chinese
- The X# version number in a standard, easily parsed format.
- For versions prior to X# 8.0, the standard format is "MM.mm.0000.DDDD" where MM is the major release number, mm is the incremental minor revision number, 0000 is a fixed placeholder, and DDDD is the four digit product date for the day the version was created.
- For X# 8.0, the formula for calculating the product date, DDDD, is 8000 + number of days since the beginning of 1998. For example, 8397 corresponds to February 1, 1999.
- For X# 9.0, the formula for calculating the product date, DDDD, is number of months since January 1, 2003 concatenated with the day of the current month. For example, 2215 corresponds to October 15, 2004.
- The format for X# 8.0 and 9.0 is "MM.mm.0000.NNNN" where MM is the major release number, mm is the incremental minor revision number, 0000 is a fixed placeholder, and NNNN is the build number.
- The X# release version in the format Mmm where M is the major release number and mm is the incremental minor revision number. For example, VERSION(5) returns 700 in X# 7.0.
-
-
- Character, Numeric
-
-
- Use VERSION( ) to conditionally execute version-specific portions of code.
- VERSION( ), VERSION(1), VERSION(3), and VERSION(4) return character strings; VERSION(2) and VERSION(5) return numeric values.
+ 指定 VERSION( ) 返回有关 X# 的附加信息。如果省略 nExpression,VERSION( ) 返回 X# 版本号。下表列出了 nExpression 的值以及返回的附加 X# 信息。
+
+ nExpression 返回的信息
+ 1 X# 日期和序列号。
+ 2 X# 版本类型:
+
+ 0 运行时版本
+ 1 标准版(早期版本)
+ 2 专业版(早期版本)
+
+ 3 本地化的 X# 语言。以下两个字符值表示 X# 本地化所使用的语言:
+
+ 00 英语
+ 07 俄语
+ 33 法语
+ 34 西班牙语
+ 39 捷克语
+ 48 德语
+ 55 朝鲜语
+ 42 捷克语
+ 49 德语
+ 82 朝鲜语
+ 86 简体中文
+ 88 繁体中文
+
+ 4 采用标准、易于解析格式的 X# 版本号。
对于 X# 8.0 之前的版本,标准格式为 "MM.mm.0000.DDDD",其中 MM 是主版本号,mm 是递增的次版本号,0000 是固定占位符,DDDD 是创建该版本当天的四位产品日期。
对于 X# 8.0,计算产品日期 DDDD 的公式为 8000 加上自 1998 年初以来的天数。例如,8397 对应于 1999 年 2 月 1 日。
对于 X# 9.0,计算产品日期 DDDD 的公式为自 2003 年 1 月 1 日以来的月数,后接当月的日期。例如,2215 对应于 2004 年 10 月 15 日。
X# 8.0 和 9.0 的格式为 "MM.mm.0000.NNNN",其中 MM 是主版本号,mm 是递增的次版本号,0000 是固定占位符,NNNN 是内部版本号。
+ 5 格式为 Mmm 的 X# 发行版本,其中 M 是主版本号,mm 是递增的次版本号。例如,在 X# 7.0 中 VERSION(5) 返回 700。
+
+
+
+ 字符类型、数值类型
+
+
+ 使用 VERSION( ) 可以有条件地执行特定于版本的代码部分。VERSION( )、VERSION(1)、VERSION(3) 和 VERSION(4) 返回字符串;VERSION(2) 和 VERSION(5) 返回数值。
@@ -13360,63 +11543,52 @@
- Determines whether the active or specified window has a border.
+ 确定活动窗口或指定窗口是否有边框。
- Specifies the name of the window for which WBORDER( ) returns a logical value.
- WBORDER( ) returns a logical value for the active output window if you omit a window name.
+ 指定 WBORDER( ) 要为其返回逻辑值的窗口名称。如果省略窗口名称,WBORDER( ) 将为活动输出窗口返回逻辑值。
- Logical
+ 逻辑类型
- WBORDER( ) returns true (.T.) if the specified window has a border; otherwise WBORDER( ) returns false (.F.). By default, windows have borders. Include the NONE clause in DEFINE WINDOW to create a window without a border.
+ 如果指定窗口有边框,WBORDER( ) 返回 true (.T.);否则返回 false (.F.)。默认情况下,窗口有边框。在 DEFINE WINDOW 中包含 NONE 子句可创建无边框的窗口。
- Returns either the number of child windows in a parent window or the names of the child windows in the order in which they are stacked in the parent window.
+ 返回父窗口中的子窗口数量,或按子窗口在父窗口中的堆叠顺序返回子窗口的名称。
- Specifies a window other than the active output window for which WCHILD( ) returns the number of child windows. The number of child windows in the specified window is returned if you include just a window name without the numeric expression nChildWindow.
- If you include both WindowName and nChildWindow, WCHILD( ) returns the names of the child windows in the specified window. If you include both WindowName and nChildWindow, separate WindowName and nChildWindow with a comma.
- You can also include the empty string in WindowName to specify the main X# window.
+ 指定活动输出窗口以外的窗口,WCHILD( ) 将返回该窗口中的子窗口数量。如果只包含窗口名称而不包含数值表达式 nChildWindow,则返回指定窗口中的子窗口数量。如果同时包含 WindowName 和 nChildWindow,则 WCHILD( ) 返回指定窗口中子窗口的名称。如果同时包含 WindowName 和 nChildWindow,请用逗号分隔 WindowName 和 nChildWindow。也可以在 WindowName 中包含空字符串来指定 X# 主窗口。
- Specifies a numeric expression included to return the names of child windows in the active output window when you omit WindowName.
- The numeric expression nChildWindow can be 0 or any positive value. The name of the child window at the bottom of the stack of child windows in the current output window is returned if nChildWindow is 0.
- If nChildWindow is a positive number, WCHILD( ) returns the name of the next child window in the window stack. The name of next child window in the stack is returned if you issue WCHILD( ) again with a positive number, and so on. The empty string is returned if WCHILD( ) is called more times than the number of child windows in the parent window. For more information on window stacking, see ACTIVATE WINDOW.
- In X# for Windows, if the main X# window is active, all windows are children of the main X# window. In X#, toolbars that are not docked in the border of the main X# window are children of the main X# window. Issuing a series of WCHILD() functions with positive numbers returns the names of the active windows and toolbars.
- If you include both WindowName and nChildWindow, separate WindowName and nChildWindow with a comma.
+ 指定一个数值表达式,在省略 WindowName 时用于返回活动输出窗口中子窗口的名称。数值表达式 nChildWindow 可以是 0 或任何正值。如果 nChildWindow 为 0,则返回当前输出窗口中子窗口堆栈底部的子窗口名称。如果 nChildWindow 为正数,WCHILD( ) 返回窗口堆栈中下一个子窗口的名称。如果再次使用正数发出 WCHILD( ),则返回堆栈中下一个子窗口的名称,依此类推。如果调用 WCHILD( ) 的次数超过父窗口中的子窗口数量,则返回空字符串。有关窗口堆叠的更多信息,请参阅 ACTIVATE WINDOW。在 X# for Windows 中,如果 X# 主窗口处于活动状态,则所有窗口都是 X# 主窗口的子窗口。在 X# 中,未停靠在 X# 主窗口边框中的工具栏是 X# 主窗口的子窗口。使用正数连续发出一系列 WCHILD() 函数,将返回活动窗口和工具栏的名称。如果同时包含 WindowName 和 nChildWindow,请用逗号分隔 WindowName 和 nChildWindow。
- Character or Numeric
+ 字符类型或数值类型
- You can create a window (the parent window) and place other windows (child windows) inside. Including the IN or IN WINDOW clause in DEFINE WINDOW creates a child window inside the parent window. A child window created and activated inside a parent window cannot be moved outside the parent window. If the parent window is moved, the child window moves with it.
- The number of child windows in the active output window is returned if you issue WCHILD( ) without any arguments.
+ 可以创建一个窗口(父窗口)并在其中放置其他窗口(子窗口)。在 DEFINE WINDOW 中包含 IN 或 IN WINDOW 子句可在父窗口内创建子窗口。在父窗口内创建并激活的子窗口不能移动到父窗口之外。如果移动父窗口,子窗口也随之移动。如果不带任何参数发出 WCHILD( ),则返回活动输出窗口中的子窗口数量。
- Returns the number of columns within the active or specified window.
+ 返回活动窗口或指定窗口中的列数。
- Specifies the window for which WCOLS( ) returns the number of columns. In X#, you can also specify the name of a toolbar. If you do not specify a window, the number of columns in the active output window is returned. If no window is active, WCOLS( ) returns the number of columns in the main X# window.
- You can specify the name of a system window (the Command window, the Data Session window, a Browse window, and so on) in WCOLS( ) if the system window has been activated and is visible or hidden. In X#, you can specify the name of a toolbar (the Standard toolbar, the Color Palette toolbar, and so on) in WCOLS( ) if the toolbar has been activated and is visible or hidden. If you specify the name of a system window or toolbar that has not been activated, X# generates an error message. The Debug window is an exception. Once the Debug window has been opened, its name can be included in WCOLS( ) if it is visible, hidden or closed.
- You can also include the empty string as the window name to return the number of columns in the main X# window.
- The empty string can be used to specify the main X# window in functions such as WLCOL( ), WLROW( ), and WROWS( ), which return window locations or sizes.
+ 指定 WCOLS( ) 要返回其列数的窗口。在 X# 中,也可以指定工具栏的名称。如果未指定窗口,则返回活动输出窗口中的列数。如果没有活动窗口,WCOLS( ) 返回 X# 主窗口中的列数。如果系统窗口(命令窗口、数据会话窗口、Browse 窗口等)已激活且处于可见或隐藏状态,则可以在 WCOLS( ) 中指定该系统窗口的名称。在 X# 中,如果工具栏(标准工具栏、调色板工具栏等)已激活且处于可见或隐藏状态,则可以在 WCOLS( ) 中指定该工具栏的名称。如果指定的系统窗口或工具栏尚未激活,X# 将生成错误消息。调试窗口是一个例外。调试窗口一旦打开,只要它处于可见、隐藏或关闭状态,就可以在 WCOLS( ) 中包含其名称。也可以将空字符串作为窗口名称,以返回 X# 主窗口中的列数。在 WLCOL( )、WLROW( ) 和 WROWS( ) 等返回窗口位置或大小的函数中,也可以使用空字符串来指定 X# 主窗口。
- Numeric
+ 数值类型
- In X#, the value returned by WCOLS( ) depends on the font specified for the window. Many fonts can be displayed in a wide variety of sizes, and some are proportionally spaced. A column corresponds to the average width of a letter in the current font. For more information, see the Fonts Overview topic.
+ 在 X# 中,WCOLS( ) 返回的值取决于为窗口指定的字体。许多字体可以以多种大小显示,有些字体是比例间距的。一列对应于当前字体中字母的平均宽度。有关更多信息,请参阅“字体概述”主题。
@@ -13433,22 +11605,22 @@
- Returns the dockable state of the specified window
+ 返回指定窗口的可停靠状态
- Specifies the name of the window to evaluate.
+ 指定要计算的窗口的名称。
- Specifies the dockable state for the window specified with the cWindowName parameter. If the specified window does not support docking, then X# ignores the lEnable parameter.
+ 指定由 cWindowName 参数指定的窗口的可停靠状态。如果指定的窗口不支持停靠,则 X# 将忽略 lEnable 参数。
- Logical data type. Returns the current dockable state for the specified window.
+ 逻辑类型。返回指定窗口的当前可停靠状态。
- The WDOCKABLE( ) function always returns False (.F.) for undockable windows. Use the WDOCKABLE( ) function on X# windows that support docking. For a list of dockable X# windows, see How to: Dock Windows.
+ 对于不可停靠的窗口,WDOCKABLE( ) 函数始终返回 False (.F.)。请对支持停靠的 X# 窗口使用 WDOCKABLE( ) 函数。有关可停靠的 X# 窗口的列表,请参阅“如何:停靠窗口”。
@@ -13567,19 +11739,17 @@
- Determines whether the specified user-defined window exists.
+ 确定指定的用户定义窗口是否存在。
- Specifies the name of the user-defined window.
- You can also specify the name of a X# system window (the Command window, the Data Session window, a Browse window, and so on), and in X#, the name of a toolbar. WEXIST( ) returns true (.T.) if the system window or toolbar you specify is visible or hidden. WEXIST( ) returns false (.F.) if the specified system window or toolbar is closed.
- Two exceptions are the Command and Debug windows. Including the Command window's name in WEXIST( ) always returns a true value. If the Debug window has been opened, WEXIST( ) returns true, even if the Debug window is closed.
+ 指定用户定义窗口的名称。也可以指定 X# 系统窗口(命令窗口、数据会话窗口、Browse 窗口等)的名称,在 X# 中还可以指定工具栏的名称。如果指定的系统窗口或工具栏处于可见或隐藏状态,WEXIST( ) 返回 true (.T.)。如果指定的系统窗口或工具栏已关闭,WEXIST( ) 返回 false (.F.)。命令窗口和调试窗口是两个例外。在 WEXIST( ) 中包含命令窗口的名称始终返回 true。如果调试窗口已打开过,即使调试窗口已关闭,WEXIST( ) 也返回 true。
- Logical
+ 逻辑类型
- WEXIST( ) returns true (.T.) if the user-defined window you specify has been created with DEFINE WINDOW; otherwise WEXIST( ) returns false (.F.). The specified window does not have to be active or visible for WEXIST( ) to return true (.T.), but it must exist.
+ 如果指定的用户定义窗口已使用 DEFINE WINDOW 创建,WEXIST( ) 返回 true (.T.);否则 WEXIST( ) 返回 false (.F.)。指定的窗口不必处于活动或可见状态,WEXIST( ) 即可返回 true (.T.),但它必须存在。
@@ -13596,37 +11766,29 @@
- Returns the name, size, or style of the current font for a window in X# for Windows.
+ 返回 X# for Windows 中窗口当前字体的名称、大小或样式。
- Specifies the font attribute you want to return.
- If nFontAttribute is 1, WFONT( ) returns the name of the current font for the active or specified window.
- If nFontAttribute is 2, WFONT( ) returns the font size.
- If nFontAttribute is 3, WFONT( ) returns a code that identifies the font style.
- The font style code is a character or set of characters that correspond to the current font style. For example, the current font style is Bold Italic if WFONT(3) returns BI.
- The following table lists the codes for each font style:
- Normal
- Outline
- Q
- Opaque
- Shadow
- –
- StrikeThru
- Transparent
- U
- Underline
+ 指定要返回的字体属性。如果 nFontAttribute 为 1,WFONT( ) 返回活动窗口或指定窗口的当前字体名称。如果 nFontAttribute 为 2,WFONT( ) 返回字体大小。如果 nFontAttribute 为 3,WFONT( ) 返回标识字体样式的代码。字体样式代码是与当前字体样式对应的一个或一组字符。例如,如果 WFONT(3) 返回 BI,则当前字体样式为粗斜体。下表列出了各字体样式的代码:
+
+ 代码 字体样式
+ N Normal
+ O Outline
+ Q Opaque
+ S Shadow
+ – StrikeThru
+ T Transparent
+ U Underline
+
- Specifies the name of the window for which you want to determine the current font, font size, or font style. In X#, you can also include the name of a toolbar. Include the empty string to return the current font, font size, or font style for the main X# window.
- WindowName can be the name of a user-defined window created with DEFINE WINDOW or a text- or memo-editing window.
- You can also include the name of a system window (View, Trace, Debug, and so on). WFONT( ) can return font attributes only for a system window that has been opened and is currently visible or hidden. If the system window you specify is closed, X# generates an error message.
- WFONT( ) returns the current font, font size or font style for the active output window if you omit WindowName.
+ 指定要确定其当前字体、字体大小或字体样式的窗口的名称。在 X# 中,也可以包含工具栏的名称。包含空字符串可返回 X# 主窗口的当前字体、字体大小或字体样式。WindowName 可以是使用 DEFINE WINDOW 创建的用户定义窗口的名称,也可以是文本或备注编辑窗口的名称。也可以包含系统窗口(View、Trace、Debug 等)的名称。WFONT( ) 只能返回已打开且当前处于可见或隐藏状态的系统窗口的字体属性。如果指定的系统窗口已关闭,X# 将生成错误消息。如果省略 WindowName,WFONT( ) 返回活动输出窗口的当前字体、字体大小或字体样式。
- Character and Numeric
+ 字符类型和数值类型
@@ -13655,15 +11817,13 @@
- Determines the active output window.
+ 确定活动输出窗口。
- Character.
+ 字符类型
- WINDOW( ) returns the name of the window to which output is currently directed./Pbr
- WINDOW( ) returns the empty string if output is being directed to the main X# window.
- This function is included for backward compatibility. You may use the WOUTPUT( ) function instead.
+ WINDOW( ) 返回当前输出所定向到的窗口的名称。/Pbr WINDOW( ) 在输出被定向到 X# 主窗口时返回空字符串。此函数为向后兼容而保留。可以改用 WOUTPUT( ) 函数。
@@ -13683,104 +11843,89 @@
- Returns the name of the window that was active prior to the current window or determines whether the specified window was active prior to the current window.
+ 返回当前窗口之前处于活动状态的窗口的名称,或确定指定窗口在当前窗口之前是否处于活动状态。
- Specifies a window that WLAST( ) evaluates. In X#, you can also specify the name of a toolbar. WLAST( ) returns true (.T.) if the specified window was active prior to the current window; otherwise false (.F.) is returned. False (.F.) is also returned if the window you specify doesn't exist.
- The name of the window that was active prior to the current window is returned if you omit WindowName.
+ 指定 WLAST( ) 要计算的窗口。在 X# 中,也可以指定工具栏的名称。如果指定的窗口在当前窗口之前处于活动状态,WLAST( ) 返回 true (.T.);否则返回 false (.F.)。如果指定的窗口不存在,也返回 false (.F.)。如果省略 WindowName,则返回当前窗口之前处于活动状态的窗口的名称。
- Character or Logical
+ 字符类型或逻辑类型
- WLAST( ) returns the empty string if the window that was active prior to the current window is the Debug, Trace, or Command window. Program execution isn't affected by bringing these windows forward when you are debugging a program that uses WLAST( ).
+ 如果当前窗口之前处于活动状态的窗口是调试窗口、跟踪窗口或命令窗口,WLAST( ) 返回空字符串。在调试使用 WLAST( ) 的程序时,将这些窗口置于前台不会影响程序的执行。
- Returns the column coordinate of the upper-left corner of the active or specified window.
+ 返回活动窗口或指定窗口左上角的列坐标。
- Specifies the window for which WLCOL( ) returns the column coordinate. In X#, you can also specify the name of a toolbar. If you omit WindowName, WLCOLS( ) returns the column coordinate of the active output window. You can also use the empty string for WindowName to specify the main X# window.
- In X#, if no window is active, WLCOLS( ) returns the column coordinate of the main X# window relative to the Windows desktop.
- If a system window (the Command window, the Data Session window, a Browse window, and so on) has been opened and is visible or hidden (its name appears on the Window menu), you can include its name in WLCOL( ). If you specify the name of a system window that is closed, X# generates an error message. The Debug window is an exception. Once the Debug window has been opened, its name can be included in WLCOL( ) if it is visible, hidden, or closed.
+ 指定 WLCOL( ) 要返回其列坐标的窗口。在 X# 中,也可以指定工具栏的名称。如果省略 WindowName,WLCOLS( ) 返回活动输出窗口的列坐标。也可以对 WindowName 使用空字符串来指定 X# 主窗口。在 X# 中,如果没有活动窗口,WLCOLS( ) 返回 X# 主窗口相对于 Windows 桌面的列坐标。如果系统窗口(命令窗口、数据会话窗口、Browse 窗口等)已打开且处于可见或隐藏状态(其名称出现在“窗口”菜单中),则可以在 WLCOL( ) 中包含其名称。如果指定已关闭的系统窗口的名称,X# 将生成错误消息。调试窗口是一个例外。调试窗口一旦打开,只要它处于可见、隐藏或关闭状态,就可以在 WLCOL( ) 中包含其名称。
- Numeric
+ 数值类型
- The value returned by WLCOL( ) depends on the current video display mode, and is relative to the main X# window. The display mode can be changed with SET DISPLAY.
- Windows can be positioned outside the main X# window. If the specified window is to the left of the main X# window, WCOL( ) returns a negative value. If the window's left border is to the right of the main X# window, WCOL( ) returns a positive value greater than the width of the main X# window.
+ WLCOL( ) 返回的值取决于当前的视频显示模式,并且相对于 X# 主窗口。可以使用 SET DISPLAY 更改显示模式。窗口可以定位在 X# 主窗口之外。如果指定的窗口位于 X# 主窗口的左侧,WCOL( ) 返回负值。如果窗口的左边框位于 X# 主窗口的右侧,WCOL( ) 返回大于 X# 主窗口宽度的正值。
- Returns the row coordinate of the upper-left corner of the active or specified window.
+ 返回活动窗口或指定窗口左上角的行坐标。
- Specifies the window for which WLROW( ) returns the row coordinate. In X#, you can also specify the name of a toolbar. If you omit WindowName, WLROW( ) returns the row coordinate of the active output window. You can also use the empty string for WindowName to specify the main X# window.
- In X#, if no window is active, WLROW( ) returns the row coordinate of the main X# window relative to the Windows desktop.
- If a system window (the Command window, the Data Session window, a Browse window, and so on) has been opened and is visible or hidden (its name appears on the Window menu), you can include its name in WLROW( ). If you specify the name of a system window that is closed, X# generates an error message. The Debug window is an exception. Once the Debug window has been opened, its name can be included in WLROW( ) if it is visible, hidden, or closed.
+ 指定 WLROW( ) 要返回其行坐标的窗口。在 X# 中,也可以指定工具栏的名称。如果省略 WindowName,WLROW( ) 返回活动输出窗口的行坐标。也可以对 WindowName 使用空字符串来指定 X# 主窗口。在 X# 中,如果没有活动窗口,WLROW( ) 返回 X# 主窗口相对于 Windows 桌面的行坐标。如果系统窗口(命令窗口、数据会话窗口、Browse 窗口等)已打开且处于可见或隐藏状态(其名称出现在“窗口”菜单中),则可以在 WLROW( ) 中包含其名称。如果指定已关闭的系统窗口的名称,X# 将生成错误消息。调试窗口是一个例外。调试窗口一旦打开,只要它处于可见、隐藏或关闭状态,就可以在 WLROW( ) 中包含其名称。
- Numeric
+ 数值类型
- The value returned by WLROW( ) depends on the current video display mode, and the row coordinate is relative to the main X# window. The display mode can be changed with SET DISPLAY.
- Windows can be positioned off the main X# window. If the top of the window is above the main X# window, WLROW( ) returns a negative value. If the top of the window is below the bottom of the main X# window, WLROW( ) returns a positive value greater than the height of the main X# window.
+ WLROW( ) 返回的值取决于当前的视频显示模式,且行坐标相对于 X# 主窗口。可以使用 SET DISPLAY 更改显示模式。窗口可以放置在 X# 主窗口之外。如果窗口顶部位于 X# 主窗口上方,WLROW( ) 返回负值。如果窗口顶部位于 X# 主窗口底部下方,WLROW( ) 返回大于 X# 主窗口高度的正值。
- Determines whether the active or specified window is maximized.
+ 确定活动窗口或指定窗口是否已最大化。
- Specifies the name of the window WMAXIMUM( ) evaluates. You can specify the name of a X# system window (the Command window, the Data Session window, a Browse window, and so on).
- If you omit WindowName, WMAXIMUM( ) returns a logical value for the active window. You can also use the empty string for WindowName to specify the main X# window.
+ 指定 WMAXIMUM( ) 要计算的窗口的名称。可以指定 X# 系统窗口的名称(命令窗口、数据工作期窗口、浏览窗口等)。如果省略 WindowName,WMAXIMUM( ) 返回活动窗口的逻辑值。也可以将空字符串用作 WindowName 来指定 X# 主窗口。
- Windows can be enlarged to fill the window that contains them. In X# for Windows, the default container window is the main window.
- A user-defined window created with DEFINE WINDOW can be maximized only if the ZOOM keyword is included in its definition.
- WMAXIMUM( ) returns true (.T.) if the current or specified window is maximized; otherwise WMAXIMUM( ) returns false (.F.). In X#, you can include the name of a toolbar. However, WMAXIMUM( ) always returns false (.F.) for a toolbar because toolbars cannot be maximized.
+ 窗口可以放大以填满包含它们的窗口。在 X# for Windows 中,默认的容器窗口是主窗口。使用 DEFINE WINDOW 创建的用户自定义窗口,只有在其定义中包含 ZOOM 关键字时才能最大化。如果当前窗口或指定窗口已最大化,WMAXIMUM( ) 返回 true (.T.);否则返回 false (.F.)。在 X# 中,可以包含工具栏的名称。但是,对于工具栏,WMAXIMUM( ) 始终返回 false (.F.),因为工具栏无法最大化。
- Determines whether the active or specified window is minimized.
+ 确定活动窗口或指定窗口是否已最小化。
- Specifies the name of the window WMINIMUM( ) evaluates. You can specify the name of a X# system window (the Command window, the Data Session window, a Browse window, and so on).
- If you omit WindowName, WMINIMUM( ) returns a logical value for the active window. You can also include the empty string in WindowName to specify the main X# window.
+ 指定 WMINIMUM( ) 要计算的窗口的名称。可以指定 X# 系统窗口的名称(命令窗口、数据工作期窗口、浏览窗口等)。如果省略 WindowName,WMINIMUM( ) 返回活动窗口的逻辑值。也可以在 WindowName 中使用空字符串来指定 X# 主窗口。
- Logical
+ 逻辑类型
- In X# for Windows, windows can be reduced to an icon.
- A user-defined window created with DEFINE WINDOW can be minimized only if the MINIMIZE keyword is included in its definition.
- WMINIMUM( ) returns true (.T.) if the current or specified window is minimized; otherwise it returns false (.F.). In X#, you can include the name of a toolbar. However, WMINIMUM( ) always returns false (.F.) for a toolbar because toolbars cannot be minimized.
+ 在 X# for Windows 中,窗口可以缩小为图标。使用 DEFINE WINDOW 创建的用户自定义窗口,只有在其定义中包含 MINIMIZE 关键字时才能最小化。如果当前窗口或指定窗口已最小化,WMINIMUM( ) 返回 true (.T.);否则返回 false (.F.)。在 X# 中,可以包含工具栏的名称。但是,对于工具栏,WMINIMUM( ) 始终返回 false (.F.),因为工具栏无法最小化。
- Determines whether the active or specified window is in front of all other windows.
+ 确定活动窗口或指定窗口是否位于所有其他窗口的前面。
- Specifies the name of the window WONTOP( ) evaluates. You can specify the name of a user-defined window created with DEFINE WINDOW or a system window (the Command window, the Data Session window, a Browse window, and so on). If you omit WindowName, WONTOP( ) returns the name of the "frontmost" or active window. You can also include the empty string in WindowName to specify the main X# window.
- If the Debug, Trace, or Command window is active and you don't specify a window name, WONTOP( ) returns the name of the window most recently in front. When you are debugging a program that uses WONTOP( ), program execution isn't affected by bringing these windows forward.
+ 指定 WONTOP( ) 要计算的窗口的名称。可以指定使用 DEFINE WINDOW 创建的用户自定义窗口的名称,或系统窗口(命令窗口、数据工作期窗口、浏览窗口等)的名称。如果省略 WindowName,WONTOP( ) 返回“最前面”的窗口或活动窗口的名称。也可以在 WindowName 中使用空字符串来指定 X# 主窗口。如果调试窗口、跟踪窗口或命令窗口处于活动状态,且未指定窗口名称,WONTOP( ) 返回最近位于最前面的窗口的名称。调试使用 WONTOP( ) 的程序时,将这些窗口置于前面不会影响程序的执行。
- Character or Logical
+ 字符类型或逻辑类型
- WONTOP( ) returns true (.T.) if the specified window is active. It returns false (.F.) if the window isn't active or doesn't exist.
- Historically in prior versions of X#, the Data Session window has always been referred to as the View window. Additionally, language used to control this window, such as HIDE WINDOW, ACTIVATE WINDOW, WONTOP( ), also refers to this window as the View window. X# continues to refer to the View window for the WONTOP( ) function.
+ 如果指定窗口处于活动状态,WONTOP( ) 返回 true (.T.)。如果窗口不是活动窗口或不存在,则返回 false (.F.)。在以往的 X# 版本中,数据工作期窗口一直被称为“视图”窗口(View window)。此外,用于控制该窗口的语言,例如 HIDE WINDOW、ACTIVATE WINDOW、WONTOP( ),也将该窗口称为视图窗口。对于 WONTOP( ) 函数,X# 继续使用视图窗口这一称呼。
@@ -13794,18 +11939,17 @@
- Determines whether output is being directed to the active or specified window.
+ 确定输出是否被定向到活动窗口或指定窗口。
- Specifies the window WOUTPUT( ) evaluates for output. Output cannot be directed to a system window or toolbar. If you omit WindowName, WOUTPUT( ) returns the name of the window to which output is currently directed. You can also include the empty string in WindowName to specify the main X# window.
- WOUTPUT( ) returns the empty string if output is being directed to the main X# window.
+ 指定 WOUTPUT( ) 要计算其输出的窗口。输出不能被定向到系统窗口或工具栏。如果省略 WindowName,WOUTPUT( ) 返回当前输出所定向到的窗口的名称。也可以在 WindowName 中使用空字符串来指定 X# 主窗口。如果输出被定向到 X# 主窗口,WOUTPUT( ) 返回空字符串。
- Logical and Character
+ 逻辑类型和字符类型
- WOUTPUT( ) returns true (.T.) if the specified user-defined window is the active output window. WOUTPUT( ) returns false (.F.) if the window you specify doesn't exist or is a system window. The last user-defined window activated with ACTIVATE WINDOW is the active output window.
+ 如果指定的用户自定义窗口是活动输出窗口,WOUTPUT( ) 返回 true (.T.)。如果指定的窗口不存在或是系统窗口,WOUTPUT( ) 返回 false (.F.)。使用 ACTIVATE WINDOW 激活的最后一个用户自定义窗口是活动输出窗口。
@@ -13823,17 +11967,17 @@
- Returns the name of the parent window of the active or specified window.
+ 返回活动窗口或指定窗口的父窗口的名称。
- Specifies a window whose parent window name WPARENT( ) returns. WPARENT( ) returns the empty string if the specified window doesn't have a parent window. If you omit WindowName, WPARENT( ) returns the name of the parent window of the active output window. WPARENT( ) returns the empty string if the active output window doesn't have a parent window.
+ 指定要返回其父窗口名称的窗口。如果指定的窗口没有父窗口,WPARENT( ) 返回空字符串。如果省略 WindowName,WPARENT( ) 返回活动输出窗口的父窗口的名称。如果活动输出窗口没有父窗口,WPARENT( ) 返回空字符串。
- Character
+ 字符类型
- You can use DEFINE WINDOW to create a window and place it in a parent window. The child window becomes integrated with its parent window. For example, a child window defined and activated inside a parent window can't be moved outside the parent window. If the parent window is moved, the child window moves with it.
+ 可以使用 DEFINE WINDOW 创建窗口并将其放置在父窗口中。子窗口与其父窗口集成在一起。例如,在父窗口内定义并激活的子窗口不能移动到父窗口之外。如果父窗口被移动,子窗口也随之移动。
@@ -13856,93 +12000,73 @@
- Included for backward compatibility. Use the Form Designer instead.
- Determines whether or not the current or specified window is involved in the current READ.
+ 为向后兼容而保留。请改用窗体设计器。确定当前窗口或指定窗口是否参与当前的 READ。
- Return value - Logical
+ 返回值 - 逻辑类型
-
- WREAD() returns true (.T.) if the specified window is participating in the current READ; false (.F.) is returned if the specified window isn't involved in the current READ or doesn't exist.
-
- You can have a window participate in a READ by:
-
- ulliIncluding the window's title in the READ WITH clause. Windows that typically aren't involved in a READ can participate in this way. Browse windows, memo- and text-editing windows, FoxPro system windows, and so on can participate in a READ./li
- liCreating a control in the window. A READ can span multiple windows if you create controls in multiple windows and then issue READ. /li/ul
+
如果指定窗口参与当前的 READ,WREAD() 返回 true (.T.);如果指定窗口未参与当前的 READ 或不存在,则返回 false (.F.)。
可以通过以下方式使窗口参与 READ:
+
+ 将窗口的标题包含在 READ WITH 子句中。通常不参与 READ 的窗口可以通过这种方式参与。浏览窗口、备注和文本编辑窗口、FoxPro 系统窗口等都可以参与 READ。
+ 在窗口中创建控件。如果在多个窗口中创建控件然后发出 READ,则 READ 可以跨越多个窗口。
+
- Returns the number of rows within the active or specified window.
+ 返回活动窗口或指定窗口内的行数。
- Specifies the window for which WROWS( ) returns the number of rows. In X#, you can also specify the name of a toolbar.
- In X#, the value returned by WROWS( ) depends on the font specified for the window. Most fonts can be displayed in a wide variety of sizes, and some are proportionally spaced. A row corresponds to the height of the current font. For more information, see the Fonts Overview topic.
- You can specify the name of a system window (the Command window, the Data Session window, a Browse window, and so on) in WROWS( ) if the system window has been opened and is visible or hidden. If you specify the name of a system window that is closed, FoxPro generates an error message. The Debug window is an exception. Once the Debug window has been opened, its name can be included in WROWS( ) if it is visible, hidden, or closed.
- You can also include the empty string in WindowName to return the number of rows in the main X# window.
- The empty string can be used to specify the main X# window in functions such as WLCOL( ), WLROW( ), and WCOLS( ), which return window locations or sizes.
+ 指定 WROWS( ) 要返回其行数的窗口。在 X# 中,也可以指定工具栏的名称。在 X# 中,WROWS( ) 返回的值取决于为窗口指定的字体。大多数字体可以以多种大小显示,并且有些是比例间距字体。一行对应于当前字体的高度。有关更多信息,请参阅“字体概述”主题。如果系统窗口(命令窗口、数据工作期窗口、浏览窗口等)已打开并且处于可见或隐藏状态,可以在 WROWS( ) 中指定其名称。如果指定已关闭的系统窗口的名称,FoxPro 会生成错误消息。调试窗口是一个例外。调试窗口一旦打开,无论其处于可见、隐藏还是关闭状态,都可以在 WROWS( ) 中包含其名称。也可以在 WindowName 中使用空字符串来返回 X# 主窗口中的行数。在返回窗口位置或大小的函数(如 WLCOL( )、WLROW( ) 和 WCOLS( ))中,可以使用空字符串来指定 X# 主窗口。
- Numeric
+ 数值类型
- If you don't specify a window name, the number of rows in the active output window is returned. If no window is active, the number of rows in the main X# window is returned.
+ 如果未指定窗口名称,则返回活动输出窗口中的行数。如果没有活动窗口,则返回 X# 主窗口中的行数。
- Returns the title assigned to the active or specified window.
+ 返回分配给活动窗口或指定窗口的标题。
- Specifies a window whose title WTITLE( ) returns. The title assigned to the window with the TITLE clause is returned if you include the name of a user-defined window created with DEFINE WINDOW.
- When you issue BROWSE WINDOW to open a Browse window in a user-defined window, WTITLE( ) returns the title of the user-defined window if the Browse window doesn't have a title. WTITLE( ) returns the title of the Browse window if the Browse window does have a title.
- You can also use the empty string for WindowName to specify the main X# window.
+ 指定要返回其标题的窗口。如果包含使用 DEFINE WINDOW 创建的用户自定义窗口的名称,则返回通过 TITLE 子句分配给该窗口的标题。当发出 BROWSE WINDOW 在用户自定义窗口中打开浏览窗口时,如果浏览窗口没有标题,WTITLE( ) 返回该用户自定义窗口的标题。如果浏览窗口有标题,WTITLE( ) 返回浏览窗口的标题。也可以将空字符串用作 WindowName 来指定 X# 主窗口。
- Character
+ 字符类型
- WTITLE( ) can be used to return a window's title, which appears in the top border of the window. The title is returned for the active window if you omit WindowName. WTITLE( ) returns the empty string if the Debug, Trace or Command window is active or output is being directed to the main X# window.
-
- Window Names and Titles Names are assigned to user-defined windows, system windows, toolbars (in X#), and Browse windows in the following manner:
- User-defined windows are assigned names when they are created with DEFINE WINDOW. There is a distinction between user-defined window names and titles. By default, user-defined windows don't have titles. If the TITLE clause is included when the window is created, the specified title appears in the top border of the window, but isn't the name of the window.
- By default, each system window, which is part of the X# interface, derives its name from the title of the window. Examples of system windows include the Command window, the Data Session window, and the Trace window. In X#, each toolbar derives its name from the title of the toolbar.
- Program and editing windows and the Label and Report Designer windows derive their names from the name of the file being created or modified.
- A Browse window derives its name from the title of the window. The name and title of the Browse window is assigned in one of three ways: either by the default title assignment of the table alias, or by the window title (if any exists), or by the Browse title (if any exists).
- By default, the Browse window name is the table alias.
- To specify a system window and toolbar names in commands and functions, enclose the entire system window or toolbar name in quotation marks. For example, to hide the Report Controls toolbar in X#, issue the following command:
+ WTITLE( ) 可用于返回窗口的标题,该标题显示在窗口的上边框中。如果省略 WindowName,则返回活动窗口的标题。如果调试窗口、跟踪窗口或命令窗口处于活动状态,或者输出被定向到 X# 主窗口,WTITLE( ) 返回空字符串。窗口名称和标题 用户自定义窗口、系统窗口、工具栏(在 X# 中)和浏览窗口的名称按以下方式分配:用户自定义窗口在使用 DEFINE WINDOW 创建时被分配名称。用户自定义窗口的名称和标题是有区别的。默认情况下,用户自定义窗口没有标题。如果在创建窗口时包含 TITLE 子句,则指定的标题会显示在窗口的上边框中,但它不是窗口的名称。默认情况下,作为 X# 界面一部分的每个系统窗口,其名称来源于窗口的标题。系统窗口的示例包括命令窗口、数据工作期窗口和跟踪窗口。在 X# 中,每个工具栏的名称来源于工具栏的标题。程序窗口和编辑窗口以及标签设计器和报表设计器窗口的名称来源于正在创建或修改的文件的名称。浏览窗口的名称来源于窗口的标题。浏览窗口的名称和标题通过以下三种方式之一分配:表别名的默认标题分配,或窗口标题(如果存在),或浏览标题(如果存在)。默认情况下,浏览窗口的名称是表别名。要在命令和函数中指定系统窗口和工具栏的名称,请将整个系统窗口或工具栏的名称括在引号中。例如,要在 X# 中隐藏“报表控件”工具栏,请发出以下命令:
HIDE WINDOW "Report Controls"
- Additional Notes on Window Names If you are unsure of the name assigned to a window, check the Window menu. All window names are listed at the bottom of the Window menu.
- Two windows exist if you issue BROWSE WINDOW WindowName. The Browse window is a separate window and takes on the attributes of the specified user-defined window. If a window is active when you issue BROWSE and you don't include the WINDOW clause, the Browse window takes on the attributes of the active window. You can override this behavior by including NORMAL in BROWSE.
- You can include window names that contain spaces in commands and functions that accept window names, such as MOVE WINDOW, DEACTIVATE WINDOW, and WONTOP( ), by specifying the part of the window name that begins with the first non-space character and continuing until the last non-space character is encountered.
- For example, a Browse window with the name Invoice Entry can be moved with this command:
+ 有关窗口名称的补充说明 如果不确定分配给窗口的名称,请查看“窗口”菜单。所有窗口名称都列在“窗口”菜单的底部。如果发出 BROWSE WINDOW WindowName,则会存在两个窗口。浏览窗口是一个独立的窗口,并采用指定的用户自定义窗口的属性。如果在发出 BROWSE 时有一个窗口处于活动状态,并且未包含 WINDOW 子句,则浏览窗口采用活动窗口的属性。可以通过在 BROWSE 中包含 NORMAL 来覆盖此行为。在接受窗口名称的命令和函数(如 MOVE WINDOW、DEACTIVATE WINDOW 和 WONTOP( ))中,可以包含带有空格的窗口名称,方法是指定从第一个非空格字符开始、直到最后一个非空格字符为止的那部分窗口名称。例如,名为 Invoice Entry 的浏览窗口可以使用以下命令移动:
MOVE WINDOW invoice BY 1,1
- The names of user-defined windows cannot contain spaces, but the names of Browse and system windows can.
+ 用户自定义窗口的名称不能包含空格,但浏览窗口和系统窗口的名称可以包含空格。
- Returns the year from the specified date or datetime expression.
+ 从指定的日期或日期时间表达式中返回年份。
- Specifies a date expression from which YEAR( ) returns the year. dExpression can be a function that returns a date, or a Date-type memory variable, array element, or field. It can also be a literal date string, such as {^1998-06-06}.
+ 指定 YEAR( ) 从中返回年份的日期表达式。dExpression 可以是返回日期的函数,也可以是日期类型的内存变量、数组元素或字段。它还可以是字面日期字符串,例如 {^1998-06-06}。
- Specifies a datetime expression from which YEAR( ) returns the year.
+ 指定 YEAR( ) 从中返回年份的日期时间表达式。
- Numeric
+ 数值类型
- YEAR( ) always returns the year with the century. The CENTURY setting (ON or OFF) doesn't affect the returned value.
+ YEAR( ) 始终返回包含世纪的年份。CENTURY 设置(ON 或 OFF)不会影响返回值。
diff --git a/src/DocChinese/VoFunctionDocs.xml b/src/DocChinese/VoFunctionDocs.xml
index 0bbf50f572..1622dcd6e7 100644
--- a/src/DocChinese/VoFunctionDocs.xml
+++ b/src/DocChinese/VoFunctionDocs.xml
@@ -279,7 +279,7 @@
如果函数成功,返回值大于 31。如果函数失败,返回值是以下错误值之一。
-
+
返回代码/值
描述
@@ -2401,18 +2401,18 @@
- Convert a value to a right-padded string.
+ 将值转换为右填充的字符串。
- The value to be converted.
- The length of the padded string.
+ 要转换的值。
+ 填充后字符串的长度。
- A right-padded string of length containing the converted value.
+ 长度为 的右填充字符串,包含转换后的值。
- AsPadR( , ) is like specifying PadR(AsString( ), , " ").
+ AsPadR( , ) 类似于指定 PadR(AsString( ), , " ")。
- This example uses AsPadR() to compare a number with the contents of a character field:
+ 此示例使用 AsPadR() 将数字与字符字段的内容进行比较:
? _FIELD->cRegion == AsPadR(2048, 10)
AsString
@@ -2775,12 +2775,12 @@
? AtLine("第三", cBigString) // 3
- At Function
- AtC Function
- AtCLine Function
- AtLine2 Function
- StrTran Function
- Substr Function
+ At 函数
+ AtC 函数
+ AtCLine 函数
+ AtLine2 函数
+ StrTran 函数
+ Substr 函数
@@ -3269,7 +3269,7 @@
一个常量,定义复制模式,如下表所示:
-
+
常量
描述
@@ -3513,7 +3513,7 @@
一个常量,定义复制模式,如下表所示:
-
+
常量
描述
diff --git a/src/DocChinese/XPPComments.Xml b/src/DocChinese/XPPComments.Xml
index d70be5623c..7028859fdf 100644
--- a/src/DocChinese/XPPComments.Xml
+++ b/src/DocChinese/XPPComments.Xml
@@ -41,7 +41,7 @@
-
CLASS_DESCR_MEMBERS
包含成员变量信息的三列二维数组。
-
+
-
CLASS_MEMBER_NAME
表示单个成员变量名称的字符字符串
@@ -59,7 +59,7 @@
-
CLASS_DESCR_METHODS
- 包含方法信息的三列二维数组。
+ 包含方法信息的三列二维数组。
-
CLASS_METHOD_NAME
方法名称的字符字符串
diff --git a/src/DocChinese/XSharp.Core.Docs.xml b/src/DocChinese/XSharp.Core.Docs.xml
index 784216eb60..dcc3261c90 100644
--- a/src/DocChinese/XSharp.Core.Docs.xml
+++ b/src/DocChinese/XSharp.Core.Docs.xml
@@ -2,106 +2,105 @@
<__UsualType>
- This enum is used to describe the type of USUAL values in the X# Runtime.
- It is based on the original USUAL type values in the VO runtime and has been extended with some additional type numbers.
+ 此枚举用于描述 X# 运行时中 USUAL 值的类型。它基于 VO 运行时中原有的 USUAL 类型值,并扩展了一些额外的类型编号。
<__UsualType.Array>
- The usual contains an ARRAY value
+ usual 包含一个 ARRAY 值
<__UsualType.Binary>
- The usual contains a Binary value (new in X#).
+ usual 包含一个 Binary 值(X# 中新增)。
<__UsualType.Byte>
- This value is in the enum for completeness but never used inside a usual. Byte values are stored as LONG.
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。Byte 值以 LONG 存储。
<__UsualType.Char>
- This value is in the enum for completeness but never used inside a usual. Char values are stored as LONG
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。Char 值以 LONG 存储
<__UsualType.Codeblock>
- The usual contains an CODEBLOCK value
+ usual 包含一个 CODEBLOCK 值
<__UsualType.Currency>
- The usual contains a Currency value (new in X#).
+ usual 包含一个 Currency 值(X# 中新增)。
<__UsualType.Date>
- The usual contains a DATE value
+ usual 包含一个 DATE 值
<__UsualType.DateTime>
- The usual contains a DateTime value (new in X#).
+ usual 包含一个 DateTime 值(X# 中新增)。
<__UsualType.Decimal>
- The usual contains a Decimal value (new in X#).
+ usual 包含一个 Decimal 值(X# 中新增)。
<__UsualType.DWord>
- This value is in the enum for completeness but never used inside a usual. DWord values are stored as LONG or FLOAT.
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。DWord 值以 LONG 或 FLOAT 存储。
<__UsualType.Dynamic>
- This value is in the enum for completeness but never used inside a usual. Dynamic values are stored as OBJECT
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。Dynamic 值以 OBJECT 存储
<__UsualType.Fixed>
- This value is NEVER used for USUALs (this was also defined in VO but never used).
+ 此值从不用于 USUAL(在 VO 中也有定义,但从未使用)。
<__UsualType.Float>
- The usual contains a FLOAT value
+ usual 包含一个 FLOAT 值
<__UsualType.Int64>
- The usual contains an INT64 value (new in Vulcan and X#).
+ usual 包含一个 INT64 值(Vulcan 和 X# 中新增)。
<__UsualType.Invalid>
- Invalid Usual Type.
+ 无效的 Usual 类型。
<__UsualType.Logic>
- The usual contains an LOGIC value
+ usual 包含一个 LOGIC 值
<__UsualType.Long>
- The usual contains a LONG value
+ usual 包含一个 LONG 值
<__UsualType.Memo>
- The usual contains an Memo value. This value is there for compatibility with VO but never used.
+ usual 包含一个 Memo 值。此值是为了与 VO 兼容而存在,但从未使用。
<__UsualType.Null>
- The usual contains a DBNull.Value value (new in X#).
+ usual 包含一个 DBNull.Value 值(X# 中新增)。
<__UsualType.Object>
- The usual contains an OBJECT value
+ usual 包含一个 OBJECT 值
<__UsualType.Psz>
- This value is in the enum for completeness but never used inside a usual.
- The usual contains an PSZ value
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。
+ usual 包含一个 PSZ 值
<__UsualType.Ptr>
- The usual contains an PTR value
+ usual 包含一个 PTR 值
<__UsualType.Real4>
- This value is in the enum for completeness but never used inside a usual. Real4 values are stored as FLOAT
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。Real4 值以 FLOAT 存储
<__UsualType.Real8>
- This value is in the enum for completeness but never used inside a usual. Real8 values are stored as FLOAT.
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。Real8 值以 FLOAT 存储。
<__UsualType.ShortInt>
- This value is in the enum for completeness but never used inside a usual. Short values are stored as LONG.
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。Short 值以 LONG 存储。
<__UsualType.String>
- The usual contains an STRING value
+ usual 包含一个 STRING 值
<__UsualType.Symbol>
- The usual contains an SYMBOL value
+ usual 包含一个 SYMBOL 值
<__UsualType.UInt64>
- The usual contains an UINT64 value (new in Vulcan and X#).
+ usual 包含一个 UINT64 值(Vulcan 和 X# 中新增)。
<__UsualType.Void>
- The usual contains a NIL.
+ usual 包含一个 NIL。
<__UsualType.Word>
- This value is in the enum for completeness but never used inside a usual. Word values are stored as LONG.
+ 此值出于完整性而包含在枚举中,但从不在 usual 内部使用。Word 值以 LONG 存储。
<_C2Hex>
- Convert a string value to a hexadecimal string.
- String to convert
- When TRUE then the inidividual characters are separated with a space in the result string
- A string with the hex representation of the value
+ 将字符串值转换为十六进制字符串。
+ 要转换的字符串
+ 当为 TRUE 时,结果字符串中的各个字符以空格分隔
+ 包含该值的十六进制表示的字符串
? _C2Hex("abcdef", TRUE) // 61 62 63 64 65 66
? _C2Hex("abcdef", FALSE) // 616263646566
@@ -110,66 +109,65 @@
C2Hex
<_FieldNames>
- Helper class for VoDbTrans and VoDbSort()
+ VoDbTrans 和 VoDbSort() 的辅助类
<_FieldNames.ctor>
- Construct a _FieldNames object.
+ 构造一个 _FieldNames 对象。
<_FieldNames.FieldCount>
- Number of fields in the list.
+ 列表中的字段数。
<_FieldNames.Fields>
- List of field names.
+ 字段名称列表。
<_JoinField>
- Helper structure for DbJoin()
+ DbJoin() 的辅助结构
<_JoinField.Area>
- Source Workarea number.
+ 源工作区编号。
<_JoinField.Pos>
- Source field position.
+ 源字段位置。
<_JoinList>
- Helper class for DbJoin()
+ DbJoin() 的辅助类
<_JoinList.Count>
- Number of fields in the list.
+ 列表中的字段数。
<_JoinList.ctor>
- Construct a _JoinList object.
+ 构造一个 _JoinList 对象。
<_JoinList.Fields>
- List of field areas and positions.
+ 字段区域和位置的列表。
<_JoinList.uiDestSel>
- Area number of destination Workarea.
+ 目标工作区的区域编号。
<_Like>
- Determine if a string matches a wildcard pattern (like the wildcard pattern for the DIR command in the OS).
- The wildcard to use. '*' matches 0 or more characters until the next non-wildcard character, '?' matches any character, all other characters must match exactly.
- The string to examine.
- This function is case sensitive. If you want to do a case insensitive compare, use Like()
+ 确定字符串是否与通配符模式匹配(类似于操作系统中 DIR 命令的通配符模式)。
+ 要使用的通配符。'*' 匹配 0 个或多个字符,直到下一个非通配符字符;'?' 匹配任意单个字符,所有其他字符必须完全匹配。
+ 要检查的字符串。
+ 此函数区分大小写。如果要进行不区分大小写的比较,请使用 Like()
Like
<_Quit>
- Terminate application processing, close all open files, and return control to the operating system.
+ 终止应用程序处理,关闭所有打开的文件,并将控制权返回给操作系统。
- This function can be used from anywhere in an application.
- A RETURN executed from the Start() function can also be used to QUIT an application.
+ 此函数可以在应用程序的任何位置使用。从 Start() 函数中执行 RETURN 也可用于 QUIT 应用程序。
<_RddList>
- Helper structure to store information for a list of RDD names for DbUseArea()
+ 用于存储 DbUseArea() 的 RDD 名称列表信息的辅助结构
<_RddList.ctor>
- Construct _RddList from class Tree.
+ 从类 Tree 构造 _RddList。
<_RddList.ctor_2>
- Construct _RddList from list of names.
+ 从名称列表构造 _RddList。
<_RddList.uiRddCount>
- Number of names in the list.
+ 列表中的名称数量。
<_SplitPath>
@@ -181,30 +179,30 @@
- The path name to break.
- The drive letter followed by a colon.
- The directories, including the trailing slash. Forward slashes and backslashes both may be present in <cPath>. Forward slashes (/) are converted to backslashes (\).
- The file name, without the extension.
- The extension, including the leading period.
+ 要拆分的路径名。
+ 驱动器字母,后跟一个冒号。
+ 目录,包括末尾的斜杠。<cPath> 中可以同时存在正斜杠和反斜杠。正斜杠 (/) 会被转换为反斜杠 (\)。
+ 文件名,不含扩展名。
+ 扩展名,包括前导的句点。
- The actual type of the parameter.
+ 参数的实际类型。
- A trimmed string, with leading and trailing spaces removed.
+ 去除了前导和尾随空格的字符串。
- This function is inlined by the compiler, but is included so it can be used in Macros as well.
+ 此函数由编译器内联,但仍然包含它,以便也可以在宏中使用。
- This parameter is ignored in X#
- This function is inlined by the compiler, but is included so it can be used in Macros as well.
+ 此参数在 X# 中被忽略
+ 此函数由编译器内联,但仍然包含它,以便也可以在宏中使用。
@@ -215,7 +213,7 @@
- Length of the source array
+ 源数组的长度
@@ -233,9 +231,9 @@
- Convert an array of ANSI characters to OEM characters, changing the contents of the argument as well as the return value.
+ 将 ANSI 字符数组转换为 OEM 字符,同时更改参数的内容和返回值。
- A byte array that contains the string to convert
+ 包含要转换的字符串的字节数组
@@ -248,11 +246,7 @@
- The return value of Asc() in XSharp depends on the setting of SetAnsi().
- When SetAnsi() = TRUE then the active windows Ansi codepage is used to calculate the result.
- When SetAnsi() = FALSE then the active windows Oem codepage is used to calculate the result.
- This is different from the behior in most single byte versions of Xbase where Asc() simply returnes the
- byte value of the 1st character of the string.
+ XSharp 中 Asc() 的返回值取决于 SetAnsi() 的设置。
当 SetAnsi() = TRUE 时,使用活动窗口的 Ansi 代码页来计算结果。
当 SetAnsi() = FALSE 时,使用活动窗口的 Oem 代码页来计算结果。
这与大多数单字节版本 Xbase 中的行为不同,在那些版本中 Asc() 只是返回字符串第一个字符的字节值。
AscA
AscW
@@ -260,7 +254,7 @@
- AscA() always uses the current Ansi codepage, and ignores the setting of SetAnsi()
+ AscA() 始终使用当前的 Ansi 代码页,并忽略 SetAnsi() 的设置
Asc
AscW
@@ -268,41 +262,41 @@
- Convert a character to its Unicode ASCII value.
+ 将字符转换为其 Unicode ASCII 值。
- Number of the Unicode character
+ Unicode 字符的编号
Asc
AscA
ChrW
- This function is not implemented yet
+ 此函数尚未实现
- This function is not implemented yet
+ 此函数尚未实现
- Base Index class. Does not implement anything.
+ 基础索引类。不实现任何功能。
- Create the BaseIndex object
- Workarea object that 'owns' this index object
+ 创建 BaseIndex 对象
+ “拥有”此索引对象的工作区对象
- Base Memo class. Does not implement anything.
+ 基础备注类。不实现任何功能。
- Create the BaseMemo object
- Workarea object that 'owns' this memo object
+ 创建 BaseMemo 对象
+ “拥有”此备注对象的工作区对象
@@ -312,9 +306,9 @@
Ptr2Bin
- Convert a string value to a hexadecimal string.
- String to convert
- A string with the hex representation of the value
+ 将字符串值转换为十六进制字符串。
+ 要转换的字符串
+ 包含该值的十六进制表示的字符串
? C2Hex("abcdef") // 616263646566
@@ -324,17 +318,12 @@
- The value of dwChar must be between 0 and 255
- The return value of Chr() in XSharp depends on the setting of SetAnsi().
- When SetAnsi() = TRUE then the active windows Ansi codepage is used to calculate the character.
- When SetAnsi() = FALSE then the active windows Oem codepage is used to calculate the character.
- This is different from the behior in most single byte versions of Xbase where Chr() simply returnes a string with a single byte
- that matches the number passed to this function.
+ dwChar 的值必须在 0 到 255 之间
XSharp 中 Chr() 的返回值取决于 SetAnsi() 的设置。
当 SetAnsi() = TRUE 时,使用活动窗口的 Ansi 代码页来计算字符。
当 SetAnsi() = FALSE 时,使用活动窗口的 Oem 代码页来计算字符。
这与大多数单字节版本 Xbase 中的行为不同,在那些版本中 Chr() 只是返回一个单字节字符串,该字节与传递给此函数的数字相匹配。
- Convert an ASCII code to a character value, always using the Ansi codepage, ignoring the SetAnsi() setting.
+ 将 ASCII 码转换为字符值,始终使用 Ansi 代码页,忽略 SetAnsi() 的设置。
@@ -343,7 +332,7 @@
- Convert an ASCII code to a character value.
+ 将 ASCII 码转换为字符值。
@@ -354,336 +343,325 @@
- Default namespace of the assembly.
+ 程序集的默认命名空间。
- Name of the class where functions, defines and globals are stored.
+ 存放函数、define 和全局变量的类的名称。
- List of parameter names for the method or constructor
+ 方法或构造函数的参数名称列表
- This enum specifies the collation mode used to create and update index strings.
+ 此枚举指定用于创建和更新索引字符串的排序规则模式。
- The version and dialect of the compiler that created the assembly.
+ 创建该程序集的编译器的版本和方言。
- Format a set of numbers representing a year, month, and day as a Date.
+ 将表示年、月、日的一组数字格式化为 Date。
- A valid year. If the century digits are not specified, the century is determined by the rules of SetEpoch().
- A number from 1 through 12 representing a valid month.
- A number representing a valid day of dwMonth.
- The date that corresponds to the passed arguments. If any of the arguments specified do not represent a valid year, month, or day, a DateTime.MinValue is returned.
+ 有效的年份。如果未指定世纪数字,则世纪由 SetEpoch() 的规则确定。
+ 表示有效月份的 1 到 12 之间的数字。
+ 表示 dwMonth 中有效日期的数字。
+ 与传入参数对应的日期。如果指定的任何参数不代表有效的年、月或日,则返回 DateTime.MinValue。
- Return the timestring from a DateTime structure
+ 从 DateTime 结构返回时间字符串
- DateTime values that needs to be converted
- A (military) time that corresponds to the passed arguments in the format HH:MM:SS without AM/PM notation.
+ 需要转换的 DateTime 值
+ 与传入参数对应的(24 小时制)时间,格式为 HH:MM:SS,不带 AM/PM 标记。
- The CoreDb class contains the methods to manipulate Workareas.
- The class is stateless. The Workarea state is stored in the RuntimeState.
+ CoreDb 类包含用于操作工作区的方法。
该类是无状态的。工作区状态存储在 RuntimeState 中。
- Return exception object from last RDD operation.
+ 返回上一次 RDD 操作的异常对象。
- Return the alias of a specified work area as a string.
+ 以字符串形式返回指定工作区的别名。
- Alias(), VoDbAlias() and CoreDb.Alias() are aliases
+ Alias()、VoDbAlias() 和 CoreDb.Alias() 是别名
- Add a new record.
+ 添加一条新记录。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBAppend() but is strongly typed.
+ 此函数类似于 DBAppend(),但是强类型的。
- VoDbAppend() and CoreDb.Append() are aliases
+ VoDbAppend() 和 CoreDb.Append() 是别名
- Retrieve information about a memo column.
+ 检索有关备注列的信息。
- The returnvalue is returned through this parameter. When set on entry this is the new value of the setting.
- TRUE if successful; otherwise, FALSE.
- VoDbBlobInfo overloads
- BlobInfo overloads in VoDb
- BlobInfo overloads in CoreDb
+ 返回值通过此参数返回。如果在输入时已设置,则它是该设置的新值。
+ 如果成功,则为 TRUE;否则为 FALSE。
+ VoDbBlobInfo 重载
+ VoDb 中的 BlobInfo 重载
+ CoreDb 中的 BlobInfo 重载
- Determine when beginning-of-file is encountered.
+ 确定是否遇到文件开头。
- TRUE after an attempt to skip backward beyond the first logical record in a database file or if
- the current database file contains no records; otherwise, FALSE. If there is no database file open in the
- current work area, CoreDbBOF() returns TRUE.
+ 如果尝试向后跳过数据库文件中的第一条逻辑记录,或者当前数据库文件不包含任何记录,则为 TRUE;否则为 FALSE。如果当前工作区中没有打开数据库文件,CoreDbBOF() 返回 TRUE。
- This function is like BOF().
- VoDbBof() and CoreDb.Bof() are aliases
+ 此函数类似于 BOF()。
+ VoDbBof() 和 CoreDb.Bof() 是别名
- Bof Function
- VoDbBof Function in XSharp.VO
+ Bof 函数
+ XSharp.VO 中的 VoDbBof 函数
- Refresh the buffer for the current Workarea, discarding any changes that were made.
- TRUE if successful; otherwise, FALSE.
+ 刷新当前工作区的缓冲区,放弃所做的任何更改。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBBuffRefresh().
+ 此函数类似于 DBBuffRefresh()。
- VoDbBuffRefresh() and CoreDb.BuffRefresh() are aliases
+ VoDbBuffRefresh() 和 CoreDb.BuffRefresh() 是别名
- Clear a logical filter condition.
+ 清除逻辑过滤条件。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBClearFilter().
+ 此函数类似于 DBClearFilter()。
- VoDbClearFilter() and CoreDb.ClearFilter() are aliases
+ VoDbClearFilter() 和 CoreDb.ClearFilter() 是别名
- Clear a locate condition by deleting the locate code block.
+ 通过删除 locate 代码块来清除 locate 条件。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBClearLocate().
+ 此函数类似于 DBClearLocate()。
- VoDbClearLocate() and CoreDb.ClearLocate() are aliases
+ VoDbClearLocate() 和 CoreDb.ClearLocate() 是别名
- Clear any active relations.
- TRUE if successful; otherwise, FALSE.
+ 清除所有活动的关系。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBClearRelation().
+ 此函数类似于 DBClearRelation()。
- VoDbClearRelation() and CoreDb.ClearRelation() are aliases
+ VoDbClearRelation() 和 CoreDb.ClearRelation() 是别名
- Clear the active locate condition.
- TRUE if successful; otherwise, FALSE.
+ 清除当前活动的 locate 条件。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBClearScope().
+ 此函数类似于 DBClearScope()。
- VoDbClearScope() and CoreDb.ClearScope() are aliases
+ VoDbClearScope() 和 CoreDb.ClearScope() 是别名
- Close all files in all work areas.
+ 关闭所有工作区中的所有文件。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBCloseAll().
+ 此函数类似于 DBCloseAll()。
- VoDbCloseAll() and CoreDb.CloseAll() are aliases
+ VoDbCloseAll() 和 CoreDb.CloseAll() 是别名
- Close all files in a work area.
+ 关闭工作区中的所有文件。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DbCloseArea().
+ 此函数类似于 DbCloseArea()。
- VoDbCloseArea() and CoreDb.CloseArea() are aliases
+ VoDbCloseArea() 和 CoreDb.CloseArea() 是别名
- Flush pending updates in one work area.
+ 刷新一个工作区中挂起的更新。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBCommit().
+ 此函数类似于 DBCommit()。
- VoDbCommit() and CoreDb.Commit() are aliases
+ VoDbCommit() 和 CoreDb.Commit() 是别名
- Flush pending updates in all work areas.
+ 刷新所有工作区中挂起的更新。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBCommitAll().
+ 此函数类似于 DBCommitAll()。
- VoDbCommitAll() and CoreDb.CommitAll() are aliases
+ VoDbCommitAll() 和 CoreDb.CommitAll() 是别名
- Resume a pending locate condition.
+ 恢复挂起的 locate 条件。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBContinue().
+ 此函数类似于 DBContinue()。
- VoDbContinue() and CoreDb.Continue() are aliases
+ VoDbContinue() 和 CoreDb.Continue() 是别名
- Create new file through the specified RDDs
+ 通过指定的 RDD 创建新文件
- Create new file through the specified RDDs
+ 通过指定的 RDD 创建新文件
- Name of RDD to use
- List of RDDs to use when creating the file
- Name of the file to create. When no extension is specified then the default extension for the RDD will be used.
- Structure to use when creating the file.
- Type of the class that must be used to work with the RDD.
- TRUE opens the database file in a new work area (first available). FALSE opens it in the current work area. lNew is useful only when lOpen has a value of TRUE. The default is FALSE.
- The alias to be associated with the work area where the file is opened. Within a single thread, X# will not accept duplicate aliases. cAlias is useful only when lOpen has a value of TRUE. The default alias is the filename without extension
- The delimiter for fields within a delimited database file. The default is a NULL string
- TRUE specifies that the file should remain open after creating. FALSE closes the file.
- TRUE specifies that an existing database file be opened. FALSE specifies that that a new database file be opened. The default is FALSE. This can be used to open existing SDF and delimited files, which do not have a structure in the header ? in which case, an empty aStruct should be used.
- TRUE when succesfull, otherwise FALSE. When an error has occurred then you can retrieve that error from RuntimeState.LastRddError.
- DbCreate() function
- VoDbCreate overloads
+ 要使用的 RDD 名称
+ 创建文件时要使用的 RDD 列表
+ 要创建的文件名。如果未指定扩展名,则将使用该 RDD 的默认扩展名。
+ 创建文件时要使用的结构。
+ 用于操作该 RDD 的类的类型。
+ TRUE 在新工作区(第一个可用的工作区)中打开数据库文件。FALSE 在当前工作区中打开。lNew 仅在 lOpen 的值为 TRUE 时有用。默认值为 FALSE。
+ 与打开文件的工作区关联的别名。在单个线程内,X# 不接受重复的别名。cAlias 仅在 lOpen 的值为 TRUE 时有用。默认别名为不带扩展名的文件名
+ 分隔符数据库文件中字段的分隔符。默认值为 NULL 字符串
+ TRUE 指定创建后文件保持打开状态。FALSE 则关闭文件。
+ TRUE 指定打开现有的数据库文件。FALSE 指定打开新的数据库文件。默认值为 FALSE。这可用于打开现有的 SDF 和分隔符文件,这些文件的头部中没有结构 ? 在这种情况下,应使用空的 aStruct。
+ 成功时为 TRUE,否则为 FALSE。发生错误时,您可以从 RuntimeState.LastRddError 中检索该错误。
+ DbCreate() 函数
+ VoDbCreate 重载
- Return the name of the alias.
- In the FoxPro dialect the full path is returned.
+ 返回别名的名称。
+ 在 FoxPro 方言中返回完整路径。
- Mark the current record for deletion.
+ 将当前记录标记为删除。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBDelete().
+ 此函数类似于 DBDelete()。
- VoDbDelete() and CoreDb.Delete() are aliases
+ VoDbDelete() 和 CoreDb.Delete() 是别名
- DbDelete Function
+ DbDelete 函数
- Return the deleted status of the current record.
+ 返回当前记录的删除状态。
- TRUE if the current record is marked for deletion; otherwise, FALSE.
- If there is no database file in use in the current work area, CoreDbDeleted() returns FALSE.
+ 如果当前记录被标记为删除,则为 TRUE;否则为 FALSE。如果当前工作区中没有正在使用的数据库文件,CoreDbDeleted() 返回 FALSE。
- Deleted Function
+ Deleted 函数
- VoDbDelete() and CoreDb.Delete() are aliases
+ VoDbDelete() 和 CoreDb.Delete() 是别名
- Determine when end-of-file is encountered.
+ 确定是否遇到文件结尾。
- TRUE when an attempt is made to move the record pointer beyond the last logical record in a
- database file or if the current database file contains no records; otherwise, FALSE. If there is no
- database file open in the current work area, CoreDbEOF() returns TRUE.
+ 当尝试将记录指针移动到数据库文件中最后一条逻辑记录之后,或者当前数据库文件不包含任何记录时,为 TRUE;否则为 FALSE。如果当前工作区中没有打开数据库文件,CoreDbEOF() 返回 TRUE。
- This function is like EOF().
- VoDbEof() and CoreDb.Eof() are aliases
+ 此函数类似于 EOF()。
+ VoDbEof() 和 CoreDb.Eof() 是别名
- Eof Function
- VoDbEof Function in XSharp.VO
+ Eof 函数
+ XSharp.VO 中的 VoDbEof 函数
- Evaluate a code block for each record that matches a specified scope and/or condition.
+ 对每条符合指定范围和/或条件的记录计算(执行)一个代码块。
- The code block to execute for each record that matches the scope and conditions.
- A code block that defines a condition that each record within the scope must meet in order to be processed.
+ 对每条符合范围和条件的记录执行的代码块。
+ 定义范围内每条记录必须满足的条件的代码块,满足该条件的记录才会被处理。
- A code block that defines another condition that each record must meet in order to be processed. As soon as a record is encountered that causes the condition to fail, the operation terminates. If no scope is specified, changes the default scope to .
+ 定义每条记录必须满足的另一个条件的代码块,满足该条件的记录才会被处理。一旦遇到导致该条件失败的记录,操作即终止。如果未指定范围, 会将默认范围更改为 。
- The number of records to process, starting at the current record.
- The number of the record to process.
- TRUE processes only records from the current record to end-of-file. FALSE processes all records.
- TRUE if successful; otherwise, FALSE.
+ 从当前记录开始要处理的记录数。
+ 要处理的记录的编号。
+ TRUE 仅处理从当前记录到文件结尾的记录。FALSE 处理所有记录。
+ 如果成功,则为 TRUE;否则为 FALSE。
- By default, Eval() operates on the currently selected work area.
- It will operate on an unselected work area if you specify it as part of an aliased expression.
- On each iteration, Eval() evaluates the specified code block.
- All records within the scope or matching the condition are processed until end-of-file is reached.
- Eval() can be used as a primitive for the construction of commands that process database files.
- In fact, many of the database processing commands are created using Eval().
+ 默认情况下,Eval() 对当前选定的工作区进行操作。如果您将其指定为带别名表达式的一部分,它将对未选定的工作区进行操作。在每次迭代中,Eval() 计算指定的代码块。范围内或符合条件的所有记录都会被处理,直到到达文件结尾。Eval() 可用作构造处理数据库文件的命令的基本单元。事实上,许多数据库处理命令都是使用 Eval() 创建的。
- Return the number of fields in the current Workarea
+ 返回当前工作区中的字段数
- Retrieve the value of a specified database field.
+ 检索指定数据库字段的值。
- The 1 based position of the field in the database file structure for the current work area.
- The returnvalue is returned through this parameter
- TRUE if successful; otherwise, FALSE.
+ 字段在当前工作区数据库文件结构中的位置(从 1 开始)。
+ 返回值通过此参数返回
+ 如果成功,则为 TRUE;否则为 FALSE。
- Retrieve the value of a specified database field as an array of bytes
+ 以字节数组形式检索指定数据库字段的值
- The 1 based position of the field in the database file structure for the current work area.
- The returnvalue is returned through this parameter
- TRUE if successful; otherwise, FALSE.
- This function only works with RDDs that inherit from the DBF RDD. The Advantage RDD does not support this.
+ 字段在当前工作区数据库文件结构中的位置(从 1 开始)。
+ 返回值通过此参数返回
+ 如果成功,则为 TRUE;否则为 FALSE。
+ 此函数仅适用于继承自 DBF RDD 的 RDD。Advantage RDD 不支持此函数。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBFieldInfo().
+ 此函数类似于 DBFieldInfo()。
- The returnvalue is returned through this parameter. When set on entry this is the new value of the setting.
- VoDbFieldInfo overloads
- FieldInfo overloads in CoreDb
+ 返回值通过此参数返回。如果在输入时已设置,则它是该设置的新值。
+ VoDbFieldInfo 重载
+ CoreDb 中的 FieldInfo 重载
- Return the name of a field as a string.
+ 以字符串形式返回字段的名称。
- The 1 based position of the field in the database file structure for the current work area.
+ 字段在当前工作区数据库文件结构中的位置(从 1 开始)。
- Return the position of a field.
+ 返回字段的位置。
@@ -691,160 +669,160 @@
- Set the value of a specified database field.
+ 设置指定数据库字段的值。
- The 1 based position of the field in the database file structure for the current work area.
- The value to write to the field
- TRUE if successful; otherwise, FALSE.
+ 字段在当前工作区数据库文件结构中的位置(从 1 开始)。
+ 要写入字段的值
+ 如果成功,则为 TRUE;否则为 FALSE。
- Retrieve the value of a specified database field as an array of bytes
+ 以字节数组形式检索指定数据库字段的值
- The 1 based position of the field in the database file structure for the current work area.
- The value to write to the field
- TRUE if successful; otherwise, FALSE.
- This function only works with RDDs that inherit from the DBF RDD. The Advantage RDD does not support this.
+ 字段在当前工作区数据库文件结构中的位置(从 1 开始)。
+ 要写入字段的值
+ 如果成功,则为 TRUE;否则为 FALSE。
+ 此函数仅适用于继承自 DBF RDD 的 RDD。Advantage RDD 不支持此函数。
- Import contents from file into Memo field
- The 1 based position of the field in the database file structure for the current work area.
- The name of the file where the value must be written.
- TRUE if successful; otherwise, FALSE.
+ 将文件内容导入备注字段
+ 字段在当前工作区数据库文件结构中的位置(从 1 开始)。
+ 要写入值的文件名。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBFileGet().
+ 此函数类似于 DBFileGet()。
- VoDbFileGet() and CoreDb.FileGet() are aliases
+ VoDbFileGet() 和 CoreDb.FileGet() 是别名
- Export field contents from Memo field to file
- The 1 based position of the field in the database file structure for the current work area.
- The name of the file to write
- TRUE if successful; otherwise, FALSE.
+ 将备注字段的内容导出到文件
+ 字段在当前工作区数据库文件结构中的位置(从 1 开始)。
+ 要写入的文件名
+ 如果成功,则为 TRUE;否则为 FALSE。
- VoDbFilePut() and CoreDb.FilePut() are aliases
+ VoDbFilePut() 和 CoreDb.FilePut() 是别名
- Return a filter.
+ 返回过滤条件。
- This function is like DBFilter().
+ 此函数类似于 DBFilter()。
- VoDbFilter() and CoreDb.Filter() are aliases
+ VoDbFilter() 和 CoreDb.Filter() 是别名
- Lock an opened and shared database file.
+ 锁定已打开的共享数据库文件。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBFlock().
+ 此函数类似于 DBFlock()。
- VoDbFlock() and CoreDb.Flock() are aliases
+ VoDbFlock() 和 CoreDb.Flock() 是别名
- Determine if the previous search operation succeeded.
+ 确定上一次搜索操作是否成功。
- This function is like Found().
+ 此函数类似于 Found()。
- VoDbFound() and CoreDb.Found() are aliases
+ VoDbFound() 和 CoreDb.Found() 是别名
- Gets the locate condition.
- An object containing the scope for the current area.
+ 获取 locate 条件。
+ 包含当前工作区范围的对象。
- Return the work area number.
+ 返回工作区编号。
- This function is like DBGetSelect().
+ 此函数类似于 DBGetSelect()。
- VoDbGetSelect() and CoreDb.GetSelect() are aliases
+ VoDbGetSelect() 和 CoreDb.GetSelect() 是别名
- Move to the last logical record.
+ 移动到最后一条逻辑记录。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBGoBottom().
+ 此函数类似于 DBGoBottom()。
- VoDbGoBottom() and CoreDb.GoBottom() are aliases
+ VoDbGoBottom() 和 CoreDb.GoBottom() 是别名
- Move to a record specified by record number.
+ 移动到由记录号指定的记录。
- ID of the record to goto
- TRUE if successful; otherwise, FALSE.
+ 要转到的记录的 ID
+ 如果成功,则为 TRUE;否则为 FALSE。
- Move to a record specified by record number.
+ 移动到由记录号指定的记录。
- ID of the record to goto
- TRUE if successful; otherwise, FALSE.
+ 要转到的记录的 ID
+ 如果成功,则为 TRUE;否则为 FALSE。
- Move to the first logical record.
+ 移动到第一条逻辑记录。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBGoTop().
+ 此函数类似于 DBGoTop()。
- VoDbGoTop() and CoreDb.GoTop() are aliases
+ VoDbGoTop() 和 CoreDb.GoTop() 是别名
- Retrieve information about a work area.
+ 检索有关工作区的信息。
- If specified, this parameter is used to change the value of a setting. This parameter also receives the return value.
- TRUE if successful; otherwise, FALSE.
- VoDbInfo overloads
- Info overloads in VoDb
+ 如果指定,此参数用于更改设置的值。此参数同时也接收返回值。
+ 如果成功,则为 TRUE;否则为 FALSE。
+ VoDbInfo 重载
+ VoDb 中的 Info 重载
- Write values to destination Workarea in a JOIN operation
+ 在 JOIN 操作中将值写入目标工作区
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- Return the number of the last record in a database file.
+ 返回数据库文件中最后一条记录的编号。
- VoDbLastRec() and CoreDb.LastRec() are aliases
+ VoDbLastRec() 和 CoreDb.LastRec() 是别名
- Search for the first record that matches a specified condition and scope.
+ 搜索符合指定条件和范围的第一条记录。
@@ -852,162 +830,162 @@
- The number of records to process, starting with the current record.
- The number of the record to process.
- TRUE processes only records from the current record to end-of-file. FALSE processes all records.
- TRUE if successful; otherwise, FALSE.
+ 从当前记录开始要处理的记录数。
+ 要处理的记录的编号。
+ TRUE 仅处理从当前记录到文件结尾的记录。FALSE 处理所有记录。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBLocate() but strongly typed.
+ 此函数类似于 DBLocate(),但是强类型的。
- Return Memo File extension
+ 返回备注文件扩展名
- VoDbMemoExt() and CoreDb.MemoExt() are aliases
+ VoDbMemoExt() 和 CoreDb.MemoExt() 是别名
- An event to which you can subscribe to be notified of operations on Workareas.
+ 一个事件,您可以订阅它以获得有关工作区操作的通知。
- Return the default index file extension for a work area as defined by the its RDD.
+ 返回工作区的默认索引文件扩展名,由其 RDD 定义。
- Default extension for the current Workarea, or an empty string when no table is open in the current Workarea.
+ 当前工作区的默认扩展名;如果当前工作区中没有打开表,则为空字符串。
- Set the condition and scope for an order.
+ 设置排序(order)的条件和范围。
- An object defining the condition and scope information.
- TRUE if successful; otherwise, FALSE.
+ 定义条件和范围信息的对象。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like OrdCondSet() but strongly typed and the condition information is passed in an object.
+ 此函数类似于 OrdCondSet(),但是强类型的,并且条件信息通过对象传递。
- Create or replace an order in an index file.
+ 在索引文件中创建或替换排序(order)。
- Orderbag name (index filename) to create the order in.
- Ordername to create.
- The order key expression specified as a string
- The order key expression specified as a codeblock.
- TRUE creates a unique order by including only those records with unique key values; FALSE uses all records in the database file.
- An object defining the condition and scope information.
- TRUE if successful; otherwise, FALSE.
+ 要在其中创建排序的 Orderbag 名称(索引文件名)。
+ 要创建的排序名称。
+ 以字符串形式指定的排序键表达式
+ 以代码块形式指定的排序键表达式。
+ TRUE 创建唯一排序,仅包含具有唯一键值的记录;FALSE 使用数据库文件中的所有记录。
+ 定义条件和范围信息的对象。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DbCreateOrder() but strongly typed and the condition information is passed in an object.
+ 此函数类似于 DbCreateOrder(),但是强类型的,并且条件信息通过对象传递。
- Remove an order from an open index file.
+ 从已打开的索引文件中删除排序(order)。
- The name of an index file, including an optional drive and directory. Use this argument with <cOrder> to remove ambiguity when there are two or more orders with the same name in different index files.
- The name of the order or a number representing its position in the order list. Using the order name is the preferred method since the position may be difficult to determine using multiple-order index files. Invalid values are ignored.
- TRUE if successful; otherwise, FALSE.
+ 索引文件的名称,包括可选的驱动器和目录。当不同索引文件中存在两个或多个同名排序时,将此参数与 <cOrder> 一起使用以消除歧义。
+ 排序的名称,或表示其在排序列表中位置的数字。建议使用排序名称,因为使用多排序索引文件时位置可能难以确定。无效的值将被忽略。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DbDeleteOrder() but strongly typed.
+ 此函数类似于 DbDeleteOrder(),但是强类型的。
- Return information about index files and the orders in them.
+ 返回有关索引文件及其中排序的信息。
- Specifies the type of information. This must match the values in the DBOI_ defines
- The name of an index file, including an optional drive and directory.
- The name of the order about which you want to obtain information or a number representing its position in the order list.
- If specified, this parameter is used to change the value of a setting.
- If specified, this parameter is used to change the value of a setting and retrieve the current setting.
- TRUE if successful; otherwise, FALSE.
+ 指定信息的类型。它必须与 DBOI_ 定义中的值匹配
+ 索引文件的名称,包括可选的驱动器和目录。
+ 您要获取其信息的排序的名称,或表示其在排序列表中位置的数字。
+ 如果指定,此参数用于更改设置的值。
+ 如果指定,此参数用于更改设置的值并检索当前设置。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DbOrderInfo() but strongly typed.
+ 此函数类似于 DbOrderInfo(),但是强类型的。
- VoDbOrderInfo overloads
- OrderInfo overloads in VoDb
+ VoDbOrderInfo 重载
+ VoDb 中的 OrderInfo 重载
- Open an index file and add specified orders to the order list in a work area.
+ 打开索引文件,并将指定的排序添加到工作区的排序列表中。
- The name of an index file, including an optional drive and directory. Use this argument with <cOrder> to remove ambiguity when there are two or more orders with the same name in different index files.
- The name of the order or a number representing its position in the order list. Using the order name is the preferred method since the position may be difficult to determine using multiple-order index files. Invalid values are ignored.
- TRUE if successful; otherwise, FALSE.
+ 索引文件的名称,包括可选的驱动器和目录。当不同索引文件中存在两个或多个同名排序时,将此参数与 <cOrder> 一起使用以消除歧义。
+ 排序的名称,或表示其在排序列表中位置的数字。建议使用排序名称,因为使用多排序索引文件时位置可能难以确定。无效的值将被忽略。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DbSetIndex() but strongly typed.
+ 此函数类似于 DbSetIndex(),但是强类型的。
- Remove orders from the order list in a work area and close associated index files.
+ 从工作区的排序列表中删除排序,并关闭相关的索引文件。
- The name of an index file, including an optional drive and directory. Use this argument with <cOrder> to remove ambiguity when there are two or more orders with the same name in different index files.
- The name of the order or a number representing its position in the order list. Using the order name is the preferred method since the position may be difficult to determine using multiple-order index files. Invalid values are ignored.
- TRUE if successful; otherwise, FALSE.
+ 索引文件的名称,包括可选的驱动器和目录。当不同索引文件中存在两个或多个同名排序时,将此参数与 <cOrder> 一起使用以消除歧义。
+ 排序的名称,或表示其在排序列表中位置的数字。建议使用排序名称,因为使用多排序索引文件时位置可能难以确定。无效的值将被忽略。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBClearIndex() but strongly typed.
+ 此函数类似于 DBClearIndex(),但是强类型的。
- Rebuild all orders in the order list of a work area.
+ 重建工作区排序列表中的所有排序。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like OrdListRebuild().
+ 此函数类似于 OrdListRebuild()。
- Set the controlling order for a work area.
+ 设置工作区的控制排序。
- The name of an index file, including an optional drive and directory. Use this argument with <cOrder> to remove ambiguity when there are two or more orders with the same name in different index files.
- The name of the order or a number representing its position in the order list. Using the order name is the preferred method since the position may be difficult to determine using multiple-order index files. Invalid values are ignored.
+ 索引文件的名称,包括可选的驱动器和目录。当不同索引文件中存在两个或多个同名排序时,将此参数与 <cOrder> 一起使用以消除歧义。
+ 排序的名称,或表示其在排序列表中位置的数字。建议使用排序名称,因为使用多排序索引文件时位置可能难以确定。无效的值将被忽略。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DbSetOrder() but strongly typed.
+ 此函数类似于 DbSetOrder(),但是强类型的。
- Set the controlling order for a work area.
+ 设置工作区的控制排序。
- The name of an index file, including an optional drive and directory. Use this argument with <cOrder> to remove ambiguity when there are two or more orders with the same name in different index files.
- The name of the order or a number representing its position in the order list. Using the order name is the preferred method since the position may be difficult to determine using multiple-order index files. Invalid values are ignored.
- This parameter returns the previous order
- TRUE if successful; otherwise, FALSE.
+ 索引文件的名称,包括可选的驱动器和目录。当不同索引文件中存在两个或多个同名排序时,将此参数与 <cOrder> 一起使用以消除歧义。
+ 排序的名称,或表示其在排序列表中位置的数字。建议使用排序名称,因为使用多排序索引文件时位置可能难以确定。无效的值将被忽略。
+ 此参数返回之前的排序
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DbSetOrder() but strongly typed.
+ 此函数类似于 DbSetOrder(),但是强类型的。
- Remove all records that have been marked for deletion from a database file.
+ 从数据库文件中删除所有标记为删除的记录。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DbPack().
+ 此函数类似于 DbPack()。
- VoDbPack() and CoreDb.Pack() are aliases
+ VoDbPack() 和 CoreDb.Pack() 是别名
@@ -1016,388 +994,384 @@
- VoDbRddCount() and CoreDb.RddCount() are aliases
+ VoDbRddCount() 和 CoreDb.RddCount() 是别名
- Return and optionally change settings controlled directly by the RDD.
- Ordinal number of the setting to set/retrieve.
- The returnvalue is returned through this parameter. When set on entry this is the new value of the setting.
- TRUE if successful; otherwise, FALSE.
- VoDbRddInfo overloads
- RddInfo overloads in VoDb
+ 返回并可选地更改由 RDD 直接控制的设置。
+ 要设置/检索的设置的序号。
+ 返回值通过此参数返回。如果在输入时已设置,则它是该设置的新值。
+ 如果成功,则为 TRUE;否则为 FALSE。
+ VoDbRddInfo 重载
+ VoDb 中的 RddInfo 重载
- Returns list of RDD names that are in use at this moment
+ 返回当前正在使用的 RDD 名称列表
- VoDbRddList() and CoreDb.RddList() are aliases
+ VoDbRddList() 和 CoreDb.RddList() 是别名
- Return an RDD name.
+ 返回 RDD 名称。
- The name of the RDD
+ RDD 的名称
- VoDbRddName() and CoreDb.RddName() are aliases
+ VoDbRddName() 和 CoreDb.RddName() 是别名
- Return and optionally change the default RDD for the application.
+ 返回并可选地更改应用程序的默认 RDD。
- The previous default RDD
+ 之前的默认 RDD
- VoDbRddSetDefault() and CoreDb.RddSetDefault() are aliases
+ VoDbRddSetDefault() 和 CoreDb.RddSetDefault() 是别名
- Restore the current record if it is marked for deletion.
+ 如果当前记录被标记为删除,则恢复该记录。
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBRecall().
+ 此函数类似于 DBRecall()。
- VoDbRecall() and CoreDb.Recall() are aliases
+ VoDbRecall() 和 CoreDb.Recall() 是别名
- Return the current record number.
+ 返回当前记录号。
- The 1 based current record number.
+ 从 1 开始的当前记录号。
- VoDbRecno() and CoreDb.Recno() are aliases
+ VoDbRecno() 和 CoreDb.Recno() 是别名
- Get the contents of the current record as an array of bytes
- An array of bytes that contains the current record.
+ 以字节数组形式获取当前记录的内容
+ 包含当前记录的字节数组。
- VoDbRecordGet() and CoreDb.RecordGet() are aliases
+ VoDbRecordGet() 和 CoreDb.RecordGet() 是别名
- Retrieve information about a record.
+ 检索有关记录的信息。
- This must match one of the values from the DbRecordInfo Enum
- Some of the DbRecordInfo enum values require a record number
- Some of the DbRecordInfo enum values require a new value.
- The returnvalue is returned through this parameter. When set on entry this is the new value of the setting.
- TRUE if successful; otherwise, FALSE.
- VoDbRecordInfo overloads
- RecordInfo overloads in VoDb
+ 这必须与 DbRecordInfo 枚举中的某个值匹配
+ 某些 DbRecordInfo 枚举值需要记录号
+ 某些 DbRecordInfo 枚举值需要新值。
+ 返回值通过此参数返回。如果在输入时已设置,则它是该设置的新值。
+ 如果成功,则为 TRUE;否则为 FALSE。
+ VoDbRecordInfo 重载
+ VoDb 中的 RecordInfo 重载
DbRecordInfo ENUM
- Update the current record from an array of bytes
- The bytes that form the record. Please note that if the DBF has a memo file, then this array must contain a valid position for the memo attached to the record.
- TRUE if successful; otherwise, FALSE.
+ 使用字节数组更新当前记录
+ 构成记录的字节。请注意,如果 DBF 具有备注文件,则此数组必须包含附加到该记录的备注的有效位置。
+ 如果成功,则为 TRUE;否则为 FALSE。
- VoDbRecordPut() and CoreDb.RecordPut() are aliases
+ VoDbRecordPut() 和 CoreDb.RecordPut() 是别名
- Return the record length in the current Workarea
+ 返回当前工作区中的记录长度
- Discard all the changes to the current workares
+ 放弃对当前工作区所做的所有更改
- TRUE if successful; otherwise, FALSE.
+ 如果成功,则为 TRUE;否则为 FALSE。
- Return the linking expression of a specified relation.
+ 返回指定关系的链接表达式。
- The position of the desired relation in the list of current work area relations. The relations are numbered according to the order in which they were defined by relation setting.
- The linking expression defined to <nRelation>.
- TRUE if successful; otherwise, FALSE.
+ 所需关系在当前工作区关系列表中的位置。关系按照通过关系设置定义的顺序编号。
+ 为 <nRelation> 定义的链接表达式。
+ 如果成功,则为 TRUE;否则为 FALSE。
- This function is like DBSetRelation().
+ 此函数类似于 DBSetRelation()。
- Lock the current record.
+ 锁定当前记录。
- The ID (usually a record number) of the record to be locked. If specified, record locks held by the current process are retained. If not specified, all locks held by the current process are released and the current record is assumed.
- TRUE if successful; otherwise, FALSE.
+ 要锁定的记录的 ID(通常为记录号)。如果指定,则保留当前进程持有的记录锁。如果未指定,则释放当前进程持有的所有锁,并以当前记录为准。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBRlock() but strongly typed.
+ 此函数类似于 DBRlock(),但具有强类型。
- Return the work area number of a relation.
+ 返回关系的工作区编号。
- The position of the desired relation in the list of work area relations. The relations are numbered according to the order in which they were defined by relation setting.
- TRUE if successful; otherwise, FALSE.
+ 所需关系在工作区关系列表中的位置。关系按照通过关系设置定义的顺序编号。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBRSelect() but strongly typed.
+ 此函数类似于 DBRSelect(),但具有强类型。
- VoDbRSelect() and CoreDb.RSelect() are aliases
+ VoDbRSelect() 和 CoreDb.RSelect() 是别名
- Move to the record having the specified key value.
+ 移动到具有指定键值的记录。
- Specifies the key value associated with the desired record.
- Determines how the work area is positioned if the specified key value is not found: TRUE performs a soft seek; FALSE does not.
- TRUE if successful; otherwise, FALSE.
+ 指定与所需记录关联的键值。
+ 确定在找不到指定键值时工作区如何定位:TRUE 执行软查找;FALSE 则不执行。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBSeek() but strongly typed.
+ 此函数类似于 DBSeek(),但具有强类型。
- Select a new work area and retrieve the current work area.
+ 选择新的工作区并获取当前工作区。
- The work area number for the new work area.
- The work area number for the old work area.
- TRUE if successful; otherwise, FALSE.
+ 新工作区的工作区编号。
+ 旧工作区的工作区编号。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBSelect() but strongly typed.
+ 此函数类似于 DBSelect(),但具有强类型。
- VoDbSelect() and CoreDb.Select() are aliases
+ VoDbSelect() 和 CoreDb.Select() 是别名
- Set a filter condition.
+ 设置过滤条件。
- Codeblock that defines the filter. Please note that some RDDs (such as Advangate) will NOT use this compiled codeblock.
- String version of the filter. Some RDDs (such as Advantage) use this condition instead of the codeblock
- TRUE if successful; otherwise, FALSE.
+ 定义过滤器的 Codeblock。请注意,某些 RDD(例如 Advangate)不会使用此已编译的 codeblock。
+ 过滤器的字符串形式。某些 RDD(例如 Advantage)会使用此条件而不是 codeblock。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBSetFilter() but strongly typed.
+ 此函数类似于 DBSetFilter(),但具有强类型。
- Set the found flag.
+ 设置 found 标志。
- TRUE if successful; otherwise, FALSE.
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBSetFound().
- VoDbSetFound() and CoreDb.SetFound() are aliases
+ 此函数类似于 DBSetFound()。
+ VoDbSetFound() 和 CoreDb.SetFound() 是别名
- Specify the code block for a locate condition.
+ 指定用于定位条件的代码块。
- TRUE if successful; otherwise, FALSE.
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBSetLocate() but strongly typed.
+ 此函数类似于 DBSetLocate(),但具有强类型。
- Relate a specified work area to the current work area.
+ 将指定的工作区与当前工作区建立关联。
- Alias of child area.
- Relational key as codeblock.
- Relational key as string.
- Name of the relation. Defaults to the parent alias + "_" + Child alias
- TRUE if successful; otherwise, FALSE.
+ 子工作区的别名。
+ 以 codeblock 形式表示的关系键。
+ 以字符串形式表示的关系键。
+ 关系的名称。默认为父别名 + "_" + 子别名
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBSetRelation() but strongly typed.
+ 此函数类似于 DBSetRelation(),但具有强类型。
- Set the locate condition.
- A Scope objhect describing the current scope.
- TRUE if successful; otherwise, FALSE.
+ 设置定位条件。
+ 描述当前范围的 Scope 对象。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- VoDbSetScope() and CoreDb.SetScope() are aliases
+ VoDbSetScope() 和 CoreDb.SetScope() 是别名
- Select a new work area.
+ 选择新的工作区。
- The number of the new work area. 0 indicates the first available free Workarea. -1 indicates the last available free Workarea.
- The newly selected work area.
+ 新工作区的编号。0 表示第一个可用的空闲工作区。-1 表示最后一个可用的空闲工作区。
+ 新选择的工作区。
- This function is like DBSetSelect() but strongly typed.
+ 此函数类似于 DBSetSelect(),但具有强类型。
- VoDbSetSelect() and CoreDb.SetSelect() are aliases
+ VoDbSetSelect() 和 CoreDb.SetSelect() 是别名
- Move the record pointer relative to the current record.
+ 相对于当前记录移动记录指针。
- The number of logical records to move, relative to the current record. A positive value means to skip forward, and a negative value means to skip backward.
- TRUE if successful; otherwise, FALSE.
+ 相对于当前记录要移动的逻辑记录数。正值表示向前跳过,负值表示向后跳过。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBSkip() but strongly typed.
+ 此函数类似于 DBSkip(),但具有强类型。
- DbSkip(), VoDbSkip() and CoreDb.Skip() are aliases
+ DbSkip()、VoDbSkip() 和 CoreDb.Skip() 是别名
- Position the cursor relative to its current position within the current scope.
+ 在当前范围内,相对于游标的当前位置对其进行定位。
- TRUE if successful; otherwise, FALSE.
+ 如果成功则返回 TRUE;否则返回 FALSE。
- VoDbSkipScope() and CoreDb.SkipScope() are aliases
+ VoDbSkipScope() 和 CoreDb.SkipScope() 是别名
- Copy records to a database file in sorted order.
- The work area number for the target Workarea.
- The field names to write specified as an _FieldNames object.
+ 按排序顺序将记录复制到数据库文件。
+ 目标工作区的工作区编号。
+ 要写入的字段名,以 _FieldNames 对象指定。
- The number of records to append, starting at the current record.
- The number of the record to append.
- TRUE processes only records from the current record to end-of-file. FALSE processes all records.
- The sort keys, specified as an _FieldNames object.
- TRUE if successful; otherwise, FALSE.
+ 要追加的记录数,从当前记录开始。
+ 要追加的记录的编号。
+ TRUE 表示仅处理从当前记录到文件结尾的记录。FALSE 表示处理所有记录。
+ 排序键,以 _FieldNames 对象指定。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- Select a new work area by specifying its alias as a string and return the number of the current work area.
+ 通过以字符串形式指定别名来选择新的工作区,并返回当前工作区的编号。
- The alias of the work area you want to select.
+ 要选择的工作区的别名。
- Copy one or more rows from one work area to another.
- The work area number for the target Workarea.
- The field names to write specified as an _FieldNames object.
+ 将一行或多行从一个工作区复制到另一个工作区。
+ 目标工作区的工作区编号。
+ 要写入的字段名,以 _FieldNames 对象指定。
- The sort keys, specified as an _FieldNames object.
- TRUE if successful; otherwise, FALSE.
+ 排序键,以 _FieldNames 对象指定。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- Copy a single row from one work area to another.
- The work area number for the target Workarea.
- The field names to write specified as an _FieldNames object.
- TRUE if successful; otherwise, FALSE.
+ 将单行从一个工作区复制到另一个工作区。
+ 目标工作区的工作区编号。
+ 要写入的字段名,以 _FieldNames 对象指定。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- VoDbTransRec() and CoreDb.TransRec() are aliases
+ VoDbTransRec() 和 CoreDb.TransRec() 是别名
- Release all locks for a work area.
+ 释放工作区的所有锁。
- The ID of the record to be unlocked. To omit, specify NULL_OBJECT.
- This unlocks all locked records or the whole file.
+ 要解锁的记录的 ID。若要省略,请指定 NULL_OBJECT。这将解锁所有已锁定的记录或整个文件。
- TRUE if successful; otherwise, FALSE.
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBUnlock().
+ 此函数类似于 DBUnlock()。
- Release all locks for all work areas.
- TRUE if successful; otherwise, FALSE.
+ 释放所有工作区的所有锁。
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DBUnlockAll().
+ 此函数类似于 DBUnlockAll()。
- VoDbUnlockAll() and CoreDb.UnlockAll() are aliases
+ VoDbUnlockAll() 和 CoreDb.UnlockAll() 是别名
- Open a file
+ 打开文件
- Open a database file.
+ 打开数据库文件。
- Open RDD in new Workarea ?
- RDDList structure that describes the RDD to use
- Name of the (dbf) file to open
- Alias to use for the Workarea
- Should the file be opened shared ?
- Should the file be opened readonly ?
- TRUE if successful; otherwise, FALSE.
+ 是否在新工作区中打开 RDD?
+ 描述要使用的 RDD 的 RDDList 结构
+ 要打开的 (dbf) 文件的名称
+ 用于工作区的别名
+ 文件是否以共享方式打开?
+ 文件是否以只读方式打开?
+ 如果成功则返回 TRUE;否则返回 FALSE。
- This function is like DbUseArea() but strongly typed.
+ 此函数类似于 DbUseArea(),但具有强类型。
- VoDbUseArea() and CoreDb.UseArea() are aliases
+ VoDbUseArea() 和 CoreDb.UseArea() 是别名
- Name of the RDD to use.
+ 要使用的 RDD 的名称。
- Type of the RDD to use.
+ 要使用的 RDD 的类型。
- Remove all records from the current Workarea.
- TRUE if successful; otherwise, FALSE.///
+ 从当前工作区中删除所有记录。
+ 如果成功则返回 TRUE;否则返回 FALSE。///
- This function is like DBZap().
+ 此函数类似于 DBZap()。
- VoDbZap() and CoreDb.Zap() are aliases
+ VoDbZap() 和 CoreDb.Zap() 是别名
- Convert a Date string to DateTime.
+ 将日期字符串转换为 DateTime。
- A string of numbers representing the month, day, and year, separated by any character other than a number. The month, day, and year digits must be in the format set by SetDateFormat() or SetDateCountry(). If the century digits are not specified, the century is determined by the rules of SetEpoch().
- A string representating the date format to use when converting the string to a date. Should consist of D, M and Y characters and separators.
+ 表示月、日和年的数字字符串,以数字以外的任意字符分隔。月、日和年的数字必须采用 SetDateFormat() 或 SetDateCountry() 所设置的格式。如果未指定世纪数字,则世纪由 SetEpoch() 的规则确定。
+ 表示将字符串转换为日期时所使用的日期格式的字符串。应由 D、M 和 Y 字符以及分隔符组成。
- The DateTime value that corresponds to the numbers specified in . If is not a valid date, CToDt() returns a DateTime.MinValue.
+ 与 中指定的数字相对应的 DateTime 值。如果 不是有效的日期,CToDt() 将返回 DateTime.MinValue。
- Convert an ANSI date string to DateTime
+ 将 ANSI 日期字符串转换为 DateTime
- A string in the ANSI form yyyy.mm.dd, where yy, mm, and dd represent year, month, and day respectively.
- The year, month, and day can be separated by any character other than a number.
- cDate is always interpreted as an ANSI string and is not dependent on SetDateFormat() or SetDateCountry().
- If the century digits are not specified, the century is determined by the rules of SetEpoch().
+ ANSI 格式 yyyy.mm.dd 的字符串,其中 yy、mm 和 dd 分别表示年、月和日。年、月和日可以用数字以外的任意字符分隔。cDate 始终被解释为 ANSI 字符串,不依赖于 SetDateFormat() 或 SetDateCountry()。如果未指定世纪数字,则世纪由 SetEpoch() 的规则确定。
- The date value that corresponds to the numbers specified in . If cDate is not a valid ANSI date, CToDAnsi() returns a DateTime.MinValue.
+ 与 中指定的数字相对应的日期值。如果 cDate 不是有效的 ANSI 日期,CToDAnsi() 将返回 DateTime.MinValue。
- Convert a string value to a logic.
+ 将字符串值转换为逻辑值。
@@ -1406,527 +1380,524 @@
Logic2Bin
- Enum that matches the various FoxPro cursor properties, used in CursorGetProp() and CursorSetProp()
+ 与各种 FoxPro 游标属性相对应的枚举,用于 CursorGetProp() 和 CursorSetProp()
- Add a property - value pair to the collection.
- Propery to store.
- Value to store
+ 向集合中添加属性 - 值对。
+ 要存储的属性。
+ 要存储的值
- Get the value for a property
- Property name to look for.
- The value from the collection or an empty value of the right type.
+ 获取属性的值
+ 要查找的属性名称。
+ 集合中的值,或相应类型的空值。
- Get the value for a property or an empty value when the property has not been defined
- Property to look for.
- Expected return type for the value
- The value from the collection or an empty value of the right type.
+ 获取属性的值;如果该属性尚未定义,则获取空值
+ 要查找的属性。
+ 值的预期返回类型
+ 集合中的值,或相应类型的空值。
- Enum that matches the various FoxPro database properties, used in DbGetProp() and DbSetProp()
+ 与各种 FoxPro 数据库属性相对应的枚举,用于 DbGetProp() 和 DbSetProp()
- Applies when using remote views, a shared connection, and to cursors created using ODBC.
+ 适用于使用远程视图、共享连接,以及使用 ODBC 创建的游标。
- The connection mode. (Default) False (.F.) specifies a synchronous connection. True (.T.) specifies an asynchronous connection.Read/write.
+ 连接模式。(默认)False (.F.) 指定同步连接。True (.T.) 指定异步连接。可读/写。
- The batch-processing mode. (Default) True (.T.) specifies the connection that operates in batch mode.
+ 批处理模式。(默认)True (.T.) 指定连接以批处理模式运行。
- The number of update statements sent to the back end for views. 1 is the default. Adjusting this value can greatly increase update performance. (N)
+ 为视图发送到后端的更新语句数量。默认值为 1。调整此值可以大幅提高更新性能。(N)
- The field caption. (C) If an equal sign (=) precedes the value of this property, Visual FoxPro evaluates the value as an expression. Otherwise, it is treated as a string literal.Read/write. FIELD
+ 字段标题。(C) 如果该属性值前面带有等号 (=),Visual FoxPro 会将该值作为表达式求值。否则,将其视为字符串文字。可读/写。FIELD
- Class (Internal)
+ 类 (内部)
- X# Column Name property (not persisted in DBC)
+ X# 列名属性(不保存在 DBC 中)
- The text of the field comment. (C)
+ 字段注释的文本。(C)
- Contains true (.T.) (default) if memo fields (of type Memo, General, or Picture, or, for remote views, type Timestamp) are included in the WHERE clause for updates; otherwise, contains false (.F.).Read/write.
+ 如果更新时 WHERE 子句中包含备注字段(Memo、General 或 Picture 类型,对于远程视图还包括 Timestamp 类型),则为 true (.T.)(默认);否则为 false (.F.)。可读/写。
- The named connection used when the view is opened. (C)
+ 打开视图时使用的命名连接。(C)
- The login connection string.
+ 登录连接字符串。
- The connection timeout interval in seconds. The default is 0 (wait indefinitely).
+ 连接超时间隔,以秒为单位。默认值为 0(无限期等待)。
- The name of the server database specified with the DATABASE clause in the CREATE CONNECTION command or in the Connection Designer.
+ 在 CREATE CONNECTION 命令或连接设计器中使用 DATABASE 子句指定的服务器数据库的名称。
- The name of the data source as defined in the Odbc.ini file.
+ 在 Odbc.ini 文件中定义的数据源名称。
- The data type for a field in a view. Initially set to the data type for the field in the data source.
+ 视图中字段的数据类型。初始设置为数据源中该字段的数据类型。
- Relative path and filename of external program file containing DBC Events code. (C)
+ 包含 DBC Events 代码的外部程序文件的相对路径和文件名。(C)
- Enabled state of DBC Events. Set to True (.T.) to enable. (L)
+ DBC Events 的启用状态。设置为 True (.T.) 以启用。(L)
- The field default value.(C)
+ 字段默认值。(C)
- The Delete trigger expression.
+ Delete 触发器表达式。
- Specifies if a pending transaction is committed or rolled back when SQLDISCONNECT( ) is called for the last connection handle.
+ 指定在为最后一个连接句柄调用 SQLDISCONNECT( ) 时,挂起的事务是提交还是回滚。
- Name of the class used for field mapping. (C)
+ 用于字段映射的类的名称。(C)
- Path to the class library specified with the DisplayClass property.(C)
+ DisplayClass 属性中指定的类库的路径。(C)
- Contains a numeric value that determines when the ODBC Login dialog box is displayed.
+ 包含一个数值,用于确定何时显示 ODBC 登录对话框。
- Contains a numeric value that determines when the ODBC Login dialog box is displayed.
+ 包含一个数值,用于确定何时显示 ODBC 登录对话框。
- If True (.T.), data is fetched only when needed, such as when record pointer moves to a row that has not been fetched. If False (.F.), additional data is fetched during idle time. (Default)
+ 如果为 True (.T.),则仅在需要时才提取数据,例如当记录指针移动到尚未提取的行时。如果为 False (.F.),则在空闲时间提取额外的数据。(默认)
- Contains true (.T.) (default) if memo and general fields are fetched with the view results; otherwise, contains false (.F.).
+ 如果备注字段和通用字段随视图结果一起提取,则为 true (.T.)(默认);否则为 false (.F.)。
- Contains the number of records fetched at a time from the remote tables. The default is 100 records. Setting FetchSize to –1 retrieves the complete result set, limited by the MaxRecords setting
+ 包含每次从远程表中提取的记录数。默认值为 100 条记录。将 FetchSize 设置为 –1 将检索完整的结果集,并受 MaxRecords 设置的限制
- The field display format. (C) .Read/write.
+ 字段显示格式。(C) 可读/写。
- The idle timeout interval in minutes. Timeout is checked no more than once per minute, therefore it is possible that active connections might deactivate one or two minutes later after the specified time interval has elapsed. The default value is 0 (wait indefinitely).
+ 空闲超时间隔,以分钟为单位。超时检查每分钟最多进行一次,因此活动连接可能在经过指定时间间隔之后一到两分钟才会被停用。默认值为 0(无限期等待)。
- The field input format. (C) .Read/write.
+ 字段输入格式。(C) 可读/写。
- The Insert trigger expression.
+ Insert 触发器表达式。
- The IsUnique flag for an Index Object
+ 索引对象的 IsUnique 标志
- Contains True (.T.) if the field is specified in an index key expression; otherwise, contains False (.F.). (L)
+ 如果该字段在索引键表达式中被指定,则为 True (.T.);否则为 False (.F.)。(L)
- The maximum number of records fetched when result sets are returned. (N) The default is – 1 (all rows are returned). A value of 0 specifies that the view is executed but no results are fetched.
+ 返回结果集时提取的最大记录数。(N) 默认值为 – 1(返回所有行)。值为 0 表示执行视图但不提取任何结果。
- Null (Internal)
+ Null (内部)
- Is the table offline (this is not stored as a real property but derived from the extistence of the properties OfflineRecs, OfflineRemRecs and Path.
+ 表是否处于脱机状态(这不是作为真正的属性存储的,而是根据属性 OfflineRecs、OfflineRemRecs 和 Path 是否存在而得出)。
- When this property is found the table is offline. The Path property then returns the OffLinePath
+ 找到此属性时,表处于脱机状态。此时 Path 属性返回 OffLinePath
- # of remote records offline.
+ 脱机的远程记录数。
- The size of the network packet used by the connection. Adjusting this value can improve performance. The default value is 4096 bytes (4K).
+ 连接使用的网络数据包的大小。调整此值可以提高性能。默认值为 4096 字节 (4K)。
- The WHERE clause parameters. The format for the parameters is ''ParameterName1, 'Type1'; ParameterName2, 'Type2'; ...''
+ WHERE 子句参数。参数的格式为 ''ParameterName1, 'Type1'; ParameterName2, 'Type2'; ...''
- The connection password.
+ 连接密码。
- The relative path with respect to the DBC to the table including the name of the file.
+ 相对于 DBC 的表的相对路径,包括文件名。
- Contains True (.T.) if SQL statements are prepared for subsequent REQUERY( ) function calls. REQUERY( ) is used to retrieve data again for a SQL view. See SQLPREPARE( ) for additional information about preparing SQL statements. The default is false (.F.).
+ 如果为后续的 REQUERY( ) 函数调用准备了 SQL 语句,则为 True (.T.)。REQUERY( ) 用于重新检索 SQL 视图的数据。有关准备 SQL 语句的更多信息,请参阅 SQLPREPARE( )。默认值为 false (.F.)。
- The tag name of the primary key. (C)
+ 主键的标记名称。(C)
- The query timeout interval in seconds. The default value is 0 (wait indefinitely).
+ 查询超时间隔,以秒为单位。默认值为 0(无限期等待)。
- ChildTag for a Relation Object
+ 关系对象的 ChildTag
- Related table for a Relation Object
+ 关系对象的关联表
- Related tag for a Relatin Object
+ 关系对象的关联标记
- The rule expression. (C)
+ 规则表达式。(C)
- The row rule error text.(C)
+ 行规则错误文本。(C)
- Contains true (.T.) if a SQL update query is sent to update remote tables; otherwise, contains false (.F.) (default).
+ 如果发送 SQL 更新查询以更新远程表,则为 true (.T.);否则为 false (.F.)(默认)。
- Contains true (.T.) if the view can share its connection handle with other connections; otherwise, contains false (.F.).
+ 如果视图可以与其他连接共享其连接句柄,则为 true (.T.);否则为 false (.F.)。
- The view source. (N) SourceType may assume the following values: 1 - The view uses local tables.2 - The view uses remote tables.
+ 视图源。(N) SourceType 可以取以下值:1 - 视图使用本地表。2 - 视图使用远程表。
- The SQL statement executed when the view is opened.(C)
+ 打开视图时执行的 SQL 语句。(C)
- A comma-delimited list of the names of the tables.(C)
+ 以逗号分隔的表名列表。(C)
- Timestamp (internal)
+ Timestamp (内部)
- Contains a numeric value that determines how the connection manages transactions on the remote table.
+ 包含一个数值,用于确定连接如何管理远程表上的事务。
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Not defined
+ 未定义
- Contains True (.T.) if the field can be updated; otherwise, contains False (.F.).
+ 如果该字段可以更新,则为 True (.T.);否则为 False (.F.)。
- The name of the field used when data in the field is updated to the remote table. By default, the remote table field name.Read/write.
+ 将字段中的数据更新到远程表时使用的字段名称。默认为远程表的字段名称。可读/写。
- The Update trigger expression.
+ Update 触发器表达式。
- The update type. Valid values are: 1 or DB_UPDATE (from Foxpro.h). The old data is updated with the new data (default). 2 or DB_DELETEINSERT (from Foxpro.h). The old data is deleted and the new data is inserted.
+ 更新类型。有效值为:1 或 DB_UPDATE(来自 Foxpro.h)。用新数据更新旧数据(默认)。2 或 DB_DELETEINSERT(来自 Foxpro.h)。删除旧数据并插入新数据。
- The minimum size (in bytes) for which result columns are returned in memo fields. For example, if the width of a column result is greater than the value of UseMemoSize, the column result is stored in a memo field. UseMemoSize may vary from 1 to 255; the default value is 255.
+ 结果列以备注字段形式返回的最小大小(以字节为单位)。例如,如果列结果的宽度大于 UseMemoSize 的值,则该列结果存储在备注字段中。UseMemoSize 的范围可以是 1 到 255;默认值为 255。
- The user identification.
+ 用户标识。
- The database version number. (N)
+ 数据库版本号。(N)
- The amount of time in milliseconds that elapses before Visual FoxPro checks whether the SQL statement has completed executing.
+ Visual FoxPro 检查 SQL 语句是否已执行完毕之前所经过的时间,以毫秒为单位。
- The WHERE clause for updates to remote tables.WhereType may assume the following values: 1 or DB_KEY , 2 or DB_KEYANDUPDATABLE, 3 or DB_KEYANDMODIFIED and 4 or DB_KEYANDTIMESTAMP
+ 更新远程表时使用的 WHERE 子句。WhereType 可以取以下值:1 或 DB_KEY,2 或 DB_KEYANDUPDATABLE,3 或 DB_KEYANDMODIFIED,以及 4 或 DB_KEYANDTIMESTAMP
- Add a DataSession to the list of open datasessions
- The DataSession to add
+ 将 DataSession 添加到已打开的数据会话列表中
+ 要添加的 DataSession
- Remove a DataSession from the list of open datasessions
- The DataSession to remove
+ 从已打开的数据会话列表中移除 DataSession
+ 要移除的 DataSession
- Construct a new datasession
- The name for this datasession.
+ 构造新的数据会话
+ 此数据会话的名称。
- Construct a new datasession
- The name for this datasession.
- The ID for the datasession.
+ 构造新的数据会话
+ 此数据会话的名称。
+ 数据会话的 ID。
- The unique id for the datasession
+ 数据会话的唯一 ID
- The name for the datasession.
+ 数据会话的名称。
- List of all open DataSessions
+ 所有已打开的 DataSession 的列表
- Values that match the XBase DateCountry defines. They are used to set the date format.
- Please note that although there are different values for British and French, the date formats are the same.
+ 与 XBase DateCountry 定义相匹配的值。它们用于设置日期格式。
+ 请注意,虽然英国和法国有不同的值,但日期格式是相同的。
- Helper class to open, close and select a database
+ 用于打开、关闭和选择数据库的辅助类
- Close a database.
+ 关闭数据库。
- Create a database.
+ 创建数据库。
- Dump a database to the terminal window.
+ 将数据库转储到终端窗口。
- Dump the conents of a properties collection.
+ 转储属性集合的内容。
- Find a database by name.
+ 按名称查找数据库。
- Get the current active database.
+ 获取当前活动的数据库。
- Check if a database is used/opened.
+ 检查数据库是否已使用/打开。
- Validate a property type.
+ 验证属性类型。
- Validate a property name.
+ 验证属性名称。
- Open a database.
+ 打开数据库。
- Select a database.
+ 选择数据库。
- DeSelect a database.
+ 取消选择数据库。
- Class that stores information about an ODBC connection in a DBC
+ 存储 DBC 中 ODBC 连接信息的类
- Is the database active ?
+ 数据库是否处于活动状态?
- Area number for the cursor in the Databases Datasession
+ Databases 数据会话中游标的工作区编号
- List of connections
+ 连接列表
- Filename for the database
+ 数据库的文件名
- Find a connection in the Database container.
- The connection name to look for.
+ 在数据库容器中查找连接。
+ 要查找的连接名称。
- Find a table in the Database container.
- The table name to look for.
+ 在数据库容器中查找表。
+ 要查找的表名。
- Find a view in the Database container.
- The view name to look for.
+ 在数据库容器中查找视图。
+ 要查找的视图名称。
- Loads the tables, views and connections from the DBC file
+ 从 DBC 文件加载表、视图和连接
- Worker method for DbGetProp()
+ DbGetProp() 的工作方法
- Alias name for the database
+ 数据库的别名
-- todo --
- Worker method for DbSetProp()
+ DbSetProp() 的工作方法
- List of tables
+ 表列表
- List of views
+ 视图列表
- Class that stores information about a field in a DBC
+ 存储 DBC 中字段信息的类
- Class that stores information about an index in a DBC
+ 存储 DBC 中索引信息的类
- This classes manages open database. Both databases that are opened explicitely and also databases that are opened
- for "free" tables that have a backlink to a database
+ 此类管理已打开的数据库,包括显式打开的数据库,以及为具有指向数据库的反向链接的“自由”表而打开的数据库
- The Databases are opened like 'normal' tables but in a separate DataSession.
- The DoForDataBase() method selects this special datasession, executes the action that is passed as parameter
- and restores the original datasession. This way you can seek, evaluate macros etc without disturbing the normal opened cursors.
+ 数据库像“普通”表一样打开,但处于单独的数据会话中。
DoForDataBase() 方法选择此特殊数据会话,执行作为参数传入的操作,然后恢复原来的数据会话。这样您就可以在不干扰正常打开的游标的情况下进行查找、计算宏等操作。
- Close a Database
- Alias name of the database to close.
- TRUE when the Database was open and was closed succesfully, otherwise FALSE.
+ 关闭数据库
+ 要关闭的数据库的别名。
+ 如果数据库已打开并成功关闭,则返回 TRUE,否则返回 FALSE。
- Create a new DBC file
- The fully qualified filename to create.
- TRUE when the database file was created successfully.
+ 创建新的 DBC 文件
+ 要创建的完全限定文件名。
+ 如果数据库文件创建成功,则返回 TRUE。
- Enhance the DBC name. Adds the extension and path when needed.
- Name of the file. The extension and path are optional.
- Name with DBC extension when needed and with full path information when found.
+ 完善 DBC 名称。在需要时添加扩展名和路径。
+ 文件名。扩展名和路径是可选的。
+ 名称,在需要时带有 DBC 扩展名,并在找到时带有完整的路径信息。
- Search a Database by file name
- The fully qualified filename to look for, so MUST have an extension and path.
- The database object (when found) otherwise NULL_OBJECT.
+ 按文件名搜索数据库
+ 要查找的完全限定文件名,因此必须包含扩展名和路径。
+ 数据库对象(如果找到),否则为 NULL_OBJECT。
- Search a Database by name
- Alias name of the database to close.
- The database object (when found) otherwise NULL_OBJECT.
+ 按名称搜索数据库
+ 要关闭的数据库的别名。
+ 数据库对象(如果找到),否则为 NULL_OBJECT。
- Open a DBC file. This does NOT make the database the active database
- Filename of the database to open.
- Should the database be opened in Shared mode
- Should the database be opened Readonly
- Should the structure of the database be validated.
- TRUE when opened succesfully. When the database was already open then FALSE is returned.
+ 打开 DBC 文件。这不会使该数据库成为活动数据库
+ 要打开的数据库的文件名。
+ 数据库是否应以共享模式打开
+ 数据库是否应以只读方式打开
+ 是否应验证数据库的结构。
+ 如果打开成功则返回 TRUE。如果数据库已经打开,则返回 FALSE。
- Validate the DBC structure
- TRUE when the structure is OK, otherwise FALSE.
+ 验证 DBC 结构
+ 如果结构正确则返回 TRUE,否则返回 FALSE。
- Calculate the column type from the FieldType
+ 根据 FieldType 计算列类型
- Initializes a new instance of the DbColumnInfo class
+ 初始化 DbColumnInfo 类的新实例
- Initializes a new instance of the DbColumnInfo class
+ 初始化 DbColumnInfo 类的新实例
- DotNet datatype of the column
+ 列的 DotNet 数据类型
- Numeric Precision
+ 数值精度
- Numeric Scale
+ 数值小数位数
- Numeric Precision
+ 数值精度
- Class that stores other info about Databases, such as the source and object code for Database
+ 存储有关数据库的其他信息的类,例如数据库的源代码和目标代码
- Class that stores information about a relation in a DBC
+ 存储 DBC 中关系信息的类
- The relational rules for Insert, Update, Delete.
+ Insert、Update、Delete 的关系规则。
- Class that stores information about a table in a DBC
- When opened the Fields, Indexes and Relations are not read. They need to be explicitely loaded with a call to GetData()
+ 存储 DBC 中表信息的类
+ 打开时不会读取字段、索引和关系。需要通过调用 GetData() 显式加载它们
- The database in which this table is defined.
+ 定义此表的数据库。
- The collection of fields
+ 字段集合
- The collection of indexes
+ 索引集合
- The Table path as stored in the DBC file.
+ DBC 文件中存储的表路径。
- The collection of relations
+ 关系集合
- Implementation of the ICurrency interface that can be used by the RDD system.
+ ICurrency 接口的实现,可供 RDD 系统使用。
@@ -1934,17 +1905,17 @@
- Class that stores information about a view in a DBC
- When opened the Fields etc are not read. They need to be explicitely loaded with a call to GetData()
+ 存储 DBC 中视图信息的类
+ 打开时不会读取字段等内容。需要通过调用 GetData() 显式加载它们
- The database in which this table is defined.
+ 定义此表的数据库。
- The collection of fields
+ 字段集合
- Implementation of the IDate interface that can be used by the RDD system.
+ IDate 接口的实现,可供 RDD 系统使用。
@@ -1952,67 +1923,67 @@
- Helper class to store the scope and codeblock for a DbEval() operation.
+ 用于存储 DbEval() 操作的范围和 codeblock 的辅助类。
- A code block to be evaluated with DbEval() on each row of the work area that is in the range defined by ScopeInfo.
+ 要使用 DbEval() 对工作区中位于 ScopeInfo 所定义范围内的每一行求值的代码块。
- Construct a DbEvalInfo object.
+ 构造 DbEvalInfo 对象。
- A DbScopeInfo structure limiting the evaluation of Block.
+ 限制 Block 求值范围的 DbScopeInfo 结构。
- '+' = AutoInc, 4 bytes
+ '+' = AutoInc,4 字节
- 'Z' 8 byte Currency
+ 'Z' 8 字节货币类型
- '8' Same as 'B'
+ '8' 与 'B' 相同
- '2' 2 byte int, autoInc
+ '2' 2 字节整数,autoInc
- '4' 4 byte int, autoInc
+ '4' 4 字节整数,autoInc
- '=' = ModTime, 8 bytes
+ '=' = ModTime,8 字节
- '^' = RowVer, 8 bytes
+ '^' = RowVer,8 字节
- '@' = Timestamp 8 bytes
+ '@' = Timestamp 8 字节
- Helper class to store a filter condition for a table.
+ 用于存储表的过滤条件的辅助类。
- A flag that is TRUE if a filter is active.
+ 如果过滤器处于活动状态则为 TRUE 的标志。
- Clear the filter fields.
+ 清除过滤器字段。
- Clone the filter object.
+ 克隆过滤器对象。
- Construct a DbFilterInfo object.
+ 构造 DbFilterInfo 对象。
- A code block representing the condition that is evaluated at each cursor location. If the result of the evaluation is FALSE, the cursor location requested is invalid according to the current filter condition.
+ 表示在每个游标位置求值的条件的代码块。如果求值结果为 FALSE,则根据当前过滤条件,所请求的游标位置无效。
- A string representing the source code for itmCobExpr.
+ 表示 itmCobExpr 源代码的字符串。
- A flag that is TRUE if a filter is optimized.
+ 如果过滤器已优化则为 TRUE 的标志。
- Implementation of the IFloat interface that can be used by the RDD system.
+ IFloat 接口的实现,可供 RDD 系统使用。
@@ -2020,16 +1991,16 @@
- Helper structure to store information needed to lock a row or table for exclusive access.
+ 用于存储以独占方式访问行或表所需锁定信息的辅助结构。
- A constant indicating the type of lock to obtain. The possible values are of the Lockmethod enum.
+ 指示要获取的锁类型的常量。可能的值来自 Lockmethod 枚举。
- An Item indicating the ID of the row to lock. This member is meaningful only if Method is set to EXCLUSIVE or MULTIPLE.
+ 一个 Item,指示要锁定的行的 ID。仅当 Method 设置为 EXCLUSIVE 或 MULTIPLE 时,此成员才有意义。
- A flag that is TRUE if the lock operation was successful.
+ 如果锁定操作成功,则该标志为 TRUE。
@@ -2038,337 +2009,334 @@
- Provides data for the Notify event of the IDbNotify interface.
+ 为 IDbNotify 接口的 Notify 事件提供数据。
- Specific data that describes the object.
+ 描述该对象的特定数据。
- The type of event that happened.
+ 发生的事件类型。
- Helper class to store information needed to open a table.
+ 用于存储打开表所需信息的辅助类。
- Unique Alias that the table has. This must be a valid XBase Identifier
+ 表所具有的唯一别名。它必须是有效的 XBase 标识符
- Construct a DbOpenInfo object.
+ 构造一个 DbOpenInfo 对象。
- The extension for the table that must be opened.
+ 必须打开的表的扩展名。
- Return the numeric FileMode based on the Shared and Readonly flags
+ 根据 Shared 和 Readonly 标志返回数值类型的 FileMode
- The filename (optionally includig a path) for the table that must be opened. Does not have an extension.
+ 必须打开的表的文件名(可选择包含路径)。不含扩展名。
- Construct a DbOpenInfo object.
- The full name (filename + extension) of the file.
+ 构造一个 DbOpenInfo 对象。
+ 文件的完整名称(文件名 + 扩展名)。
- Should the table be opened Shared?
+ 表是否应以共享方式打开?
- Workarea number in which the table will be opened.
+ 将在其中打开表的工作区编号。
- The following numbers are reserved but not implemented yet.
+ 以下数字为保留值,但尚未实现。
- Helper class to store information needed to create a conditional order.
+ 用于存储创建条件索引顺序所需信息的辅助类。
- A flag that is TRUE if one or more valid conditions have been specified in the structure.
+ 如果结构中指定了一个或多个有效条件,则该标志为 TRUE。
- A flag that is TRUE if open orders should remain open while the new order is being created.
+ 如果在创建新索引顺序期间已打开的索引顺序应保持打开状态,则该标志为 TRUE。
- A flag that is TRUE if all rows are to be processed during order creation.
+ 如果在创建索引顺序期间要处理所有行,则该标志为 TRUE。
- Collation for the FoxPro INDEX ON command
+ FoxPro INDEX ON 命令的排序规则
- A flag that is TRUE if the new order will be a custom built order.
+ 如果新的索引顺序为自定义构建的索引顺序,则该标志为 TRUE。
- A flag that is TRUE if the order should be created in descending order.
+ 如果索引顺序应按降序创建,则该标志为 TRUE。
- A code block defining the expression to evaluate every StepSize rows during the creation of the order. The code block referenced should return a logical value: TRUE indicates that creation of the order should continue normally, and FALSE indicates that order creation should terminate.
+ 一个代码块,定义在创建索引顺序期间每 StepSize 行要计算的表达式。所引用的代码块应返回逻辑值:TRUE 表示索引顺序的创建应正常继续,FALSE 表示索引顺序的创建应终止。
- A code block defining the for condition to use for the creation and maintenance of the order.
+ 一个代码块,定义用于创建和维护索引顺序的 for 条件。
- A string defining the for condition to use for the creation and maintenance of the order.
+ 一个字符串,定义用于创建和维护索引顺序的 for 条件。
- Binary option for the FoxPro INDEX ON command
+ FoxPro INDEX ON 命令的 Binary 选项
- Candidate option for the FoxPro INDEX ON command
+ FoxPro INDEX ON 命令的 Candidate 选项
- The number of rows to process for order creation.
+ 创建索引顺序时要处理的行数。
- A flag that is TRUE if the for condition may NOT be optimized,
+ 如果 for 条件不可被优化,则该标志为 TRUE,
- A single row number to include in the order.
+ 要包含在索引顺序中的单个行号。
- A flag that is TRUE if only the rows specified by lStartRecno through end-of-file are to be included in the order.
+ 如果仅包含从 lStartRecno 到文件末尾的行,则该标志为 TRUE。
- A flag indicating whether the order is to be scoped. fScoped will be TRUE if WhileBlock, NextCount, Recno, Rest, or All is specified.
+ 指示索引顺序是否带范围的标志。如果指定了 WhileBlock、NextCount、Recno、Rest 或 All,则 fScoped 为 TRUE。
- The row at which to begin processing when either the NextCount or Rest scoping options are specified.
+ 指定 NextCount 或 Rest 范围选项时开始处理的行。
- The frequency of the evaluation of EvalBlock.
+ EvalBlock 的计算频率。
- A flag that is TRUE if only rows in the controlling order are to be included in the order.
+ 如果仅包含控制索引顺序中的行,则该标志为 TRUE。
- A code block defining the while condition to use for the creation of the order. An empty value indicates that no while condition is being imposed.
+ 一个代码块,定义用于创建索引顺序的 while 条件。空值表示未施加 while 条件。
- A string defining the for while condition to use for the creation and maintenance of the order.
+ 一个字符串,定义用于创建和维护索引顺序的 while 条件。
- Helper class to store information needed to create a new order.
+ 用于存储创建新索引顺序所需信息的辅助类。
- The index file name.
+ 索引文件名。
- A code block containing the key expression defining the order imposed on the work area.
+ 一个代码块,包含定义施加于工作区的索引顺序的键表达式。
- The key expression defining the order.
+ 定义索引顺序的键表达式。
- A DbOrderCondInfo object containing information about the condition (if any) for the order.
+ 一个 DbOrderCondInfo 对象,包含有关索引顺序的条件(如果有)的信息。
- The order name or number to create in BagName.
+ 要在 BagName 中创建的索引顺序名称或编号。
- A flag that is TRUE if the order should contain only unique keys.
+ 如果索引顺序应仅包含唯一键,则该标志为 TRUE。
- Helper class to store information needed to open/address an order.
+ 用于存储打开/寻址索引顺序所需信息的辅助类。
- A flag that is TRUE if all tags of the index file must be opened.
+ 如果必须打开索引文件的所有标记,则该标志为 TRUE。
- The index file name.
+ 索引文件名。
- A code block containing the key expression defining the order imposed on the work area.
+ 一个代码块,包含定义施加于工作区的索引顺序的键表达式。
- An object containing the order name or number
+ 包含索引顺序名称或编号的对象
- Return value for some order operations.
+ 某些索引顺序操作的返回值。
- Register an object that will receive notification messages for Workarea events.
- TRUE when registration succceeded. FALSE when the client was already registered
+ 注册一个将接收 Workarea 事件通知消息的对象。
+ 注册成功时为 TRUE。如果客户端已注册,则为 FALSE
- Helper class to store a list of relational information.
+ 用于存储关系信息列表的辅助类。
- A code block used to reposition the cursor of the child table when this relation is resolved.
+ 一个代码块,用于在解析此关系时重新定位子表的游标。
- A reference to the child RDD for the relation.
+ 对该关系的子 RDD 的引用。
- The expression used to reposition the cursor of the child table when this relation is resolved.
+ 用于在解析此关系时重新定位子表游标的表达式。
- name of the relation. Defaults to the parent alias = '_' + child alias.
+ 关系的名称。默认值为父别名 = '_' + 子别名。
- A reference to the parent RDD for the relation.
+ 对该关系的父 RDD 的引用。
- Helper class to store references to all of the scope clause expressions.
+ 用于存储对所有范围子句表达式的引用的辅助类。
- Clear the scope fields.
+ 清除范围字段。
- Clone the scopeinfo object.
+ 克隆 scopeinfo 对象。
- Construct a DbScopeInfo object.
+ 构造一个 DbScopeInfo 对象。
- A code block representing the conditional for clause. A for condition is, essentially, a filter that hides rows for which the condition evaluates to FALSE. The string value is provided for storage, while the code block is provided as a parameter for the EvalBlock() method.
+ 一个代码块,表示条件 for 子句。for 条件本质上是一个过滤器,用于隐藏条件计算结果为 FALSE 的行。字符串值用于存储,而代码块则作为参数提供给 EvalBlock() 方法。
- A string representing the conditional for clause. A for condition is, essentially, a filter that hides rows for which the condition evaluates to FALSE. The string value is provided for storage, while the code block is provided as a parameter for the EvalBlock() method.
+ 一个字符串,表示条件 for 子句。for 条件本质上是一个过滤器,用于隐藏条件计算结果为 FALSE 的行。字符串值用于存储,而代码块则作为参数提供给 EvalBlock() 方法。
- A flag that is TRUE if a process should ignore duplicate key values.
+ 如果进程应忽略重复的键值,则该标志为 TRUE。
- A flag that is TRUE if a process should ignore any filter condition imposed on the current work area.
+ 如果进程应忽略施加于当前工作区的任何过滤条件,则该标志为 TRUE。
- A flag that is TRUE if a process should include deleted rows.
+ 如果进程应包含已删除的行,则该标志为 TRUE。
- A flag that is TRUE if the last row of the current scope is required.
+ 如果需要当前范围的最后一行,则该标志为 TRUE。
- Permits continuation of a process for the next lNext rows, while obeying for and while clauses.
+ 允许在遵循 for 和 while 子句的同时,对接下来的 lNext 行继续执行某个进程。
- Permits continuation of a process for a single row number, while obeying for and while clauses.
+ 允许在遵循 for 和 while 子句的同时,对单个行号继续执行某个进程。
- A flag that is TRUE if a process should continue stepping through data from the current work area cursor position until logical end-of-file.
+ 如果进程应从当前工作区游标位置开始持续遍历数据直到逻辑文件末尾,则该标志为 TRUE。
- A code block representing the conditional while clause. A while condition permits continuation of a process that steps through rows until the condition evaluates to FALSE. The string value is provided for storage, while the code block is provided as a parameter for the EvalBlock() method.
+ 一个代码块,表示条件 while 子句。while 条件允许逐行遍历的进程持续执行,直到条件计算结果为 FALSE。字符串值用于存储,而代码块则作为参数提供给 EvalBlock() 方法。
- A string representing the conditional while clause. A while condition permits continuation of a process that steps through rows until the condition evaluates to FALSE. The string value is provided for storage, while the code block is provided as a parameter for the EvalBlock() method.
+ 一个字符串,表示条件 while 子句。while 条件允许逐行遍历的进程持续执行,直到条件计算结果为 FALSE。字符串值用于存储,而代码块则作为参数提供给 EvalBlock() 方法。
- Helper structure to store information needed to perform a seek operation
+ 用于存储执行查找(seek)操作所需信息的辅助结构
- A flag that is TRUE if the last occurrence of the specified key value is to be sought, rather than the first.
+ 如果要查找指定键值的最后一次出现而不是第一次出现,则该标志为 TRUE。
- A flag that is TRUE if a soft seek is to be performed.
+ 如果要执行软查找(soft seek),则该标志为 TRUE。
- An object containing the key value to find.
+ 包含要查找的键值的对象。
- Helper class to store information needed to perform a physical sort.
+ 用于存储执行物理排序所需信息的辅助类。
- Construct a DbSortInfo object.
+ 构造一个 DbSortInfo 对象。
- Number of items in the Items array.
+ Items 数组中的项数。
- An array of DbSortItem structures defining the key values for the sort. Note that the key values are processed in the order that they appear in this array.
+ 一个 DbSortItem 结构数组,定义排序的键值。请注意,键值按其在此数组中出现的顺序进行处理。
- A DbTransInfo object holding the destination work area, column transfer information, and scoping information for the Sort() method.
+ 一个 DbTransInfo 对象,保存 Sort() 方法的目标工作区、列传输信息和范围信息。
- Helper structure to store information about a single sort key value.
+ 用于存储单个排序键值相关信息的辅助结构。
- A one-based index indicating the column on which the sort is based.
+ 一个从一开始的索引,指示排序所依据的列。
- One or more constants that function as sort optimization and control flags.
- They are passed to your RDD Sort() routine from the high-level wrapper function for the DBSort() function.
+ 一个或多个充当排序优化和控制标志的常量。它们由 DBSort() 函数的高级包装函数传递给您的 RDD Sort() 例程。
- The length of the field in the Workarea buffer.
+ 字段在 Workarea 缓冲区中的长度。
- The offset of the field in the Workarea buffer.
+ 字段在 Workarea 缓冲区中的偏移量。
- Helper class to store information needed for the global transfer of data items from one work area to another.
+ 用于存储将数据项从一个工作区全局传输到另一个工作区所需信息的辅助类。
- Construct a DbTransInfo object.
+ 构造一个 DbTransInfo 对象。
- The destination work area.
+ 目标工作区。
- Transfer attributes specified using one or more of the constants Match or PutRec.
+ 使用常量 Match 或 PutRec 中的一个或多个指定的传输属性。
- Number of items in the Items array.
+ Items 数组中的项数。
- An array of DbTransItem structures defining the items to transfer to the destination work area. This is usually a list of column mappings from the source to the destination.
+ 一个 DbTransItem 结构数组,定义要传输到目标工作区的项。这通常是从源到目标的列映射列表。
- A DbScopeInfo object describing the limits of the scope of the transfer.
+ 一个 DbScopeInfo 对象,描述传输范围的限制。
- The source work area.
+ 源工作区。
- Helper structure to store information about a single piece of data (usually a column) to transfer from one work area to another.
+ 用于存储从一个工作区传输到另一个工作区的单个数据(通常是一列)相关信息的辅助结构。
- A one-based field index in the destination work area.
+ 目标工作区中从一开始的字段索引。
- A one-based field index in the source work area.
+ 源工作区中从一开始的字段索引。
- Unregister an object that receives notification messages for Workarea events.
- TRUE when unregistration succceeded. FALSE when the the client was not registered.
+ 取消注册一个接收 Workarea 事件通知消息的对象。
+ 取消注册成功时为 TRUE。如果客户端未注册,则为 FALSE。
- this class is used to mark default parameter values in the middle of a parameter list.
+ 此类用于标记参数列表中间的默认参数值。
- It is used when compiling in VO or Vulcan mode.
- And only for parameters that are followed by parameters without default value (because that is not supported by the .Net framework).
- The X# compiler will find this attribute at compile time and will insert its value into the argument list.
+ 它在以 VO 或 Vulcan 模式编译时使用,并且仅用于后面跟有无默认值参数的参数(因为 .Net framework 不支持这种情况)。
X# 编译器将在编译时找到此特性,并将其值插入到参数列表中。
- Flag indicating the type of the default parameter
+ 指示默认参数类型的标志
Value
- Description
+ 描述
-
0
- Regular .Net default value
+ 常规 .Net 默认值
-
1
@@ -2376,168 +2344,163 @@
-
2
- Date (value is LONG ticks, empty for NULL_DATE)
+ 日期(值为 LONG 刻度数,NULL_DATE 时为空)
-
3
- Symbol, value can be empty or a string
+ Symbol,值可以为空或字符串
-
4
- PSZ, null = empty, or a string
+ PSZ,null = 空,或字符串
-
5
- IntPtr (can be 0 for NullPtr)
+ IntPtr(对于 NullPtr 可以为 0)
-
6
- Decimal (stored as string without 'm' suffix)
+ Decimal(以不带 'm' 后缀的字符串存储)
- Value of the default parameter
+ 默认参数的值
- Convert a DateTime to a string.
+ 将 DateTime 转换为字符串。
- The DateTime to be converted.
+ 要转换的 DateTime。
- A string representation of the given Date, formatted in the current Date format.
+ 给定 Date 的字符串表示形式,按当前日期格式设置。
- Convert a DateTime value to a string formatted as string in ANSI format
+ 将 DateTime 值转换为 ANSI 格式的字符串
- The DateTime to be converted
+ 要转换的 DateTime
- An 8-character string in the format yyyymmdd. If dDate is a DateTime.MinValue, a string of eight spaces is returned. The return value is not affected by the current date format.
+ 格式为 yyyymmdd 的 8 个字符的字符串。如果 dDate 为 DateTime.MinValue,则返回由八个空格组成的字符串。返回值不受当前日期格式的影响。
- Return the error stack as a string.
- Starting level. Defaults to 1.
- The error stack with line numbers. In the VO and Vulcan dialect the stack is in "VO Format"
+ 以字符串形式返回错误堆栈。
+ 起始级别。默认值为 1。
+ 带行号的错误堆栈。在 VO 和 Vulcan 方言中,堆栈采用 "VO Format"
- Return the error stack as a string.
- StackTrace object to convert to an error stack string
- Starting level. Defaults to 1.
- The error stack with line numbers. In the VO and Vulcan dialect the stack is in "VO Format"
+ 以字符串形式返回错误堆栈。
+ 要转换为错误堆栈字符串的 StackTrace 对象
+ 起始级别。默认值为 1。
+ 带行号的错误堆栈。在 VO 和 Vulcan 方言中,堆栈采用 "VO Format"
- Set the error code for a file operation.
+ 设置文件操作的错误代码。
- The previous errorcode from the last file operation.
+ 上一次文件操作的先前错误代码。
- Get the error code for a file operation.
+ 获取文件操作的错误代码。
- The error from the last file operation or the last user-specified setting. If there was no error, FError() returns 0.
+ 上一次文件操作或用户上一次指定设置所产生的错误。如果没有错误,FError() 返回 0。
- Get the last exception for a file operation.
+ 获取文件操作的最后一个异常。
- The exception from the last file operation or the last user-specified setting. If there was no exception, FException() returns null.
+ 上一次文件操作或用户上一次指定设置所产生的异常。如果没有异常,FException() 返回 null。
- Access or allocate the File I/O Buffer used by the X# Runtime for Low Level File Access for a file.
+ 访问或分配 X# 运行时用于对文件进行低级文件访问的文件 I/O 缓冲区。
- The size of the buffer that you would like to allocate.s
+ 您希望分配的缓冲区大小。
- The Byte[] associated with the file handle for an open file.
- When the file handle is invalid then a NULL object will be returned.
+ 与打开文件的文件句柄关联的 Byte[]。当文件句柄无效时,将返回 NULL 对象。
- This function will either return the existing buffer or allocate a new buffer of the requested size.
- When there is already a buffer allocated for the file handle, and this buffer is large enough then the existing buffer is returned.
- When the size requested exceeds the size of the allocated buffer, or when no buffer exists, then a new byte array will be allocated.
+ 此函数要么返回现有缓冲区,要么分配一个所请求大小的新缓冲区。
当已经为该文件句柄分配了缓冲区且该缓冲区足够大时,将返回现有缓冲区。当请求的大小超过已分配缓冲区的大小,或者不存在缓冲区时,将分配一个新的字节数组。
- Return the filename for a file handle
+ 返回文件句柄对应的文件名
- Access the FileStream object used by the X# Runtime for Low Level File Access
+ 访问 X# 运行时用于低级文件访问的 FileStream 对象
- The FileStream object or NULL when the handle is not valid
+ FileStream 对象,当句柄无效时为 NULL
- You are not supposed to close the stream object that you retrieve with this function.
- The Lifetime management of the stream should be left to the X# Runtime
- If you want to close the stream, please use the FClose() function
+ 您不应关闭通过此函数检索到的流对象。流的生命周期管理应交由 X# 运行时处理
如果要关闭该流,请使用 FClose() 函数
- Locks a region in a stream. Contains TRY CATCH mechanism.
- The stream to lock.
- Start of the region to lock. The method checks to see that the location is >= 0.
- Size of the region to lock. The method checks to see that the size is > 0.
- TRUE when succesfull, FALSE when an exception occurred during reading or when offset or length were invalid.
+ 锁定流中的某个区域。包含 TRY CATCH 机制。
+ 要锁定的流。
+ 要锁定区域的起始位置。该方法会检查位置是否 >= 0。
+ 要锁定区域的大小。该方法会检查大小是否 > 0。
+ 成功时为 TRUE;读取期间发生异常,或偏移量或长度无效时为 FALSE。
- Read data from a stream. Contains TRY CATCH mechanism. Reads from current location.
+ 从流中读取数据。包含 TRY CATCH 机制。从当前位置读取。
- Read data from a stream. Contains TRY CATCH mechanism. Reads from current location.
+ 从流中读取数据。包含 TRY CATCH 机制。从当前位置读取。
- Read data at a location in the file. Makes sure that file locations are >= 0
+ 在文件中的某个位置读取数据。确保文件位置 >= 0
- Sets the length of a stream. Contains TRY CATCH mechanism.
- The stream for which to set the lengt.
- The new length of the stream. The method checks to see that the location is >= 0.
- TRUE when succesfull, FALSE when an exception occurred during reading or when the length < 0
+ 设置流的长度。包含 TRY CATCH 机制。
+ 要设置其长度的流。
+ 流的新长度。该方法会检查位置是否 >= 0。
+ 成功时为 TRUE;读取期间发生异常,或长度 < 0 时为 FALSE
- Sets the location of a stream. Contains TRY CATCH mechanism. .
+ 设置流的位置。包含 TRY CATCH 机制。
- Unlocks a region in a stream. Contains TRY CATCH mechanism.
- The stream to unlock.
- Start of the region to unlock. The method checks to see that the location is >= 0.
- Size of the region to unlock. The method checks to see that the size is > 0.
- TRUE when succesfull, FALSE when an exception occurred during reading or when offset or length were invalid.
+ 解锁流中的某个区域。包含 TRY CATCH 机制。
+ 要解锁的流。
+ 要解锁区域的起始位置。该方法会检查位置是否 >= 0。
+ 要解锁区域的大小。该方法会检查大小是否 > 0。
+ 成功时为 TRUE;读取期间发生异常,或偏移量或长度无效时为 FALSE。
- Write data to a stream. Contains TRY CATCH mechanism. Writes to the current location.
+ 向流中写入数据。包含 TRY CATCH 机制。写入到当前位置。
- Write data at a location in the file. Makes sure that file locations are >= 0.
+ 在文件中的某个位置写入数据。确保文件位置 >= 0。
- Write data to a stream. Contains TRY CATCH mechanism. Writes to the current location.
+ 向流中写入数据。包含 TRY CATCH 机制。写入到当前位置。
- Open a file.
+ 打开文件。
@@ -2547,12 +2510,12 @@
- An array of bytes to store the data read from the specified file. The length of this variable must be greater than or equal to the number of bytes in the next parameter.
+ 用于存储从指定文件读取的数据的字节数组。此变量的长度必须大于或等于下一个参数中的字节数。
- An array of bytes to store the data read from the specified file. The length of this variable must be greater than or equal to the number of bytes in the next parameter.
+ 用于存储从指定文件读取的数据的字节数组。此变量的长度必须大于或等于下一个参数中的字节数。
@@ -2560,52 +2523,52 @@
- The possible values for the origin are:
+ origin 的可能值为:
- Constant
- Seeks from
+ 常量
+ 查找起点
-
FS_END
- End-of-file
+ 文件末尾
-
FS_RELATIVE
- Current pointer position
+ 当前指针位置
-
FS_SET
- Beginning-of-file
+ 文件开头
- Returns the size in bytes of a specified file.
+ 返回指定文件的大小(以字节为单位)。
- The size of the file or -1 when the file handle is not valid.
+ 文件的大小,当文件句柄无效时为 -1。
- Returns the size in bytes of a specified file.
- Specifies a file for which FSIZE( ) returns the size in bytes.
- The size of the file or -1 when the file is not found.
+ 返回指定文件的大小(以字节为单位)。
+ 指定一个文件,FSIZE( ) 返回其大小(以字节为单位)。
+ 文件的大小,当未找到文件时为 -1。
- Write a string to an open file
+ 将字符串写入打开的文件
- If FALSE an OEM to ANSI conversion is made.
+ 如果为 FALSE,则执行 OEM 到 ANSI 的转换。
@@ -2622,7 +2585,7 @@
- Write a string, a carriage-return character, and a linefeed character to an open file.
+ 将字符串、一个回车符和一个换行符写入打开的文件。
@@ -2630,13 +2593,13 @@
- Error code Enum that matches the Visual Objecs and Vulcan Generic Error Codes
+ 与 Visual Objects 和 Vulcan 通用错误代码相匹配的错误代码枚举
- These enums are also available as DEFINES and can therefore also be used without the "Gencode." prefix.
+ 这些枚举也可作为 DEFINES 使用,因此也可以不带 "Gencode." 前缀使用。
- This function is not implemented yet
+ 此函数尚未实现
@@ -2646,17 +2609,17 @@
- Get the type of the class that is used to compile macros
+ 获取用于编译宏的类的类型
- The type of the currently defined MacroCompiler. This may be NULL if no type has been set yet and no macros have been compiled.
+ 当前定义的 MacroCompiler 的类型。如果尚未设置类型且尚未编译任何宏,则可能为 NULL。
- This function is not implemented yet
+ 此函数尚未实现
- Returns TimeZone difference for current timezone in Hours
+ 返回当前时区的时区差(以小时为单位)
@@ -2674,99 +2637,95 @@
- Interface that is used for BLOB operations for memo files
+ 用于备注文件 BLOB 操作的接口
- Data to write to the blob file. This can be a BYTE[] but also other values.
- At this moment the FPT RDD supports BYTE[], String, Logic
- Other value types may follow later
+ 要写入 blob 文件的数据。它可以是 BYTE[],也可以是其他值。目前 FPT RDD 支持 BYTE[]、String、Logic,以后可能会支持其他值类型
- Length of the data to write or return. Defaults to all data
+ 要写入或返回的数据长度。默认值为全部数据
- Pointer for which to write or return the data
+ 要为其写入或返回数据的指针
- Start of the data to write or return. Defaults to 0
+ 要写入或返回的数据的起始位置。默认值为 0
- This interface defines Compile time and runtime codeblocks
+ 此接口定义编译时和运行时代码块
- Evaluate the codeblock
+ 计算代码块
- Returns the number of parameters defined for the codeblock
+ 返回为代码块定义的参数数量
- This interface extends the ICodeblock interface and adds a property
- that returns the 'real' returntype of the codeblock, before
- customizations are done to the value (for example for Foxpro where NIL gets converted to FALSE)
+ 此接口扩展了 ICodeblock 接口,并添加了一个属性,用于返回代码块在对值进行自定义处理之前的“真实”返回类型(例如在 Foxpro 中,NIL 会被转换为 FALSE)
- Returns the real /original return type of the EvalBlock() method
+ 返回 EvalBlock() 方法的真实/原始返回类型
- A value of the __UsualType enum
+ __UsualType 枚举的值
- This interface is used to return Decimal values from the RDD system
+ 此接口用于从 RDD 系统返回 Decimal 值
- Decimal value of the Currency
+ Currency 的 Decimal 值
- This interface defines Date values
+ 此接口定义日期值
- Day part of the date. A number between 0 an 31
- Integer value
+ 日期的日部分。介于 0 和 31 之间的数字
+ 整数值
- Is the date empty (NULL_DATE)
- Logical value
+ 日期是否为空(NULL_DATE)
+ 逻辑值
- Month part of the date. A number between 0 an 12
- Integer value
+ 日期的月部分。介于 0 和 12 之间的数字
+ 整数值
- Date as System.DateTime structure
- System.DateTime value
+ System.DateTime 结构形式的日期
+ System.DateTime 值
- Year part of the date. A number between 0 and 9999
- Integer value
+ 日期的年部分。介于 0 和 9999 之间的数字
+ 整数值
- This interface must be implemented by objects that register themselves for DB Notifications
+ 注册接收 DB 通知的对象必须实现此接口
@@ -2774,29 +2733,29 @@
- This interface defines a row in a .Net Table.
+ 此接口定义 .Net 表中的一行。
- This interface defines FLOAT values
+ 此接口定义 FLOAT 值
- Number of decimals.
- Integer value
+ 小数位数。
+ 整数值
- Number of digits (includes the optional decimal separator and decimals).
- Integer value
+ 位数(包括可选的小数分隔符和小数位)。
+ 整数值
- Double value of the Float
+ Float 的 Double 值
- This interface defines the Macro compiler subsystem
+ 此接口定义宏编译器子系统
@@ -2804,664 +2763,661 @@
- Compile a string into a runtime codeblock.
- String to compile
- Should single quotes be allowed
- Module of the main app
- will be set to TRUE when the string was a real codeblock (with {|..| }).
- will be set to TRUE when the macro contains code that may result in adding new MemVars).
- A compiled codeblock
+ 将字符串编译为运行时代码块。
+ 要编译的字符串
+ 是否允许使用单引号
+ 主应用程序的模块
+ 当字符串是真正的代码块(带有 {|..| })时,将设置为 TRUE。
+ 当宏包含可能导致添加新 MemVar 的代码时,将设置为 TRUE。
+ 已编译的代码块
- This interface extends the Macro compiler and adds a method that is called to decide between ambigous methods or constructors
+ 此接口扩展了宏编译器,并添加了一个方法,用于在有歧义的方法或构造函数之间作出选择
- This property allows to set a delegate that may be used to resolve ambigous references
+ 此属性允许设置一个委托,用于解析有歧义的引用
- This interface defines the mimimum methods that a RDD that supports memos should implement.
+ 此接口定义支持备注的 RDD 应实现的最少方法。
- Close the memo file
+ 关闭备注文件
- Create the memo file
- object describing the file to create.
+ 创建备注文件
+ 描述要创建的文件的对象。
- Flush the changes to the memo file
+ 将更改刷新到备注文件
- Get a value from a memo file for the specified column.
- 1 based column number for which the value should be retrieved.
+ 从备注文件中获取指定列的值。
+ 要检索其值的列的列号(从 1 开始)。
- Get the value for a column and write (export) it to an external file.
- 1 based column number for which the value should be retrieved.
- Name of the file that needs to be written to.
+ 获取列的值并将其写入(导出)到外部文件。
+ 要检索其值的列的列号(从 1 开始)。
+ 需要写入的文件名。
- Get the length of the for the specified column.
- 1 based column number for which the length should be retrieved.
+ 获取指定列的长度。
+ 要检索其长度的列的列号(从 1 开始)。
- Open the memo file
- object describing the file to open.
+ 打开备注文件
+ 描述要打开的文件的对象。
- Write a value to a memo file for a specified column
- 1 based column number for which the value should be written.
- New value that needs to written to the memo file for this column.
+ 将值写入备注文件中的指定列
+ 要写入其值的列的列号(从 1 开始)。
+ 需要为此列写入备注文件的新值。
- Read (Import) a value from an external file and write it to the specified column.
- 1 based column number for which the value should be written.
- Name of the file that needs to be read from.
+ 从外部文件读取(导入)值并将其写入指定列。
+ 要写入其值的列的列号(从 1 开始)。
+ 需要从中读取的文件名。
- Physically remove all memos from the memofile.
+ 从备注文件中物理删除所有备注。
- Name of the implicit namespace.
+ 隐式命名空间的名称。
- This interface defines the mimimum methods that a RDD that supports indexes should implement.
+ 此接口定义支持索引的 RDD 应实现的最少方法。
- Flush the changes to the index.
+ 将更改刷新到索引。
- Result of the last seek operation for the current Workarea.
+ 当前 Workarea 上一次查找(seek)操作的结果。
- Set the condition for the next Index Creation
- An object containing information for the order condition.
+ 设置下一次创建索引的条件
+ 包含索引顺序条件信息的对象。
- Create a new index or tag.
- An object containing information for order creation.
+ 创建新的索引或标记。
+ 包含索引顺序创建信息的对象。
- Delete an index or tag.
- An object containing information about the order to remove.
+ 删除索引或标记。
+ 包含要删除的索引顺序信息的对象。
- Retrieve information about the current index.
+ 检索有关当前索引的信息。
- Open an index file and add to the list of open indexes for the current Workarea.
- An object containing information about the orderlist (file) to add.
+ 打开索引文件并将其添加到当前 Workarea 的已打开索引列表中。
+ 包含要添加的索引顺序列表(文件)信息的对象。
- Close an index file and remove it from the list of open indexes for the current Workarea.
+ 关闭索引文件并将其从当前 Workarea 的已打开索引列表中移除。
- An object containing information about the orderlist (file) to delete.
+ 包含要删除的索引顺序列表(文件)信息的对象。
- Set focus to another index in the list open indexes for the current Workarea.
- An object containing information about the order to select.
+ 将焦点设置到当前 Workarea 已打开索引列表中的另一个索引。
+ 包含要选择的索引顺序信息的对象。
- Rebuild all indexes for the current Workarea.
+ 重建当前 Workarea 的所有索引。
- Perform a seek operation on the current selected index for the current Workarea.
- An object containing containing the necessary seek information.
+ 在当前工作区的当前选定索引上执行查找操作。
+ 包含必要查找信息的对象。
- An RDD that implements this interface will return the data for memo fields as BYTE[] when
- the ReturnRawData property is set TRUE
+ 当 ReturnRawData 属性设置为 TRUE 时,实现此接口的 RDD 将以 BYTE[] 形式返回备注字段的数据。
- Return Memo values as BYTE[] ?
+ 是否将备注值作为 BYTE[] 返回?
- Definition for the interface that each RDD must implement
+ 每个 RDD 都必须实现的接口的定义。
- Add a column.
- RddFieldInfo object.
+ 添加一列。
+ RddFieldInfo 对象。
- Retrieve the alias name.
+ 检索别名。
- Append a blank row and position the cursor to the new row.
- A flag that is TRUE if you want to clear all pending row locks before appending the new row and FALSE if you want to add the new row to the end of the current lock list.
+ 追加一个空白行,并将游标定位到该新行。
+ 标志:如果希望在追加新行之前清除所有挂起的行锁,则为 TRUE;如果希望将新行添加到当前锁定列表的末尾,则为 FALSE。
- Add a newly appended row to the list of locked rows.
- An enum value specifying the kind of lock to acquire.
+ 将新追加的行添加到已锁定行的列表中。
+ 指定要获取的锁类型的枚举值。
- Retrieve the Workarea number.
+ 检索工作区编号。
- Retrieve information about a memo column.
- Specifies the type of information.
+ 检索有关备注列的信息。
+ 指定信息的类型。
- Is the table at the logical beginning-of-file.
+ 表是否位于逻辑文件开头。
- Report the initialization of a relation.
- An object containing information about the relation
+ 报告关系的初始化。
+ 包含有关关系的信息的对象。
- Report the initialization of a relation.
- An object containing information about the relation
+ 报告关系的初始化。
+ 包含有关关系的信息的对象。
- Post a pending relational movement, indicating that the specified child work area has been affected by a parental movement.
- An object containing information about the relation
+ 发布一个挂起的关系移动,表示指定的子工作区已受到父级移动的影响。
+ 包含有关关系的信息的对象。
- Clear the active filter condition.
+ 清除活动的过滤条件。
- Clear relations.
+ 清除关系。
- Clear the active locate condition.
+ 清除活动的定位条件。
- Close a table.
+ 关闭表。
- Close the memo file
+ 关闭备注文件。
- Compile an expression.
- The expression to compile.
+ 编译表达式。
+ 要编译的表达式。
- Goto the next record based on the corrent locate condition.
+ 根据当前的定位条件移动到下一条记录。
- Create a table.
- object describing the file to create.
+ 创建表。
+ 描述要创建的文件的对象。
- Add columns defined in an array.
- Array of RddFieldInfo objects.
+ 添加在数组中定义的列。
+ RddFieldInfo 对象的数组。
- Create the memo file
- object describing the file to create.
+ 创建备注文件。
+ 描述要创建的文件的对象。
- Evaluate a code block for each row.
- object containing the information about which rows to visit.
+ 为每一行计算一个代码块。
+ 包含要访问哪些行的信息的对象。
- Mark the row at the current cursor position for deletion.
+ 将当前游标位置处的行标记为删除。
- Is the current row deleted?
+ 当前行是否已删除?
- Driver (RDD) name of the object.
+ 对象的驱动程序 (RDD) 名称。
- Is the table at the logical end-of-file.
+ 表是否位于逻辑文件末尾。
- Evaluate a code block.
- The code block to evaluate.
+ 计算一个代码块。
+ 要计算的代码块。
- Is the Workarea opened Exclusively
+ 工作区是否以独占方式打开。
- The # of fields in the current Workarea.
+ 当前工作区中的字段数。
- Return the ONE based field index for a field name.
- The name of the field in the database file structure. When the name is not found it will also check for a field alias with this name.
- The ONE based position of the field in the database file structure.
+ 返回字段名称的从 1 开始的字段索引。
+ 数据库文件结构中的字段名称。如果找不到该名称,还会检查是否存在具有此名称的字段别名。
+ 字段在数据库文件结构中从 1 开始的位置。
- Retrieve and optionally change information about a column.
- The ONE based position of the field in the database file structure.
- Specifies the type of information.
- If specified (not null), then this parameter is used to change the value of a setting.
- The current value for the property indicated with <nOrdinal>
+ 检索并可选地更改有关列的信息。
+ 字段在数据库文件结构中从 1 开始的位置。
+ 指定信息的类型。
+ 如果指定(非 null),则此参数用于更改设置的值。
+ 由 <nOrdinal> 指示的属性的当前值。
- Retrieve a column name based on its ONE based column number.
- The ONE based position of the column whose name you want to obtain.
- The name of the column.
+ 根据从 1 开始的列号检索列名。
+ 要获取其名称的列的从 1 开始的位置。
+ 列的名称。
- The filter condition as a string.
+ 以字符串形式表示的过滤条件。
- Flush the changes to the table, its indexes and memo file.
+ 将更改刷新到表、其索引和备注文件。
- Force all pending relational seeks to be performed.
+ 强制执行所有挂起的关系查找。
- The outcome of the last search operation.
+ 上一次搜索操作的结果。
- Retrieve the field information for a column based on its ONE based column number.
- The ONE based position of the column whose info you want to obtain.
- The Field information for the specified field.
+ 根据从 1 开始的列号检索列的字段信息。
+ 要获取其信息的列的从 1 开始的位置。
+ 指定字段的字段信息。
- Retrieve the RDD's record buffer as array of bytes.
- Record buffer of the RDD. This is the original buffer, so changing this buffer may cause corruption !
+ 以字节数组形式检索 RDD 的记录缓冲区。
+ RDD 的记录缓冲区。这是原始缓冲区,因此更改此缓冲区可能会导致数据损坏!
- Retrieve the active locate condition.
- The current scope information for the RDD.
+ 检索活动的定位条件。
+ RDD 的当前范围信息。
- Get a value for the specified column.
- The ONE based position of the column whose value you want to obtain.
- The value of the specified field.
+ 获取指定列的值。
+ 要获取其值的列的从 1 开始的位置。
+ 指定字段的值。
- Get the value for a column and write (export) it to an external file.
- ONE based position for which the value should be retrieved.
- Name of the file that needs to be written to.
- TRUE when the operation succeeded. Otherwise FALSE to indicate a failure.
+ 获取列的值并将其写入(导出)到外部文件。
+ 要获取值的从 1 开始的位置。
+ 要写入的文件名。
+ 操作成功时为 TRUE,否则为 FALSE,表示失败。
- Get the length of the for the specified column.
- ONE based position for which the length should be retrieved.
- The length of the value of the specified field.
+ 获取指定列的长度。
+ 要获取长度的从 1 开始的位置。
+ 指定字段的值的长度。
- Position the cursor to the last logical row.
+ 将游标定位到最后一个逻辑行。
- Write the contents of a work area's memory to the data store (usually a disk).
+ 将工作区内存的内容写入数据存储(通常是磁盘)。
- Mark a data buffer as hot, indicating that it needs to be written to the data store.
+ 将数据缓冲区标记为已修改,表示需要将其写入数据存储。
- Position the cursor to a specific, physical row.
- The ONE based row number of the new cursor position.
+ 将游标定位到指定的物理行。
+ 新游标位置的从 1 开始的行号。
- Position the cursor to a specific, physical identity.
- The ONE based row ID of the new cursor position.
+ 将游标定位到指定的物理标识。
+ 新游标位置的从 1 开始的行 ID。
- Position the cursor to the first logical row.
+ 将游标定位到第一个逻辑行。
- Lock or unlock the header of a database file.
- An enum value specifying the kind of lock to acquire.
+ 锁定或解锁数据库文件的头部。
+ 指定要获取的锁类型的枚举值。
- Retrieve and optionally change information about a work area.
- Specifies the type of information.
- If specified (not null), then this parameter is used to change the value of a setting.
+ 检索并可选地更改有关工作区的信息。
+ 指定信息的类型。
+ 如果指定(非 null),则此参数用于更改设置的值。
- Perform a lock.
- An object specifying the kind of lock to acquire.
+ 执行锁定。
+ 指定要获取的锁类型的对象。
- Open a table.
- object describing the file to open.
+ 打开表。
+ 描述要打开的文件的对象。
- Open the memo file
- object describing the file to open.
+ 打开备注文件。
+ 描述要打开的文件的对象。
- Set the condition for the next Index Creation
- An object containing information for the order condition.
+ 设置下一次创建索引的条件。
+ 包含排序条件信息的对象。
- Create a new index or tag.
- An object containing information for order creation.
+ 创建新的索引或标记。
+ 包含创建排序所需信息的对象。
- Delete an index or tag.
- An object containing information about the order to remove.
+ 删除索引或标记。
+ 包含有关要删除的排序的信息的对象。
- Retrieve information about an index.
- An object containing information about the order to retrieve the info for.
- Specifies the type of information to retrieve.
- The requested value for the specified index.
+ 检索有关索引的信息。
+ 包含有关要检索其信息的排序的信息的对象。
+ 指定要检索的信息的类型。
+ 指定索引的请求值。
- Open an index file and add to the list of open indexes for the current Workarea.
- An object containing information about the orderlist (file) to add.
+ 打开索引文件并将其添加到当前工作区的已打开索引列表中。
+ 包含有关要添加的排序列表(文件)的信息的对象。
- Close an index file and remove it from the list of open indexes for the current Workarea.
+ 关闭索引文件并将其从当前工作区的已打开索引列表中移除。
- An object containing information about the orderlist (file) to delete.
+ 包含有关要删除的排序列表(文件)的信息的对象。
- Set focus to another index in the list open indexes for the current Workarea.
- An object containing information about the order to select.
+ 将焦点设置到当前工作区已打开索引列表中的另一个索引。
+ 包含有关要选择的排序的信息的对象。
- Rebuild all indexes for the current Workarea.
+ 重建当前工作区的所有索引。
- Physically remove rows marked for deletion.
+ 物理删除标记为删除的行。
- Replace the row at the current cursor position with the contents of a byte array.
- The buffer containing the information that you want to write.
- The buffer should have at least the # of bytes that matches the current record size.
+ 用字节数组的内容替换当前游标位置处的行。
+ 包含要写入的信息的缓冲区。
+ 缓冲区的字节数至少应与当前记录大小相匹配。
- Write a value for a specified column
- ONE based position for which the value should be written.
- New value that needs to written to the table this column.
+ 为指定列写入一个值。
+ 要写入值的从 1 开始的位置。
+ 需要写入到表中此列的新值。
- Read (Import) a value from an external file and write it to the specified column.
- ONE based position for which the value should be written.
- Name of the file that needs to be read from.
+ 从外部文件读取(导入)一个值并将其写入指定列。
+ 要写入值的从 1 开始的位置。
+ 需要从中读取的文件名。
- Remove the deletion marker from the row at the current cursor position.
+ 移除当前游标位置处的行的删除标记。
- The number of rows.
+ 行数。
- The row identifier at the current cursor position.
+ 当前游标位置处的行标识符。
- Retrieve and optionally change information about a row.
- Specifies the type of information.
- If specified (not null), then this parameter is used to specify for which object to retrieve the info.
- If specified (not null), then this parameter is used to change the value of a setting.
+ 检索并可选地更改有关行的信息。
+ 指定信息的类型。
+ 如果指定(非 null),则此参数用于指定要检索其信息的对象。
+ 如果指定(非 null),则此参数用于更改设置的值。
- The physical row identifier at the current cursor position.
+ 当前游标位置处的物理行标识符。
- Discard all changes to the current record and reread the buffer from disk. When the current buffer is in Append mode then the server will move to the bottom of the file.
+ 放弃对当前记录的所有更改,并从磁盘重新读取缓冲区。当当前缓冲区处于追加模式时,服务器将移动到文件底部。
- Retrieve the logical number of a related work area.
- The ONE based relation number for which to obtain the logical number.
- The area number of the relation.
+ 检索相关工作区的逻辑编号。
+ 要获取其逻辑编号的从 1 开始的关系编号。
+ 关系的区域编号。
- Evaluate a code block against the relation in a work area.
- An object containing information about the relation
+ 针对工作区中的关系计算一个代码块。
+ 包含有关关系的信息的对象。
- Retrieve the key expression of a relation.
- The ONE based relation number for which to obtain the key expression.
- The key expression of the relation.
+ 检索关系的键表达式。
+ 要获取其键表达式的从 1 开始的关系编号。
+ 关系的键表达式。
- Perform a seek operation on the current selected index for the current Workarea.
- An object containing containing the necessary seek information.
+ 在当前工作区的当前选定索引上执行查找操作。
+ 包含必要查找信息的对象。
- The result of the actial seek operation is stored in the Found property of the RDD and the EOF property.
+ 实际查找操作的结果存储在 RDD 的 Found 属性和 EOF 属性中。
- Set the Number of Fields the AddField Method will add.
- Number of fields that will be added.
+ 设置 AddField 方法将添加的字段数。
+ 将要添加的字段数。
- Set the filter condition.
- object containing the filter information.
+ 设置过滤条件。
+ 包含过滤信息的对象。
- Set a relation.
- An object containing information about the relation
+ 设置关系。
+ 包含有关关系的信息的对象。
- Set the locate condition.
- object containing the scope information.
+ 设置定位条件。
+ 包含范围信息的对象。
- Is the current Workarea opened Shared?
+ 当前工作区是否以共享方式打开?
- Position the cursor relative to its current position.
+ 相对于当前位置定位游标。
- The number of rows to skip.
- If this argument is positive, the cursor moves forward (toward the end-of-file). If it is negative, the cursor moves backward (toward the beginning-of-file).
+ 要跳过的行数。如果此参数为正数,则游标向前移动(朝向文件末尾);如果为负数,则游标向后移动(朝向文件开头)。
- Position the cursor, respecting scope and filter conditions.
+ 定位游标,同时遵循范围和过滤条件。
- The number of rows to skip. If this argument is positive,
- the cursor moves forward (toward the end-of-file). If it is negative, the cursor moves backward (toward the beginning-of-file).
+ 要跳过的行数。如果此参数为正数,则游标向前移动(朝向文件末尾);如果为负数,则游标向后移动(朝向文件开头)。
- Position the cursor regardless of scope and filter conditions.
- The number of rows to skip. If this argument is positive, the cursor moves forward (toward the end-of-file). If it is negative, the cursor moves backward (toward the beginning-of-file).
+ 定位游标,不考虑范围和过滤条件。
+ 要跳过的行数。如果此参数为正数,则游标向前移动(朝向文件末尾);如果为负数,则游标向后移动(朝向文件开头)。
- Position the cursor relative to its current position within the current scope.
- The number of rows to skip. If this argument is positive, the cursor moves forward (toward the end-of-file). If it is negative, the cursor moves backward (toward the beginning-of-file).
+ 在当前范围内相对于当前位置定位游标。
+ 要跳过的行数。如果此参数为正数,则游标向前移动(朝向文件末尾);如果为负数,则游标向后移动(朝向文件开头)。
- Physically reorder a table.
- An object containing information about now to sort the table.
+ 物理重新排序表。
+ 包含有关如何对表进行排序的信息的对象。
- Force relational movement in child work areas to synchronize them with the parent work area.
+ 强制子工作区中的关系移动,使其与父工作区同步。
- Copy one or more rows from one work area to another.
- An object containing information about the transfer of data.
+ 将一行或多行从一个工作区复制到另一个工作区。
+ 包含有关数据传输的信息的对象。
- Copy a single row from one work area to another.
- An object containing information about the transfer of data.
+ 将单行从一个工作区复制到另一个工作区。
+ 包含有关数据传输的信息的对象。
- Release locks.
- The row number to unlock. This argument is provided for drivers that support multiple row locks. By convention, a value of zero indicates that all rows should be unlocked.
+ 释放锁。
+ 要解锁的行号。此参数是为支持多行锁定的驱动程序提供的。按照惯例,值为零表示应解锁所有行。
- Physically remove all rows from a table.
+ 物理删除表中的所有行。
- Determine if the leftmost character in a string is alphanumeric..
- The string to examine.
- TRUE if the first character is either alphabetic or numeric otherwise FALSE.
+ 确定字符串最左侧的字符是否为字母数字字符。
+ 要检查的字符串。
+ 如果第一个字符是字母或数字,则为 TRUE,否则为 FALSE。
IsAlNum
IsAlpha
@@ -3469,26 +3425,25 @@
- Determine if a string matches a wildcard pattern (like the wildcard pattern for the DIR command in the OS).
- The wildcard to use. '*' matches 0 or more characters until the next non-wildcard character, '?' matches any character, all other characters must match exactly.
- The string to examine.
+ 确定字符串是否与通配符模式匹配(类似于操作系统中 DIR 命令的通配符模式)。
+ 要使用的通配符。'*' 匹配 0 个或多个字符,直到下一个非通配符字符;'?' 匹配任意单个字符;所有其他字符必须完全匹配。
+ 要检查的字符串。
- This function is case INsensitive in all dialects except FoxPro.
- If you want to do a case sensitive compare in these dialects, use _Like()
+ 除 FoxPro 外,此函数在所有方言中都不区分大小写。如果要在这些方言中进行区分大小写的比较,请使用 _Like()。
_Like
- List of possible Locking Methods
+ 可用的锁定方法列表。
- Lock a row, releasing currently locked rows.
+ 锁定一行,并释放当前已锁定的行。
- Lock a table, releasing locks currently held.
+ 锁定表,并释放当前持有的锁。
- Lock a row, maintaining currently locked rows.
+ 锁定一行,并保持当前已锁定的行。
@@ -3506,34 +3461,31 @@
- You can register a function / method with this prototype in the RuntimeState to intercept errors in the macro compiler
+ 您可以在 RuntimeState 中注册具有此原型的函数/方法,以拦截宏编译器中的错误。
- Source of the macro that causes the error
- Exception describing the problem
- An object that implements ICodeblock, or NULL to tell the macro compiler to throw the error/
+ 导致错误的宏的源代码。
+ 描述问题的异常。
+ 实现 ICodeblock 的对象,或者为 NULL,以告知宏编译器抛出该错误。
- This delegate is called when the macro compiler encounters an error.
- The delegate can decide to return a codeblock that will be used instead of the original codeblock
- In theory you can 'patch' the cMacro and call the macro compiler again.
- However that may cause an other error, resulting in an endless loop.
+ 当宏编译器遇到错误时会调用此委托。委托可以决定返回一个代码块,用来代替原始代码块。理论上,您可以“修补” cMacro 并再次调用宏编译器。但是,这可能会导致另一个错误,从而造成无限循环。
- This delegate is used to decide if an assembly should be included in the type cache
+ 此委托用于决定是否应将某个程序集包含在类型缓存中。
- Assembly object of the assembly being inspected
- TRUE when the types in the assembly need to be cached.
+ 正在检查的程序集的 Assembly 对象。
+ 当需要缓存程序集中的类型时为 TRUE。
- This delegate is used to decide between 2 ambigous methods, functions or constructors
+ 此委托用于在 2 个有歧义的方法、函数或构造函数之间做出选择。
- MethodInfo of the first symbol
- MethodInfo of the second symbol
- The types of the arguments that were passed to the method call
- The delegate should return 1 when it wants to use the first symbol and 2 when it wants to use the second symbol or 0 when it does not want to use either symbol
+ 第一个符号的 MethodInfo。
+ 第二个符号的 MethodInfo。
+ 传递给方法调用的参数的类型。
+ 当委托希望使用第一个符号时应返回 1,希望使用第二个符号时返回 2,不希望使用任何一个符号时返回 0。
@@ -3541,19 +3493,17 @@
- This function should NOT be used to read the contents of a binary file (such as a word document).
- Use MemoReadBinary() in stead .
+ 不应使用此函数读取二进制文件(例如 Word 文档)的内容。请改用 MemoReadBinary()。
MemoReadBinary
MemoWrit
- Return the contents of a binary file as an array of bytes.
- Use this function in stead of MemoRead() to read the contents of a binary file.
+ 以字节数组形式返回二进制文件的内容。读取二进制文件的内容时,请使用此函数代替 MemoRead()。
- The name of the binary file to read from disk, including an optional drive, directory, and extension. SetDefault() and SetPath() settings are ignored; the Windows default is used unless you specify a drive and directory as part of the file name. No extension is assumed
- The file as an array of bytes
+ 要从磁盘读取的二进制文件的名称,包括可选的驱动器、目录和扩展名。SetDefault() 和 SetPath() 的设置将被忽略;除非在文件名中指定了驱动器和目录,否则使用 Windows 默认值。不会假定任何扩展名。
+ 以字节数组形式表示的文件。
MemoRead
MemoWritBinary
@@ -3563,18 +3513,13 @@
- Write binary data o a disk file. Use this function for binary files instead of MemoWrit(). This day may be read with MemoReadBinary().
+ 将二进制数据写入磁盘文件。对于二进制文件,请使用此函数代替 MemoWrit()。这些数据可以通过 MemoReadBinary() 读取。
- The name of the target disk file, including an optional drive, directory, and extension.
- SetDefault() and SetPath() settings are ignored; the Windows default is used unless you specify a drive and
- directory as part of the file name. No extension is assumed.
- If the file does not exist, it is created. If it exists, this function attempts to open the file in exclusive
- mode and, if successful, the file is overwritten without warning or error. If access is denied because,
- for example, another process is using the file, MemoWrit() returns FALSE and NetErr() is set to TRUE.
+ 目标磁盘文件的名称,包括可选的驱动器、目录和扩展名。SetDefault() 和 SetPath() 的设置将被忽略;除非在文件名中指定了驱动器和目录,否则使用 Windows 默认值。不会假定任何扩展名。如果文件不存在,则会创建该文件。如果文件已存在,则此函数会尝试以独占模式打开该文件,如果成功,则会在没有任何警告或错误的情况下覆盖该文件。如果访问被拒绝(例如,因为另一个进程正在使用该文件),MemoWrit() 将返回 FALSE,并且 NetErr() 被设置为 TRUE。
- The contents to write
- TRUE if the writing operation is successful; otherwise, FALSE
+ 要写入的内容。
+ 如果写入操作成功,则为 TRUE;否则为 FALSE。
MemoReadBinary
MemoWrit
@@ -3597,15 +3542,15 @@
- Convert an array of OEM characters to ANSI characters.
+ 将 OEM 字符数组转换为 ANSI 字符。
- A byte array that contains the string to convert
+ 包含要转换的字符串的字节数组。
- The number of characters to convert
- String converted to Ansi
+ 要转换的字符数。
+ 转换为 Ansi 的字符串。
@@ -3620,7 +3565,7 @@
- A byte array that contains the string to convert
+ 包含要转换的字符串的字节数组。
@@ -3630,11 +3575,11 @@
- This class was inspired by the DiskIO module in Visual Objects
+ 此类的灵感来自 Visual Objects 中的 DiskIO 模块。
- Convert a intptr to a string
+ 将 intptr 转换为字符串。
Bin2Ptr
@@ -3647,383 +3592,380 @@
- Error subclass used by the RDD system.
+ RDD 系统使用的 Error 子类。
- Helper class for the RDD system to store field information
+ RDD 系统用于存储字段信息的辅助类。
- Alternative name, no length limit. This is the Caption for VFP fields
+ 替代名称,没有长度限制。这是 VFP 字段的标题 (Caption)。
- Return the blank (non null) value of the column.
+ 返回该列的空白(非 null)值。
- Can the field be sorted?
+ 该字段是否可以排序?
- Dynamic property for the Caption. Read from the VFP properties collection.
+ Caption 的动态属性。从 VFP 属性集合中读取。
- Clone a RddFieldInfo object.
+ 克隆 RddFieldInfo 对象。
- Dynamic property for the ColumnName. Read from the VFP properties collection.
+ ColumnName 的动态属性。从 VFP 属性集合中读取。
- Copy values from one object to another.
- Object to copy values to.
- Only the fields will be copied.
+ 将值从一个对象复制到另一个对象。
+ 要将值复制到的对象。
+ 仅复制字段。
- Construct a RddFieldInfo object.
+ 构造 RddFieldInfo 对象。
Name
- Type, may also contain flags in the form of a colon follwed by N,0,B,+,Z,E,U
- Length 'DBF style', so length in Buffer
- Number of decimals.
- Offset in record buffer (optional).
+ 类型,还可以包含标志,形式为冒号后跟 N,0,B,+,Z,E,U。
+ “DBF 风格”的长度,即缓冲区中的长度。
+ 小数位数。
+ 在记录缓冲区中的偏移量(可选)。
- Construct a RddFieldInfo object.
+ 构造 RddFieldInfo 对象。
Name
Type
- Length 'DBF style', so length in Buffer
- Number of decimals.
- Offset in record buffer (optional)
- Flags (optional)
+ “DBF 风格”的长度,即缓冲区中的长度。
+ 小数位数。
+ 在记录缓冲区中的偏移量(可选)。
+ 标志 (可选)
- Construct a RddFieldInfo object.
- Object to copy values from.
+ 构造 RddFieldInfo 对象。
+ 要从中复制值的对象。
- Decimal positions
+ 小数位数
- Dynamic property for the DefaultValue. Read from the VFP properties collection.
+ DefaultValue 的动态属性。从 VFP 属性集合中读取。
- Dynamic property for the Description. Read from the VFP properties collection.
+ Description 的动态属性。从 VFP 属性集合中读取。
- Field Type
+ 字段类型
- FieldType as a string
+ 以字符串形式表示的 FieldType。
- Field type as 1 character string.
+ 以 1 个字符的字符串形式表示的字段类型。
- Flags, such as Nullable, AutoIncrement, Binary etc.
+ 标志,例如 Nullable、AutoIncrement、Binary 等。
- Dynamic property for the Format. Read from the VFP properties collection.
+ Format 的动态属性。从 VFP 属性集合中读取。
- Does the field have properties.
+ 该字段是否具有属性。
- Dynamic property for the InputMask. Read from the VFP properties collection.
+ InputMask 的动态属性。从 VFP 属性集合中读取。
- Is it an autoincrement ?
+ 是否为自动递增字段?
- Is it binary ?
+ 是否为二进制字段?
- Is it a compressed field (not implemented yet) ?
+ 是否为压缩字段(尚未实现)?
- Is it an encryped field (not implemented yet)?
+ 是否为加密字段(尚未实现)?
- Is it a memo ?
+ 是否为备注字段?
- Is it nullable ?
+ 是否可为空?
- Is it a standard Dbase 3 field (CDLMN) ?
+ 是否为标准的 Dbase 3 字段 (CDLMN)?
- Is it a unicode text ?
+ 是否为 Unicode 文本?
- Dynamic property for the IsUnique. Read from the VFP properties collection.
+ IsUnique 的动态属性。从 VFP 属性集合中读取。
- Is it a variable length field ?
+ 是否为可变长度字段?
- Is it a VFP extended field ?
+ 是否为 VFP 扩展字段?
- Physical length in the table
+ 在表中的物理长度。
- Name, normally max 10 characters
+ 名称,通常最多 10 个字符
- Next key for autoincrement columns.
+ 自动递增列的下一个键值。
- Offset in the record buffer for DBF fields.
+ DBF 字段在记录缓冲区中的偏移量。
- 1 based Ordinal position in the RDD.
+ 在 RDD 中从 1 开始的序号位置。
- Dynamic property for the PrimaryKey. Read from the VFP properties collection.
+ PrimaryKey 的动态属性。从 VFP 属性集合中读取。
- Dynamic list of optional properties, such as Caption, Description.
- These properties are used to store VFP specific properties and are read from the DBC file.
+ 可选属性的动态列表,例如 Caption、Description。
+ 这些属性用于存储 VFP 特定的属性,并从 DBC 文件中读取。
- Dynamic property for the RuleExpression. Read from the VFP properties collection.
+ RuleExpression 的动态属性。从 VFP 属性集合中读取。
- Dynamic property for the RuleText. Read from the VFP properties collection.
+ RuleText 的动态属性。从 VFP 属性集合中读取。
- Check if two fields match in type, length and decimals.
+ 检查两个字段的类型、长度和小数位数是否匹配。
- Step value for autoincrement columns.
+ 自动递增列的步长值。
- Validate combinations of type, length and decimals.
+ 验证类型、长度和小数位数的组合。
- This class is used to register RDD names with the matching System.Types
+ 此类用于将 RDD 名称与匹配的 System.Types 进行注册。
- Add a registration for a new RDD.
- FALSE when the RDD name is already registered, TRUE when the registration succeeded.
+ 为新的 RDD 添加注册。
+ 当 RDD 名称已注册时为 FALSE,注册成功时为 TRUE。
- Assembly object where the RDD is defined
+ 定义该 RDD 的程序集的 Assembly 对象。
- Name of the assembly where the RDD is defined.
+ 定义该 RDD 的程序集的名称。
- Locate an entry for a particular RDD name
- NULL when no RDD registration found.
+ 查找特定 RDD 名称的条目。
+ 未找到 RDD 注册时为 NULL。
- try to resolve the RDD
+ 尝试解析 RDD。
- 'Common' name of the RDD
+ RDD 的“通用”名称。
- Type of the RDD
+ RDD 的类型。
- Fully qualified type name of the RDD
+ RDD 的完全限定类型名称。
- Register Worker function for File Search API.
+ 为文件搜索 API 注册工作函数。
- Function that implements the worker. Must implement the FileSearcher delegate, so take STRING parameter and return a STRING
+ 实现该工作的函数。必须实现 FileSearcher 委托,即接受 STRING 参数并返回 STRING。
- current Worker function
+ 当前 Worker 函数
- FileSearcher Delegate
+ FileSearcher 委托
- Container Class that holds the XSharp Runtime state
+ 保存 XSharp 运行时状态的容器类。
- Please note that unlike in most XBase products every thread has its own copy of the runtime state.
- The runtime state from a new thread is a copy of the state of the main thread at that moment.
+ 请注意,与大多数 XBase 产品不同,每个线程都有自己的运行时状态副本。
新线程的运行时状态是该时刻主线程状态的副本。
- The current Alternate setting.
+ 当前的 Alternate 设置。
- The current AltFile setting.
+ 当前的 AltFile 设置。
- The current ANSI setting
+ 当前的 ANSI 设置。
- The System.Reflection.Module for the main application.
+ 主应用程序的 System.Reflection.Module。
- Delegate that describes the signature of the AutoLock methods
+ 描述 AutoLock 方法签名的委托。
- The current AutoOpen setting (used by the RDD system).
+ 当前的 AutoOpen 设置(由 RDD 系统使用)。
- The current AutoOrder setting (used by the RDD system).
+ 当前的 AutoOrder 设置(由 RDD 系统使用)。
- Gets/Set the tally result for latest bulk operation.
+ 获取/设置最近一次批量操作的 tally 结果。
- The current AutoShareMode setting (used by the RDD system).
+ 当前的 AutoShareMode 设置(由 RDD 系统使用)。
- Current Break Level. Gets set by compiler generated code for BEGIN SEQUENCE .. END constructs.
+ 当前的 Break 级别。由编译器为 BEGIN SEQUENCE .. END 结构生成的代码设置。
- The current Century setting (used in DATE <-> STRING conversions).
+ 当前的 Century 设置(用于 DATE <-> STRING 转换)。
- The current Collation mode (used by the RDD system).
+ 当前的排序规则 (Collation) 模式(由 RDD 系统使用)。
- Send an OnCollationChanged event when changed.
+ 更改时发送 OnCollationChanged 事件。
- Current collation table.
+ 当前排序规则表。
- The current Compatible setting.
+ 当前的 Compatible 设置。
- The current compiler setting for the AllowOldStyleAssignments compiler option.
+ AllowOldStyleAssignments 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the AZ compiler option.
+ AZ 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the FOVF compiler option.
+ FOVF 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO13 compiler option.
+ VO13 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the OVF compiler option.
+ OVF 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO10 compiler option.
+ VO10 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO11 compiler option.
+ VO11 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO12 compiler option.
+ VO12 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO13 compiler option.
+ VO13 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO12 compiler option.
+ VO12 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO4 compiler option.
+ VO4 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO6 compiler option.
+ VO6 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current compiler setting for the VO7 compiler option.
+ VO7 编译器选项的当前编译器设置。
- The default value for this option is 'False'.
+ 此选项的默认值为 'False'。
- The current Console setting.
+ 当前的 Console 设置。
- Gets / Sets the current Workarea number.
+ 获取/设置当前工作区编号。
- The DataSession information for the current Thread.
+ 当前线程的 DataSession 信息。
- The current DateCountry setting mode (used in DATE <-> STRING conversions).
+ 当前的 DateCountry 设置模式(用于 DATE <-> STRING 转换)。
- The current Date format
+ 当前的日期格式
- This string should contain a combination of DD MM and either YY or YYYY characters.
- For example DD-MM-YYYY for italian date format, MM/DD/YYYY for American date format or DD/MM/YYYY for British Date format.
- Note that all other characters except the four groups mentioned above are copied to the output string verbatim.
- This value is 'per thread'
+ 此字符串应包含 DD、MM 以及 YY 或 YYYY 字符的组合。
例如,DD-MM-YYYY 为意大利日期格式,MM/DD/YYYY 为美国日期格式,DD/MM/YYYY 为英国日期格式。请注意,除上述四组字符之外的所有其他字符都将原样复制到输出字符串中。
+ 此值为“每线程”独立
@@ -4032,285 +3974,277 @@
- The default number of decimals for new FLOAT values that are created without explicit decimals.
+ 创建时未显式指定小数位数的新 FLOAT 值的默认小数位数。
- The default number of decimals for new FLOAT values that are created without explicit decimals.
+ 创建时未显式指定小数位数的新 FLOAT 值的默认小数位数。
- The default RDD.
+ 默认的 RDD。
- This value is 'per thread'
+ 此值为“每线程”独立
- RDD Deleted Flag that determines whether to ignore or include records that are marked for deletion.
+ RDD 删除标志,用于确定是忽略还是包含标记为删除的记录。
- Name of the RDD uses for DELIM operations.
+ 用于 DELIM 操作的 RDD 名称。
- This event is invoked when the runtime dialect is changed.
- Normally this will almost never happen. However inside our test suites this is quite common
+ 当运行时方言更改时,将触发此事件。
+ 通常这种情况几乎不会发生。但是在我们的测试套件中,这种情况相当常见
- The default number of digits for new FLOAT values that are created without explicit decimals
+ 创建时未显式指定小数位数的新 FLOAT 值的默认位数
- Logical setting that fixes the number of digits used to display numeric output.
+ 逻辑设置,用于固定显示数值输出时所使用的位数。
- The 'DOS' Codepage. This gets read at startup from the OS().
+ “DOS”代码页。该值在启动时从 OS() 读取。
- Sends an OnCodePageChanged event when changed.
+ 更改时发送 OnCodePageChanged 事件。
- The DOS Encoding. This is based on the corrent DOS Codepage.
+ DOS 编码。它基于当前的 DOS 代码页。
- Should text files, such as memo files be written with a closing EOF = chr(26) character.
+ 文本文件(例如备注文件)写入时是否应以 EOF = chr(26) 字符结尾。
- End of line character to be used by the runtime. Defaults to CR + LF (13 + 13).
+ 运行时使用的行尾字符。默认为 CR + LF (13 + 13)。
- Date Epoch value that determines how dates without century digits are interpreted.
+ 日期纪元值,用于确定不带世纪位的日期如何解释。
- Date Epoch Century value. This gets set by the SetEpoch() function to the century in which the Epoch year falls.
+ 日期纪元世纪值。该值由 SetEpoch() 函数设置为纪元年份所在的世纪。
- Date Epoch Year value. This gets set by the SetEpoch() function to the Epoch year % 100.
+ 日期纪元年份值。该值由 SetEpoch() 函数设置为纪元年份 % 100。
- String comparison Exact flag that determines how comparisons with the single '=' characters should be done.
+ 字符串比较的 Exact 标志,用于确定如何处理使用单个 '=' 字符的比较。
- Field delimiters for DELIM operations.
+ 用于 DELIM 操作的字段分隔符。
- The last File IO error number
+ 最后一个文件 IO 错误编号
- The last file IO Exception
+ 最后一个文件 IO 异常
- Logical setting that fixes the number of decimal digits used to display numbers.
+ 逻辑设置,用于固定显示数字时所使用的小数位数。
- Numeric value that controls the precision of Float comparisons.
+ 数值,用于控制 Float 比较的精度。
- Retrieve the runtime state for the current thread
+ 获取当前线程的运行时状态
- The setting that determines whether to use the High Performance (HP) locking schema for newly created .NTX files
+ 该设置用于确定新创建的 .NTX 文件是否使用高性能 (HP) 锁定方案
- Current SetInternational Setting.
+ 当前 SetInternational 设置。
- The last file found with File(). This is the name that FPathName() returns.
+ 使用 File() 找到的最后一个文件。这是 FPathName() 返回的名称。
- Last error that occurred in the RDD subsystem.
+ RDD 子系统中发生的最后一个错误。
- Last Script error that occurred .
+ 发生的最后一个脚本错误。
- Number of tries that were done when the last lock operation failed.
+ 上一次锁定操作失败时所进行的尝试次数。
- Active Macro compiler
+ 活动的宏编译器
- This value is NOT 'per thread' but global for all threads.
+ 此值不是“每线程”独立,而是对所有线程全局有效。
- You can register an error handler that will be called when the macrocompiler encounters an error
+ 您可以注册一个错误处理程序,当宏编译器遇到错误时将调用该处理程序
- This property allows you to override the mechanism that decided if the types in an assembly should be cached
- The default behavior is that every assembly that is found is cached.
+ 此属性允许您重写用于决定是否缓存程序集中类型的机制。默认行为是缓存找到的每个程序集。
- Active Macro compiler
+ 活动的宏编译器
- This value is NOT 'per thread' but global for all threads.
+ 此值不是“每线程”独立,而是对所有线程全局有效。
- The current default MemoBlock size.
+ 当前默认的 MemoBlock 大小。
- Retrieve state name
- String value, such as "State for Thread 123" IDb
+ 获取状态名称
+ 字符串值,例如 "State for Thread 123" IDb
- Did the last RDD operation cause a Network Error ?
+ 上一次 RDD 操作是否导致了网络错误?
- The setting that determines whether to use the new locking offset of -1 (0xFFFFFFFF) for .NTX files.
+ 该设置用于确定 .NTX 文件是否使用新的锁定偏移量 -1 (0xFFFFFFFF)。
- The name of the method that was called in the last late bound method call.
+ 最后一次后期绑定方法调用中被调用的方法的名称。
- A cached copy of the string that is returned for empty dates, matching the current DateFormat
+ 为空日期返回的字符串的缓存副本,与当前的 DateFormat 匹配
- This event is thrown when one of the codepages of the runtimestate is changed
- Clients can refresh cached information by registering to this event
+ 当运行时状态的某个代码页更改时,将引发此事件
+ 客户端可以通过注册此事件来刷新缓存的信息
- This event is thrown when the collation of the runtimestate is changed
- Clients can refresh cached information by registering to this event
+ 当运行时状态的排序规则更改时,将引发此事件
+ 客户端可以通过注册此事件来刷新缓存的信息
- RDD Optimize Flag
+ RDD 优化标志
- The current SetRefresh flag.
+ 当前的 SetRefresh 标志。
- The current SetSafety flag.
+ 当前的 SetSafety 标志。
- Active Script compiler. Gets assigned from the ExecScriptFast() function.
+ 活动的脚本编译器。由 ExecScriptFast() 函数赋值。
- This value is NOT 'per thread' but global for all threads.
+ 此值不是“每线程”独立,而是对所有线程全局有效。
- This method can be used to switch the active DataSession in the runtime state.
- The previous active datasession
- The datasession that needs to be set as the new active datasession
+ 此方法可用于切换运行时状态中的活动 DataSession。
+ 之前的活动数据会话
+ 需要设置为新的活动数据会话的数据会话
- This sets the DataSession in the current thread.
+ 这会设置当前线程中的 DataSession。
- The dictionary that stores most of the settings in the runtime state. The key to the index is the number from the Set Enum
+ 存储运行时状态中大多数设置的字典。索引的键是 Set 枚举中的编号
Set Enum
- The current SetSoftSeek flag.
+ 当前的 SetSoftSeek 标志。
- This event is invoked when the runtime state is changed.
+ 当运行时状态更改时,将触发此事件。
- Compare 2 strings respecting the runtime string comparison rules.
+ 按照运行时字符串比较规则比较两个字符串。
- The first string .
- The second string.
+ 第一个字符串。
+ 第二个字符串。
- The StringCompare method takes into account:
- - the setting of SetExact()
- - the setting of VO13 of the main app
- - the setting of Collation mode
- This method respects the current setting of SetCollation():
- - When the current collationmode is Clipper or Windows then a Unicode - Ansi conversions will be performed.
- The Clipper collation uses the current DOS codepage and the Windows collation the current Windows codepage.
- - When the current collationmode is Unicode or Ordinal then the original strings will be compared.
+ StringCompare 方法会考虑:
- SetExact() 的设置
- 主应用程序的 VO13 设置
- 排序规则模式的设置
此方法遵循 SetCollation() 的当前设置:
- 当前排序规则模式为 Clipper 或 Windows 时,将执行 Unicode - Ansi 转换。Clipper 排序规则使用当前的 DOS 代码页,Windows 排序规则使用当前的 Windows 代码页。
- 当前排序规则模式为 Unicode 或 Ordinal 时,将比较原始字符串。
@@ -4318,15 +4252,12 @@
- Compare 2 byte arrays respecting the runtime string comparison rules.
- The first list of bytes.
- The second list of bytes.
- The # of bytes to compare.
+ 按照运行时字符串比较规则比较两个字节数组。
+ 第一个字节列表。
+ 第二个字节列表。
+ 要比较的字节数。
- This method works on BYTE arrays and is used by the RDD system.
- This method respects the current setting of SetCollation():
- - When the current collationmode is Clipper or Windows then no Ansi - Unicode conversions will be done.The comparisons will be done on the byte arrays.
- - When the current collationmode is Unicode or Ordinal then the byte arrays will be converted to Unicode before the comparison is executed.
+ 此方法适用于 BYTE 数组,由 RDD 系统使用。
此方法遵循 SetCollation() 的当前设置:
- 当前排序规则模式为 Clipper 或 Windows 时,不会执行 Ansi - Unicode 转换。将在字节数组上进行比较。
- 当前排序规则模式为 Unicode 或 Ordinal 时,在执行比较之前,字节数组将被转换为 Unicode。
@@ -4335,52 +4266,52 @@
- The first string .
- The second string.
+ 第一个字符串。
+ 第二个字符串。
- This method only checks for SetCollation and does not check fot SetExact() or the VO13 setting
+ 此方法仅检查 SetCollation,不检查 SetExact() 或 VO13 设置
- String delimiters for DELIM operations.
+ 用于 DELIM 操作的字符串分隔符。
- The Thousand separator
+ 千位分隔符
- ToString() override
- String value, such as "State for Thread 123"
+ ToString() 重写
+ 字符串值,例如 "State for Thread 123"
- Should indexes by default be created with the 'Unique setting'.
+ 默认情况下创建索引时是否应使用“唯一”设置。
- The Windows Codepage. This gets read at startup from the OS().
+ Windows 代码页。该值在启动时从 OS() 读取。
- Sends an OnCodePageChanged event when changed.
+ 更改时发送 OnCodePageChanged 事件。
- The Windows Encoding. This is based on the corrent Win Codepage.
+ Windows 编码。它基于当前的 Windows 代码页。
- The Workarea information for the current Thread.
- This property is a backward compatible alias for the DataSession property
+ 当前线程的工作区信息。
+ 此属性是 DataSession 属性的向后兼容别名
@@ -4390,11 +4321,11 @@
RuntimeState.SetValue
- Show seconds in time display
+ 在时间显示中显示秒
- Show seconds in time display
+ 在时间显示中显示秒
@@ -4408,56 +4339,51 @@
- The current setting, either "Windows" (the default), "Clipper", "Unicode" or "Ordinal"
- The collation mode to use. The available modes are "Windows" (the default), "Clipper", "Unicode" and "Ordinal".
+ 当前设置,为 "Windows"(默认值)、"Clipper"、"Unicode" 或 "Ordinal" 之一
+ 要使用的排序规则模式。可用模式为 "Windows"(默认值)、"Clipper"、"Unicode" 和 "Ordinal"。
- Get the name of the current errorlog file
- Current name of the error log file.
+ 获取当前错误日志文件的名称
+ 错误日志文件的当前名称。
- Set the name of the current errorlog file
- New name of error log file
- Previous name of the error log file.
+ 设置当前错误日志文件的名称
+ 错误日志文件的新名称
+ 错误日志文件的先前名称。
- This function allows you to enable or disable the VO compatible Errorstack format.
- Specify TRUE to enable the new format.
- The current setting for the ErrorStack format.
+ 此函数允许您启用或禁用与 VO 兼容的 Errorstack 格式。
+ 指定 TRUE 以启用新格式。
+ ErrorStack 格式的当前设置。
- The default setting for the format is based on the dialect of the main application.
- When the main dialect is VO or Vulcan then the VO format is used. Otherwise the normal .Net format is used.
+ 该格式的默认设置基于主应用程序的方言。当主方言为 VO 或 Vulcan 时,使用 VO 格式。否则使用普通的 .Net 格式。
- Get/Set hours format (12 or 24 hours)
+ 获取/设置小时格式(12 或 24 小时制)
- SetInternational() allows XSharp apps to operate in different international modes.
- The "CLIPPER" mode is provided for compatibility with CA-Clipper applications and uses an
- internationalization routine defined in the nation module.
- The "Windows" mode uses international services provided by Windows.
- When you set this mode several settings will be changed
+ SetInternational() 允许 XSharp 应用程序以不同的国际化模式运行。"CLIPPER" 模式用于与 CA-Clipper 应用程序兼容,并使用 nation 模块中定义的国际化例程。
"Windows" 模式使用 Windows 提供的国际化服务。设置此模式时,将更改多项设置
Setting
- Initial value in CLIPPER mode
+ CLIPPER 模式下的初始值
-
SetAmExt
- Empty String
+ 空字符串
-
SetPmExt
- Empty String
+ 空字符串
-
SetAmPm
- FALSE (24 hour format)
+ FALSE (24 小时制)
-
SetCentury
@@ -4465,7 +4391,7 @@
-
SetDateCountry
- American (1)
+ 美式 (1)
-
SetDateFormat
@@ -4477,11 +4403,11 @@
-
SetDecimalSep
- Period (.)
+ 句点 (.)
-
SetThousandSep
- Comma (,)
+ 逗号 (,)
-
SetTimeSep
@@ -4492,26 +4418,26 @@
- Set the type of the class that must be used to compile macros
+ 设置必须用于编译宏的类的类型
- The type of the class that implements the macro compiler. This type MUST implement IMacroCompiler.
- The type of the previously defined MacroCompiler. This may be NULL if no type has been set yet and no macros have been compiled.
+ 实现宏编译器的类的类型。此类型必须实现 IMacroCompiler。
+ 先前定义的 MacroCompiler 的类型。如果尚未设置类型且尚未编译任何宏,则该值可能为 NULL。
- Set the class that must be used to compile macros
+ 设置必须用于编译宏的类
- The object that implements the macro compiler.
- The previously defined MacroCompiler. This may be NULL if no compiler has been set yet and no macros have been compiled.
+ 实现宏编译器的对象。
+ 先前定义的 MacroCompiler。如果尚未设置编译器且尚未编译任何宏,则该值可能为 NULL。
- Set the delegate that may be used to decide which symbol to call for ambiguous symbols
+ 设置可用于决定对有歧义的符号调用哪个符号的委托
- The delegate to call.
- The previously delegate.
+ 要调用的委托。
+ 先前的委托。
@@ -4519,45 +4445,30 @@
- In Visual Objects the nation DLL is an external DLL. For X# there are no separate
- nation DLL. The nation support code is integrated in XSharp.Core.DLL.
- For compatibility you can still use the SetNatDLL() function to switch to another
- nation module.
- The available nation modules are (just like in Visual Objects):
- "BRAZIL", "CROATIA", "CZECH852", "CZECH895", "DANISH", "DUTCH", "FINNISH",
- "FRENCH", "GENERIC", "GERMAN", "GERMAN2", "HUNG852", "HUNGCWI", "ITALIAN",
- "NORWEGN", "POL-ISO", "POL-MAZ", "POL852", "PORT850", "PORT860", "ROMANIA",
- "RUSSIAN", "SERBIA", "SL-W-95", "SL-W-AS7", "SL-W-EE", "SLOV852", "SLOV895",
- "SPANISH", "SWEDISH", "TURKISH", "UK"
-
You may specify a DLL name with full path. The Runtime will strip the path and extension
- from the file name and will look for one of the names listed above.
- The nation DLL name is NOT case sensitive.
+ 在 Visual Objects 中,nation DLL 是一个外部 DLL。在 X# 中没有单独的 nation DLL。nation 支持代码已集成到 XSharp.Core.DLL 中。为了兼容,您仍然可以使用 SetNatDLL() 函数切换到另一个 nation 模块。
可用的 nation 模块与 Visual Objects 中相同:
"BRAZIL", "CROATIA", "CZECH852", "CZECH895", "DANISH", "DUTCH", "FINNISH", "FRENCH", "GENERIC", "GERMAN", "GERMAN2", "HUNG852", "HUNGCWI", "ITALIAN", "NORWEGN", "POL-ISO", "POL-MAZ", "POL852", "PORT850", "PORT860", "ROMANIA", "RUSSIAN", "SERBIA", "SL-W-95", "SL-W-AS7", "SL-W-EE", "SLOV852", "SLOV895", "SPANISH", "SWEDISH", "TURKISH", "UK"
您可以指定带完整路径的 DLL 名称。运行时将去除文件名中的路径和扩展名,并查找上面列出的名称之一。
nation DLL 名称不区分大小写。
- Return the Path array that is used by the File() function to locate files outside of the current directory.
- This is a combination of the SetDefault() and SetPath() variables.
- This may be null if the file function has never been called or never been called for files outside of the current
- directory.
+ 返回 File() 函数用于在当前目录之外定位文件的路径数组。它是 SetDefault() 和 SetPath() 变量的组合。如果从未调用过 file 函数,或从未针对当前目录之外的文件调用过它,则该值可能为 null。
- Get/Set seconds display
+ 获取/设置秒显示
- Return the setting that determines whether a space is displayed between fields or expressions when you use the ? or ?? command.
+ 返回用于确定使用 ? 或 ?? 命令时,是否在字段或表达式之间显示空格的设置。
- Change the setting that determines whether a space is displayed between fields or expressions when you use the ? or ?? command.
+ 更改用于确定使用 ? 或 ?? 命令时,是否在字段或表达式之间显示空格的设置。
@@ -4577,120 +4488,114 @@
- Error code Enum that matches the XSharp Error Severity codesFDesc
+ 与 XSharp 错误严重性代码匹配的错误代码枚举FDesc
- These enums are also available as DEFINES and can therefore also be used without the "Severity." prefix.
+ 这些枚举也可用作 DEFINE,因此也可以在不带 "Severity." 前缀的情况下使用。
- The compiler will replace calls to SLen() as much as possible with a direct call to the Length property of a string.
+ 编译器将尽可能把对 SLen() 的调用替换为对字符串 Length 属性的直接调用。
- Enum that matches the various FoxPro Sql properties, used in SqlGetProp() and SqlSetProp()
+ 与各种 FoxPro Sql 属性匹配的枚举,用于 SqlGetProp() 和 SqlSetProp()
- Specifies whether result sets are returned synchronously.
+ 指定结果集是否同步返回。
- Specifies whether SqlExec( ) returns result sets all at once (True (.T.), the default),
- or individually with SqlMoreResults( ) (False (.F.)).
+ 指定 SqlExec( ) 是一次性返回所有结果集(True (.T.),默认值),还是通过 SqlMoreResults( ) 逐个返回(False (.F.))。
- Contains True (.T.) if a shared connection is busy; otherwise contains False (.F.).
+ 如果共享连接处于忙碌状态,则包含 True (.T.);否则包含 False (.F.)。
- The login connection string.
+ 登录连接字符串。
- Specifies the time to wait (in seconds) before returning a connection time-out error.
- If you specify 0, the wait is indefinite and a time-out error is never returned. ConnectTimeOut can be 0 to 600. The default is 15.
+ 指定返回连接超时错误之前等待的时间(以秒为单位)。如果指定 0,则无限期等待,且永远不会返回超时错误。ConnectTimeOut 可以为 0 到 600。默认值为 15。
- The name of the data source as defined in the ODBC.INI file.
+ 在 ODBC.INI 文件中定义的数据源名称。
- Specifies if a pending transaction is committed or rolled back when SqlDisconnect( ) is called for the last connection handle.
+ 指定为最后一个连接句柄调用 SqlDisconnect( ) 时,挂起的事务是提交还是回滚。
- Contains a numeric value that determines when the ODBC Login dialog box is displayed.
+ 包含一个数值,用于确定何时显示 ODBC 登录对话框。
- Specifies if error messages are displayed (True (.T.)) or are not displayed (False (.F.), the default).
+ 指定是否显示错误消息(True (.T.))或不显示(False (.F.),默认值)。
- The idle timeout interval in minutes. Active connections are deactivated after the specified time interval.
- The default value is 0 (wait indefinitely).
+ 空闲超时间隔(以分钟为单位)。活动连接在指定时间间隔后将被停用。默认值为 0(无限期等待)。
- The native commandtext in the SQLStatement object.
+ SQLStatement 对象中的原生命令文本。
- The internal ODBC connection, which may be used by external code to call ODBC.
- In X# this does not return the connection handle but the DbConnection object !
+ 内部 ODBC 连接,外部代码可使用它来调用 ODBC。
+ 在 X# 中,这不会返回连接句柄,而是返回 DbConnection 对象!
- The internal ODBC statement , which may be used by external code to call ODBC.
- In X# this does not return the statement handle but the DbCommand object !
+ 内部 ODBC 语句,外部代码可使用它来调用 ODBC。
+ 在 X# 中,这不会返回语句句柄,而是返回 DbCommand 对象!
- The size of the network packet used by the connection. Adjusting this value can improve performance.
- The default value is 4096 bytes (4K).
+ 连接所使用的网络数据包的大小。调整此值可以提高性能。默认值为 4096 字节 (4K)。
- The connection password.
+ 连接密码。
- Specifies the time to wait (in seconds) before returning a general time-out error.
- If you specify 0 (the default), the wait is indefinite and a time-out error is never returned. QueryTimeOut can be 0 to 600.
+ 指定返回常规超时错误之前等待的时间(以秒为单位)。如果指定 0(默认值),则无限期等待,且永远不会返回超时错误。QueryTimeOut 可以为 0 到 600。
- Specifies whether the underlying connection is a shared connection (True (.T.)), or not (False (.F.)).
+ 指定底层连接是否为共享连接(True (.T.))或不是(False (.F.))。
- Contains a numeric value that determines how the connection manages transactions on the remote table.
+ 包含一个数值,用于确定连接如何管理远程表上的事务。
- The user identification.
+ 用户标识。
- The amount of time in milliseconds that elapses before Visual FoxPro checks if the SQL statement
- has completed executing. The default is 100 milliseconds.
+ Visual FoxPro 检查 SQL 语句是否已执行完毕之前所经过的时间(以毫秒为单位)。默认值为 100 毫秒。
- Arguments that are sent to StateChanged event handlers
+ 发送给 StateChanged 事件处理程序的参数
- New value of the setting
+ 设置的新值
- Old value of the setting
+ 设置的旧值
- Setting that was just changed
+ 刚刚更改的设置
- Convert an Date string to DateTime
+ 将日期字符串转换为 DateTime
@@ -4698,19 +4603,19 @@
- One or more of the following constants or strings: ADHSRV
+ 以下常量或字符串中的一个或多个:ADHSRV
- Error code Enum that matches the XSharp Error Sub Codes
+ 与 XSharp 错误子代码匹配的错误代码枚举
- These enums are also available as DEFINES and can therefore also be used without the "Subcodes." prefix.
+ 这些枚举也可用作 DEFINE,因此也可以在不带 "Subcodes." 前缀的情况下使用。
- Exchange the right and left halves of a Int64
+ 交换 Int64 的左右两半
@@ -4718,56 +4623,55 @@
- Calculate the Usual Type for a System Type
+ 计算 System 类型对应的 Usual 类型
- You can use this function in assemblies that do not have a reference to XSharp.RT to determine the type of a value
+ 您可以在没有 XSharp.RT 引用的程序集中使用此函数来确定值的类型
- This example converts a symbol that is passed inside an object to a string
+ 此示例将在对象中传递的符号转换为字符串
if SystemTypeToUsualType(oOrder:GetType()) == __UsualType.Symbol
oOrder := oOrder:ToString()
endif
- The type of the value to check
- A value from the __UsualType enum
+ 要检查的值的类型
+ __UsualType 枚举中的一个值
- Return a descriptive name (in upper case) for a X# (Usual) Type
- Type number to check for
+ 返回 X# (Usual) 类型的描述性名称(大写)
+ 要检查的类型编号
- Control the buffered File IO setting for the runtime
+ 控制运行时的缓冲文件 IO 设置
- The default behavior for X# 2.7 and later is to use Buffered Filestreams for Exclusive disk io.
- With this function you can switch that behavior on and off.
+ X# 2.7 及更高版本的默认行为是对独占磁盘 IO 使用缓冲文件流。
使用此函数可以开启或关闭该行为。
- Should the buffer file IO be used ?
- Previous setting for the buffered file IO
+ 是否应使用缓冲文件 IO?
+ 缓冲文件 IO 的先前设置
- Retrieve the buffered File IO setting for the runtime
- Current setting for the buffered file IO
+ 获取运行时的缓冲文件 IO 设置
+ 缓冲文件 IO 的当前设置
- This function is not implemented yet
+ 此函数尚未实现
- This function is not implemented yet
+ 此函数尚未实现
- This function is not implemented yet
+ 此函数尚未实现
@@ -4776,255 +4680,254 @@
- Size of the largest member.
+ 最大成员的大小。
- Total size of the VOSTRUCT or UNION.
+ VOSTRUCT 或 UNION 的总大小。
- Unique Alias
+ 唯一别名
- Workarea Number (1 based)
+ 工作区编号 (从 1 开始)
- Is at BOF ?
+ 是否位于 BOF?
- Result of the last Block evaluation.
+ 最后一次 Block 求值的结果。
- List of Fields
+ 字段列表
- Should the file be flushed (it is dirty) ?
+ 文件是否应被刷新(是否已被修改)?
- File handle of the current file
+ 当前文件的文件句柄
- Maximum fieldname length (Advantage supports field names > 10 characters)
+ 最大字段名长度 (Advantage 支持 > 10 个字符的字段名)
- Current index implementation.
+ 当前索引实现。
- # of parents
+ 父级数量
- Size of record
+ 记录大小
- List of children
+ 子项列表
- Result of last macro evaluation
+ 最后一次宏求值的结果
- Current Scope
+ 当前范围
- Is the file opened Shared ?
+ 文件是否以共享方式打开?
- Is at bottom ?
+ 是否位于底部?
- Has the workarea been closed.
+ 工作区是否已关闭。
- File name of the main file
+ 主文件的文件名
- Current Filter
+ 当前过滤器
- Return the (1 based) RddFieldInfo object for the specified field
+ 返回指定字段的(从 1 开始的)RddFieldInfo 对象
- 1 based index
- FieldInfo object or NULL when the index is not valid
+ 从 1 开始的索引
+ FieldInfo 对象;当索引无效时为 NULL
- Does the workarea have properties.
+ 工作区是否具有属性。
- Does the workarea have relations.
+ 工作区是否具有关系。
- Current memo implementation.
+ 当前备注实现。
- File information from the Open/Create methods
+ 来自 Open/Create 方法的文件信息
- Current Order condition
+ 当前排序条件
- Is the file opened ReadOnly ?
+ 文件是否以只读方式打开?
- Current Record
+ 当前记录
- Set the Number of Fields the AddField Method will add.
+ 设置 AddField 方法将添加的字段数。
- Is at top?
+ 是否位于顶部?
- Class that contains the list of open Workareas. Each thread will have its own list.
+ 包含已打开工作区列表的类。每个线程都有自己的列表。
- Close All RDDs referenced by this Workarea list
- TRUE when all areas were closed succesfully. When one or more areas failed to close then FALSE is returned.
+ 关闭此工作区列表引用的所有 RDD
+ 当所有区域都成功关闭时为 TRUE。如果一个或多个区域关闭失败,则返回 FALSE。
- Close area with 1 based Workarea number
- 1 based Area number for which to find the alias
- TRUE when the area was closed succesfully.
+ 关闭从 1 开始编号的工作区对应的区域
+ 要查找别名的从 1 开始的区域编号
+ 当区域成功关闭时为 TRUE。
- Close the area where this RDD object is used.
- Object of te RDD that needs to be closed.
- TRUE when the area was closed.
- This will close the area, even when the method is called from another thread.
+ 关闭使用此 RDD 对象的区域。
+ 需要关闭的 RDD 对象。
+ 当区域已关闭时为 TRUE。
+ 即使该方法是从另一个线程调用的,这也会关闭该区域。
- Commit changes in all workares in this Workarea list
- TRUE when all areas were committed succesfully. When one or more areas failed to commit then FALSE is returned.
+ 提交此工作区列表中所有工作区的更改
+ 当所有区域都成功提交时为 TRUE。如果一个或多个区域提交失败,则返回 FALSE。
- Get Current Workarea Object
+ 获取当前工作区对象
- Get 1 based Current Workarea Number
+ 获取从 1 开始的当前工作区编号
- Return 1 based Workarea Number for Alias or 0 when no found
- Alias of area to look for. Case INsensitive
- Area number of an the table with the given alias.
+ 返回别名对应的从 1 开始的工作区编号,未找到时返回 0
+ 要查找的区域的别名。不区分大小写
+ 具有给定别名的表所在的区域编号。
- Return 1 based empty Workarea
- Do we start to search from the start (TRUE) or the end (FALSE)
- Area number of an area where no table is open.
+ 返回从 1 开始的空工作区
+ 是从头开始搜索 (TRUE) 还是从末尾开始搜索 (FALSE)
+ 未打开任何表的区域的区域编号。
- Get Alias for 1 based Workarea Number
- 1 based Area number for which to find the alias
- Alias or an empty string when there is no table open in the area
+ 获取从 1 开始编号的工作区的别名
+ 要查找别名的从 1 开始的区域编号
+ 别名;当该区域中没有打开的表时为空字符串
- Get RDD object for 1 based Workarea Number
+ 获取从 1 开始编号的工作区的 RDD 对象
- Set RDD object and ALias for 1 based Workarea Number
+ 设置从 1 开始编号的工作区的 RDD 对象和别名
- Unlock All RDDs referenced by this Workarea list
+ 解锁此工作区列表引用的所有 RDD
- Helper class for the BREAK statement
+ BREAK 语句的辅助类
- The property that is passed by the BREAK statement
+ 由 BREAK 语句传递的属性
- This class performs buffered IO to files opened exclusively
+ 此类对以独占方式打开的文件执行缓冲 IO
- This method overrides the normal behavior of the FileStream class and flushes the cached data to disk before calling the parent Close() method.
+ 此方法重写 FileStream 类的正常行为,在调用父类 Close() 方法之前,将缓存的数据刷新到磁盘。
- This method overrides the normal behavior of the FileStream class and flushes the cached data to disk before calling the parent Flush() method.
+ 此方法重写 FileStream 类的正常行为,在调用父类 Flush() 方法之前,将缓存的数据刷新到磁盘。
- This method overrides the normal behavior of the FileStream class and reads the data from an inmemory cache, when possible
+ 此方法重写 FileStream 类的正常行为,并在可能的情况下从内存缓存中读取数据
- This method overrides the normal behavior of the FileStream class and writed the data to an inmemory cache, when possible
+ 此方法重写 FileStream 类的正常行为,并在可能的情况下将数据写入内存缓存
- This method overrides the normal behavior of the FileStream class and writed the data to an inmemory cache, when possible
+ 此方法重写 FileStream 类的正常行为,并在可能的情况下将数据写入内存缓存
- Bypass the buffered Read mechanism and call the original Read() method in the base class
+ 绕过缓冲读取机制,调用基类中原始的 Read() 方法
- Bypass the buffered Write mechanism and call the original Write() method in the base class
+ 绕过缓冲写入机制,调用基类中原始的 Write() 方法
- Special Filestream class that sets the runtime IO Errorstate when an error occurs.
+ 特殊的 Filestream 类,在发生错误时设置运行时 IO 错误状态。
- Create a XsFileStream object on Windows and a normal FileStream object on other OS-es
+ 在 Windows 上创建 XsFileStream 对象,在其他操作系统上创建普通的 FileStream 对象
- The name of the file opened in the stream.
+ 流中打开的文件的名称。
- Delegate used for the DialectChanged Event handler
+ 用于 DialectChanged 事件处理程序的委托
- This delegate is used when you want to implement your own function for the logic behind the File() function. You can register your own FileSearcher by calling the RegisterFileSearch() function.
- RegisterFileSearch() Function
+ 当您想为 File() 函数背后的逻辑实现自己的函数时,将使用此委托。您可以通过调用 RegisterFileSearch() 函数来注册自己的 FileSearcher。
+ RegisterFileSearch() 函数
- Delegate used for the StateChanged Event handler
+ 用于 StateChanged 事件处理程序的委托
- This enum lists the various dialects possible in XSharp. The enum MUST match the dialect values inside the compiler
+ 此枚举列出了 XSharp 中可能的各种方言。该枚举必须与编译器内部的方言值匹配
- This class is used for Shared diskaccess on Windows.
+ 此类用于 Windows 上的共享磁盘访问。
- The class bypasses some of the default methods in the FileStraem class and directly uses calls to OS functions to make
- sure that changes made by other users are visible and not hidden because of caching in the .Net FileStream class.
+ 该类绕过了 FileStraem 类中的一些默认方法,直接调用操作系统函数,以确保其他用户所做的更改可见,而不会因 .Net FileStream 类中的缓存而被隐藏。
- This method calls the Windows FlushFileBuffers() function directly.
+ 此方法直接调用 Windows 的 FlushFileBuffers() 函数。
- This method calls the Windows GetFileSize() function directly.
+ 此方法直接调用 Windows 的 GetFileSize() 函数。
- This method calls the Windows LockFile() function directly.
+ 此方法直接调用 Windows 的 LockFile() 函数。
- This method calls the Windows ReadFile() function directly.
+ 此方法直接调用 Windows 的 ReadFile() 函数。
- This method calls the Windows SetFilePointerEx() function directly.
+ 此方法直接调用 Windows 的 SetFilePointerEx() 函数。
- This method calls the Windows SetEndOfFile() function directly.
+ 此方法直接调用 Windows 的 SetEndOfFile() 函数。
- This method calls the Windows UnlockFile() function directly.
+ 此方法直接调用 Windows 的 UnlockFile() 函数。
- This method calls the Windows WriteFile() function directly.
+ 此方法直接调用 Windows 的 WriteFile() 函数。
- This method calls the Windows WriteFile() function directly.
+ 此方法直接调用 Windows 的 WriteFile() 函数。
\ No newline at end of file
diff --git a/src/DocChinese/XSharp.RDD.Docs.xml b/src/DocChinese/XSharp.RDD.Docs.xml
index e4d9536425..2d83125c4c 100644
--- a/src/DocChinese/XSharp.RDD.Docs.xml
+++ b/src/DocChinese/XSharp.RDD.Docs.xml
@@ -130,7 +130,7 @@
- AX_SetConnectionHandle Function
+ AX_SetConnectionHandle 函数
用于读取/写入日期列的类
@@ -351,7 +351,7 @@
包含要检查的驱动器号或服务器名称的字符串。
如果应用程序使用服务器名称作为参数,则还必须包含共享或
卷名。例如,使用"\\server\share"或"\\server\vol:"。
- AdsIsServerLoaded Function
+ AdsIsServerLoaded 函数
表示索引构建完成的百分比
@@ -368,7 +368,7 @@
设置所有后续表打开操作的连接句柄。
由 AdsConnect60 返回的连接句柄
- AdsConnect60 Function
+ AdsConnect60 函数
AdsGetLastError FUNCTION
diff --git a/src/DocChinese/XSharp.RT.Docs.xml b/src/DocChinese/XSharp.RT.Docs.xml
index 884bbc7cc0..d841f5c378 100644
--- a/src/DocChinese/XSharp.RT.Docs.xml
+++ b/src/DocChinese/XSharp.RT.Docs.xml
@@ -2,8 +2,7 @@
<__Array>
- Internal type that implements the VO Compatible ARRAY type.
- This type has methods and properties that normally are never directly called from user code.
+ 实现与 VO 兼容的 ARRAY 类型的内部类型。
此类型具有的方法和属性通常不会被用户代码直接调用。
@@ -19,7 +18,7 @@
- The element stored at the specified location in the array.
+ 存储在数组中指定位置的元素。
<__Array.__SetElement>
@@ -32,16 +31,16 @@
- The element stored at the specified location in the array.
+ 存储在数组中指定位置的元素。
<__Array.ctor>
- Create an array and fill it with elements from an existing .Net array of USUALS
+ 创建一个数组,并使用现有 .Net USUAL 数组中的元素填充它
<__Array.DefaultValue>
- Returns the default value for array elements when arrays are resized or initialized. This is NIL.
+ 返回数组调整大小或初始化时数组元素的默认值。该值为 NIL。
<__Array.IMPLICIT>
- Implicit conversion to OBJECT[]. SubArrays become nested OBJECT[] arrays.
+ 隐式转换为 OBJECT[]。子数组将变为嵌套的 OBJECT[] 数组。
<__Array.SELF_index>
@@ -51,75 +50,74 @@
- The value of the property of the element stored at the indicated location in the array.
+ 存储在数组中指定位置的元素的属性值。
<__Array.SELF_indices>
- The value of the property of the element stored at the indicated location in the array.
+ 存储在数组中指定位置的元素的属性值。
<__ArrayBase_T_>
- Internal type that implements the new TYPED ARRAY type.
- This type has methods and properties that normally are never directly called from user code.
+ 实现新的 TYPED ARRAY 类型的内部类型。
此类型包含的方法和属性通常不会在用户代码中被直接调用。
- Type of the elements inside the array
+ 数组内元素的类型
<__ArrayBase_T_.__GetElement>
- The element stored at the specified location in the array.
+ 存储在数组中指定位置的元素。
<__ArrayBase_T_.__SetElement>
- New element to store in the array at the position specified
- The new element
+ 要存储在数组指定位置的新元素
+ 新元素
<__ArrayBase_T_.Count>
- Length of the array.
+ 数组的长度。
<__ArrayBase_T_.ctor>
- Create an empty array
+ 创建一个空数组
<__ArrayBase_T_.ctor_2>
- Create an array with a certain capacity.
+ 创建一个具有指定容量的数组。
<__ArrayBase_T_.ctor_3>
- Create an array with a certain capacity and specify if it should be filled with default values.
+ 创建一个具有指定容量的数组,并指定是否使用默认值填充。
<__ArrayBase_T_.ctor_4>
- Create an array and fill it with elements from an existing collection.
+ 创建一个数组,并使用现有集合中的元素填充它。
<__ArrayBase_T_.ctor_5>
- Create an array and fill it with elements from an existing .Net array of objects. Note that the objects must be of the right type.
+ 创建一个数组,并使用现有 .Net 对象数组中的元素填充它。请注意,这些对象必须是正确的类型。
<__ArrayBase_T_.ctor_6>
- Create an array and fill it with elements from an existing .Net array.
+ 创建一个数组,并使用现有 .Net 数组中的元素填充它。
<__ArrayBase_T_.DefaultValue>
- Returns the default value for array elements when arrays are resized or initialized.
+ 返回数组调整大小或初始化时数组元素的默认值。
<__ArrayBase_T_.EXPLICIT>
- Implicitely convert a typed array to an array of USUALs.
+ 将类型化数组隐式转换为 USUAL 数组。
<__ArrayBase_T_.IMPLICIT>
- Implicitely convert an array of USUALs to a typed array. Note that the usuals must contain a value of the correct type.
+ 将 USUAL 数组隐式转换为类型化数组。请注意,这些 USUAL 必须包含正确类型的值。
<__ArrayBase_T_.IMPLICIT_2>
- Implicitely convert a typed Array to an OBJECT[].
+ 将类型化数组隐式转换为 OBJECT[]。
<__ArrayBase_T_.IsEmpty>
- Is the array empty.
+ 数组是否为空。
<__ArrayBase_T_.Length>
- Length of the array.
+ 数组的长度。
<__ArrayBase_T_.SELF_index>
@@ -132,222 +130,208 @@
- The element stored at the indicated location in the collection.
+ 存储在集合中指定位置的元素。
<__Binary>
- Internal type that implements the FoxPro Compatible BINARY type.
- This type has many operators and implicit converters that normally are never directly called from user code.
- The data in this type is stored as an array of Bytes
- Conversions from and to String are supported and they use the current active windows codepage.
+ 实现 FoxPro 兼容的 BINARY 类型的内部类型。
此类型包含许多运算符和隐式转换器,通常不会在用户代码中被直接调用。此类型中的数据以 Byte 数组的形式存储。
支持与 String 之间的转换,转换时使用当前活动的 Windows 代码页。
<__Binary.ctor>
- Byte[] value that has the bytes that define the binary
- STRING that will be converted to bytes using the current windows codepage.
+ 包含定义该二进制数据的字节的 Byte[] 值
+ 将使用当前 Windows 代码页转换为字节的 STRING。
- When you create a Binary from a string, then accented characters and characters outside the current windows codepage may be replaced with a question mark.
- and when the current codepage is a so called multi byte codepage than one character may be mapped to more than one byte in the result
+ 从字符串创建 Binary 时,带重音符号的字符以及当前 Windows 代码页之外的字符可能会被替换为问号。并且当当前代码页是所谓的多字节代码页时,一个字符在结果中可能会映射为多个字节
<__Binary.Value>
- Binary value as array of Bytes
+ 以 Byte 数组表示的二进制值
<__Currency>
- Internal type that implements the FoxPro Compatible CURRENCY type.
- This type has many operators and implicit converters that normally are never directly called from user code.
- The data in this type is stored as a System.Decimal with 4 decimal places
+ 实现 FoxPro 兼容的 CURRENCY 类型的内部类型。此类型包含许多运算符和隐式转换器,通常不会在用户代码中被直接调用。此类型中的数据以带有 4 位小数的 System.Decimal 形式存储
<__Currency.ctor>
- Real8 value to convert to a CURRENCY
- Decimal value to convert to a CURRENCY
- Float value to convert to a CURRENCY
- ICurrency value to convert to a CURRENCY
+ 要转换为 CURRENCY 的 Real8 值
+ 要转换为 CURRENCY 的 Decimal 值
+ 要转换为 CURRENCY 的 Float 值
+ 要转换为 CURRENCY 的 ICurrency 值
<__Currency.Value>
- Decimal (System.Decimal) value
+ Decimal (System.Decimal) 值
<__Date>
- Internal type that implements the VO Compatible DATE type
- This type has many operators and implicit converters that normally are never directly called from user code.
- It holds year, month, day in 32 bits. For date calculations it uses the System.DateTime calculation logic.
- There are implicit converters between Date and DateTime.
+ 实现 VO 兼容的 DATE 类型的内部类型
此类型包含许多运算符和隐式转换器,通常不会在用户代码中被直接调用。它以 32 位保存年、月、日。日期计算使用 System.DateTime 的计算逻辑。Date 与 DateTime 之间存在隐式转换器。
<__Date.ctor>
- Create a Date Value
- DateTime value to convert to a DATE
- Date value to convert to a DATE
- Ticks value to convert to a DATE
- String value to convert to a DATE
+ 创建一个日期值
+ 要转换为 DATE 的 DateTime 值
+ 要转换为 DATE 的 Date 值
+ 要转换为 DATE 的 Ticks 值
+ 要转换为 DATE 的字符串值
- Format specifier for value
+ 值的格式说明符
- Year value to convert to a DATE
- Month value to convert to a DATE
- Day value to convert to a DATE
+ 要转换为 DATE 的年份值
+ 要转换为 DATE 的月份值
+ 要转换为 DATE 的日值
<__Date.Value>
- Return DATE value as DateTime.
+ 将 DATE 值作为 DateTime 返回。
<__Float>
- Internal type that implements the XBase Compatible FLOAT type.
- This type has many operators and implicit converters that normally are never directly called from user code.
+ 实现 XBase 兼容的 FLOAT 类型的内部类型。此类型包含许多运算符和隐式转换器,通常不会在用户代码中被直接调用。
<__Float.ctor>
- Real8 value to convert to a FLOAT
- Number of significant decimals of the FLOAT
- Length of the FLOAT
- IFLoat value to copy into the FLOAT
+ 要转换为 FLOAT 的 Real8 值
+ FLOAT 的有效小数位数
+ FLOAT 的长度
+ 要复制到 FLOAT 中的 IFLoat 值
<__Float.Decimals>
- Number of decimals
+ 小数位数
<__Float.Digits>
Width
<__Float.Value>
- REAL8 (System.Double) value
+ REAL8 (System.Double) 值
<__Psz>
- Internal type that implements the XBase Compatible PSZ type.
- This type has many operators and implicit converters that normally are never directly called from user code.
+ 实现 XBase 兼容的 PSZ 类型的内部类型。
此类型包含许多运算符和隐式转换器,通常不会在用户代码中被直接调用。
<__Symbol>
- Internal type that implements the XBase Compatible SYMBOL type.
- This type has many operators and implicit converters that normally are never directly called from user code.
- There are also some operators that handle implicit conversions between Symbols and Strings in your code.
+ 实现 XBase 兼容的 SYMBOL 类型的内部类型。
此类型包含许多运算符和隐式转换器,通常不会在用户代码中被直接调用。
还有一些运算符用于处理代码中 Symbol 与 String 之间的隐式转换。
<__Symbol.ctor>
- String value to convert to a SYMBOL
- Should the symbol be converted to Uppercase
- Position of an existing symbol in the symbol table.
+ 要转换为 SYMBOL 的字符串值
+ 是否应将该符号转换为大写
+ 现有符号在符号表中的位置。
<__Usual>
- Internal type that implements the XBase Compatible USUAL type.
- This type has many operators and implicit converters that normally are never directly called from user code.
+ 实现 XBase 兼容的 USUAL 类型的内部类型。
此类型包含许多运算符和隐式转换器,通常不会在用户代码中被直接调用。
<__Usual.__InexactEquals>
- This method is used by the compiler for code that does an inexact comparison between two usuals.
- Left hand side of the comparison
- Right hand side of the comparison
- TRUE when the values are equal
- This method takes the SetExact() setting into account when comparing string values.
+ 编译器在对两个 USUAL 进行不精确比较的代码中使用此方法。
+ 比较的左侧
+ 比较的右侧
+ 当两个值相等时为 TRUE
+ 比较字符串值时,此方法会考虑 SetExact() 设置。
<__Usual.__InexactNotEquals>
- This method is used by the compiler for code that does an inexact comparison.
- Left hand side of the comparison
- Right hand side of the comparison
- TRUE when the values are NOT equal
- This method takes the SetExact() setting into account when comparing string values.
+ 编译器在进行不精确比较的代码中使用此方法。
+ 比较的左侧
+ 比较的右侧
+ 当两个值不相等时为 TRUE
+ 比较字符串值时,此方法会考虑 SetExact() 设置。
<__Usual.CompareTo>
- This method is needed to implement the IComparable interface.
+ 实现 IComparable 接口需要此方法。
<__Usual.ctor>
- This constructor is used in code generated by the compiler when needed.
- object that will be stored inside the usual.
- When the object is a value type, the the value will be stored inside the usual. Otherwise a reference to the value will be stored.
+ 此构造函数在需要时用于编译器生成的代码中。
+ 将存储在 USUAL 内部的对象。
+ 当该对象是值类型时,其值将存储在 USUAL 内部。否则将存储对该值的引用。
<__Usual.IsArray>
- This property returns TRUE when the USUAL is of type Array
+ 当 USUAL 为 Array 类型时,此属性返回 TRUE
<__Usual.IsBinary>
- This property returns TRUE when the USUAL is of type Binary
+ 当 USUAL 为 Binary 类型时,此属性返回 TRUE
<__Usual.IsByRef>
- This property returns TRUE when the USUAL is passed by reference (not implemented yet)
+ 当 USUAL 是通过引用传递时,此属性返回 TRUE(尚未实现)
<__Usual.IsCodeblock>
- This property returns TRUE when the USUAL is of type Codeblock
+ 当 USUAL 为 Codeblock 类型时,此属性返回 TRUE
<__Usual.IsCurrency>
- This property returns TRUE when the USUAL is of type Currency
+ 当 USUAL 为 Currency 类型时,此属性返回 TRUE
<__Usual.IsDate>
- This property returns TRUE when the USUAL is of type Date
+ 当 USUAL 为 Date 类型时,此属性返回 TRUE
<__Usual.IsDateTime>
- This property returns TRUE when the USUAL is of type DateTime
+ 当 USUAL 为 DateTime 类型时,此属性返回 TRUE
<__Usual.IsDecimal>
- This property returns TRUE when the USUAL is of type Decimal
+ 当 USUAL 为 Decimal 类型时,此属性返回 TRUE
<__Usual.IsEmpty>
- This property returns TRUE when the USUAL is Empty.
+ 当 USUAL 为空时,此属性返回 TRUE。
<__Usual.IsFloat>
- This property returns TRUE when the USUAL is of type FLOAT
+ 当 USUAL 为 FLOAT 类型时,此属性返回 TRUE
<__Usual.IsFractional>
- This property returns TRUE when the USUAL is of type FLOAT, Decimal or Currency
+ 当 USUAL 为 FLOAT、Decimal 或 Currency 类型时,此属性返回 TRUE
<__Usual.IsInt64>
- This property returns TRUE when the USUAL is of type Int64
+ 当 USUAL 为 Int64 类型时,此属性返回 TRUE
<__Usual.IsInteger>
- This property returns TRUE when the USUAL is of type LONG or INT64
+ 当 USUAL 为 LONG 或 INT64 类型时,此属性返回 TRUE
<__Usual.IsLogic>
- This property returns TRUE when the USUAL is of type LOGIC
+ 当 USUAL 为 LOGIC 类型时,此属性返回 TRUE
<__Usual.IsLong>
- This property returns TRUE when the USUAL is of type Long
+ 当 USUAL 为 Long 类型时,此属性返回 TRUE
<__Usual.IsNil>
- This property returns TRUE when the USUAL is NIL, or when the usual is a reference type and NULL or when the isual is a PTR type and IntPtr.Zero
+ 当 USUAL 为 NIL,或者 USUAL 是引用类型且为 NULL,或者 USUAL 是 PTR 类型且为 IntPtr.Zero 时,此属性返回 TRUE
<__Usual.IsNull>
- This property returns TRUE when the USUAL is of type NULL
+ 当 USUAL 为 NULL 类型时,此属性返回 TRUE
<__Usual.IsNumeric>
- This property returns TRUE when the USUAL is of type LONG, Int64, FLOAT or Decimal
+ 当 USUAL 为 LONG、Int64、FLOAT 或 Decimal 类型时,此属性返回 TRUE
<__Usual.IsObject>
- This property returns TRUE when the USUAL is of type Object
+ 当 USUAL 为 Object 类型时,此属性返回 TRUE
<__Usual.IsPsz>
- This property returns TRUE when the USUAL is of type Psz
+ 当 USUAL 为 Psz 类型时,此属性返回 TRUE
<__Usual.IsPtr>
- This property returns TRUE when the USUAL is of type Ptr (IntPtr)
+ 当 USUAL 为 Ptr (IntPtr) 类型时,此属性返回 TRUE
<__Usual.IsReferenceType>
- This property returns TRUE when the USUAL is a reference type (Array, Decimal, Object, String)
+ 当 USUAL 为引用类型(Array、Decimal、Object、String)时,此属性返回 TRUE
<__Usual.IsString>
- This property returns TRUE when the USUAL is of type String
+ 当 USUAL 为 String 类型时,此属性返回 TRUE
<__Usual.IsSymbol>
- This property returns TRUE when the USUAL is of type Symbol
+ 当 USUAL 为 Symbol 类型时,此属性返回 TRUE
<__Usual.SELF_index>
@@ -360,272 +344,257 @@
- The element stored at the indicated location in the array.
- When the contents of the USUAL is not an array or does not support indexed access then a runtime error is generated.
+ 存储在数组中指定位置的元素。
+ 当 USUAL 的内容不是数组或不支持索引访问时,将生成运行时错误。
<__Usual.SELF_name>
- The element stored at the indicated location in the collection.
- When the contents of the USUAL is not an array or does not name based indexing then a runtime error is generated.
+ 存储在集合中指定位置的元素。
+ 当 USUAL 的内容不是数组或不支持基于名称的索引时,将生成运行时错误。
<__Usual.SystemType>
- This property returns the System.Type that represents the value of the usual.
+ 此属性返回表示该 USUAL 的值的 System.Type。
<__Usual.Type>
- This property returns the __UsualType of the USUAL
+ 此属性返回该 USUAL 的 __UsualType
<__Usual.Value>
- Return the value of the USUAL as object. NIL values are shown as a NIL string.
+ 以 object 形式返回 USUAL 的值。NIL 值显示为 NIL 字符串。
<__UsualEnumerator>
- Create an enumerator for the USUAL type or throw a runtime exception.
- Name of the Usual
- This function is automatically called by code generated by the compiler when enumerating an untyped variable
+ 为 USUAL 类型创建枚举器,否则抛出运行时异常。
+ USUAL 的名称
+ 在枚举无类型变量时,编译器生成的代码会自动调用此函数
<__WinBool>
- Internal type that implements the WIN32 Compatible LOGIC type in UNIONs and VOSTRUCTs
+ 在 UNION 和 VOSTRUCT 中实现 WIN32 兼容的 LOGIC 类型的内部类型
<__WinBool.ctor>
- This constructor is used in code generated by the compiler when needed.
+ 此构造函数在需要时用于编译器生成的代码中。
<__WinBool.Value>
- Value as Logic
+ 作为 Logic 的值
<__WinDate>
- Internal type that implements the XBase Compatible DATE type in UNIONs and VOSTRUCTs
+ 在 UNION 和 VOSTRUCT 中实现 XBase 兼容的 DATE 类型的内部类型
<__WinDate.ctor>
- This constructor is used in code generated by the compiler when needed.
+ 此构造函数在需要时用于编译器生成的代码中。
<__WinDate.JulianValue>
- Value as Julian Number, 0 for NULL_DATE
+ 以儒略日数表示的值,NULL_DATE 为 0
<__WinDate.Value>
- Value as Date
+ 作为 Date 的值
<_ArrayToObjectArray>
- Helper function to convert ARRAY to OBJECT[]
- X# array to convert
- OBJECT Array
- This is a helper function used for late bound code that can also be called from user code.
+ 将 ARRAY 转换为 OBJECT[] 的辅助函数
+ 要转换的 X# 数组
+ OBJECT 数组
+ 这是用于后期绑定代码的辅助函数,也可以从用户代码中调用。
<_ArrayToUsualArray>
- Helper function to convert ARRAY to USUAL[]
- X# array to convert
- USUAL Array
- This is a helper function used for late bound code that can also be called from user code.
+ 将 ARRAY 转换为 USUAL[] 的辅助函数
+ 要转换的 X# 数组
+ USUAL 数组
+ 这是用于后期绑定代码的辅助函数,也可以从用户代码中调用。
<_CallClipFunc>
- Call a clipper function by name
- The name of the function to call.
- The list of arguments to pass to the function
- The list of arguments to pass to the function
- The return value of the function
- Note that X# allows to call functions that are overloaded.
+ 按名称调用 clipper 函数
+ 要调用的函数的名称。
+ 传递给该函数的参数列表
+ 传递给该函数的参数列表
+ 函数的返回值
+ 请注意,X# 允许调用重载的函数。
<_Codeblock>
- Internal type that is the base class for macro compiled codeblocks.
+ 宏编译的代码块的基类内部类型。
<_Codeblock.ctor>
- This constructor is used by the Macro Compiler
- Compiled codeblock created by the macro compiler.
- Macro string that was used to create the codeblock.
- Did the macro string start with "{|".
- Does the macro create Memvars .
+ 宏编译器使用此构造函数
+ 由宏编译器创建的已编译代码块。
+ 用于创建该代码块的宏字符串。
+ 宏字符串是否以 "{|" 开头。
+ 宏是否创建 Memvars。
<_Codeblock.Eval>
- Executes the codeblock.
+ 执行代码块。
- Zero or more arguments to pass to the codeblock.
+ 传递给代码块的零个或多个参数。
- The value of the last expression within the codeblock as a USUAL.
- If the last expression in the codeblock is of type VOID, then the codeblock
- returns NIL.
+ 代码块中最后一个表达式的值,以 USUAL 形式返回。如果代码块中的最后一个表达式的类型为 VOID,则代码块返回 NIL。
<_Codeblock.IsBlock>
- Was the codeblock created from a string that started with "{|"
+ 代码块是否由以 "{|" 开头的字符串创建
<_Codeblock.ToString>
- Returns the original string that was used to create the macro compiled codeblock.
+ 返回用于创建该宏编译代码块的原始字符串。
<_MClear>
- Clear all memory variables (all public variables and the private variables of the current thread)
+ 清除所有内存变量(所有 public 变量以及当前线程的 private 变量)
<_MRelease>
- Release variables that match a certain wildcard pattern
+ 释放与某个通配符模式匹配的变量
- The wildcard pattern to use when releasing the memvars. May contain * and ? characters.
- Indicates if the variables that need to be released should match (TRUE) or NOT match (FALSE) the pattern.
+ 释放内存变量时使用的通配符模式。可以包含 * 和 ? 字符。
+ 指示需要释放的变量应与该模式匹配 (TRUE) 还是不匹配 (FALSE)。
- For most dialects the variables are not removed but their values are replaced with NIL.
+ 对于大多数方言,变量不会被移除,而是其值被替换为 NIL。
- dsAccessToLocals(TRUE)];
- TION _MRelease(cMask AS STRING, lMatch AS LOGIC) AS VOID
+ dsAccessToLocals(TRUE)]; TION _MRelease(cMask AS STRING, lMatch AS LOGIC) AS VOID
<_MRestore>
- Recreate public and private variables previously saved to a file and initialize them with their former values.
+ 重新创建先前保存到文件中的 public 和 private 变量,并使用其原有的值对其进行初始化。
- The name of the memory file to read. The default extension is .MEM
- When set to TRUE then the existing memory variables will be saved. Otherwise all memory variables will be deleted first.
- (Optional) Wildcard pattern to use when saving. This can include literal characters as well as the standard wildcard characters, * and ?.
- (Optional) When set to TRUE then variables matching the pattern are restored. When set to FALSE then the variables that do NOT match the pattern are restored.
+ 要读取的内存文件的名称。默认扩展名为 .MEM
+ 设置为 TRUE 时,将保留现有的内存变量。否则将先删除所有内存变量。
+ (可选)保存时使用的通配符模式。可以包含字面字符以及标准通配符 * 和 ?。
+ (可选)设置为 TRUE 时,将恢复与该模式匹配的变量。设置为 FALSE 时,将恢复与该模式不匹配的变量。
- When memory variables are restored, they are recreated as private variables with the scope of the current procedure or function
- unless they exist as public variables and you specify the ADDITIVE clause . If ADDITIVE is specified, public and private variables
- with the same names are overwritten unless hidden with PRIVATE. If ADDITIVE is not specified, all public and private variables are
- released before the memory file is loaded. In that case all restored variables will become private variables.
+ 恢复内存变量时,它们将被重新创建为具有当前过程或函数作用域的 private 变量,除非它们作为 public 变量已存在且指定了 ADDITIVE 子句。如果指定了 ADDITIVE,则同名的 public 和 private 变量将被覆盖,除非被 PRIVATE 隐藏。如果未指定 ADDITIVE,则在加载内存文件之前将释放所有 public 和 private 变量。在这种情况下,所有恢复的变量都将成为 private 变量。
<_MSave>
- Copy public and private memory variables visible within the current routine to a disk file.
+ 将当前例程中可见的 public 和 private 内存变量复制到磁盘文件。
- The name of the file, including an optional drive, directory, and extension. The default extension is .MEM
- Wildcard pattern to use when saving. This can include literal characters as well as the standard wildcard characters, * and ?.
- When set to TRUE then variables matching the pattern are saved. When set to FALSE then the variables that do NOT match the pattern are saved.
+ 文件名,包括可选的驱动器、目录和扩展名。默认扩展名为 .MEM
+ 保存时使用的通配符模式。可以包含字面字符以及标准通配符 * 和 ?。
+ 设置为 TRUE 时,将保存与该模式匹配的变量。设置为 FALSE 时,将保存与该模式不匹配的变量。
- An existing MEM file will be overwritten. When an existing file is ReadOnly then an exception will be thrown.
+ 现有的 MEM 文件将被覆盖。当现有文件为只读时,将抛出异常。
<_MxRelease>
- Release one or more memory variables variables.
+ 释放一个或多个内存变量。
- Variable 1
- Variable 2
- Variable 3
- Variable 4
- Variable n
+ 变量 1
+ 变量 2
+ 变量 3
+ 变量 4
+ 变量 n
- The variables are not removed but their values are replaced with NIL.
+ 变量不会被移除,而是其值被替换为 NIL。
<_ObjectArrayToUsualArray>
- Helper function to convert OBJECT[] to USUAL[]
- This is a helper function used for late bound code that can also be called from user code.
- OBJECT array to convert
- USUAL Array
+ 将 OBJECT[] 转换为 USUAL[] 的辅助函数
+ 这是用于后期绑定代码的辅助函数,也可以从用户代码中调用。
+ 要转换的 OBJECT 数组
+ USUAL 数组
<_PrivateCount>
- Count private variables
+ 统计私有变量数量
<_PrivateEnum>
- Enumerate private variables
+ 枚举私有变量
<_PrivateFirst>
- Enumerate private variables
+ 枚举私有变量
<_PrivateNext>
- Enumerate private variables
+ 枚举私有变量
<_PublicCount>
- Count public variables
+ 统计公共变量数量
<_PublicEnum>
- Enumerate public variables
+ 枚举公共变量
<_PublicFirst>
- Enumerate public variables
+ 枚举公共变量
<_PublicNext>
- Enumerate public variables
+ 枚举公共变量
<_SequenceError>
- This function is automatically inserted by the compiler in a RECOVER USING block and gets called when the
- RECOVER USING block is reached because of an exception.
+ 此函数由编译器自动插入到 RECOVER USING 块中,当由于异常而到达 RECOVER USING 块时被调用。
- The exception that triggered the jump into the RECOVER USING block
+ 触发跳转到 RECOVER USING 块的异常
- The default implementation of this function (in the XSharp.RT assembly) called the installed error handler
- that is installed with ErrorBlock()
- The function should then have the following prototype
+ 此函数的默认实现(位于 XSharp.RT 程序集中)调用通过 ErrorBlock() 安装的错误处理程序。该函数应具有以下原型
FUNCTION _SequenceError(e as Exception) AS VOID
- The result of the call to the error handler installed in the ErrorBlock
- Break Function
- Break Function
+ 调用 ErrorBlock 中安装的错误处理程序的结果
+ Break 函数
+ Break 函数
<_SequenceRecover>
- This function is automatically inserted by the compiler in a compiler generated
- RECOVER USING block when you have a BEGIN SEQUENCE .. END SEQUENCE in your code
- without RECOVER USING clause
+ 当您的代码中存在没有 RECOVER USING 子句的 BEGIN SEQUENCE .. END SEQUENCE 时,编译器会将此函数自动插入到编译器生成的 RECOVER USING 块中
- The parameter that was passed in the BREAK statement or the call to the _Break function
+ 在 BREAK 语句或对 _Break 函数的调用中传递的参数
- If a REAL exception occurs then this function is NOT called. The function is only called when
- the (generated) RECOVER USING block is called with a value from a BREAK statement.
- The default implementation of this function (in the XSharp.RT assembly) does nothing.
- You can override this function in your own code if you want.
- The function should then have the following prototype
+ 如果发生真正的异常,则不会调用此函数。仅当使用 BREAK 语句提供的值调用(生成的)RECOVER USING 块时,才会调用此函数。
此函数的默认实现(位于 XSharp.RT 程序集中)不执行任何操作。如果需要,您可以在自己的代码中重写此函数。该函数应具有以下原型
FUNCTION _SequenceRecover(u as USUAL) AS VOID
- Break Function
+ Break 函数
<_Str>
- The returned string with always have a DOT as decimal separator.
+ 返回的字符串始终使用点 (.) 作为小数分隔符。
<_Str3>
- A string with DOT as decimal separator.
+ 使用点 (.) 作为小数分隔符的字符串。
<_TextRestore>
- This function is used by the TEXT TO FILE UDC
+ 此函数由 TEXT TO FILE UDC 使用
<_TextSave>
- This function is used by the TEXT TO FILE UDC
+ 此函数由 TEXT TO FILE UDC 使用
- FileName specified in the TEXT TO FILE UDC
+ 在 TEXT TO FILE UDC 中指定的文件名
<_UsualArrayToObjectArray>
- Helper function to convert USUAL[] to OBJECT[]
- USUAL array to convert
- OBJECT Array
- This is a helper function used for late bound code that can also be called from user code.
+ 将 USUAL[] 转换为 OBJECT[] 的辅助函数
+ 要转换的 USUAL 数组
+ OBJECT 数组
+ 这是用于后期绑定代码的辅助函数,也可以从用户代码中调用。
<_VoDbErrInfoPtr>
@@ -633,82 +602,82 @@
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- Calculate the # of dimensions in an array
+ 计算数组的维数
- Number of dimensions in an array
+ 数组的维数
- Calculate a string that represents the dimensions in an array
+ 计算表示数组维度的字符串
- String that displays the dimensions in an array
+ 显示数组维度的字符串
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
- A lambda expression that will be evaluated for every element in the array.
+ 数组元素的类型
+ 将对数组中每个元素求值的 lambda 表达式。
@@ -717,112 +686,106 @@
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- The type of the array elements
+ 数组元素的类型
- This class is used to write BLOB data to a FPT file.
+ 此类用于将 BLOB 数据写入 FPT 文件。
- Check if a BEGIN SEQUENCE...END construct is active.
+ 检查 BEGIN SEQUENCE...END 结构是否处于活动状态。
- Internal type that implements the VO Compatible CODEBLOCK type
- This type has methods that normally are never directly called from user code.
+ 实现 VO 兼容的 CODEBLOCK 类型的内部类型
此类型包含的方法通常不会在用户代码中被直接调用。
- This constructor is used by the Compiler for compile time codeblocks.
- Number of parameters defined in the compile time codeblock.
+ 编译器将此构造函数用于编译时代码块。
+ 编译时代码块中定义的参数数量。
- Executes the codeblock.
+ 执行代码块。
- Zero or more arguments to pass to the codeblock.
+ 传递给代码块的零个或多个参数。
- The value of the last expression within the codeblock as a USUAL.
- If the last expression in the codeblock is of type VOID, then the codeblock
- returns NIL.
+ 代码块中最后一个表达式的值,以 USUAL 形式返回。如果代码块中的最后一个表达式的类型为 VOID,则代码块返回 NIL。
- This method is abstract and is implemented in the derived classes
- created by the compiler.
+ 此方法是抽象的,由编译器创建的派生类实现。
- Eval method that can be called from code that does not "know" about the USUAL type.
- such as the code in the RDD classes.
+ 可从“不了解” USUAL 类型的代码(例如 RDD 类中的代码)调用的 Eval 方法。
- Zero or more arguments to pass to the codeblock.
+ 传递给代码块的零个或多个参数。
- Returns the number of parameters in the codeblock
+ 返回代码块中的参数数量
- Return a string that contains the # of parameters for display in the debugger.
+ 返回包含参数数量的字符串,用于在调试器中显示。
- This class contains helper code that is called by the compiler to support various XBase language constructs, such as the
- automatic memory management of PSZ values created with String2Psz().
+ 此类包含由编译器调用的辅助代码,用于支持各种 XBase 语言构造,例如对由 String2Psz() 创建的 PSZ 值的自动内存管理。
- Determine if we are inside a BEGIN SEQUENCE .. END by looking at the SEQUENCE counter in the runtime.
+ 通过查看运行时中的 SEQUENCE 计数器,确定我们是否处于 BEGIN SEQUENCE .. END 之内。
- Increment the SEQUENCE counter for a BEGIN SEQUENCE statement
+ 为 BEGIN SEQUENCE 语句递增 SEQUENCE 计数器
- Decrement the SEQUENCE counter for a BEGIN SEQUENCE statement
+ 为 BEGIN SEQUENCE 语句递减 SEQUENCE 计数器
- Allocate a PSZ and add it to the list
+ 分配一个 PSZ 并将其添加到列表中
- Free all PSZ values in the List
+ 释放列表中的所有 PSZ 值
- Subtract 2 strings.
+ 减去两个字符串。
- Concatenate two Symbols.
+ 连接两个 Symbol。
@@ -832,7 +795,7 @@
- Concatenate three Symbols.
+ 连接三个 Symbol。
@@ -866,7 +829,7 @@
- Return the number of arguments that a code block is expecting.
+ 返回代码块所需的参数数量。
@@ -874,32 +837,32 @@
- A string representating the date format to use when converting the string to a date. Should consist of D, M and Y characters and separators.
+ 将字符串转换为日期时使用的日期格式的字符串表示。应由 D、M 和 Y 字符以及分隔符组成。
- Automatically lock a record in the FoxPro dialect
+ 在 FoxPro 方言中自动锁定记录
- Automatically lock a record in the FoxPro dialect
+ 在 FoxPro 方言中自动锁定记录
- Automatically unlock a record in the FoxPro dialect
+ 在 FoxPro 方言中自动解锁记录
- Automatically unlock a record in the FoxPro dialect
+ 在 FoxPro 方言中自动解锁记录
- Refresh the buffer for the current workarea, discarding any changes that were made.
+ 刷新当前工作区的缓冲区,丢弃所做的任何更改。
- Clears the top and/or bottom scope.
+ 清除顶部和/或底部范围。
- An optional constant that indicates which scope needs to be set.
+ 一个可选常量,指示需要设置哪个范围。
- TRUE when the scope was cleared succesfully, otherwise FALSE.
+ 成功清除范围时为 TRUE,否则为 FALSE。
@@ -918,9 +881,9 @@
DbRecordInfo ENUM
- Checks if a scope is set in a work area.
+ 检查工作区中是否设置了范围。
- An optional constant that indicates which scope needs to be set.
+ 一个可选常量,指示需要设置哪个范围。
@@ -930,44 +893,43 @@
- Order in the index file to activate. When not specified then the first order in the file becomes active.
+ 要激活的索引文件中的顺序。如果未指定,则文件中的第一个顺序将变为活动状态。
- An optional name for the relation. Defaults to ParentName + "_" + ChildName.
+ 关系的可选名称。默认为 ParentName + "_" + ChildName。
- Sets scope values.
+ 设置范围值。
- A constant that indicates which scope needs to be set.
+ 一个常量,指示需要设置哪个范围。
- The value that needs to be set.
- The type of the value must match the type of the index expression.
+ 需要设置的值。该值的类型必须与索引表达式的类型匹配。
- TRUE when the scope was set succesfully and when the record pointer has been successfully moved to the first record in the scope, otherwise FALSE.
- The record pointer is moved to the first record in the scope when setting of the scope was succesfull.
+ 成功设置范围并且记录指针已成功移动到范围内的第一条记录时为 TRUE,否则为 FALSE。
+ 成功设置范围后,记录指针将移动到范围内的第一条记录。
- Write information to the Debug Terminal Program
+ 将信息写入调试终端程序 (Debug Terminal Program)
- List of values to display on the debug terminal
+ 要在调试终端上显示的值列表
- Return the Day of Year
+ 返回一年中的第几天
- Date for which to calculate the Date
+ 要计算其一年中第几天的日期
- For Object values the 'emptyness' is determined by Comparing to NULL_OBJECT and comparign to DBNull.Value
+ 对于 Object 值,“是否为空”通过与 NULL_OBJECT 比较以及与 DBNull.Value 比较来确定
@@ -978,77 +940,66 @@
- Suppress Array Index check to be compatible with Visual Objects
- TRUE to enable the array index checks.
- The previous setting of the flag
+ 禁止数组索引检查以与 Visual Objects 兼容
+ TRUE 表示启用数组索引检查。
+ 该标志之前的设置
- In some situations Visual Objects did not throw a runtime error when you were accessing a non existing array element.
- You can enable this (mis)behaviour in X# by disabling the array index checks.
- The default behavior is to generate an error when you access array indices out of the existing range.
+ 在某些情况下,当您访问不存在的数组元素时,Visual Objects 不会抛出运行时错误。
您可以通过禁用数组索引检查,在 X# 中启用这种(错误)行为。
默认行为是在您访问超出现有范围的数组索引时生成错误。
- // The following code does not throw a runtime error but displays NIL for u[1,1]
- // To get the same behavior in X# you need to call EnableArrayIndexCheck(FALSE)
- FUNCTION Start
- LOCAL u AS USUAL
- u := {1,2,3}
- ? u[1,1]
- WAIT
- RETURN TRUE
+ // The following code does not throw a runtime error but displays NIL for u[1,1] // To get the same behavior in X# you need to call EnableArrayIndexCheck(FALSE) FUNCTION Start LOCAL u AS USUAL u := {1,2,3} ? u[1,1] WAIT RETURN TRUE
- Evaluate a code block or an objects Eval() method.
+ 计算代码块或对象的 Eval() 方法。
- Object or block to evaluate
- Block to evaluate
- List of arguments
- Result of the evaluation
+ 要计算的对象或代码块
+ 要计算的代码块
+ 参数列表
+ 计算结果
- Read an array of bytes direct from the workarea buffer.
- This will only work for DBF based workareas (not for Advantage workareas)
+ 直接从工作区缓冲区读取字节数组。
+ 这仅适用于基于 DBF 的工作区(不适用于 Advantage 工作区)
- The value of the field.`
- IF does not correspond to the position of any field in the database file, FieldGetBytes() will generate an error.
+ 字段的值。` 如果 与数据库文件中任何字段的位置都不对应,FieldGetBytes() 将产生错误。
- This will only work for DBF based workareas (not for Advantage workareas)
- Write an array of bytes direct to the workarea buffer.
- The position OF the FIELD IN the database file structure.
- The value to write to the field
+ 这仅适用于基于 DBF 的工作区(不适用于 Advantage 工作区)
+ 直接将字节数组写入工作区缓冲区。
+ 字段在数据库文件结构中的位置。
+ 要写入字段的值
- The value assigned TO the field.
- IF does not correspond to the position of any field in the database file, FieldPutBytes() will generate an error.
+ 赋给字段的值。如果 与数据库文件中任何字段的位置都不对应,FieldPutBytes() 将产生错误。
- Find a class in the referenced assemblies
+ 在引用的程序集中查找类
- Classname to find
- System.Type object or NULL
+ 要查找的类名
+ System.Type 对象或 NULL
- Guard Block following MemAlloc return value
+ 紧随 MemAlloc 返回值之后的保护块
Checksum
- Zero terminator
+ 零终止符
- Guard Block preceding MemAlloc return value
+ 位于 MemAlloc 返回值之前的保护块
- Cargo slot
+ Cargo 槽
- Group number
+ 组编号
Checksum
@@ -1064,17 +1015,16 @@
- Return the number of local arguments that a function is expecting.
- The name of the function to examine.
- The number of arguments that a method is expecting.
+ 返回函数所需的本地参数个数。
+ 要检查的函数名称。
+ 方法所需的参数个数。
- Note that you can't use this for functions that are overloaded.
- And unlike in VO this function can also be used to return the number of parameters for typed functions.
+ 请注意,此函数不能用于重载的函数。
并且与 VO 不同,此函数也可用于返回带类型函数的参数个数。
- A block of memory to store the data read from the specified file. The length of this variable must be greater than or equal to the number of bytes in the next parameter.
+ 用于存储从指定文件读取的数据的内存块。此变量的长度必须大于或等于下一个参数中的字节数。
@@ -1091,75 +1041,70 @@
- Get the number of 1/10000 seconds that have elapsed since Windows was started.
+ 获取自 Windows 启动以来经过的 1/10000 秒数。
- Support class to support runtime access to globals declared in the loaded X# assemblies
+ 用于支持在运行时访问已加载的 X# 程序集中所声明的全局变量的支持类
- Find the Global Field with a name
+ 按名称查找全局字段
- Name of the global to find
+ 要查找的全局变量名称
- Return the value of a Global
+ 返回全局变量的值
- Name of the global to find
+ 要查找的全局变量名称
Value
- TRUE when a global with the name exists, FALSE when it does not exist
+ 存在具有该名称的全局变量时为 TRUE,不存在时为 FALSE
- Return a list of all Global Fields. This is used in the Globals Debugger Window
+ 返回所有全局字段的列表。此函数用于全局变量调试窗口
- List of Globals
+ 全局变量列表
- Assign a value to a Global
+ 为全局变量赋值
- Name of the global to assign
- New value
- TRUE when a global with the name exists, and the value was successfully assigned. FALSE when it does not exist or when there was an error assigning the value.,
+ 要赋值的全局变量名称
+ 新值
+ 存在具有该名称的全局变量且赋值成功时为 TRUE。不存在或赋值出错时为 FALSE。,
- This interface is used for objects that implement a special mechanism
- for reading / writing properties at runtime.
+ 此接口用于实现了在运行时读取/写入属性的特殊机制的对象。
- Retrieve an array of the property names that exist.
+ 检索现有属性名称的数组。
- Retrieve the value of a property by name.
- Property Name
- The current value of the property
- Accessing a property that does not exist will result in a runtime error.
+ 按名称检索属性的值。
+ 属性名称
+ 属性的当前值
+ 访问不存在的属性将导致运行时错误。
- Update the value of a property by name.
- Property Name
- New value of the property
+ 按名称更新属性的值。
+ 属性名称
+ 属性的新值
- Assigning a property that does not exist may result in a runtime error.
- However the class may also decide to "silently" add the property.
+ 为不存在的属性赋值可能会导致运行时错误。
不过,该类也可以决定“静默”添加该属性。
- This interface can be used to access any object with an indexer.
- This is mostly used for elements inside typed arrays of the 'ARRAY OF' class.
- If you implement the interface on the elements you can use an array syntax to
- assess fields/properties in the elements of the array by name or ordinal.
+ 此接口可用于访问任何带有索引器的对象。它主要用于 'ARRAY OF' 类的类型化数组内部的元素。如果在元素上实现此接口,则可以使用数组语法按名称或序号访问数组元素中的字段/属性。
@@ -1171,13 +1116,12 @@
- Get/Set array elements with a name.
- Name which will be used to lookup a property
+ 按名称获取/设置数组元素。
+ 用于查找属性的名称
- This interface is used to index a collection using the VO Array syntax.
- The interface is implemented by the ARRAY type in the runtime, but you can also use it for your custom types.
+ 此接口用于使用 VO 数组语法对集合进行索引。该接口由运行时中的 ARRAY 类型实现,但您也可以将其用于自定义类型。
@@ -1199,55 +1143,49 @@
- This interface described the methods needed for a LateBound object
- When an object implements this interface then the X# runtime will not use
- reflection to implement late bound calls to properties or methods
- but will call these methods instead.
+ 此接口描述了 LateBound 对象所需的方法
当对象实现此接口时,X# 运行时将不使用反射来实现对属性或方法的后期绑定调用,而是调用这些方法。
- Method to read a field or property late bound.
+ 后期绑定读取字段或属性的方法。
- Field/Property Name
- Current value of Field/Property
+ 字段/属性名称
+ 字段/属性的当前值
- Method to update a field or property late bound.
+ 后期绑定更新字段或属性的方法。
- Field/Property Name
- New value for field/property
+ 字段/属性名称
+ 字段/属性的新值
- Call a method in the type late bound. Arguments are passed as Clipper calling convention parameters.
- The method name is passed as first parameter.
+ 以后期绑定方式调用类型中的方法。参数按 Clipper 调用约定传递。方法名称作为第一个参数传递。
- Result of MethodCall
+ MethodCall 的结果
- This interface defines and extension to the Macro compiler subsystem
+ 此接口定义了对宏编译器子系统的扩展
- Compile a string into a runtime codeblock.
- String to compile
- Should single quotes be allowed
- Module of the main app
- will be set to TRUE when the string was a real codeblock (with {|..| }).
- will be set to TRUE when the macro contains code that may result in adding new MemVars).
- A compiled codeblock
+ 将字符串编译为运行时代码块。
+ 要编译的字符串
+ 是否允许使用单引号
+ 主应用程序的模块
+ 当字符串是真正的代码块(带有 {|..| })时将被设置为 TRUE。
+ 当宏包含可能导致添加新内存变量的代码时将被设置为 TRUE。)
+ 已编译的代码块
- This interface is used to index a collection using a numeric and a string index and is implemented by the
- typed array class ('ARRAY OF'). If your elements inside the collection implement the IIndexProperties interface then
- the lookup of the property inside array element will be resolved with a call to the named indexer on that object.
+ 此接口用于使用数值索引和字符串索引对集合进行索引,由类型化数组类('ARRAY OF')实现。如果集合内部的元素实现了 IIndexProperties 接口,则数组元素内部属性的查找将通过对该对象上的命名索引器的调用来解析。
@@ -1265,32 +1203,25 @@
- InList() determines whether an expression is found in a series of expressions.
- The first expression is compared to each of the other expressions until either a match is
- found or the entire list has been traversed.
- For exact matching, use InListExact().
+ InList() 确定某个表达式是否存在于一系列表达式中。第一个表达式将依次与其他每个表达式进行比较,直到找到匹配项或遍历完整个列表为止。如需精确匹配,请使用 InListExact()。
InListExact
- InListExact() determines whether an expression is found in a series of expressions.
- The first expression is compared to each of the other expressions until either a match is
- found or the entire list has been traversed.
- InListExact() is the same as InList() except that == is used for matching instead of = .
- There is no difference between InList() and InListExact() for non string datatypes.
+ InListExact() 确定某个表达式是否存在于一系列表达式中。第一个表达式将依次与其他每个表达式进行比较,直到找到匹配项或遍历完整个列表为止。InListExact() 与 InList() 相同,只是匹配时使用 == 而不是 = 。对于非字符串数据类型,InList() 和 InListExact() 之间没有区别。
InList
- This example compares InList() and InListExact() when the left operand in a comparison is longer than the right operand of a comparison:
+ 此示例比较了当比较中左操作数比右操作数长时 InList() 和 InListExact() 的行为:
? InList("longer", "long") // TRUE
? InList("long ", "long") // TRUE
? InListExact("longer", "long") // FALSE
? InListExact("long ", "long") // FALSE
- This example compares InList() and InListExact() when the right operand in a comparison is longer than the left operand of a comparison:
+ 此示例比较了当比较中右操作数比左操作数长时 InList() 和 InListExact() 的行为:
? InList("long", "longer") // FALSE
? InList("long", "long ") // FALSE
@@ -1302,121 +1233,120 @@
- This interface Extended the ICodeblock interface and adds support for usual
- parameters and return values
+ 此接口扩展了 ICodeblock 接口,并增加了对 usual 参数和返回值的支持
- Executes the codeblock.
+ 执行代码块。
- Zero or more arguments to pass to the codeblock.
- The value of the last expression in the codeblock.
+ 传递给代码块的零个或多个参数。
+ 代码块中最后一个表达式的值。
- Was the codeblock created from a string that started with "{|"
+ 代码块是否由以 "{|" 开头的字符串创建
- Determine if the leftmost character in a PSZ is alphanumeric.
- The string to examine.
- TRUE if the first character is either alphabetic or numeric otherwise FALSE.
+ 确定 PSZ 最左边的字符是否为字母或数字。
+ 要检查的字符串。
+ 如果第一个字符是字母或数字则为 TRUE,否则为 FALSE。
- Determine if the leftmost character in a PSZ is alphabetic.
- The string to examine.
- TRUE if the first character is alphabetic.
+ 确定 PSZ 最左边的字符是否为字母。
+ 要检查的字符串。
+ 如果第一个字符是字母则为 TRUE。
- Determine if the leftmost character in a PSZ is alphanumeric.
- The string to examine.
- TRUE if the first character is alphanumeric.
+ 确定 PSZ 最左边的字符是否为字母或数字。
+ 要检查的字符串。
+ 如果第一个字符是字母或数字则为 TRUE。
- Determine if the leftmost character in a PSZ is a binary digit (0 or 1)).
- The string to examine.
- TRUE if the first character of the string is 0 or 1 otherwise FALSE.
+ 确定 PSZ 最左边的字符是否为二进制数字(0 或 1)。
+ 要检查的字符串。
+ 如果字符串的第一个字符是 0 或 1 则为 TRUE,否则为 FALSE。
- Determine if a value is a Binary.
+ 确定值是否为 Binary。
- The value to examine.
- TRUE if the value is a Binary data type; otherwise, FALSE.
+ 要检查的值。
+ 如果该值是 Binary 数据类型则为 TRUE;否则为 FALSE。
- Determine if a value is passed by reference
+ 确定值是否按引用传递
- The value to examine.
+ 要检查的值。
- Determine if a value is a Currency.
+ 确定值是否为 Currency。
- The value to examine.
- TRUE if the value is a Currency data type; otherwise, FALSE.
+ 要检查的值。
+ 如果该值是 Currency 数据类型则为 TRUE;否则为 FALSE。
- Determine if a value is a DateTime.
+ 确定值是否为 DateTime。
- The value to examine.
- TRUE if the value is a DATETIME data type; otherwise, FALSE.
+ 要检查的值。
+ 如果该值是 DATETIME 数据类型则为 TRUE;否则为 FALSE。
- Determine if a value is a Decimal.
+ 确定值是否为 Decimal。
- The value to examine.
- TRUE if the value is a Decimal data type; otherwise, FALSE.
+ 要检查的值。
+ 如果该值是 Decimal 数据类型则为 TRUE;否则为 FALSE。
- Determine if a value is a Decimal or a Float
+ 确定值是否为 Decimal 或 Float
- The value to examine.
- TRUE if the value is a Decimal, Currency or Float data type; otherwise, FALSE.
+ 要检查的值。
+ 如果该值是 Decimal、Currency 或 Float 数据类型则为 TRUE;否则为 FALSE。
- Determine if a value is a INT64.
+ 确定值是否为 INT64。
- The value to examine.
- TRUE if the value is a INT64 data type; otherwise, FALSE.
+ 要检查的值。
+ 如果该值是 INT64 数据类型则为 TRUE;否则为 FALSE。
- Determine if a value is an integer (LONG or INT64).
+ 确定值是否为整数(LONG 或 INT64)。
- The value to examine.
- TRUE if the value is a LONG or INT64 data type; otherwise, FALSE.
+ 要检查的值。
+ 如果该值是 LONG 或 INT64 数据类型则为 TRUE;否则为 FALSE。
- Determine if the leftmost character in a PSZ is lower.
- The string to examine.
- TRUE if the first character is a lowercase letter otherwise, FALSE.
+ 确定 PSZ 最左边的字符是否为小写。
+ 要检查的字符串。
+ 如果第一个字符是小写字母则为 TRUE,否则为 FALSE。
- TRUE if the value is a LONG, FLOAT, IN64 or DECIMAL data type; otherwise, FALSE.
+ 如果该值是 LONG、FLOAT、IN64 或 DECIMAL 数据类型则为 TRUE;否则为 FALSE。
- Determine if the leftmost character in a PSZ is a blank (that is, Chr(9) through Chr(13) or Chr(32)).
- The string to examine.
- TRUE if the first character of the string blank otherwise FALSE.
+ 确定 PSZ 最左边的字符是否为空白字符(即 Chr(9) 到 Chr(13) 或 Chr(32))。
+ 要检查的字符串。
+ 如果字符串的第一个字符是空白字符则为 TRUE,否则为 FALSE。
- Determine if the leftmost character in a PSZ is uppercase.
- The string to examine.
- TRUE if the first character is an uppercase letter otherwise, FALSE.
+ 确定 PSZ 最左边的字符是否为大写。
+ 要检查的字符串。
+ 如果第一个字符是大写字母则为 TRUE,否则为 FALSE。
- Determine if the leftmost character in a PSZ is a hex character (that is, digits from 1 through 9 and letters from A through F).
- The string to examine.
- TRUE if the first character is hex otherwise FALSE.
+ 确定 PSZ 最左边的字符是否为十六进制字符(即数字 1 到 9 以及字母 A 到 F)。
+ 要检查的字符串。
+ 如果第一个字符是十六进制字符则为 TRUE,否则为 FALSE。
@@ -1441,7 +1371,7 @@
- Determine the number of Symbols in the atom table.
+ 确定原子表中的 Symbol 数量。
@@ -1449,23 +1379,23 @@
- MCompile() allows you to use the macro compiler to compile a string and store the compiled results for later execution. Instead of invoking the macro compiler each time an expression is evaluated, you could speed up your application by compiling an expression only once and executing the compiled form as often as desired.
- Should single quotes be allowed as string delimiters
- MCompile returns a STRING in VO. It returns a XSharp._Codeblock in .Net.
+ MCompile() 允许您使用宏编译器编译字符串,并存储编译结果以供以后执行。与其在每次计算表达式时都调用宏编译器,不如只编译表达式一次,然后根据需要多次执行已编译的形式,这样可以提高应用程序的速度。
+ 是否允许将单引号用作字符串分隔符
+ MCompile 在 VO 中返回 STRING。在 .Net 中它返回 XSharp._Codeblock。
- The group to which the newly allocated memory buffer will belong. This group should have already been opened by MemGrpOpen().
+ 新分配的内存缓冲区所属的组。该组应已通过 MemGrpOpen() 打开。
- Enumerate all the pointers allocated in a memory group
+ 枚举内存组中分配的所有指针
- The group you want to compact
- MemWalker Delegate
- TRUE when all delegate calls return TRUE
+ 要压缩的组
+ MemWalker 委托
+ 当所有委托调用都返回 TRUE 时为 TRUE
@@ -1484,18 +1414,17 @@
- ReAllocate a static memory buffer of a specified size.
+ 重新分配指定大小的静态内存缓冲区。
- Returns the original pointer when the nSize parameter is smaller or equal to the current size.
- Extraneous bytes are zeroed out. Returns a new buffer when the requesed size is bigger than the original size.
+ 当 nSize 参数小于或等于当前大小时,返回原始指针。
多余的字节会被清零。当请求的大小大于原始大小时,返回新的缓冲区。
- Enable / disable memory tracing
+ 启用/禁用内存跟踪
@@ -1507,253 +1436,237 @@
- Internal type that implements the Dynamic Memory Variables.
+ 实现动态内存变量的内部类型。
- Get the value of a local, private or public (in that order). Throws an exception when the variable does not exist.
- The value of the memory variable.
- The name of the memory variable
+ 获取本地变量、私有变量或公共变量的值(按此顺序)。当变量不存在时抛出异常。
+ 内存变量的值。
+ 内存变量的名称
- Get the value of a local, private or public (in that order). Returns NIL if the value does not exist.
- The value of the memory variable or NIL when it does not exist.
- The name of the memory variable
- When a private and a public exist with the same name then the private has preference
+ 获取本地变量、私有变量或公共变量的值(按此顺序)。如果该值不存在则返回 NIL。
+ 内存变量的值,不存在时为 NIL。
+ 内存变量的名称
+ 当存在同名的私有变量和公共变量时,私有变量优先
- Updates the value of a local, private or public (in that order).
- If the value does not exist than a new variable at the current level is created.
+ 更新本地变量、私有变量或公共变量的值(按此顺序)。如果该变量不存在,则在当前级别创建一个新变量。
- The value of the memory variable.
- The name of the memory variable.
- The value to assign.
+ 内存变量的值。
+ 内存变量的名称。
+ 要赋的值。
- Add a public memvar or a private memvar to the current level.
- The name of the memory variable
- Should the variable be created as private
+ 向当前级别添加公共内存变量或私有内存变量。
+ 内存变量的名称
+ 变量是否应创建为私有变量
- Clear a variable by name. Tries to clear a private first and when that is not found then a public
- The name of the memory variable.
+ 按名称清除变量。首先尝试清除私有变量,如果未找到,则清除公共变量
+ 内存变量的名称。
- Clear does not remove the variable but sets its value to NIL.
- In the FoxPro dialect Clear does not clear local variables when these are visible.
+ Clear 不会删除变量,而是将其值设置为 NIL。
在 FoxPro 方言中,当本地变量可见时,Clear 不会清除它们。
- Clear all memvar name/value pairs.
- Does not remove locals. Does not remove privates stack levels.
+ 清除所有内存变量的名称/值对。不会删除本地变量。不会删除私有变量的堆栈级别。
- Get a memvar object from the stack (if it exists)
+ 从堆栈中获取内存变量对象(如果存在)
- Delegate for reading memvars.
- Name of the Memvar for which the value has to be retrieved
- The value of the memory variable.
+ 用于读取内存变量的委托。
+ 要检索其值的内存变量名称
+ 内存变量的值。
- Name of the memory variable.
+ 内存变量的名称。
- Find a private variable. Try on the current level on the stack first and when not found then walk the stack.
+ 查找私有变量。首先在堆栈的当前级别上尝试,未找到时再遍历整个堆栈。
- Update a private variable. Does NOT add a new variable
+ 更新私有变量。不会添加新变量
- Get the total number of unique private variable names.
+ 获取唯一私有变量名称的总数。
- Get an enumerator for all the unique names of private variables
+ 获取所有唯一私有变量名称的枚举器
- Get the first unique private variable name.
+ 获取第一个唯一私有变量名称。
- Get the next unique private variable name.
+ 获取下一个唯一私有变量名称。
- Find a public variable
- The name of the memory variable.
+ 查找公共变量
+ 内存变量的名称。
- Update a public variable. Does NOT create a new public when there is no variable with that name.
- The name of the memory variable.
- The value to assign.
+ 更新公共变量。当不存在具有该名称的变量时,不会创建新的公共变量。
+ 内存变量的名称。
+ 要赋的值。
- Gets the total number of public variables.
+ 获取公共变量的总数。
- Get an enumerator for all the unique names of public variables
+ 获取所有唯一公共变量名称的枚举器
- Gets the name of the first public variable.
+ 获取第一个公共变量的名称。
- Gets the name of the next public variable.
+ 获取下一个公共变量的名称。
- Delegate for writing memvars.
- Name of the Memvar for which the value has to be retrieved
- Value to assign to the memory variable
- When the variable does not exist then a new memory variable may be created.
+ 用于写入内存变量的委托。
+ 要检索其值的内存变量名称
+ 要赋给内存变量的值
+ 当变量不存在时,可能会创建新的内存变量。
- Release a private variable
+ 释放私有变量
- Assign NIL to all visible private variables. Hidden privates are not affected.
+ 将 NIL 赋给所有可见的私有变量。隐藏的私有变量不受影响。
- Release all privates at a certain level and higher
+ 释放某一级别及更高级别上的所有私有变量
- Try to retrieve the value of a local, private or public (in that order).
- The name of the memory variable
- Value of the variable, or NIL whe the variable does not exist.
- TRUE when the variable was found. Otherwise FALSE
+ 尝试检索本地变量、私有变量或公共变量的值(按此顺序)。
+ 内存变量的名称
+ 变量的值,变量不存在时为 NIL。
+ 找到变量时为 TRUE。否则为 FALSE
- Value of the memory variable. The default is NIL for PRIVATEs and FALSE for PUBLICs.
+ 内存变量的值。PRIVATE 变量的默认值为 NIL,PUBLIC 变量的默认值为 FALSE。
- The name of the variable .
+ 变量的名称。
- Release a memory variable
- The name of the variable you want to clear.
- The value of this variable will be set to NIL. The variable is NOT deleted.
+ 释放内存变量
+ 要清除的变量的名称。
+ 此变量的值将被设置为 NIL。变量不会被删除。
- Release a memory variable
- The name of the variable you want to release.
+ 释放内存变量
+ 要释放的变量的名称。
- Only memory blocks that were allocated while MemTrace was set to TRUE will be included.
+ 仅包含在 MemTrace 设置为 TRUE 期间分配的内存块。
- Delegate that a client needs to implement to use MemWalk.
+ 客户端需要实现的委托,用于使用 MemWalk。
- Convert an object containing a numeric value to a FLOAT
+ 将包含数值的对象转换为 FLOAT
- Object containing the numeric value to convert.
- The value in the form of a float.
- Thrown when the parameter oValue cannot be converted to a FLOAT.
+ 包含要转换的数值的对象。
+ 以 float 形式表示的值。
+ 当参数 oValue 无法转换为 FLOAT 时抛出。
- Convert a null value to the correct value for the type
+ 将 null 值转换为该类型的正确值
- Count the number of parameters that do not have a default value
+ 统计没有默认值的参数个数
- This method returns TRUE when the assembly from which an IVarGet()
- or IVarPut() was called is the same assembly in which a property was defined.
+ 当调用 IVarGet() 或 IVarPut() 的程序集与定义属性的程序集相同时,此方法返回 TRUE。
- Property that we are checking
+ 我们要检查的属性
- TRUE when the first stackframe outside of XSharp.RT is in the same assembly as
+ 当 XSharp.RT 之外的第一个堆栈帧与 位于同一程序集中时为 TRUE
- Determines the number of orders for the current work area.
+ 确定当前工作区的索引标识(order)数量。
- OrdCount() returns the number of open indexes as a numeric value.
- When no index is open or when no file is open in the current workarea, the return value is 0.
+ OrdCount() 以数值形式返回已打开索引的数量。当没有打开索引,或当前工作区中没有打开文件时,返回值为 0。
- Return a list of all tag names for the current work area.
+ 返回当前工作区的所有标记(tag)名称列表。
- OrdList() returns a one dimensional array holding strings with the tag names of all open indexes.
- When no index is open, an empty array is returned.
+ OrdList() 返回一个一维数组,其中包含所有已打开索引的标记名称字符串。当没有打开索引时,返回空数组。
- Changes and/or reads a system setting.
+ 更改和/或读取系统设置。
- Is a positive integer identifying a system setting or system variable.
- This should match the values from the Set enumerated type.
+ 是标识系统设置或系统变量的正整数。该值应与 Set 枚举类型中的值匹配。
- The optional expression can specify a new value for a system setting.
- The data type is dependent on the system setting designated by .
+ 可选表达式可以为系统设置指定新值。数据类型取决于 所指定的系统设置。
- When Set() is called without the argument ,
- the function returns the current system setting designated by .
- If is specified, the corresponding system setting is set to
- and the value of the old setting is returned.
+ 当调用 Set() 时不带参数 时,函数返回由 指定的当前系统设置。如果指定了 ,则相应的系统设置将被设置为 ,并返回旧设置的值。
- If you are coming from XHarbour or Xbase++ please don't use set.ch for the value of
- because there are some differences between the values in this header file and the values used inside X#.
+ 如果您来自 XHarbour 或 Xbase++,请不要将 set.ch 用作 的值,因为该头文件中的值与 X# 内部使用的值之间存在一些差异。
- Dump the contents of an array to the terminal window
- Array to dump
- Name to show before the array brackets. Defaults to 'a'
- Nothing
+ 将数组的内容转储到终端窗口
+ 要转储的数组
+ 显示在数组括号之前的名称。默认值为 'a'
+ 无
- This dumps the information to the terminal window.
- This will only work if the main application is a console application.
+ 这会将信息转储到终端窗口。仅当主应用程序是控制台应用程序时才有效。
- Dump the contents of an object to the terminal window
- Object to dump
- Name to show before the field names. Defaults to 'o'
- Nothing
+ 将对象的内容转储到终端窗口
+ 要转储的对象
+ 显示在字段名称之前的名称。默认值为 'o'
+ 无
- This dumps the information to the terminal window.
- This will only work if the main application is a console application.
+ 这会将信息转储到终端窗口。仅当主应用程序是控制台应用程序时才有效。
- Dump the currently defined privates to the terminal window
- Only dump the privates from the current level on the evaluation stack.
- Nothing
+ 将当前定义的私有变量转储到终端窗口
+ 仅转储计算堆栈上当前级别的私有变量。
+ 无
- This dumps the information to the terminal window.
- This will only work if the main application is a console application.
+ 这会将信息转储到终端窗口。仅当主应用程序是控制台应用程序时才有效。
- Dump the currently defined publics to the terminal window
- Nothing
+ 将当前定义的公共变量转储到终端窗口
+ 无
- This dumps the information to the terminal window.
- This will only work if the main application is a console application.
+ 这会将信息转储到终端窗口。仅当主应用程序是控制台应用程序时才有效。
- A string representation of the value.
+ 值的字符串表示形式。
@@ -1766,7 +1679,7 @@
- Convert a string to a Symbol.
+ 将字符串转换为 Symbol。
@@ -1775,7 +1688,7 @@
- Convert a string to an uppercase Symbol.
+ 将字符串转换为大写的 Symbol。
@@ -1784,7 +1697,7 @@
- Convert a symbol to string
+ 将 Symbol 转换为字符串
@@ -1793,7 +1706,7 @@
- Convert a string to a Symbol and add it to the atom table.
+ 将字符串转换为 Symbol 并将其添加到原子表中。
@@ -1803,7 +1716,7 @@
- Convert a string to an uppercase Symbol and add it to the atom table.
+ 将字符串转换为大写的 Symbol 并将其添加到原子表中。
@@ -1822,7 +1735,7 @@
- Determine whether a Symbol is in the atom table.
+ 确定 Symbol 是否在原子表中。
@@ -1831,7 +1744,7 @@
- Convert a Symbol to a null-terminated string.
+ 将 Symbol 转换为以 null 结尾的字符串。
@@ -1840,7 +1753,7 @@
- Terminate the registration of an object that has been registered with RegisterAxit().
+ 终止已通过 RegisterAxit() 注册的对象的注册。
@@ -1848,7 +1761,7 @@
- Determine the data type of an expression.
+ 确定表达式的数据类型。
@@ -1856,27 +1769,26 @@
- Access contents of an address, whether it is passed by reference or not.
+ 访问地址的内容,无论其是否按引用传递。
- Determine the data type of an expression.
+ 确定表达式的数据类型。
- Returns the version of X# you are using.
+ 返回您正在使用的 X# 的版本。
- The VoDb class extends the CoreDb class with methods that take usual parameters or return usual values.
- All other methods are identical and inherited from the CoreDb class.
+ VoDb 类通过接受 usual 参数或返回 usual 值的方法扩展了 CoreDb 类。
所有其他方法都相同,并继承自 CoreDb 类。
@@ -1885,7 +1797,7 @@
- The difference between VoDb.Info and CoreDb.Info is that VoDb.Info takes a USUAL parameter
+ VoDb.Info 与 CoreDb.Info 的区别在于 VoDb.Info 接受 USUAL 参数
@@ -1894,7 +1806,7 @@
- The difference between VoDb.OrderInfo and CoreDb.OrderInfo is that VoDb.Info takes a USUAL parameter
+ VoDb.OrderInfo 与 CoreDb.OrderInfo 的区别在于 VoDb.Info 接受 USUAL 参数
@@ -1903,7 +1815,7 @@
- The difference between VoDb.RddInfo and CoreDb.RddInfo is that VoDb.RddInfo takes a USUAL parameter
+ VoDb.RddInfo 与 CoreDb.RddInfo 的区别在于 VoDb.RddInfo 接受 USUAL 参数
@@ -1912,7 +1824,7 @@
- The difference between VoDb.RecordInfo and CoreDb.RecordInfo is that VoDb.RecordInfo takes a USUAL parameter
+ VoDb.RecordInfo 与 CoreDb.RecordInfo 的区别在于 VoDb.RecordInfo 接受 USUAL 参数
@@ -1921,17 +1833,17 @@
- The difference between VoDb.Select and CoreDb.Select is that VoDb.Select takes a USUAL parameter
+ VoDb.Select 与 CoreDb.Select 的区别在于 VoDb.Select 接受 USUAL 参数
- The difference between VoDb.SetFilter and CoreDb.SetFilter is that VoDb.SetFilter takes a USUAL parameter
+ VoDb.SetFilter 与 CoreDb.SetFilter 的区别在于 VoDb.SetFilter 接受 USUAL 参数
- These functions all map to the static methods inside VoDb (and CoreDb)
+ 这些函数都映射到 VoDb(和 CoreDb)内部的静态方法
@@ -1978,7 +1890,7 @@
- VoDbCloseArea() is an alias for CoreDbCloseArea()
+ VoDbCloseArea() 是 CoreDbCloseArea() 的别名
@@ -1995,14 +1907,14 @@
- Array with structure to use when creating the file.
- Type of the RDDs to use when creating the file
- structure that describes the list of RDDs to use
+ 创建文件时要使用的结构数组。
+ 创建文件时要使用的 RDD 类型
+ 描述要使用的 RDD 列表的结构
- The difference between VoDbCreate and CoreDb.Create is that VoDbCreate takes a ARRAY parameter
+ VoDbCreate 与 CoreDb.Create 的区别在于 VoDbCreate 接受 ARRAY 参数
@@ -2031,7 +1943,7 @@
- New value to assign to the Field.
+ 要赋给字段的新值。
@@ -2127,7 +2039,7 @@
- New value to assign to the Order.
+ 要赋给索引标识(Order)的新值。
@@ -2148,7 +2060,7 @@
- This returns the previous order that was selected.
+ 这将返回之前选择的索引标识(order)。
@@ -2165,7 +2077,7 @@
- The difference between VoDbRddInfo and CoreDb.RddInfo is that VoDbRddInfo takes a USUAL parameter
+ VoDbRddInfo 与 CoreDb.RddInfo 的区别在于 VoDbRddInfo 接受 USUAL 参数
@@ -2255,8 +2167,8 @@
- List of field names to copy
- List of field names to sort on
+ 要复制的字段名称列表
+ 要排序的字段名称列表
@@ -2267,7 +2179,7 @@
- List of field names to copy
+ 要复制的字段名称列表
@@ -2279,7 +2191,7 @@
- The difference between VoDbUnlock and CoreDb.UnLock is that VoDbUnlock takes USUAL parameters
+ VoDbUnlock 与 CoreDb.UnLock 的区别在于 VoDbUnlock 接受 USUAL 参数
@@ -2289,23 +2201,23 @@
- Open a file
+ 打开文件
- List of RDDs to use.
- Name of the RDD to use.
- Type of the RDD to use.
+ 要使用的 RDD 列表。
+ 要使用的 RDD 名称。
+ 要使用的 RDD 类型。
- Dynamically loads a library (dll) compiled with X#, running any _INIT procedures it may contain.
- The full path of the library to load.
- The Assembly object of the loaded library.
+ 动态加载使用 X# 编译的库(dll),并运行其中可能包含的所有 _INIT 过程。
+ 要加载的库的完整路径。
+ 已加载库的 Assembly 对象。
\ No newline at end of file