XpsSerializationManager.SetFontSubsettingPolicy Method

Definition

Sets the granularity at which font-subsetting is performed.

public:
 void SetFontSubsettingPolicy(System::Windows::Xps::Serialization::FontSubsetterCommitPolicies policy);
public void SetFontSubsettingPolicy (System.Windows.Xps.Serialization.FontSubsetterCommitPolicies policy);
member this.SetFontSubsettingPolicy : System.Windows.Xps.Serialization.FontSubsetterCommitPolicies -> unit
Public Sub SetFontSubsettingPolicy (policy As FontSubsetterCommitPolicies)

Parameters

policy
FontSubsetterCommitPolicies

One of the enumeration values that specifies the font-subsetting policy.

Remarks

The default font-subsetting policy is CommitEntireSequence.

When font glyphs for text in an XPS document are saved in the document package, the document text displays identically on any computer or printer. If glyphs are not saved in document and the required font is not installed on the local computer or printer, the rendering device must substitute glyphs from another font. Substituting glyphs can change the appearance of the text when a different font is used.

SetFontSubsettingPolicy determines the granularity of font-subsetting.

CommitEntireSequence (default) is the most efficient and enables the pages of all documents in a document sequence to share one font-subset that contains only the glyphs that are actually used.

When creating interleaved documents, font-subsetting across a document sequence can require a large amount of memory to hold the complete document until the final font-subset can be determined. CommitPerPage or CommitPerDocument can be specified to reduce application memory requirements when you create interleaved documents.

When policy is None, all the glyphs for all fonts that are used in the XPS document are saved, even glyphs for characters that not actually used in the text.

Applies to

See also