变量

1. 在 Part Studio 中，单击 打开“变量”对话框。

   

2. 在对话框中：

   1. 输入变量的名称（参考变量所依据的名称）。

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. 选择类型：
      • 长度 - 代表长度的数值（小数、整数、分数）
      • 角度 - 代表角度的数值（小数、整数、分数）
      • 数字 - 数值（小数、整数、分数）
      • 任意项目 - 上述任意项目，具有不同单位的数值，或 FeatureScript 值，例如布尔、映射、数组、字符串或函数。请参见 https://cad.onshape.com/FsDoc/variables.html#standard-types 及下面的示例。
   3. 输入一个值（可选：长度、角度及任意项目的单位）。
   4. 输入变量的自定义说明。
3. 单击 。

1. 在 Part Studio 中，单击 打开“变量”对话框，然后单击“测量”：

   

2. 在对话框中：
   1. 选择类型：
      • 距离 - 表示距离的数值（小数、整数、分数）
      • 长度 - 代表长度的数值（小数、整数、分数）
      • 直径 - 表示直径的数值（小数、整数、分数）

   2. 输入变量的名称（参考变量所依据的名称）。

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. 选择要测量其间距的图元。
   4. 根据您的喜好填写剩余输入框。
3. 单击 。

“来自表格”选项位于“变量”功能中，它允许用户创建单个变量来存储 CSV 表格中指定行和列的子集。“行”选项用于筛选行，并确定变量的“结果类型”（单个值、数组或映射）。随后，“列”选项对每行进行筛选，并决定最终变量中每个条目的类型。

1. 在 Part Studio 中，单击 打开“变量”对话，然后单击“来自表格”：

   

2. 在对话框中：
   1. 输入变量的“名称”（并以此名称引用它）。

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. 在“CSV 文件”下，单击“选择 CSV 文件”输入框以打开对话：

      

      从“当前文档”、“其他文档”中选择 CSV 文件，或单击对话底部的“导入”按钮，从您的设备中选择 CSV 文件。

      选择后，单击该文件。文件将加载到“选择 CSV 文件”输入框中。

   3. 根据您的需求填写“行”和“列”输入框：
      • 访问类型 - 选择“根据索引”、“根据索引范围”、“根据标签”或“所有值”。
        • Index - If By index is selected, enter a single Index value.
        • 最小/最大索引 - 选择“根据索引范围”时，请输入最小和最大索引值。
        • 值 - 如果选择“根据标签”，请输入标签的字符串值。
      • 正则表达式 - 选中此项以对一组目标字符串进行模式匹配。
      • 结果类型 - 选择“单一值”、“数组”或“映射”。
        • 标签列/行索引 - 如果“结果类型”为“映射”，请输入数字索引值或变量。
   4. 选中“转换系数”，若需进行不同测量单位之间的转换（例如，若表格中数值单位为英寸，而您希望将其转换为厘米），请在此处输入一个带测量单位的值。

      

   5. 或者，输入“说明”以提供有关正在使用的变量或 CSV 文件的一些详细信息。
3. 单击 。

示例

以下所有示例均使用下面的 3x3 CSV 表格：

• 数组的数组 - 当为“行”和“列”同时设置“访问类型：所有值”和“结果类型：数组”时，将创建一个对应整个 CSV 文件的数组的数组：

  

• 以第一列为索引的行 - 若要以 CSV 文件第一列中的值为行创建索引，请为“行”选择“访问类型：所有值”、“结果类型：映射”，并设置“标签列索引：0”。这将把表格的第一列设置为映射的键。

  对于“列”，选择“访问类型：根据索引范围”并设置表格列的“最小/最大索引”范围（在下面的示例中，输入了“最小/最大索引”范围为“1/2”，这将为表格的第二和第三列提供一个数组）。最后，选择“结果类型：数组”：

  

• 第一列 - 若仅访问第一列，请为“行”设置“访问类型：所有值”和“结果类型：数组”。接着，为“列”选择“访问类型：根据索引 (0)”和“结果类型：单个值”：

  

• 第一行 - 若仅访问第一行，请为“行”设置“访问类型：根据索引 (0)”和“结果类型：单个值”。接着，为“列”选择“访问类型：所有值”和“结果类型：数组”：

  

