Tutorial - 创建表格

这个主题基本指南，将创建一个带有复选框的表格，它控制在执行时，将允许您从列表中选择一个用户名，然后选择测量的元素。这些信息将在最终的报告中显示。

当你通过使用编辑窗口指令，复制这些内容时，这个指南将给你关于表格编辑的相关内容，一些关于图形的一些关于编程技巧的。

这个指南中，你将在表格编辑和编辑窗口之间进行切换，所以首先打开编辑窗口。

右击“编辑”窗口，并从快捷菜单选择停靠视图，使其不要停靠。
选择最大化按钮，则全屏显示。
将编辑窗口置于命令模式。

选择文件 | 报告 | 新建 | 窗体报告，打开窗体编辑器。
要隐藏任何未使用的工具栏，请右键单击工具栏区域并将其删除。
要隐藏任何未使用的PC-DMIS窗口，请从视图菜单中选择打开的窗口。保持打开“编辑”窗口。
要最大化表单编辑器，请单击编辑器窗口右上角的最大化按钮。可以在编辑器的背景上看到“窗体”一词。窗体编辑器现在应类似于：

窗体编辑器

使用窗体编辑器时，您可能会发现隐藏常用的 PC-DMIS 工具栏和窗口很有用，如此可释放屏幕空间。若要频繁使用该编辑器，可以为模板创建一个存储的屏幕布局。有关布局信息，请参见“使用工具栏”一章中的“窗口布局工具栏”主题。

拖动表格/视图的灰色背景，令其 5 英寸宽、6 英寸高。
添加一个 Border 对象，拖动边界，令其恰好处于窗体区域。设置边界属性，令 LineWidth 值为 3，ForeColor 为深蓝色 (0.0.128)。
添加一个 Bitmap 对象到窗体上方。屏幕上将显示位图对话框。使用加载按钮浏览所选的位图文件，如企业徽标。调整位图的大小和位置，令其在表格上方 1.5 英寸之内。
添加一个 RadioButton 对象到位图对象的下方。访问 RadioButton 的属性，并单击 ListItems 值。屏幕上将显示列表选择对话框。此对话框可让您创建该对象的选项按钮列表。
- 从列表选择框中选择现有的录音按钮项。在名称框中，将名称更改为 "CIRCLE 1"。索引值应显示 0。
- 点击添加按钮添加3个更多的选项。然后将添加的项目更改为 "CIRCLE 2"、"CIRCLE 3" 和 "CIRCLE 4"。它们的索引值分别为 1、2 和 3。列表选择对话框类似于：
  
  列表选择对话矿，显示4个选项，其索引值从0到3。
- 完成后，单击确定。
通过将 (ObjectCode) 值从 "RadioButton1" 更改为 "optMeasure"，重命名 RadioButton 对象。
添加一个 Frame 对象，并围绕 RadioButton 对象拖动。更改“框架”的 Text 属性为“选择要测量的项目”。
添加一个 EditBox 对象到 RadioButton 对象的右侧，将其从 "EditBox1" 重命名为 "txtMeasure"。
添加一个 Text 对象 (Text1) 到 RadioButton 对象下方，将其 Text 属性设置为“选择用户：”。
添加一个 ComboBox 到 Text 对象的右侧，将其从 "ComboBox1" 重命名为 "cboUsers"。此控件将包含用户列表。
- 单击 ListItems 值添加用户列表。此操作将再次访问列表选择对话框。
- 单击添加。PC-DMIS 在列表选择下方插入“（无）”。
- 将列表中第一个项目的名称由“（无）”变为“[选择一个使用者]”，并为其指定索引值 0。
- 继续使用该对话框来增加五个或六个用户名称。这个指南使用"Bob", "Allen", "Mary", "Shelly", "Jared", and "Kurt"。
- 根据需要，使用向上或向下按钮更改项目在列表中的显示位置。完成后的对话框类似于：
  
  列表选择对话框显示用户名称的列表。
- 单击确定。ComboBox 复选框中现在包含以下列表项目。
添加一个 EditBox 对象到 ComboBox 的右侧，并将其从 "EditBox2" 重命名为 "txtUser"。
添加另一 Text 对象 (Text2) 到名称为“选择用户”的对象的下方，并将添加对象的 Text 属性设置为“键入报告说明：”。
添加另一 EditBox 对象到上述文本对象的右侧，并将其从 "EditBox3" 重命名为 "txtDescription"。
添加一个 Button 对象至窗体底部，并将其名称 "Button1" 重命名为 "cmdContinue"。将其 Text 属性更改为“继续 (&C)”。与符号可用于定义要作为快捷方式字符与 Alt 一同使用的字符。因此，执行模式下在表格上按 Alt + C 将与单击继续按钮的作用一样。
选择文件 | 保存，保存窗体。为此窗体命名 "TestForm.Form"，把它保存在所选的目录中。
按 Ctrl + E 在运行模式下测试窗体。由于控件没有绑定任何代码，因此无论单击哪个项目，均不会发生任何操作，只是添加到下一个而已。完成以后，再次按 Ctrl + E 返回至编辑模式。

