Share via

2.12.18 Image.Sizing

  • Article

The Image.Sizing element specifies the behavior of an Image instance if the actual image does not fit within the specified size of the image as denoted by Image.Height and Image.Width. This element is optional. If the Image.Sizing element is present, its value MUST be a String ([XMLSCHEMA2/2] section 3.2.1) that is one of the following:

AutoSize: Specifies that the border of the image instance will grow or shrink to accommodate the dimensions of the actual image.

Fit: Specifies that the actual image is resized to exactly match both the Image.Height and Image.Width dimensions.

FitProportional: Specifies that the actual image is resized to fit within the image instance dimensions, while preserving the aspect ratio.

Clip: Specifies that the actual image is clipped to fit the dimensions of the image instance.

If the Image.Sizing element is not present, its value is interpreted as "AutoSize".

Following is the parent element of the Image.Sizing element.

Parent elements

Image

The following is the XML Schema definition of the Image.Sizing element.

 <xsd:element name="Sizing" minOccurs="0">
   <xsd:simpleType>
     <xsd:restriction base="xsd:string">
       <xsd:enumeration value="AutoSize" />
       <xsd:enumeration value="Fit" />
       <xsd:enumeration value="FitProportional" />
       <xsd:enumeration value="Clip" />
     </xsd:restriction>
   </xsd:simpleType>
 </xsd:element>