Polybench® Reference
A surface to draw schematics on or to define user interface screens on.

Page

Overview

A Page is the surface you drag or draw all your schematics and user interfaces on.

A Page can be either a Design Page (invisible to the end-user), a Display Page (user interface of an application), or a Printable Page (can be printed to paper).

Properties

Find more information about changing properties here: link

Protected
type: True or False
Set to true to protect the contents of this page, so that other people cannot see it without knowing a password.
Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'


Description
type: See description
Some description for your own use.


Author
type: See description
The author of this page, sheet or note.


GridSize
type: Integer value
The size of the grid on this page.


PageSize
type: Size containing width and height
The size of this page or note in pixels.


PageType
type: Select from the list
Select the type of this page from the list. The PageType determines how the page is used by Polybench.
Select one of those presets:
design
A Design Page can be used to design math processing schematics on. This page type cannot be shown in end-user applications.
display
A Display Page is a page that is shown as user interface in end-user applications. It should contain viewers, buttons, images, etc. Do not use this page type to design math processing schematics on.
printable
A Report Page contains elements that should be printed to paper, or to a PDF or as image. A Report Page is never shown in end-user applications (use PRINTPREVIEW (see link) to show to the end-user).
module
The page is a Design Page (like 'design'), but then specifically for designing modules.


BackgroundImage
type: Known image name
The name of the background image. The image name can be selected from the Image Repository (press the small button).

This property uses the Image Repository. For more information about the use of images in a project, refer to link

BackgroundColor
type: Known color name
The background color of the page. The color name can be selected from the Color Repository (press the small button).

This property uses the Color Repository. For more information about the use of colors in a project, refer to link

Caption
type: Word or phrase
The name of the object in the project. This name must not contain '.' or '$' characters.

Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.

Documentation
type: See description
Optional documentation of this object.

It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.

Details

There are basically three types of pages:

1) pages that are used to design measurement configurations on (operators with connectors). The size of these pages is not very relevant, because they are normally not displayed to your end users. The page should be large enough to draw your schematics on. If it is too small, just change the size parameters of it. The size of the page does not have influence on performance or efficiency.

2) pages with sizes that fit on different monitor screens. The size of such a page is represented as a number of pixels for width and height. The width-to-height ratio determines how well the page fits on a screen, without leaving unused borders. The pixel sizes also determine the resolution of the screen, or how finely grained you can design a user interface.

3) pages with the shape of a piece of paper (in standard formats), used to define printable forms. Pages of this type only can be selected for print jobs, for example using the Action PRINT.

Note that if a page is displayed to the end user in full screen, the page is scaled in a way that it is entirely visible. If the end user's computer display has another aspect ratio than the application was designed for, then the pages will still be displayed completely, although an unused border may also be visible.

This behavior is different from the default Windows behavior, where screens often can be resized. The reason that Polybench forbids the resizing of screens by end-users, is that you now have full control of the layout of a screen. The layout will not change on monitors with different aspect ratios; it will only zoom to a fitting size.