Unit Size

Defines the size of a rectangle in terms of width and height using unit-aware values.

Remarks

Unit Size allows you to specify the width and height of a rectangle using unit-aware string values. This is useful in scenarios where sizes must be defined in physical or logical units, or as a percentage or pixel value.

Each property ('Width' and 'Height') can be configured independently, or you can use shorthand notation to set both dimensions to the same value. You may enter values directly as a comma-separated string, or expand the property in the UI to edit each value separately.

Usage

• To set both width and height to the same value: 8px
• To set width and height independently: 1in, 2in

Supported Unit Types

The following unit types are supported when specifying values for Unit Size:

• px: Pixels
• in: Inches
• pt: Points (1/72 of an inch)
• cm: Centimeters
• mm: Millimeters
• %: Percent (context-dependent, typically relative to a parent or container)

Note: The twip (twentieths of a point) and em (typographic em) units are not supported in Unit Size. Attempting to use these units will result in a validation error.

Examples

• 8px: Sets both width and height to 8 pixels.
• 1in, 2in: Sets width to 1 inch and height to 2 inches.
• 5cm, 10mm: Sets width to 5 centimeters and height to 10 millimeters.
• 50%, 75%: Sets width to 50% and height to 75% of the reference dimension.

When configuring a Unit Size, ensure that the units are appropriate for the context in which the size will be used.

Properties

Name	Type		Description
Width	String	►	The width of the rectangle, specified as a unit-aware string. ConverterUnit Value Converter Sets the width of the rectangle. Enter a value with a supported unit (such as 1in, 8px, 5pt, 10mm, or 50%). If both width and height are set to the same value, you may enter a single value for both. Supported units:px, in, pt, cm, mm, %
Height	String	►	The height of the rectangle, specified as a unit-aware string. ConverterUnit Value Converter Sets the height of the rectangle. Enter a value with a supported unit (such as 2in, 8px, 5pt, 10mm, or 75%). If both width and height are set to the same value, you may enter a single value for both. Supported units:px, in, pt, cm, mm, %

Used By

Region DetectorSticky Note DetectionResize