注释

• 要查看变量结果，请将鼠标悬停在特征名称上。工具提示显示 CSV 文件的结果：

  

• 由于变量源自表格，因此其“变量类型”和“变量表格”中的值为只读状态（如以下示例中的“尺寸”变量）：

  

创建尺寸，在尺寸输入框中输入 # 和变量名称（也可作为表达式的一部分，如下所示）：

和

保存尺寸，变量会替换为值，并且会求解表达式（如果适用）：

双击尺寸进行编辑时，会显示变量（和表达式）：

如果使用不带变量的表达式作为草图尺寸，则在尺寸值左侧使用不带变量的表达式图标 () 进行指示。如果将带有变量的表达式用于草图尺寸，则在尺寸值左侧使用带变量的表达式图标 () 进行指示。请参见在草图中显示表达式。

在 Part Studio 中使用表达式的任何地方均可使用变量。例如，在拉伸或旋转运算中。

像往常一样开始操作（在本例中为“旋转”操作）；在数值输入框中输入 # 和变量名称（或可选择作为表达式的一部分）：

接受特征。

编辑特征时，会在数值输入框中显示求解：

在输入框中单击，会显示变量（在适当的情况下，还会显示表达式）。

变量自动填充特征

定义变量后，如果在数值对话框输入框中输入井号标签（或者井号、下划线或任何字母），将打开变量自动填充特征，如下所示：

左：在对话中使用变量。右：使用草图中的尺寸输入框中的变量。

