From 8d18f9331bd014319013aa55125995549f6b5948 Mon Sep 17 00:00:00 2001 From: xinjie <38008973+vfp9@users.noreply.github.com> Date: Wed, 6 Nov 2024 14:40:09 +0800 Subject: [PATCH] [DOCC]Synchronized Simplified Chinese Documentation (#1624) --- docs/Help_ZH-CN/Topics/ARRAY.xml | 4 ++-- docs/Help_ZH-CN/Topics/Build-Configurations.xml | 4 ++-- docs/Help_ZH-CN/Topics/CODEBLOCK.xml | 6 +++--- docs/Help_ZH-CN/Topics/Calling-conventions.xml | 6 +++--- docs/Help_ZH-CN/Topics/CharLiterals.xml | 4 ++-- docs/Help_ZH-CN/Topics/Highlight-words.xml | 4 ++-- docs/Help_ZH-CN/Topics/VersionHistory.xml | 11 +++++++++-- .../Topics/command_Fox_FunctionProcedure.xml | 6 ++++-- docs/Help_ZH-CN/Topics/command_Fox_Properties.xml | 6 +++--- docs/Help_ZH-CN/Topics/command_GLOBAL.xml | 7 ++++--- docs/Help_ZH-CN/Topics/command_XPP_Methods.xml | 7 +++---- docs/Help_ZH-CN/Topics/command_Xpp_Classmembers.xml | 5 ++--- docs/Help_ZH-CN/Topics/opt-memvar.xml | 10 +++++----- docs/Help_ZH-CN/XSHelp.hmxp | 2 +- 14 files changed, 45 insertions(+), 37 deletions(-) diff --git a/docs/Help_ZH-CN/Topics/ARRAY.xml b/docs/Help_ZH-CN/Topics/ARRAY.xml index 5d35e64289..26051c191e 100644 --- a/docs/Help_ZH-CN/Topics/ARRAY.xml +++ b/docs/Help_ZH-CN/Topics/ARRAY.xml @@ -1,6 +1,6 @@  - + ARRAY ARRAY @@ -10,7 +10,7 @@ ARRAY - ARRAY 类型是由 USUAL 值组成的动态数组。数组的每个元素都可以包含另一个数组，因此数组可以是多维的。 + ARRAY 类型是由 USUAL 值组成的动态数组。数组的每个元素都可以包含另一个数组，这意味着数组可以是多维的。 实现 ARRAY 类型在 XSharp.__Array 类中实现。 diff --git a/docs/Help_ZH-CN/Topics/Build-Configurations.xml b/docs/Help_ZH-CN/Topics/Build-Configurations.xml index ffdfba970a..9864fb0d3d 100644 --- a/docs/Help_ZH-CN/Topics/Build-Configurations.xml +++ b/docs/Help_ZH-CN/Topics/Build-Configurations.xml @@ -1,13 +1,13 @@  - + 生成配置
生成配置
- 如果需要用不同的设置来生成项目，就需要生成配置。例如，"调试" 和 "发布" 都是配置，在生成时会相应地使用不同的编译器选项。一个配置处于活动状态，并在 Visual Studio IDE 顶部的命令栏中显示。 + 当您需要用不同的设置来构建项目时，就会用到构建配置。例如，调试（Debug）和发布（Release）是在构建过程中使用不同编译器选项的两种配置。有一种配置处于活动状态，它在 Visual Studio IDE 顶部的命令栏中显示。 diff --git a/docs/Help_ZH-CN/Topics/CODEBLOCK.xml b/docs/Help_ZH-CN/Topics/CODEBLOCK.xml index 7e16c8a882..02eb94d280 100644 --- a/docs/Help_ZH-CN/Topics/CODEBLOCK.xml +++ b/docs/Help_ZH-CN/Topics/CODEBLOCK.xml @@ -1,6 +1,6 @@  - + CODEBLOCK CODEBLOCK @@ -30,8 +30,8 @@ XSharp 还引入了包含语句列表的代码块： FUNCTION Start() AS VOID
LOCAL cb AS CODEBLOCK
cb := {| a,b,c|  
  ? "value 1" ,a
  ? "value 2" ,b
  ? "value 3" ,c
  RETURN a*b*c
  }
? Eval(cb,10,20,30)
WAIT
RETURN 注意 - -
  • 第一条语句应从参数列表后的新行开始。
    • + +
  • 第一条语句应从参数列表后的新行开始。
  • 参数列表后不应有分号。
  • 语句列表应以 RETURN 语句结束。
    •  diff --git a/docs/Help_ZH-CN/Topics/Calling-conventions.xml b/docs/Help_ZH-CN/Topics/Calling-conventions.xml index e3df371605..7be9839cc7 100644 --- a/docs/Help_ZH-CN/Topics/Calling-conventions.xml +++ b/docs/Help_ZH-CN/Topics/Calling-conventions.xml @@ -1,6 +1,6 @@  - + 调用约定
    @@ -70,9 +70,9 @@ 然后，你希望在代码中使用 3 个名为 “a”、“b ”和 “c ”的局部变量。 然而，编译器会生成一个带有参数的函数。类似这样 FUNCTION Foo(args PARAMS USUAL[]) - 然后，我们在函数内部生成局部变量，并将参数的名称标注出来 + 在函数内部，我们将根据您声明的参数名称生成局部变量： LOCAL a := args[1] as USUAL
    LOCAL b := args[2] as USUAL
    LOCAL c := args[3] as USUAL     - 实际上，代码会更复杂一些，因为您可能会决定在所有函数中使用比声明参数更少的参数。我们必须考虑到这一点。 + 在现实中，代码会更复杂一些，因为您可能决定调用的函数参数少于声明的参数。我们必须考虑到这一点。 现在看起来是这样的 LOCAL numParams := args:Length
    LOCAL a := iif(numParams > 0, args[1], NIL) AS USUAL     “numParams” 和  ”args" 的名称是由编译器生成的，其中包含一个特殊字符，以确保我们引入的变量名称不会与代码中的名称相冲突。 diff --git a/docs/Help_ZH-CN/Topics/CharLiterals.xml b/docs/Help_ZH-CN/Topics/CharLiterals.xml index 28d1f49d52..ec5b83dfdd 100644 --- a/docs/Help_ZH-CN/Topics/CharLiterals.xml +++ b/docs/Help_ZH-CN/Topics/CharLiterals.xml @@ -1,6 +1,6 @@  - + Char 字面量 CHAR @@ -14,7 +14,7 @@ 根据所选方言的不同，Char 字面量有不同的符号。 - 在许多方言中，单引号是字符串分隔符，因此 Char 字面量需要 “c ”前缀。 + 在许多方言中，单引号是字符串分隔符，因此 Char 字面量需要 'c' 前缀。 只有在 Core 和 Vulcan 方言中，字符字面量总是保留单引号 diff --git a/docs/Help_ZH-CN/Topics/Highlight-words.xml b/docs/Help_ZH-CN/Topics/Highlight-words.xml index 52499732c9..c7fcf48892 100644 --- a/docs/Help_ZH-CN/Topics/Highlight-words.xml +++ b/docs/Help_ZH-CN/Topics/Highlight-words.xml @@ -1,6 +1,6 @@  - + Highlight Identifiers(高亮标识符) Highlight words @@ -10,7 +10,7 @@ Highlight Identifiers(高亮标识符)
    - 当您选择一个特定的单词时，它会显示该单词的所有使用地点，并区分大小写。 + 当您选择一个特定的单词时，它会显示该单词的所有使用位置，并区分大小写。 diff --git a/docs/Help_ZH-CN/Topics/VersionHistory.xml b/docs/Help_ZH-CN/Topics/VersionHistory.xml index df537c4782..9646e724d6 100644 --- a/docs/Help_ZH-CN/Topics/VersionHistory.xml +++ b/docs/Help_ZH-CN/Topics/VersionHistory.xml @@ -1,6 +1,6 @@  - + 版本历史 Changes @@ -34,6 +34,8 @@
  • 修正了 /vo9(处理丢失的 RETURN 语句和返回值)编译器选项的若干问题 (#1544)
  • 修正了在 FoxPro 方言的 CLASS 语句中使用特性(attributes)的问题 (#1566)
  • 我们修正了编译系统中的一个问题，该问题有时会导致重新编译，即使没有更改任何内容。
    • +
  • 编译器在构建带有 .editorconfig 文件的解决方案时可能会崩溃。
    • +
  • 修正了为 FoxPro 风格类定义内的成员属性生成特性(attributes)输出的问题。
    •  运行时 Bug 修复 @@ -51,6 +53,9 @@
  • 修正了宏编译器在使用某些语言关键字(如 REF、FIELD、DEFAULT)作为标识符时出现的问题 (#1557)
  • 修正了读取使用多字节编码存储的 DBF 文件的可变长度字段的问题。
  • 修正了用简体中文编码的 DBF 文件被解释为粤语的问题。
    • +
  • 修复了 DBF RDD 中的一个问题，即在获取记录或文件锁后，未重新加载 currentbuffer。
    • +
  • 修正了 USUAL 类型中的一个问题，即浮点数值的 CompareTo 执行不正确 (#1616)
    • +
  • 修正了 USUAL 类型中 ! 运算符与 (LOGIC) cast 相比不能产生正确结果的问题。
    • VOSDK @@ -67,8 +72,9 @@
  • 修复了编辑器中代码片段在 VS 2022 17.11 版中不再工作的问题 (#1564)
  • 修复了带有结束关键字（如 NEXT 和 ENDDO）的缩进行的问题(当这些关键字后跟有 “垃圾 ”时)。
  • 当 include 中的一个文件声明了实体(如 USING SomeNameSpace)时，在 VS 表单设计器中打开表单可能会失败(#1595,#1596)
    • +
  • 修正了调试器中以“$”字符开头的标识符（如异常对话框中的“$exception”）无法正确评估的问题(#1602)
    • +
  • 修正了使用 DEFINE CLASS  ... ENDDEFINE 声明的 VFP 样式的类的缩进问题(#1609)
    •  - 新特性
  • 现在，在 VS 中构建任何项目类型时，TargetFramework 属性都会自动添加到程序集中 (#1507)
    • @@ -83,6 +89,7 @@
  • 我们不再为没有任何 X# 项目的解决方案创建 X# intellisense 数据库
  • 我们对 X# intellisense 数据库结构做了一些更改。当您打开一个已有数据库的解决方案时，数据库将被删除，所有源文件将被重新扫描(仅一次)。
  • X# 源代码编辑器顶部现在多了一个组合框，可列出包含文件的项目。当一个文件包含在多个项目中时，你可以看到所有项目。切换到新项目将改变 “评估上下文”。条件编译（#ifdef）会在编辑器中反映出变化。
    • +
  • 我们在编辑器中添加了对 Edit.NextMethod 和 Edit.PreviousMethod 命令的支持。这些命令通常没有快捷键，但您可以使用 Visual Studio 工具栏上的 “自定义 ”选项来分配它们。例如，您可以指定 Ctrl-DownArrow 和 Ctl-UpArrow。
    •  XIDE 常规 diff --git a/docs/Help_ZH-CN/Topics/command_Fox_FunctionProcedure.xml b/docs/Help_ZH-CN/Topics/command_Fox_FunctionProcedure.xml index 623ebf55ba..ecd1ea80d9 100644 --- a/docs/Help_ZH-CN/Topics/command_Fox_FunctionProcedure.xml +++ b/docs/Help_ZH-CN/Topics/command_Fox_FunctionProcedure.xml @@ -1,6 +1,6 @@  - + FUNCTION 和 PROCEDURE _ACCESS @@ -21,7 +21,8 @@ 用途 定义类定义的方法和事件函数及过程。 语法 - [Modifiers] FUNCTION | PROCEDURE Name[_ACCESS |_ASSIGN] + [Attributes] [Modifiers] FUNCTION | PROCEDURE Name[_ACCESS |_ASSIGN] + [AS <idType>]   ([cParamName | cArrayName[] [AS Type][@]]) [AS Type]   [HELPSTRING cHelpString] | THIS_ACCESS(cMemberName) [NODEFAULT]      cStatements @@ -29,6 +30,7 @@ 更多详情，请参阅 FUNCTION 和 PROCEDURE 。 参数 + _ACCESS_ACCESS 或 _ASSIGN 后缀指定为同名属性创建 Access 或 Assign 方法。 _ASSIGN diff --git a/docs/Help_ZH-CN/Topics/command_Fox_Properties.xml b/docs/Help_ZH-CN/Topics/command_Fox_Properties.xml index f2d2399535..bceb36e73e 100644 --- a/docs/Help_ZH-CN/Topics/command_Fox_Properties.xml +++ b/docs/Help_ZH-CN/Topics/command_Fox_Properties.xml @@ -1,6 +1,6 @@  - + 属性和字段
    @@ -10,7 +10,7 @@ 用途 声明具有可选初始值的字段和或属性 语法 - [FIELD] [modifiers] <IdName>, <IdName> ...] [AS <idType>] + [Attributes] [FIELD] [modifiers] <IdName>, <IdName> ...] [AS <idType>] [[.]Object.] <IdName> = <Expression> ...] 声明和/或初始化属性的两种语法均受支持。 @@ -20,7 +20,7 @@ FIELD 如果包含 FIELD 关键字，那么名称将是类中字段的名称 - Modifiers可选的修饰符列表，用于指定属性的可见性或作用域，如 PUBLIC、protected、hidden。protected(保护)、hidden(隐藏)。 + <IdName>要声明的字段或属性的有效标识符名称。 diff --git a/docs/Help_ZH-CN/Topics/command_GLOBAL.xml b/docs/Help_ZH-CN/Topics/command_GLOBAL.xml index e2aae17514..423195fbd2 100644 --- a/docs/Help_ZH-CN/Topics/command_GLOBAL.xml +++ b/docs/Help_ZH-CN/Topics/command_GLOBAL.xml @@ -1,6 +1,6 @@  - + GLOBAL 语句 Arraysdeclaring @@ -18,9 +18,10 @@ 用途 声明整个应用程序或模块都可使用的变量或数组。 语法 - [Modifiers]  GLOBAL <idVar> [:= <uValue>] [AS | IS <idType>] - [Modifiers]  GLOBAL DIM <ArraySpec> AS | IS <idType> + [Attributes] [Modifiers]  GLOBAL <idVar> [:= <uValue>] [AS | IS <idType>] + [Attributes] [Modifiers]  GLOBAL DIM <ArraySpec> AS | IS <idType> 参数 + <idVar>变量的有效标识符名称。 全局变量是一个实体，因此与其他实体共享相同的名称空间。 这就意味着，全局变量和函数不可能具有相同的名称。 diff --git a/docs/Help_ZH-CN/Topics/command_XPP_Methods.xml b/docs/Help_ZH-CN/Topics/command_XPP_Methods.xml index 2f692b8341..7ff1047c6e 100644 --- a/docs/Help_ZH-CN/Topics/command_XPP_Methods.xml +++ b/docs/Help_ZH-CN/Topics/command_XPP_Methods.xml @@ -1,6 +1,6 @@  - + METHOD 实现 ACCESS @@ -22,9 +22,8 @@ [Attributes] [ACCESS | ASSIGN] [Modifiers] METHOD [<ClassName>:] <MethodName>[ [([<idParam> [AS|REF|OUT|IN <idType>] [, ...])] ) [AS <idType>]
    [=> <expression>]
    CRLF     [<Body>]
    [END METHOD]?     参数 - Modifiers一个或多个修饰符的可选列表。 CLASS, STATIC, ABSTRACT, UNSAFE, ASYNC, EXTERN
    STATIC 是 CLASS 的同义词。     - - + + ACCESS | ASSIGN声明此方法实现了一个属性的 Getter 或 Setter。这也必须在类声明中定义为 ACCESS 或 ASSIGN。 diff --git a/docs/Help_ZH-CN/Topics/command_Xpp_Classmembers.xml b/docs/Help_ZH-CN/Topics/command_Xpp_Classmembers.xml index a0e0912187..dfc45da1c8 100644 --- a/docs/Help_ZH-CN/Topics/command_Xpp_Classmembers.xml +++ b/docs/Help_ZH-CN/Topics/command_Xpp_Classmembers.xml @@ -1,6 +1,6 @@  - + METHOD 声明 ACCESS @@ -29,8 +29,7 @@ [Attributes] INLINE [CLASS] METHOD <MethodName>[ [([<idParam> [AS|REF|OUT|IN <idType>] [, ...])] ) [AS <idType>]
    [=> <expression>]
    CRLF     [<Body>]
    [END METHOD]     参数 - Modifiers可选的修饰符列表，用于指定方法的相关信息。(deferred , final , introduce , override , class , sync, new, static, async, unsafe, extern)。 - + <MethodName,...> 是一个用逗号分隔的列表，其中包含所声明的实例方法的名称。方法名称与函数和变量名称的约定相同。它必须以下划线或字母开头，并且必须包含字母数字字符。 IS <MethodName>X# 不支持 IS methodname 子句 diff --git a/docs/Help_ZH-CN/Topics/opt-memvar.xml b/docs/Help_ZH-CN/Topics/opt-memvar.xml index 50154dc50f..f90ecd67a4 100644 --- a/docs/Help_ZH-CN/Topics/opt-memvar.xml +++ b/docs/Help_ZH-CN/Topics/opt-memvar.xml @@ -1,6 +1,6 @@  - + -memvar -memvar @@ -10,17 +10,17 @@ -memvar
    - -memvar选项告诉编译器启用对 "内存变量 "的支持。如果要使用 -fox2 编译选项让宏编译器看到局部变量，在 FoxPro 方言中也需要使用该选项。 + -memvar选项告诉编译器启用对 "内存变量 "的支持。在 FoxPro 方言中，如果想让宏编译器看到局部变量，也需要使用该选项。 语法 - -memvar [+ | -]   + -memvar [+ | -]   参数 - + | - 指定 + 或 -memvar，可指示编译器启用对内存变量的支持。 + + | - 指定 + 或 -memvar，可指示编译器启用对内存变量的支持。 备注 这对 Core 和 Vulcan 方言不起作用。 启用该选项将在编译器中启用以下命令：
     MEMVAR <MemvarName,...> - PUBLIC <MemVarName,...>   + PUBLIC <MemVarName,...>   PRIVATE <MemVarName,...> PARAMETERS <ParameterName,,...> diff --git a/docs/Help_ZH-CN/XSHelp.hmxp b/docs/Help_ZH-CN/XSHelp.hmxp index 6d25d07a08..edd0570d4a 100644 --- a/docs/Help_ZH-CN/XSHelp.hmxp +++ b/docs/Help_ZH-CN/XSHelp.hmxp @@ -744,7 +744,7 @@ XSharp BV - Cahors (2.21.0.0) + Cahors (2.21.0.4) XSharp