Enum ReportImageSizing

Namespace

DocWright.Reporting.Pagination

Assembly

DocWright.Reporting.dll

How an image is fitted into the box the report item gives it.

public enum ReportImageSizing

Fields

AutoSize = 0

The item is resized to the image's natural size, and the items below and to the right of it move by the difference. The default.

This is the only mode that changes the item's own box, and so the only one that moves anything else on the page. The movement follows the same rule in both axes as a grown textbox's does vertically.

Fit = 1

The image is stretched to the box exactly, giving up its aspect ratio.

FitProportional = 2

The image is scaled uniformly to the largest size that fits inside the box, and placed at the box's top-left corner.

Clip = 3

The image is drawn at its natural size from the box's top-left corner, and whatever falls outside the box is clipped away.

Remarks

The four modes are RDL's, and each was measured against Microsoft's report engine (Phase 54e, image-sizing-*). An image's natural size throughout is its pixel size at 96 dpi (AssumedPixelsPerInch); a resolution the file declares is ignored.

Every mode anchors the image at the box's top-left. None of them centres it, which is worth stating because most layout systems centre the leftover space in the modes that have any.