您可以一直键入内容以筛选列表中的合理选项，使用方向键可在列表中上移和下移，当列表中的变量亮显时，使用 Enter 键可接受该变量。您也可以使用鼠标滚轮来滚动变量列表，并通过单击鼠标来选择特定的变量。请注意，如果未使用井号 (#)，FeatrureScript 函数也会包含在列表中：

另请注意以下几点：

• 使用 Esc 键可关闭下拉列表而不选择任何内容。如果从下拉列表中移除焦点，也会将其关闭而不选择任何内容。
• 计算值显示为浅灰色，不会插入这些值（仅插入变量或函数名称）。函数输入也是如此，因为不插入输入占位符名称。
• 仅显示当前使用环境中存在的变量，而不显示特征列表中再往下的变量

变量值可以包含表达式。您可以指定带索引的数组，该索引可以是变量。这样，您可以通过更改索引变量的值来更改变量的值。

要在变量中使用数组，必须先设置基于零的索引。

1. 创建一个变量并将名称设置为“config”。选择“数字”作为类型，将 #config 的值设置为“2”。
2. 创建一个变量，将名称设置为“diameter”。将 #diameter 的值设置为“[0.25, 0.5, 1][#config]”。

第二组方括号 [#config] 充当数组中的索引指针。

3. 创建一个变量，将名称设置为“length”。将 #length 的值设置为“[2, 4, 10][#config]”。

4. 创建一个圆。
5. 创建一条线。
6. 将圆的直径设置为“#diameter”。

   因为 #config = 2，所以圆的直径为 1。

7. 将线的长度设置为“#length”。

   因为 #config = 2，所以线的长度为 10。

更改索引变量的值即可更改所有数组变量的索引。

您可以根据需要创建变量，例如在特征对话框的输入框中输入数字值时。该变量会保存在特征列表中的当前操作之前。

例如，在创建草图的过程中弹出尺寸对话框时，除了输入尺寸的值，您也可以输入 #，系统会显示现有变量的列表，同时显示“新建变量”选项：

选择“新建变量”打开“变量”对话框以创建新变量，然后将其用于当前输入框。（或者如果适用，请从当前变量中选择一个）

通过“创建变量”对话框，您可以为特征（默认）或配置创建变量。

为新变量输入名称和值。单击复选标记以保存新变量并将其用于打开的特征。

根据 FeatureScript 语句，您可以在变量中使用 FeatureScript 函数 。

例如，您可以创建名为“调整”的“任意项目”类型的变量，以保存将指定长度加倍并加上 2.5 mm 的函数，如下所示：

function(len) { return len * 2 + 2.5 mm; }

然后在表达式中参考该变量，例如：

#Adjust(20mm)

• 更改变量的值时（像编辑任何特征一样来编辑变量），使用该变量的所有运算都会自动更新。
• 更改变量的名称后，可以选中将更改应用于使用该变量的所有位置：

  

  选中 “更新所有参考” 旁边的方框。

1. 在 Part Studio 中，选择“变量”工具图标 () 打开“变量工具”对话框：

   

2. 在对话框中：
   1. 选择类型：
   • 长度 - 代表长度的数值（小数、整数、分数）
   • 角度 - 代表角度的数值（小数、整数、分数）
   • 数字 - 数值（小数、整数、分数）
   • 任意项目 - 上述任意项目，具有不同单位的数值，或 FeatureScript 值，例如布尔、映射、数组、字符串或函数。请参见 https://cad.onshape.com/FsDoc/variables.html#standard-types 及下面的示例。
   2. 输入变量的名称（参考变量所依据的名称）。

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. 输入一个值（可选：长度、角度及任意项目的单位）。
3. 轻按复选标记。

您创建的变量列在特征列表中，显示变量的名称和值。

1. 在 Part Studio 中，选择“变量”工具图标 () 打开“变量工具”对话框，然后轻按“已测量”：

   

2. 在对话框中：
   1. 选择类型：
   • 距离 - 表示距离的数值（小数、整数、分数）
   • 长度 - 代表长度的数值（小数、整数、分数）
   • 直径 - 表示直径的数值（小数、整数、分数）

3. 输入变量的名称（参考变量所依据的名称）。

   在“名称”输入框中仅可使用英文字母、数字和下划线 (_)。变量名区分大小写，且不能以数字开头。

   1. 选择要测量其间距的图元。
   2. 根据您的喜好填写剩余输入框。
4. 轻按复选标记。

您创建的变量列在特征列表中，显示变量的名称和值。

“来自表格”选项位于“变量”功能中，它允许用户创建单个变量来存储 CSV 表格中指定行和列的子集。“行”选项用于筛选行，并确定变量的“结果类型”（单个值、数组或映射）。随后，“列”选项对每行进行筛选，并决定最终变量中每个条目的类型。

iOS 支持从 CSV 文件（来自表格）创建变量，仅限于编辑和查看在桌面（浏览器）平台上创建的变量。

1. 轻按 打开“变量”对话，然后轻按“来自表格”：

   

2. 在对话框中：
   1. 输入变量的“名称”（并以此名称引用它）。

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. 在“CSV 文件”下，轻按“选择 CSV 文件”输入框以选择并打开现有的 CSV 文件。它已加载到“选择 CSV 文件”输入框

      中。根据您的需求填写“行”和“列”输入框：

      • 访问类型 - 选择“根据索引”、“根据索引范围”、“根据标签”或“所有值”。
        • Index - If By index is selected, enter a single Index value.
        • 最小/最大索引 - 选择“根据索引范围”时，请输入最小和最大索引值。
        • 值 - 如果选择“根据标签”，请输入标签的字符串值。
      • 正则表达式 - 选中此项以对一组目标字符串进行模式匹配。
      • 结果类型 - 选择“单一值”、“数组”或“映射”。
        • 标签列/行索引 - 如果“结果类型”为“映射”，请输入数字索引值或变量。
   3. 切换“转换系数”，若需进行不同测量单位之间的转换（例如，若表格中数值单位为英寸，而您希望将其转换为厘米），请在此处输入带测量单位的数值。
   4. 或者，输入“说明”以提供有关正在使用的变量或 CSV 文件的一些详细信息。
3. 轻按复选标记。

创建尺寸，在尺寸输入框中输入 # 和变量名称（也可作为表达式的一部分，如下所示）：

和

保存尺寸，变量会替换为值，并且会求解表达式（如果适用）：

双击尺寸进行编辑时，会显示变量（和表达式）：

在 Part Studio 中使用表达式的任何地方均可使用变量。例如，在拉伸或旋转运算中：

像往常一样开始操作（在本例中是旋转），在数值输入框中输入 # 和变量名称（也可作为表达式的一部分）。例如：(#x) deg。

接受特征。

编辑特征时，会在数值输入框中显示求解。例如：4 deg。

在输入框中单击，会显示变量（在适当的情况下，还会显示表达式）。

变量值可以包含表达式，但是必须求得标量值。您可以指定带索引的数组，该索引可以是变量。这样，您可以通过更改索引变量的值来更改变量的值。

要在变量中使用数组，必须先设置基于零的索引。

1. 轻按变量工具，将名称设置为“config”。将 #config 的值设置为 2。
2. 轻按变量工具，将名称设置为“diameter”。将 #diameter 的值设置为 [0.25, 0.5, 1] [#config]。

请务必包含括住“#config”的第二组括号，这样可以使变量 #config 的值可以指向数组中的正确位置。

3. 轻按变量工具，将名称设置为“length”。将 #length 的值设置为 [2, 4, 10] [#config]。

请务必包含括住“#config”的第二组括号，这样可以使变量 #config 的值可以指向数组中的正确位置。

4. 轻按草图工具，绘制一个圆的草图。
5. 轻按草图工具，绘制一条线的草图。
6. 将圆的直径设置为“#diameter”。
7. 将线的长度设置为“#length”。

   圆的直径设置为 1，线的长度设置为 10。

8. 编辑 #config 变量，将值设置为 0。

草图将会更新，圆的直径现在设置为 0.25，线的长度设置为 2。

您可以按照自己的意愿针对任意多个数组执行此操作，数组可以容纳无限个位置（并不是如本例中所示那样仅限于三个值）。

根据 FeatureScript 语句，您可以在变量中使用 FeatureScript 函数 。

例如，您可以创建名为“调整”的“任意项目”类型的变量，以保存将指定长度加倍并加上 2.5 mm 的函数，如下所示：

function(len) { return len * 2 + 2.5 mm; }

然后在表达式中参考该变量，例如：

#Adjust(20mm)

• 更改变量的值时（像编辑任何特征一样来编辑变量），使用该变量的所有运算都会自动更新。
• 变量名称区分大小写。
• 您可以输入变量作为独立的值或作为方程的一部分。
• 您可以在尺寸标注、表达式或特征中使用变量。

• 如果您指定没有单位的变量，表达式也将没有单位或假定工作区单位。但是，如果您明确为变量值添加单位，则任何表达式在编写时也应匹配该单位才能有效。

• 更改变量的名称后，可以选中将更改应用于使用该变量的所有位置：

  

  选择“更新所有参考”。

1. 在 Part Studio 中，选择“变量”工具 以打开“变量工具”对话框：

   

2. 在对话框中：
   1. 选择类型：
   • 长度 - 代表长度的数值（小数、整数、分数）
   • 角度 - 代表角度的数值（小数、整数、分数）
   • 数字 - 数值（小数、整数、分数）
   • 任意项目 - 上述任意项目，具有不同单位的数值，或 FeatureScript 值，例如布尔、映射、数组、字符串或函数。请参见 https://cad.onshape.com/FsDoc/variables.html#standard-types 及下面的示例。
   2. 输入变量的名称（参考变量所依据的名称）。

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. 输入一个值（可选：长度、角度及任意项目的单位）。
3. 轻按复选标记。

您创建的变量列在特征列表中，显示变量的名称和值。

1. 在 Part Studio 中，选择“变量”工具 以打开“变量工具”对话框，然后单击“测量”：

   

2. 在对话框中：
   1. 选择类型：
   • 距离 - 表示距离的数值（小数、整数、分数）
   • 长度 - 代表长度的数值（小数、整数、分数）
   • 直径 - 表示直径的数值（小数、整数、分数）

3. 输入变量的名称（参考变量所依据的名称）。

   在“名称”输入框中仅可使用英文字母、数字和下划线 (_)。变量名区分大小写，且不能以数字开头。

   1. 选择要测量其间距的图元。
   2. 根据您的喜好填写剩余输入框。
4. 轻按复选标记。

您创建的变量列在特征列表中，显示变量的名称和值。

“来自表格”选项位于“变量”功能中，它允许用户创建单个变量来存储 CSV 表格中指定行和列的子集。“行”选项用于筛选行，并确定变量的“结果类型”（单个值、数组或映射）。随后，“列”选项对每行进行筛选，并决定最终变量中每个条目的类型。

Android 支持从 CSV 文件（来自表格）创建变量，仅限于编辑和查看在桌面（浏览器）平台上创建的变量。

1. 轻按 打开“变量”对话，然后轻按“来自表格”：

   

2. 在对话框中：
   1. 输入变量的“名称”（并以此名称引用它）。

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. 在“CSV 文件”下，轻按“选择 CSV 文件”输入框以选择并打开现有的 CSV 文件。它已加载到“选择 CSV 文件”输入框

      中。根据您的需求填写“行”和“列”输入框：

      • 访问类型 - 选择“根据索引”、“根据索引范围”、“根据标签”或“所有值”。
        • Index - If By index is selected, enter a single Index value.
        • 最小/最大索引 - 选择“根据索引范围”时，请输入最小和最大索引值。
        • 值 - 如果选择“根据标签”，请输入标签的字符串值。
      • 正则表达式 - 选中此项以对一组目标字符串进行模式匹配。
      • 结果类型 - 选择“单一值”、“数组”或“映射”。
        • 标签列/行索引 - 如果“结果类型”为“映射”，请输入数字索引值或变量。
   3. 切换“转换系数”，若需进行不同测量单位之间的转换（例如，若表格中数值单位为英寸，而您希望将其转换为厘米），请在此处输入带测量单位的数值。
   4. 或者，输入“说明”以提供有关正在使用的变量或 CSV 文件的一些详细信息。
3. 轻按复选标记。

创建尺寸，在尺寸输入框中输入 # 和变量名称（也可作为表达式的一部分，如下所示）：

和

保存尺寸，变量会替换为值，并且会求解表达式（如果适用）：

双击尺寸进行编辑时，会显示变量（和表达式）：

在 Part Studio 中使用表达式的任何地方均可使用变量。例如，在拉伸或旋转运算中：

像往常一样开始操作（在本例中是旋转），在数值输入框中输入 # 和变量名称（也可作为表达式的一部分）。例如：(#x) deg。

接受特征。

编辑特征时，会在数值输入框中显示求解。例如：4 deg。

在输入框中单击，会显示变量（在适当的情况下，还会显示表达式）。

变量值可以包含表达式，但是必须求得标量值。您可以指定带索引的数组，该索引可以是变量。这样，您可以通过更改索引变量的值来更改变量的值。

要在变量中使用数组，必须先设置基于零的索引。

1. 轻按变量工具，将名称设置为“config”。将 #config 的值设置为 2。
2. 轻按变量工具，将名称设置为“diameter”。将 #diameter 的值设置为 [0.25, 0.5, 1] [#config]。

请务必包含括住“#config”的第二组括号，这样可以使变量 #config 的值可以指向数组中的正确位置。

3. 轻按变量工具，将名称设置为“length”。将 #length 的值设置为 [2, 4, 10] [#config]。

请务必包含括住“#config”的第二组括号，这样可以使变量 #config 的值可以指向数组中的正确位置。

4. 轻按草图工具，绘制一个圆的草图。
5. 轻按草图工具，绘制一条线的草图。
6. 将圆的直径设置为“#diameter”。
7. 将线的长度设置为“#length”。

   圆的直径设置为 1，线的长度设置为 10。

8. 编辑 #config 变量，将值设置为 0。

草图将会更新，圆的直径现在设置为 0.25，线的长度设置为 2。

您可以针对任意多个数组执行此操作，您的数组可以容纳无限位（并不是如本例中所示那样仅限于三个值）。

根据 FeatureScript 语句，您可以在变量中使用 FeatureScript 函数 。

例如，您可以创建名为“调整”的“任意项目”类型的变量，以保存将指定长度加倍并加上 2.5 mm 的函数，如下所示：

function(len) { return len * 2 + 2.5 mm; }

然后在表达式中参考该变量，例如：

#Adjust(20mm)

• 更改变量的值时（像编辑任何特征一样来编辑变量），使用该变量的所有运算都会自动更新。
• 变量名称区分大小写。
• 您可以输入变量作为独立的值或作为方程的一部分。
• 您可以在尺寸标注、表达式或特征中使用变量。