Polybench® Reference
Represents a static image in a project.

Static Image

Overview

You can use a Static Image object in your project to enhance a user interface or help document your analysis design. For example, you could display your logo, or some explenatary picture for your users.
The image is static, which means that it cannot be changed from within a project.

The Static Image object shows an image from the Image Repository (link).

Properties

Find more information about changing properties here: link

ImageName
type: Known image name
The name of the image in the image repository.

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

Size
type: Size containing width and height
The size of the user interface of this object (width, height).


Coordinates
type: Coordinate
The location of the user interface of this object in (x,y) coordinates, relative to the object it is on top of.


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

You can use a Static Image just as an image in your application, but also as a background for other objects, because it is possible to drag other user interface objects onto the image. In that case, the Static Image behaves like a Panel (link).

A quick way to add a Static Image to your design, is by copying an image onto the drawing board (not an image file, but the image itself). The image is then automatically added to the Image Repository.

If you need an image that changes as a result of some Action, then take a look at the Picture Viewer (link).