Class Artifact

Artifact class

Class represents PDF Artifact object.

public class Artifact : IDisposable

Constructors

NameDescription
Artifact(ArtifactType, ArtifactSubtype)Constructor of artifact with specified type and subtype
Artifact(string, string)Constructor of artifact with specified type and subtype

Properties

NameDescription
ArtifactHorizontalAlignment { get; set; }Horizontal alignment of artifact. If position is specified explicitly (in Position property) this value is ignored.
ArtifactVerticalAlignment { get; set; }Vertical alignment of artifact. If position is specified explicitly (in Position property) this value is ignored.
BottomMargin { get; set; }Bottom margin of artifact. If position is specified explicitly (in Position property) this value is ignored.
Contents { get; }Gets collection of artifact internal operators.
CustomSubtype { get; set; }Gets name of artifact subtype. May be used if artifact subtype is not standard subtype.
CustomType { get; set; }Gets name of artifact type. May be used if artifact type is non standard.
Form { get; }Gets XForm of the artifact (if XForm is used).
Image { get; }Gets image of the artifact (if presents).
IsBackground { get; set; }If true Artifact is placed behind page contents.
LeftMargin { get; set; }Left margin of artifact. If position is specified explicitly (in Position property) this value is ignored.
Lines { get; }Lines of multiline text artifact.
Opacity { get; set; }Gets or sets opacity of the artifact. Possible values are in range 0..1.
Position { get; set; }Gets or sets artifact position. If this property is specified, then margins and alignments are ignored.
Rectangle { get; }Gets rectangle of the artifact.
RightMargin { get; set; }Right margin of artifact. If position is specified explicitly (in Position property) this value is ignored.
Rotation { get; set; }Gets or sets artifact rotation angle.
Subtype { get; set; }Gets artifact subtype. If artifact has non-standard subtype, name of the subtype may be read via CustomSubtype.
Text { get; set; }Gets text of the artifact.
TextState { get; set; }Text state for artifact text.
TopMargin { get; set; }Top margin of artifact. If position is specified explicitly (in Position property) this value is ignored.
Type { get; set; }Gets artifact type.

Methods

NameDescription
BeginUpdates()Start delated updates. Use this feature if you need make several changes to the same artifact to improve performance. Usually artifact operators are changed anytime when artifact property was changed. This causes changing of page contents everytime when artifact was changed. To avoid this effect put all artifact updates between StartUpdates/SaveUpdates calls. This allows to change page contents only once.
Dispose()Dispose the artifact.
GetValue(string)Gets custom value of artifact.
RemoveValue(string)Remove custom value from the artifact.
SaveUpdates()Saves all updates in artifact which were made after BeginUpdates() call.
SetImage(Stream)Sets image of the artifact.
SetImage(string)Sets image of the artifact.
SetLinesAndState(string[], TextState)Set text and text properties of the artifact. Allows to specify multiple lines.
SetPageNumberReplacementString(string)Sets what string will be replaced with the page number. The default value is #.
SetPdfPage(Page)Sets PDF page which is placed on the document page as artifact.
SetText(FormattedText)Sets text of the artifact.
SetTextAndState(string, TextState)Set text and text properties of the artifact.
SetValue(string, string)Sets custom value of artifact.

Other Members

NameDescription
enum ArtifactSubtypeEnumeration of possible artifacts subtype.
enum ArtifactTypeEnumeration of possuble artifact types.

See Also