CanGrow, CanShrink Properties

CanGrow, CanShrink Properties

See Also                  Applies To

You can use the CanGrow and CanShrink properties to control the appearance of sections or controls on forms and reports that are printed or previewed. For example, if you set both properties to Yes, a section or control automatically adjusts vertically to print or preview all the data the section or control contains.

Notes

Setting

The CanGrow property uses the following settings.

Setting Visual Basic Description
Yes True (–1) The section or control grows vertically so that all data it contains can be printed or previewed.
No False (0) (Default) The section or control doesn't grow. Data that doesn't fit within the fixed size of the section or control won't be printed or previewed.

The CanShrink property uses the following settings.

Setting Visual Basic Description
Yes True The section or control shrinks vertically so that the data it contains can be printed or previewed without leaving blank lines.
No False (Default) The section or control doesn't shrink.

You can set these properties only by using the section or control's property sheet.

For controls, you can set the default for these properties by using the default control style or the DefaultControl method in Visual Basic.

These property settings are read-only in a macro or Visual Basic in any view but Design view.

Remarks

You can use these properties to control the appearance of printed forms and reports. When you set both properties to Yes, the object automatically adjusts so any amount of data can be printed. When a control grows or shrinks, the controls below it move down or up the page.

If you set a control's CanGrow property to Yes, Microsoft Access automatically sets the CanGrow property of the section containing the control to Yes. (However, if you set a control's CanShrink property to Yes, Microsoft Access doesn't set the section's CanShrink property to Yes.)

Sections grow and shrink vertically across their entire width. For example, suppose a form has two text boxes side by side in a section, and each control has its CanShrink property set to Yes. If one text box contains one line of data and the other text box contains two lines of data, both text boxes will be two lines long because the section is sized across its entire width. To grow and shrink the data independently, you can place two subform or subreport controls side by side, and set their CanGrow and CanShrink properties to Yes.

When you use the CanGrow and CanShrink properties, remember that: