Document Solutions for PDF
GrapeCity.Documents.Pdf Assembly / GrapeCity.Documents.Pdf Namespace / GcPdfDocument Class
Properties Methods Events

In This Topic
    GcPdfDocument Class Members
    In This Topic

    The following tables list the members exposed by GcPdfDocument.

    Public Constructors
     NameDescription
    Public ConstructorCreates a new instance of the GcPdfDocument class, optionally specifying a license key.  
    Top
    Public Properties
     NameDescription
    Public PropertyGets the GrapeCity.Documents.Pdf.AcroForms.AcroForm object defining common properties of the AcroForms in this document.  
    Public PropertyGets the list of GrapeCity.Documents.Pdf.Articles.ArticleThread objects.  
    Public PropertyGets the collection of embedded files associated with whole document. Typically it is used to identify which embedded file was the source of the PDF document.  
    Public Propertystatic (Shared in Visual Basic)Gets or sets a value indicating whether to generate appearance streams for annotations that have rich text content (GrapeCity.Documents.Pdf.Annotations.FreeTextAnnotation, GrapeCity.Documents.Pdf.Annotations.LineAnnotation). The default value for this property is false.

    Note that currently there is a limitation: if this property is set to true so that appearance streams for rich text are generated, all rich text formatting is ignored.

     
    Public Propertystatic (Shared in Visual Basic)Gets or sets an object that implements the ICMapProvider interface. GcPdfDocument uses that interface to obtain an GrapeCity.Documents.Pdf.Text.CMap.CMap if it specified by name in the PDF file.

    By default GcPdf tries to initialize this property automatically in the GcPdfDocument's constructor with the CMapProvider.Instance defined in the optional GrapeCity.Documents.Pdf.Resources package (which in this case needs to be explicitly referenced by the application).

     
    Public PropertyGets or sets the compression level. Default value is System.IO.Compression.CompressionLevel.Fastest.  
    Public PropertyGets or sets the PDF/A conformance level.

    The default is none (the document does not conform to PDF/A).

     
    Public PropertyGets the dictionary of named destinations defined in the Dests entry of the document catalog.  
    Public PropertyGets the dictionary of named destinations defined in the Dests entry of the Name Dictionary.  
    Public PropertyGets or sets a DocumentInfo object that contains information about this document (author, title, etc).

    Note: this property is not null by default (when a GcPdfDocument is created) but it can become null after a call to Load(Stream,String) if the loaded document does not have a document info object.

     
    Public PropertyGets the dictionary of document level file attachments.  
    Public PropertyGets or sets the FileID object defining ID of this PDF document. Note that this ID is automatically updated if the Clear method is called.  
    Public PropertyGets or sets the GrapeCity.Documents.Text.IFontCollection object used when the GcPdfDocument needs to find a GrapeCity.Documents.Text.Font (e.g. if it is not embedded in the PDF). If this property is null (the default), then the GrapeCity.Documents.Text.FontCollection.SystemFonts will be used.  
    Public PropertyGets or sets the font embedding mode.

    The default is FontEmbedMode.EmbedSubset.

    Note that this property does not affect the 14 standard PDF fonts, their embedding is determined by the StandardFontEmbedMode property.

    Also note that if the GcPdfDocument is saved as PDF/A, and the value of this property is FontEmbedMode.NotEmbed, the fonts are embedded anyway using the FontEmbedMode.EmbedSubset mode.

     
    Public PropertyGets the collection of font handlers associated with the current document.  
    Public PropertyGets or sets a GrapeCity.Documents.Text.Utf32CodeSet object that specifies which Unicode characters to include in embedded font subsets for fonts that are used in AcroForms.

    This value will be used for a font if that font handler's FontHandler.Utf32CodeSet is null.

    Note that if for a font, its FontHandler.Utf32CodeSet is null, and FormEmbedUtf32CodeSet is null, and the font is used in the AcroForm, then this whole font will be embedded even if partial embedding is specified by FontHandler.EmbedMode or FontEmbedMode.

     
    Public PropertyGets the collection of GrapeCity.Documents.Pdf.Graphics.Images.PdfImageHandler objects associated with the current document.  
    Public PropertyGets the ImageOptions object that contains options controlling how images are processed in the current document.  
    Public PropertyGets a value indicating whether compression is used when saving the document.  
    Public PropertyGets or sets a value indicating whether newly added pages have landscape orientation.  
    Public PropertyGets or sets a language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.  
    Public PropertyGets a value indicating whether the PDF that was loaded into this GcPdfDocument was linearized ("fast web view").

    Note that this value only indicates the linearization of the original PDF that was loaded, if the current document is saved its linearization is not affected by this property. To save the current document as linearized, pass SaveMode.Linearized when saving the PDF using one of the save methods:

     
    Public PropertyGets the System.IO.Stream object that was passed to the Load() method that was used to load this document, or null if Load() was not called.  
    Public PropertyGets a GrapeCity.Documents.Pdf.Structure.MarkInfo object that provides additional information relevant to specialized uses of structured PDF documents.  
    Public PropertyGets or sets the metadata associated with this document.  
    Public PropertyGets the dictionary of named destinations defined in the current document.  
    Public PropertyGets or sets a DestinationBase to be displayed or an GrapeCity.Documents.Pdf.Actions.ActionBase to be performed when the document is opened.  
    Public PropertyGets the GrapeCity.Documents.Pdf.Layers.OptionalContentProperties object that contains information about optional PDF content (layers) in this document.  
    Public PropertyGets the collection of the current document outlines.  
    Public PropertyGets the list of OutputIntent objects associated with the current document.

    Note that if the document is saved as PDF/A (see PdfAConformanceLevel) and this collection is empty, a default output intent will be automatically added to it.

     
    Public PropertyGets the dictionary of PageLabelingRange objects. Each key in this dictionary is the index of the first page in a labeling range.  
    Public PropertyGets or sets the page layout to be used when the document is opened.  
    Public PropertyGets or sets how the document should be displayed when opened.  
    Public PropertyGets a rectangle that represents the surface of the current page (in points).  
    Public PropertyGets the collection of Page objects that make up the document.  
    Public PropertyGets or sets the default page size for the document (in points).  
    Public PropertyGets or sets the page size for the document.  
    Public PropertyGets or sets a value indicating whether the document is PDF/A compliant.  
    Public PropertyGets or sets the PDF Version of the generated document.

    By default the version is determined automatically based on which features are used in this document. Setting this property to a non-null string in the format "1.X" (where X is a digit from 0 to 9) overrides the automatic value with the specified one.

    Setting this property to null or an empty string reverts to the default behavior.

     
    Public PropertyGets or sets the type of algorithm that is used for PDF content recognition when building page text maps (see Page.GetTextMap).

    This property affects the behavior of methods such as GetText(Boolean), FindText, GrapeCity.Documents.Pdf.TextMap.ITextMap.FindText and other APIs that rely on text maps.

     
    Public PropertyGets the GrapeCity.Documents.Pdf.Security object that manages security for the current document (passwords, etc).  
    Public PropertyGets the GrapeCity.Documents.Pdf.Security.DocumentSecurityStore object associated with this document.  
    Public PropertyGets or sets the font embedding mode for the 14 standard PDF fonts.

    The default is FontEmbedMode.NotEmbed.

    Note that if the GcPdfDocument is saved as PDF/A, and the value of this property is FontEmbedMode.NotEmbed, the standard fonts are embedded anyway using the FontEmbedMode.EmbedSubset mode.

     
    Public PropertyGets a GrapeCity.Documents.Pdf.Structure.StructTreeRoot object that represents the current document's structure tree as defined by PDF structure tags.  
    Public PropertyGets the ViewerPreferences object that contains information specifying how the current document should be displayed.  
    Public PropertyGets or sets a value indicating whether comments and some optional line breaks will be added to the generated PDF file. Primarily useful for debugging.  
    Top
    Public Methods
     NameDescription
    Public MethodClears the document, removing all content and resetting all properties and settings to their initial default values.  
    Public MethodDeletes a specified text from all pages of the current document.

    Note that the results may be affected by the current value of the RecognitionAlgorithm property.

     
    Public MethodEnds document generation in sequential mode. This call must be preceded by a call to StartDoc.  
    Public MethodOverloaded. Exports the document's form data to a stream in FDF format.  
    Public MethodOverloaded. Exports the document's form data to a stream in XFDF format.  
    Public MethodOverloaded. Exports the document's form data to a stream in XML format.  
    Public MethodSearches for all occurrences of a text in a range of the document's pages.

    Note that the results are affected by the value of RecognitionAlgorithm property.

     
    Public MethodGets the list of fonts in this GcPdfDocument.  
    Public MethodOverloaded. Gets the list of images in this GcPdfDocument.

    Note that for large documents this method can take a while to complete, as it enumerates the content streams of all pages in the document.

     
    Public MethodOverloaded. Parses the PDF's structure tree (as returned by the StructTreeRoot property) and creates a GrapeCity.Documents.Pdf.Recognition.Structure.LogicalStructure object that represents the logical structure of the document.

    Returns null if the current document does not have a structure tree.

     
    Public MethodOverloaded. Extracts and returns all text from the current document.  
    Public MethodOverloaded. Imports the document's form data from a key/value collection.

    The keys are field names, the values are collections of field values.

    For nested fields, the field's name should include all its parents' names delimited by dots, e.g. TopParent.Parent.MyField.

    This method may be especially useful when importing form data submitted by a web page.

     
    Public MethodOverloaded. Imports the document's form data from a stream in FDF format.  
    Public MethodOverloaded. Imports the document's form data from a stream in XFDF format.  
    Public MethodOverloaded. Imports the document's form data from a stream in XML format.  
    Public MethodOverloaded. Loads the document from a specified input stream, overwriting the current content of the document. The stream should contain valid PDF data and must be kept open while reading or modifying the document. If the document is modified, it can be saved using the Save(String,Boolean) or Save(Stream,Boolean) methods.  
    Public MethodMerges all or some pages from a specified GcPdfDocument into the current document.  
    Public MethodAdds a blank page to the document.

    The size of the new page is defined by the value of the PageSize property.

    If you want the new page to have a different size than the rest of the document, create the new page first, then set the Page.Size property.

     
    Public MethodOverloaded. Optimizes font usage by merging subsets of same fonts and by removing duplicate and unused fonts.

    This method uses the default values from OptimizeFontsOptions.

     
    Public MethodOverloaded. Applies all GrapeCity.Documents.Pdf.Annotations.RedactAnnotations to the current document.  
    Public MethodRegisters an indirect PDF object with the current document and returns the ID of the object as a GrapeCity.Documents.Pdf.Spec.PdfObjID.  
    Public MethodRemoves embedded fonts from the current document.

    Please note that a PDF may display incorrectly after removing embedded fonts. Use with caution.

     
    Public MethodReplaces a specified text on all pages of the current document.

    Note that the results may be affected by the current value of the RecognitionAlgorithm property.

     
    Public MethodOverloaded. Saves the current PDF document to a file using the default mode (no incremental update, not linearized).  
    Public MethodOverloaded. Saves the document pages as images in BMP format, one page per output file.

    The filePath parameter is used as a .NET format string, with current page number (1-based) passed to it as the value to be formatted. Note that if filePath does not contain a format item (such as "{0}"), all pages will be saved into the same file name, the last page overwriting everything else.

     
    Public MethodOverloaded. Saves the document pages as images in GIF format, one page per output file.

    The filePath parameter is used as a .NET format string, with current page number (1-based) passed to it as the value to be formatted. Note that if filePath does not contain a format item (such as "{0}"), all pages will be saved into the same file name, the last page overwriting everything else.

     
    Public MethodOverloaded. Iterates over the document pages and generates a GrapeCity.Documents.Imaging.GcBitmap for each page in the pageRange.  
    Public MethodOverloaded. Saves the document pages as images in JPEG format, one page per output file.

    The filePath parameter is used as a .NET format string, with current page number (1-based) passed to it as the value to be formatted. Note that if filePath does not contain a format item (such as "{0}"), all pages will be saved into the same file name, the last page overwriting everything else.

     
    Public MethodOverloaded. Saves the document pages as images in PNG format, one page per output file.

    The filePath parameter is used as a .NET format string, with current page number (1-based) passed to it as the value to be formatted. Note that if filePath does not contain a format item (such as "{0}"), all pages will be saved into the same file name, the last page overwriting everything else.

     
    Public MethodOverloaded. Saves the document pages as images in SVG format, one page per output file.

    The filePath parameter is used as a .NET format string, with current page number (1-based) passed to it as the value to be formatted. Note that if filePath does not contain a format item (such as "{0}"), all pages will be saved into the same file name, the last page overwriting everything else.

     
    Public MethodOverloaded. Saves the document pages as images to a stream in TIFF format, one page per frame.  
    Public Methodstatic (Shared in Visual Basic)Sets the license key.  
    Public MethodOverloaded. Signs and saves the current document to a stream. Note that stream must support read and seek operations.  
    Public MethodStarts document generation in sequential mode.

    In this mode, the content of the document is written directly into the underlying stream as soon as it is created, without the use of temporary files. When all content has been added, call EndDoc to finish creating the document.

     
    Public MethodOverloaded. Adds a document time stamp and saves the current document to a stream.  
    Top
    Public Events
     NameDescription
    Public EventOccurs periodically when the document is being saved or exported. Can be used to implement a progress indicator.  
    Top
    See Also