PDFFlowImageContent¶

Namespace: O2S.Components.PDF4NET.FlowDocument

Defines an image content that can be added to a flow document.

public class PDFFlowImageContent : PDFFlowContent

Inheritance Object → PDFFlowContent → PDFFlowImageContent

Constructors¶

PDFFlowImageContent(PDFImage)¶

Initializes a new PDFFlowImageContent object.

public PDFFlowImageContent(PDFImage image)

Parameters

image PDFImage
Image to draw in the document.

PDFFlowImageContent(PDFImage, Double, Double)¶

Initializes a new PDFFlowImageContent object.

public PDFFlowImageContent(PDFImage image, double imageWidth, double imageHeight)

Parameters

image PDFImage
Image to draw in the document.

imageWidth Double
Width of displayed image.

imageHeight Double
Height of displayed image.

Properties¶

Background¶

Gets or sets the content background.

public PDFBrush Background { get; set; }

Property Value

PDFBrush
The background of the flow content.

Remarks

The background that fills the flow content bounding rectangle.

DestinationName¶

Gets or sets the destination name.

public string DestinationName { get; set; }

Property Value

String
The name of the destination created at the location of the flow content.

Remarks

A named destination is created at the top of flow content when this property is not null or an empty string.

HorizontalAlign¶

Gets or sets the horizontal align.

public PDFGraphicAlign HorizontalAlign { get; set; }

Property Value

PDFGraphicAlign
The image alignment on horizontal relative to available space.

ImageHeight¶

Gets or sets the image height.

public double ImageHeight { get; set; }

Property Value

Double
The height of the image drawn on the page.

Exceptions

ArgumentOutOfRangeException
Thrown when Height is set to a value less than 0.

Remarks

The value of this property represents either a percentage (0 to 100) or an absolute value based on the value of PDFFlowImageContent.SizeIsRelativeToAvailableSpace property.

ImageWidth¶

Gets or sets the image width.

public double ImageWidth { get; set; }

Property Value

Double
The width of the image drawn on the page.

Exceptions

ArgumentOutOfRangeException
Thrown when Width is set to a value less than 0.

Remarks

The value of this property represents either a percentage (0 to 100) or an absolute value based on the value of PDFFlowImageContent.SizeIsRelativeToAvailableSpace property.

InnerMargins¶

Gets or sets the content inner margins.

public PDFFlowContentMargins InnerMargins { get; set; }

Property Value

PDFFlowContentMargins
A PDFFlowContentMargins object specifying the content inner margins.

Remarks

The inner margins are located inside the content's bounding rectangle. The margins are applied to content as a whole and not to parts of content when content is split across pages.

OuterMargins¶

Gets or sets the content outer margins.

public PDFFlowContentMargins OuterMargins { get; set; }

Property Value

PDFFlowContentMargins
A PDFFlowContentMargins object specifying the content outer margins.

Remarks

The outer margins are located outside the content's bounding rectangle. The margins are applied to content as a whole and not to parts of content when content is split across pages.

SizeIsRelativeToAvailableSpace¶

Gets or sets a value indicating how the image size is interpreted.

public bool SizeIsRelativeToAvailableSpace { get; set; }

Property Value

Boolean
True if the image size (PDFFlowImageContent.ImageWidth, PDFFlowImageContent.ImageHeight properties) is a percentage of the available space, false is the image size is given in absolute values.

StructureElement¶

Gets or sets the structure element.

public PDFStructureElement StructureElement { get; set; }

Property Value

PDFStructureElement
The PDFStructureElement object associated with this flow content object.

Tag¶

Gets or sets an arbitrary object value that can be used to store custom information about this element.

public object Tag { get; set; }

Property Value

Object
The intended value.

Remarks

This property is analogous to Tag properties in other Microsoft programming models. Tag is intended to provide a pre-existing property location where you can store some basic custom information about any PDFFlowContent without requiring you to subclass a content object.

VerticalAlign¶

Gets or sets the vertical align.

public PDFGraphicAlign VerticalAlign { get; set; }

Property Value

PDFGraphicAlign
The image alignment on vertical relative to available space.

Methods¶

GetContentHeight(Double)¶

Gets the content height.

public double GetContentHeight(double width)

Parameters

width Double
The width for which the content height is computed.

Returns

Double
The height of the content for the specified width.

Events¶

AfterContentDraw¶

Gets or sets the event that is fired after the flow content object is drawn on the page.

public event EventHandler<PDFFlowContentDrawEventArgs> AfterContentDraw;

BeforeContentDraw¶

Gets or sets the event that is fired before the flow content object is drawn on the page.

public event EventHandler<PDFFlowContentDrawEventArgs> BeforeContentDraw;