Name | Description | |
---|---|---|
![]() | GcPdfDocument Constructor | Creates a new instance of the GcPdfDocument class, optionally specifying a license key. |
The following tables list the members exposed by GcPdfDocument.
Name | Description | |
---|---|---|
![]() | GcPdfDocument Constructor | Creates a new instance of the GcPdfDocument class, optionally specifying a license key. |
Name | Description | |
---|---|---|
![]() | AcroForm | Gets the GrapeCity.Documents.Pdf.AcroForms.AcroForm object defining common properties of the AcroForms in this document. |
![]() | ArticleThreads | Gets the list of GrapeCity.Documents.Pdf.Articles.ArticleThread objects. |
![]() | AssociatedFiles | Gets 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. |
![]() ![]() | BuildRichTextAppearanceStreams | 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. |
![]() ![]() | CMapProvider | 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). |
![]() | CompressionLevel | Gets or sets the compression level. Default value is System.IO.Compression.CompressionLevel.Fastest. |
![]() | ConformanceLevel | Gets or sets the PDF/A conformance level.
The default is none (the document does not conform to PDF/A). |
![]() | DestinationsDests | Gets the dictionary of named destinations defined in the Dests entry of the document catalog. |
![]() | DestinationsNamesDests | Gets the dictionary of named destinations defined in the Dests entry of the Name Dictionary. |
![]() | DocumentInfo | Gets 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. |
![]() | EmbeddedFiles | Gets the dictionary of document level file attachments. |
![]() | FileID | Gets or sets the FileID object defining ID of this PDF document. Note that this ID is automatically updated if the Clear method is called. |
![]() | FontCollection | Gets 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. |
![]() | FontEmbedMode | Gets 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. |
![]() | FontHandlers | Gets the collection of font handlers associated with the current document. |
![]() | FormEmbedUtf32CodeSet | Gets 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. |
![]() | ImageHandlers | Gets the collection of GrapeCity.Documents.Pdf.Graphics.Images.PdfImageHandler objects associated with the current document. |
![]() | ImageOptions | Gets the ImageOptions object that contains options controlling how images are processed in the current document. |
![]() | IsCompressed | Gets a value indicating whether compression is used when saving the document. |
![]() | Landscape | Gets or sets a value indicating whether newly added pages have landscape orientation. |
![]() | Lang | Gets 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. |
![]() | Linearized | Gets 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: |
![]() | LoadStream | Gets 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. |
![]() | MarkInfo | Gets a GrapeCity.Documents.Pdf.Structure.MarkInfo object that provides additional information relevant to specialized uses of structured PDF documents. |
![]() | Metadata | Gets or sets the metadata associated with this document. |
![]() | NamedDestinations | Gets the dictionary of named destinations defined in the current document. |
![]() | OpenAction | Gets or sets a DestinationBase to be displayed or an GrapeCity.Documents.Pdf.Actions.ActionBase to be performed when the document is opened. |
![]() | OptionalContent | Gets the GrapeCity.Documents.Pdf.Layers.OptionalContentProperties object that contains information about optional PDF content (layers) in this document. |
![]() | Outlines | Gets the collection of the current document outlines. |
![]() | OutputIntents | Gets 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. |
![]() | PageLabelingRanges | Gets the dictionary of PageLabelingRange objects. Each key in this dictionary is the index of the first page in a labeling range. |
![]() | PageLayout | Gets or sets the page layout to be used when the document is opened. |
![]() | PageMode | Gets or sets how the document should be displayed when opened. |
![]() | PageRectangle | Gets a rectangle that represents the surface of the current page (in points). |
![]() | Pages | Gets the collection of Page objects that make up the document. |
![]() | PageSize | Gets or sets the default page size for the document (in points). |
![]() | PaperKind | Gets or sets the page size for the document. |
![]() | PdfACompliant | Gets or sets a value indicating whether the document is PDF/A compliant. |
![]() | PdfVersion | Gets 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. |
![]() | RecognitionAlgorithm | Gets 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. |
![]() | Security | Gets the GrapeCity.Documents.Pdf.Security object that manages security for the current document (passwords, etc). |
![]() | SecurityStore | Gets the GrapeCity.Documents.Pdf.Security.DocumentSecurityStore object associated with this document. |
![]() | StandardFontEmbedMode | Gets 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. |
![]() | StructTreeRoot | Gets a GrapeCity.Documents.Pdf.Structure.StructTreeRoot object that represents the current document's structure tree as defined by PDF structure tags. |
![]() | ViewerPreferences | Gets the ViewerPreferences object that contains information specifying how the current document should be displayed. |
![]() | WriteComments | Gets or sets a value indicating whether comments and some optional line breaks will be added to the generated PDF file. Primarily useful for debugging. |
Name | Description | |
---|---|---|
![]() | Clear | Clears the document, removing all content and resetting all properties and settings to their initial default values. |
![]() | DeleteText | Deletes 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. |
![]() | EndDoc | Ends document generation in sequential mode. This call must be preceded by a call to StartDoc. |
![]() | ExportFormDataToFDF | Overloaded. Exports the document's form data to a stream in FDF format. |
![]() | ExportFormDataToXFDF | Overloaded. Exports the document's form data to a stream in XFDF format. |
![]() | ExportFormDataToXML | Overloaded. Exports the document's form data to a stream in XML format. |
![]() | FindText | Searches 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. |
![]() | GetFonts | Gets the list of fonts in this GcPdfDocument. |
![]() | GetImages | Overloaded. 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. |
![]() | GetLogicalStructure | Overloaded. 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. |
![]() | GetText | Overloaded. Extracts and returns all text from the current document. |
![]() | ImportFormDataFromCollection | Overloaded. 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. |
![]() | ImportFormDataFromFDF | Overloaded. Imports the document's form data from a stream in FDF format. |
![]() | ImportFormDataFromXFDF | Overloaded. Imports the document's form data from a stream in XFDF format. |
![]() | ImportFormDataFromXML | Overloaded. Imports the document's form data from a stream in XML format. |
![]() | Load | Overloaded. 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. |
![]() | MergeWithDocument | Merges all or some pages from a specified GcPdfDocument into the current document. |
![]() | NewPage | Adds 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. |
![]() | OptimizeFonts | Overloaded. Optimizes font usage by merging subsets of same fonts and by removing duplicate and unused fonts.
This method uses the default values from OptimizeFontsOptions. |
![]() | Redact | Overloaded. Applies all GrapeCity.Documents.Pdf.Annotations.RedactAnnotations to the current document. |
![]() | RegisterPdfObject | Registers an indirect PDF object with the current document and returns the ID of the object as a GrapeCity.Documents.Pdf.Spec.PdfObjID. |
![]() | RemoveDuplicateImages | Removes images with identical content from the current document. |
![]() | RemoveEmbeddedFonts | Removes embedded fonts from the current document.
Please note that a PDF may display incorrectly after removing embedded fonts. Use with caution. |
![]() | ReplaceText | Replaces 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. |
![]() | Save | Overloaded. Saves the current PDF document to a file using the default mode (no incremental update, not linearized). |
![]() | SaveAsBmp | Overloaded. 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. |
![]() | SaveAsGif | Overloaded. 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. |
![]() | SaveAsImage | Overloaded. Iterates over the document pages and generates a GrapeCity.Documents.Imaging.GcBitmap for each page in the pageRange. |
![]() | SaveAsJpeg | Overloaded. 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. |
![]() | SaveAsPng | Overloaded. 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. |
![]() | SaveAsSvg | Overloaded. 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. |
![]() | SaveAsTiff | Overloaded. Saves the document pages as images to a stream in TIFF format, one page per frame. |
![]() ![]() | SetLicenseKey | Sets the license key. |
![]() | Sign | Overloaded. Signs and saves the current document to a stream. Note that stream must support read and seek operations. |
![]() | StartDoc | Starts 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. |
![]() | TimeStamp | Overloaded. Adds a document time stamp and saves the current document to a stream. |
Name | Description | |
---|---|---|
![]() | SavingDocument | Occurs periodically when the document is being saved or exported. Can be used to implement a progress indicator. |