core

#### Section and Page Properties

The main editing areas in the Report Template Editor and the Custom Report Editor are special objects called the Section and the Page, respectively. These objects contain properties that you can access and set just as with any other object.

Command Set
Defines how commands get processed within the current section (Page tab).

All Commands - The setting processes the entire command set in the current section (Page tab). This is the default value.

Continue from Previous Section - This setting continues to process the command set from the previous section, continuing where the last section stopped processing.

Same as Previous Section - This setting causes the section (Page tab) to take exactly the same command set as the previous section. The head section and all subsequent sections with this setting form a mini-group. All subsequent sections in the mini group create one page with the head page.

(Form Name)
Defines the name of the page.

Height
Defines the height, in pixels, of the main editing area.

LocalDecls
Provides a window for you to declare variables local to this object. Once declared, you can use these variables in events that affect the object. This type of declaration lets you give the variable a value in one event and then check that value in a different event. The variable is safe from accidental modification since it is invisible to other objects in the report or form.

LocalVariables
See the "Declare Global Variables Using the LocalVariables Property" topic.

Maximum Number Of Pages
Defines the maximum number of report pages that use the design of the current Page tab.

For example, if you set this value to 2, but you have easily enough dimensions in your measurement routine to fill five pages, the section does not process commands once the number of pages for that section reaches the specified maximum of two pages. The current process command needs a newly-created section (Page tab) to display additional information.

The default value of 0 means there is no maximum and so all pages are displayed.

ToolTipText
Common Properties

Width
Defines the width, in pixels, of the main editing area.

Examples of "Command Set" and "Maximum Number of Pages" Properties

In the following examples, suppose that your report template has four sections named A, B, C, and D, and that each one contains a TextReportObject. Additionally, suppose that your measurement routine has enough dimensions to display three pages of dimensions per section. For each example, a table details the property settings.

##### Example 1

Sections | Maximum Number of Pages | Command Set
A | 0 | All Commands
B | 0 | All Commands
C | 0 | All Commands
D | 0 | All Commands

In this example, PC-DMIS displays the pages in the final report like this:

A1,A2,A3,B1,B2,B3,C1,C2,C3,D1,D2,D3

##### Example 2

Sections | Maximum Number of Pages | Command Set
A | 1 | All Commands
B | 0 | All Commands
C | 0 | All Commands
D | 1 | All Commands

In this example, PC-DMIS displays the pages in the final report like this:

A1,B1,B2,B3,C1,C2,C3,D1

##### Example 3

Sections | Maximum Number of Pages | Command Set
A | 1 | All Commands
B | 0 | All Commands
C | 0 | Same As Previous Section
D | 1 | All Commands

In this example, PC-DMIS displays the pages in the final report like this:

A1,B1,C1,B2,C2,B3,C3,D1

##### Example 4

Sections | Maximum Number of Pages | Command Set
A | 1 | All Commands
B | 0 | Continue From Previous Section
C | 0 | Same As Previous Section
D | 1 | All Commands

In this example, PC-DMIS displays the pages in the final report like this:

A1,B2,C2,B3,C3,D1

Related Topics:

About Sections

Working with Multiple Pages