Working with ISetCanvas Parts

The following tasks are associated with using an ISetCanvas* part in visual composition. Tasks that are common to many parts are described in related topics.

Selecting the orientation
Controls are organized in rows or columns, called decks, in a set canvas. To specify either rows or columns, set the deckOrientation property in the ISetCanvas* property sheet. With the <default> value, the deck orientation is horizontal, and controls are organized in a single row. To change the deck orientation to vertical, select the vertical choice in the value column.

Specifying the number of decks (rows or columns)
To specify multiple decks, set the deckCount property in the ISetCanvas* property sheet. Enter the number in the value column.

Distributing controls within decks
To specify the distribution of controls within decks, set the packType property in the ISetCanvas* property sheet. With the <default> value, controls are packed tightly in each deck. Alternatively, select one of the following choices in the value column:

even
Adjusts the pad space between controls to distribute them evenly within decks. This also has the effect of aligning controls across decks to give the appearance of both rows and columns.

expanded
Expands all controls to the same width and height. This also has the effect of distributing controls evenly within decks and aligning them across decks. All controls are separated by the uniform pad space.

tight
Packs controls tightly in decks, without changing either the space between controls or the size of controls.

Aligning controls within decks
If controls are packed tightly or distributed evenly, you can align the controls within their decks.

To specify alignment, set the alignment property in the ISetCanvas* property sheet. Select an alignment choice in the value column.

Reordering controls
To reorder controls on the canvas, open the ISetCanvas* pop-up menu and select View parts list. Then, in the parts list window, drag parts within the list to reorder them.

Defining a set canvas as a group box
Use a set canvas to achieve the appearance of a group box around controls on a multicell canvas. The set canvas can provide the appearance you want without sacrificing automatic sizing of controls. To define a set canvas as a group box on a multicell canvas, do the following:
  1. Drop an ISetCanvas* part on a cell of the IMultiCellCanvas* part.

  2. To define group box text, set the text property in the ISetCanvas* property sheet. Enter the text in the value column.

  3. For vertical arrangement of controls as in a group box, set the deckOrientation property in the ISetCanvas* property sheet. Select the vertical choice in the value column.

  4. Drop the controls you want on the ISetCanvas* part.


Related procedures
Common Tasks for Control Parts
Setting Part Style Properties
Setting Part Color Properties
Setting Part Font Properties
Setting Part Handlers Properties
Setting Part Framing Properties
Working with VisualAge User Interface Parts

Related references
ISetCanvas
Property Settings -- ISetCanvas
Portability -- ISetCanvas