Height, Width Properties

Applies To

  • Height property — ActiveX control, Bound Object Frame control, Chart control, Check Box control, Combo Box control, Command Button control, Form section, Image control, Label control, Line control, List Box control, Option Button control, Option Group control, Page, Rectangle control, Report section, Subform/Subreport control, Tab control, Text Box control, Toggle Button control, Unbound Object Frame control.
  • Width property — ActiveX control, Bound Object Frame control, Chart control, Check Box control, Combo Box control, Command Button control, Form, Image control, Label control, Line control, List Box control, Option Button control, Option Group control, Page, Rectangle control, Report, Subform/Subreport control, Tab control, Text Box control, Toggle Button control, Unbound Object Frame control.
Description

You can use the Height and Width properties to size an object to specific dimensions. This can be useful, for example, if you want to create objects that are exactly the same size or that have the same width or height.

Notes

  • The Height property applies only to form sections and report sections, not to forms and reports.
  • The Width property applies only to forms and reports, not to form sections and report sections.
  • Both properties apply to controls on forms and reports.
Setting

Enter a number for the desired height or width in the current unit of measurement. To use a unit of measurement different from the setting in the Regional Settings Properties dialog box in Windows Control Panel, specify the unit, such as cm or in (for example, 5 cm or 3 in). The setting for the Width property must be a value from 0 to 22 inches (55.87 cm).

You can set these properties by using the object's property sheet, a macro, or Visual Basic.

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

In Visual Basic, use a numeric expression to set the value of each property. Values are expressed in twips.

For report sections, you can't use a macro or Visual Basic to set the Height property when you print or preview a report. For report controls, you can set the Height and Width properties when you print or preview a report only by using a macro or an event procedure specified in a section's OnFormat event property setting.

You can't set these properties for an object once the print process has started. For example, attempting to set the Height property in a report's Print event generates an error.

Remarks

Microsoft Access automatically sets the Height and Width properties when you create or size a control or when you size a window in form Design View or report Design view.

The height of sections and the width of forms and reports are measured from the inside of their borders. The height and width of controls are measured from the center of their borders so controls with different border widths align correctly. The margins for forms and reports are set in the Page Setup dialog box, available by clicking Page Setup on the File menu.

Note To set the left and top location of an object, use the Left and Top properties.

See Also

BorderWidth property, Left, Top properties, MoveSize action.

Example

The following code resizes a command button to a 1-inch by 1-inch square button (the default unit of measurement in Visual Basic is twips; 1440 twips equals one inch):

Me!cmdSizeButton.Height = 1440    ' 1440 twips = 1 inch.
Me!cmdSizeButton.Width = 1440