在该步中您完成了基本窗体，添加了各种控件并为列表指定了项目。其类似于：

选择 RadioButton 对象 optMeasure，访问其属性。
单击 EventChange 事件。屏幕上将显示 VBS 迷你编辑器。从这个小型代码窗口可键入 Visual BASIC 代码语句，只要从选项按钮列表选择了新值，即会运行这些语句。
在代码窗口中定义代码：

尺寸的索引号为整数。

intIndex=optMeasure.Index

选择 case 整数所引号

Case 0

txtMeasure.Text="Circle 1"

Case 1

txtMeasure.Text="Circle 2"

Case 2

txtMeasure.Text="Circle 3"

Case 3

txtMeasure.Text="Circle 4"

终止选择

单击确定。迷你编辑器关闭。
选择文件 | 保存，保存窗体。
按 Ctrl + E 并进入运行模式，可测试报告。选择一项特征进行测量。

此代码在您从列表中选择一项要测量的特征时执行。它检查从选项按钮列表选择的内容，并设置 txtMeasure 的 Text 属性，以显示文本字符串 "CIRCLE 1"、"CIRCLE 2 等。按 Ctrl + E 退出运行模式并返回编辑模式。

选择 ComboBox 对象 cboUsers，访问其属性。
单击 EventChange 事件。屏幕上将显示 VBS 迷你编辑器。
在代码窗口中定义代码：

txtUser.Text=cboUsers.TextValue

单击确定。迷你编辑器关闭。
选择文件 | 保存，保存窗体。
按 Ctrl + E 并进入运行模式，可测试报告。选择一个用户。

该代码在您从列表中选择一个用户时执行。它检查选择的列表项目的文本值，并设置 txtUser 的 Text 属性，以显示选择的用户的文本字符串。按 Ctrl + E 退出运行模式并返回编辑模式。

选择“按钮”对象 cmdContinue，访问其属性。
单击 EventClick 事件。屏幕上将显示 VBS 迷你编辑器。
在代码窗口中定义代码：

If cboUsers.Value>0 And Len(txtDescription.Text)>0 And Len(txtMeasure.Text)>0 Then

取消视图。

ELSE/

MsgBox“请在继续前填写整个窗体。”

END_IF/

单击确定。迷你编辑器关闭。
选择文件 | 保存，保存窗体。
按 Ctrl + E 并进入运行模式，可测试报告。单击继续按钮。

单击继续按钮时运行此代码。代码检查窗体内容是否填写完整，若是则关闭窗体编辑器。否则显示一条消息，通知用户填写缺少的内容。

Len ( ) 函数测试编辑框中文本字符串的长度（或字符数），确保非空。
cboUsers.Value > 0 代码检查是否从列表选择了用户名称。

现在定义了表格，可以在编辑窗口和表格之间传递数据。

如果尚未这样做，保存表格。
从窗口菜单选择编辑窗口，令“编辑”窗口显示在前面。
在命令模式下。
在每个圆之后插入特征位置尺寸指令。
通过在测量圆特征前的“编辑”窗口中键入下面的代码，可在上方的圆特征前，定义要指定给窗体使用的变量。

ASSIGN/STR_DESCRIPTION=""

ASSIGN/STR_USER=""

ASSIGN/STR_MEASURE=""

将光标直接放在这些语句后面，并选择插入 | 报告命令 | 窗体。屏幕上显示插入窗体对话框。浏览存储 "TestForm.FORM" 的目录，选择此文件并单击打开。
PC-DMIS 把 FORM/FILENAME 命令块连同选择的窗体文件的路径，一同插入到“编辑”窗口中。标记并执行这条命令后，将运行窗体。在继续执行“编辑”窗口前，将一直等待直至窗体关闭。

注意，此命令中有 PARAM/= 语句，或者说是有一个“参数”。使用这些参数，可在 PC-DMIS“编辑”窗口变量和窗体控件属性之间回传和前传值。
在 PARAM/= 语句等号左边单击，键入 "TXTDESCRIPTION.TEXT"。单击等号右边，键入 "STR_DESCRIPTION"。按 Enter。将出现另外一个 PARAM/= 语句。

记住，txtDescription 是您在表格中为 EditBox 对象指定的名称，用于接受使用者输入的报告说明。

