[]
        
(Showing Draft Content)

FileSpecification

Class: FileSpecification

Represents a PDF File Specification.

The complex architecture of this class is based on the PDF Specification, for full details please consult that spec.

See

FileSpecificationProperties

Extends

Constructors

Constructor

new FileSpecification(om, properties): FileSpecification;

Creates a FileSpecification object on the base of properties specified by the FileSpecificationProperties.

Parameters

om

ObjectManager

ObjectManager that controls the lifetime of the FileSpecification.

properties

FileSpecificationProperties

The properties of created object.

Returns

FileSpecification

Overrides

ObjectBase.constructor

Constructor

new FileSpecification(properties): FileSpecification;

Creates a FileSpecification object on the base of properties specified by the FileSpecificationProperties.

Parameters

properties

FileSpecificationProperties

The properties of created object.

Returns

FileSpecification

Overrides

ObjectBase.constructor

Constructor

new FileSpecification(
   om, 
   fileName, 
   stream, 
   desc?): FileSpecification;

Creates a FileSpecification associated with the specified EmbeddedFileStream object.

Parameters

om

ObjectManager

ObjectManager that controls the lifetime of the FileSpecification.

fileName

string

The file name used as a name for embedded file.

stream

EmbeddedFileStream

The EmbeddedFileStream associated with created file specification.

desc?

string

The optional description.

Returns

FileSpecification

Overrides

ObjectBase.constructor

Constructor

new FileSpecification(
   fileName, 
   stream, 
   desc?): FileSpecification;

Creates a FileSpecification associated with the specified EmbeddedFileStream object.

Parameters

fileName

string

The file name used as a name for embedded file.

stream

EmbeddedFileStream

The EmbeddedFileStream associated with created file specification.

desc?

string

The optional description.

Returns

FileSpecification

Overrides

ObjectBase.constructor

Accessors

desc

Get Signature

get desc(): string;

Gets or sets the description of this File Specification.

Returns

string

Set Signature

set desc(value): void;

Gets or sets the description of this File Specification.

Parameters
value

string

Returns

void


dosFile

Get Signature

get dosFile(): FileInfo;

Gets the FileInfo object defining information about the referenced file for the DOS platform. NOTE: Using this property is not recommended beginning with PDF 1.7.

Returns

FileInfo


file

Get Signature

get file(): FileInfo;

Gets the FileInfo object that specifies information about a referenced file. Note that this property should be used for files with names containing ASCII characters only, and is provided for backwards compatibility. For file names that contain non-ASCII characters, unicodeFile should be used instead.

See

unicodeFile

Returns

FileInfo


fileSystem

Get Signature

get fileSystem(): string;

Gets or sets the file system to be used to interpret this file specification.

If this property is present, all other properties are interpreted by the designated file system. PDF defines only one standard file system name, URL; an application or plug-in extension can register other names.

Returns

string

Set Signature

set fileSystem(value): void;

Gets or sets the file system to be used to interpret this file specification.

If this property is present, all other properties are interpreted by the designated file system. PDF defines only one standard file system name, URL; an application or plug-in extension can register other names.

Parameters
value

string

Returns

void


hasEmbeddedFileStream

Get Signature

get hasEmbeddedFileStream(): boolean;

Gets a value indicating that this file specification has at least one EmbeddedFileStream associated with it.

Returns

boolean


id

Get Signature

get id(): number;

Gets the reference to the object.

Returns

number

Inherited from

ObjectBase.id


ID

Get Signature

get ID(): FileID;

Gets or sets the FileID object specifying the ID of the referenced file.

This property improves an application's chances of finding the intended file and allows it to warn the user if the file has changed since the link was made.

Returns

FileID

Set Signature

set ID(value): void;

Gets or sets the FileID object specifying the ID of the referenced file.

This property improves an application's chances of finding the intended file and allows it to warn the user if the file has changed since the link was made.

Parameters
value

FileID

Returns

void


macFile

Get Signature

get macFile(): FileInfo;

Gets the FileInfo object defining information about the referenced file for the Mac OS platform. NOTE: Using this property is not recommended beginning with PDF 1.7.

Returns

FileInfo


om

Get Signature

get om(): ObjectManager;

Gets the owner ObjectManager instance.

Returns

ObjectManager

Inherited from

ObjectBase.om


relationship

Get Signature

get relationship(): string;

Gets or sets a value that represents the relationship of this object to the source that points to it. The FileSpecificationRelationshipType defines values from PDF specification.

Returns

string

Set Signature

set relationship(value): void;

Gets or sets a value that represents the relationship of this object to the source that points to it. The FileSpecificationRelationshipType defines values from PDF specification.

Parameters
value

string

Returns

void


unicodeFile

Get Signature

get unicodeFile(): FileInfo;

Gets the FileInfo object that specifies information about a referenced file.

See

file

Returns

FileInfo


unixFile

Get Signature

get unixFile(): FileInfo;

Gets the FileInfo object defining information about the referenced file for the Unix platform. NOTE: Using this property is not recommended beginning with PDF 1.7.

Returns

FileInfo


volatile

Get Signature

get volatile(): boolean;

Gets or sets a value indicating whether the file referenced by the file specification is volatile (changes frequently with time). If the value is true, applications should never cache a copy of the file.

Returns

boolean

Set Signature

set volatile(value): void;

Gets or sets a value indicating whether the file referenced by the file specification is volatile (changes frequently with time). If the value is true, applications should never cache a copy of the file.

Parameters
value

boolean

Returns

void

Methods

free()

free(): void;

Detaches the object from the ObjectManager and deallocates its memory, if possible.

Returns

void

Inherited from

ObjectBase.free


getStream()

getStream(): Uint8Array<ArrayBufferLike>;

Gets a value indicating that this file specification has at least one EmbeddedFileStream associated with it.

Returns

Uint8Array<ArrayBufferLike>


rebind()

rebind(omTo): void;

Rebinds the object from the current ObjectManager to the specified one.

Parameters

omTo

ObjectManager

The new ObjectManager for the object.

Returns

void

Inherited from

ObjectBase.rebind