PDFEmbeddedFile Class

Summary

Properties of an embedded file (attachment) in this document.

Syntax

Java

[SerializableAttribute()] 
public class PDFEmbeddedFile

public class PDFEmbeddedFile

Remarks

PDF documents support embedded files of any type. The file can be another PDF, a TIF file, a JPEG image, or any other binary or textual data.

The embedded files (attachments) of a PDF document can be read using the following:

Create a new PDFDocument object for the PDF file.
Call PDFDocument.ParseDocumentStructure with the PDFParseDocumentStructureOptions.EmbeddedFiles flag.
If the PDF file contains any embedded files then they will be read and set in the PDFDocument.EmbeddedFiles collection.
If the PDF file has any embedded file schemas (for PDF portfolios), then they will be read and set in the PDFDocument.EmbeddedFilesSchemas collection.

The binary data of an embedded file can be extracted and saved to an output file or stream using PDFFile.ExtractEmbeddedFile.

PDFEmbeddedFile contains the following members:

Member	Description
FileNumber	1-based file number of this embedded file. This is a unique value
FileName	Embedded file name
ObjectNumber	PDF object number of this embedded file. This is a unique value
Description	Description of this embedded file. This is optional
FileSize	Size of the file in bytes
Created	Date this file was created
Modified	Date this file was last modified
SchemaValues	Values for the PDF schema if this PDF is a portfolio. This is optional

Note that the FileName may not be unique in the collection of embedded files found in a PDF document. Instead, use the FileNumber or ObjectNumber property to get a unique identifier for the embedded file.

FileNumber is used as the parameter to identify the embedded file to extract using PDFFile.ExtractEmbeddedFile.

Refer to PDFDocument.EmbeddedFiles for more information on using a PDFSchema with PDF portfolio and embedded files.

Example

For an example, refer to EmbeddedFiles.

Requirements

Target Platforms