IXpsFixedPageWriter.AddFont Method (Boolean, Boolean)

 

Adds a new obfuscated or restricted XpsFont to the current page.

Namespace:   System.Windows.Xps.Packaging
Assembly:  ReachFramework (in ReachFramework.dll)

XpsFont AddFont(
	bool obfuscate,
	bool addRestrictedRelationship
)

Parameters

obfuscate
Type: System.Boolean

true to obfuscate the font; otherwise, false.

addRestrictedRelationship
Type: System.Boolean

true to prevent modification of any text that uses the font; otherwise, false.

Return Value

Type: System.Windows.Xps.Packaging.XpsFont

The new font resource that was added.

Exception Condition
ObjectDisposedException

Dispose has been called.

AddFont adds a new XpsFont with optional obfuscation or restrictions to the document package, and associates it with the current FixedPage.

Set the obfuscate parameter to true when you are legally obligated to obfuscate a licensed proprietary font. While obfuscation does not encrypt the font, it inhibits unzipping proprietary fonts and installing them separately for other uses.

For more information about font obfuscation and the use of restricted fonts see the XML Paper Specification (XPS) available for download at http://go.microsoft.com/fwlink/?LinkID=65761.

The following example shows how to use the AddFont method to add a font resource to a page.

// -------------------------- AddPageResources ----------------------------
private Dictionary<string, List<XpsResource>>
        AddPageResources(IXpsFixedPageWriter fixedPageWriter)
{
    // Collection of all resources for this page.
    //   Key: "XpsImage", "XpsFont"
    //   Value: List of XpsImage or XpsFont
    Dictionary<string, List<XpsResource>> resources =
        new Dictionary<string, List<XpsResource>>();

    // Collections of images and fonts used in the current page.
    List<XpsResource> xpsImages = new List<XpsResource>();
    List<XpsResource> xpsFonts  = new List<XpsResource>();

    try
    {
        XpsImage xpsImage;
        XpsFont  xpsFont;

        // Add, Write, and Commit image1 to the current page.
        xpsImage = fixedPageWriter.AddImage(XpsImageType.JpegImageType);
        WriteToStream(xpsImage.GetStream(), image1);
        xpsImage.Commit();
        xpsImages.Add(xpsImage);    // Add image1 as a required resource.

        // Add, Write, and Commit font 1 to the current page.
        xpsFont = fixedPageWriter.AddFont();
        WriteObfuscatedStream(
            xpsFont.Uri.ToString(), xpsFont.GetStream(), font1);
        xpsFont.Commit();
        xpsFonts.Add(xpsFont);      // Add font1 as a required resource.

        // Add, Write, and Commit image2 to the current page.
        xpsImage = fixedPageWriter.AddImage(XpsImageType.TiffImageType);
        WriteToStream(xpsImage.GetStream(), image2);
        xpsImage.Commit();
        xpsImages.Add(xpsImage);    // Add image2 as a required resource.

        // Add, Write, and Commit font2 to the current page.
        xpsFont = fixedPageWriter.AddFont(false);
        WriteToStream(xpsFont.GetStream(), font2);
        xpsFont.Commit();
        xpsFonts.Add(xpsFont);      // Add font2 as a required resource.

        // Return the image and font resources in a combined collection.
        resources.Add("XpsImage", xpsImages);
        resources.Add("XpsFont", xpsFonts);
        return resources;
    }
    catch (XpsPackagingException xpsException)
    {
        throw xpsException;
    }
}// end:AddPageResources()

.NET Framework
Available since 3.0
Return to top
Show: