Positioning controls in a DataWindow object

Table 19-6 shows the properties for each control in a DataWindow object that determine how it is positioned within the DataWindow object. All except the HideSnaked property are on the Position page of the object’s Properties view.

Sliding properties also affect control positioning. Sliding properties are described on “Sliding controls to remove blank space in a DataWindow object”.

Table 19-6: Position properties for controls in a DataWindow object

Property

Description

X

Position (in units you selected for the DataWindow object) from the left edge of the DataWindow band where the control is placed.

Y

Position (in units you selected for the DataWindow object) from the top edge of the DataWindow band where the control is placed.

Width

Width of the control in units you selected for the DataWindow object.

Height

Height of control in units you selected for the DataWindow object.

Layer

You can select from the following values:

  • Background Control is behind other controls. It is not restricted to one band. This is useful for adding a watermark (such as the word CONFIDENTIAL) to the background of a report.

  • Band Control is placed within one band. It cannot extend beyond the band's border.

  • Foreground Control is in front of other controls. It is not restricted to one band.

Moveable

When selected, control can be moved during execution and in preview. This is useful for designing layout.

Resizable

When selected, control can be resized during execution and in preview. This is useful for designing layout.

HideSnaked

When selected, control appears only in the first column on the page; in subsequent columns the control does not appear. This is only for newspaper columns, where the entire DataWindow object snakes from column to column (set on the General page of the Properties view).

Default positioning

PocketBuilder uses the defaults shown in Table 19-7 when you place a new control in a DataWindow object.

Table 19-7: Default position for controls in a DataWindow object

Control

Default position

Graph

Foreground, movable, resizable

All other controls

Band, not movable, not resizable