在执行过程中，txtDescription 的文本属性最初采用 STR_DESCRIPTION 的值。在本例中，其采用的是空字符串。关闭窗体后，它将窗体的值返回给 STR_DESCRIPTION。
继续采用这种方式定义 STR_USER 和 STR_MEASURE 变量的参数，将它们分别键入 txtUser 和 txtMeasure 对象的文本属性。
保存对“编辑”窗口的更改。完成以后，FORM/FILENAME 命令块类似于：

CS7 =FORM/FILENAME=D:\PARTPROGRAMS\TESTFORM.FORM

PARAM/TXTDESCRIPTION.TEXT=STR_DESCRIPTION

PARAM/TXTMEASURE.TEXT=STR_MEASURE

PARAM/TXTUSER.TEXT=STR_USER

参数/=

结束表格/

当你创建表格后，就创建了一个选项按钮的列表，（使用RadioButton对象），控制测量元素。这时，你需要添加附加的描述到编辑窗口中，以便测量根据在表格中南学选择的正确的特征。

在“编辑”窗口中，将光标放在第一个 CIR1 特征的前面，并按 Enter。你的鼠标应该在圆特征处的空白线处。
选择插入 | 流控制命令 | 控制对 | If / End If。PC-DMIS 将把 IF / END IF 条件语句插入“编辑”窗口：

IF/0

END_IF/

定义条件。突出显示默认值 0 并键入：

STR_MEASURE=="Circle 1"

点击等号的右边，并键入"STR_DESCRIPTION"。
选择整个 CIR1 特征及其后的位置尺寸，选择编辑 | 剪切。然后选择编辑 | 粘贴，将它移至 IF/STR_MEASURE == "Circle 1" 行后面、END_IF/ 行前面的一空白行。第一个条件块类似于：

IF/STR_MEASURE=="Circle 1"

CIR1 特征如下...

位置尺寸如下...

END_IF/

继续重复以上的步骤，为其他圆特征也定义变量。结束时，编辑窗口代码如下：

ASSIGN/STR_DESCRIPTION=""

ASSIGN/STR_USER=""

ASSIGN/STR_MEASURE=""

CS7 =FORM/FILENAME=D:\PARTPROGRAMS\TESTFORM.FORM

PARAM/TXTDESCRIPTION.TEXT=STR_DESCRIPTION

PARAM/TXTMEASURE.TEXT=STR_MEASURE

PARAM/TXTUSER.TEXT=STR_USER

参数/=

结束表格/

IF/STR_MEASURE=="Circle 1"

CIR1=特征/圆

DIM LOC1 LOCATION OF CIRCLE CIR1

END_IF/

IF/STR_MEASURE=="Circle 2"

CIR2=特征/圆

DIM LOC2 LOCATION OF CIRCLE CIR2

END_IF/

IF/STR_MEASURE=="Circle 3"

CIR3=特征/圆

DIM LOC3 LOCATION OF CIRCLE CIR3

END_IF/

IF/STR_MEASURE=="Circle 4"

CIR4=特征/圆

DIM LOC4 LOCATION OF CIRCLE CIR4

END_IF/

现在您需要做最后几步。首先，通过使用报告注释让PC-DMIS将表格中的值发送到报告窗口的最终报告中。然后，在表格中隐藏一些对象。

在“编辑”窗口中，直接在 FORM/FILENAME 命令后键入这些命令。

注释/报告，

"User: "+STR_USER

注释/报告，

"Report Description: "+STR_DESCRIPTION

注释/报告，

"Measure Routine: "+STR_MEASURE

选择窗口 | 窗体编辑器，返回窗体编辑器。
右击可以访问属性对话框。从下拉列表中选择 txtMeasure。PC-DMIS 将选择该对象。
单击高级，将可见属性设为“否”。
从下拉列表中选择 txtUser。PC-DMIS选择该对象。
单击高级，将可见属性设为“否”。由于使用者无需查看这些值，并且我们使用它们的唯一原因，就是将值返回 PC-DMIS，因此将此属性设为“否”可使这些对象在执行过程中不可见。
保存表格。
关闭表格编辑器

选择视图 | 报告窗口，并使用模板选择对话框工具栏图标设置报告，以使用默认的标准报告模板 TextOnly.rtp。
返回“编辑”窗口。标记整个“编辑”窗口，保存测量例程，然后选择文件 | 执行测试测量例程。
PC-DMIS 到达 FORM/FILENAME 命令时，将运行表格，暂停程序的执行，直至完成窗体的填写。

填写窗体并单击继续按钮。PC-DMIS 将窗体的值返回 PC-DMIS 变量。
条件语句检查 STR_MEASURE 变量的值，执行相应的圆特征。
PC-DMIS打印报告指令和已测特征的检测结果到报告窗口中。