Class LaunchAction in namespace setasign\SetaPDF2\Core\Document\Action in SetaPDF v2 API Reference

Index

\setasign\SetaPDF2
1. Core
  1. Document
  2. Document
    1. Action

setasign\SetaPDF2\Core\Document\Action

LaunchAction Class representing a Launch action

File: /SetaPDF v2/Core/Document/Action/LaunchAction.php
Old class name (alias): \SetaPDF_Core_Document_Action_Launch

Launch an application, usually to open a file. See PDF 32000-1:2008 - 12.6.4.5

Class hierarchy

Action
- LaunchAction

Summary

Properties

$_actionDictionary

protected \setasign\SetaPDF2\Core\Type\PdfDictionary Action::$_actionDictionary

The action dictionary

$_indirectReference

protected \setasign\SetaPDF2\Core\Type\IndirectObjectInterface Action::$_indirectReference

Static Methods

byObjectOrDictionary()

public static Action::byObjectOrDictionary (

\setasign\SetaPDF2\Core\Type\PdfIndirectObject|\setasign\SetaPDF2\Core\Type\PdfIndirectReference|\setasign\SetaPDF2\Core\Type\PdfDictionary $objectOrDictionary

): Action

Creates an action object by an action dictionary.

Parameters

$objectOrDictionary : \setasign\SetaPDF2\Core\Type\PdfIndirectObject|\setasign\SetaPDF2\Core\Type\PdfIndirectReference|\setasign\SetaPDF2\Core\Type\PdfDictionary

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

Throws \InvalidArgumentException

createActionDictionary()

public static LaunchAction::createActionDictionary (

string|\setasign\SetaPDF2\Core\FileSpecification|\setasign\SetaPDF2\Core\Type\PdfDictionary $fileSpecification,
?bool $newWindow = null

): \setasign\SetaPDF2\Core\Type\PdfDictionary

Create a Launch Action dictionary.

Parameters

$fileSpecification : string|\setasign\SetaPDF2\Core\FileSpecification|\setasign\SetaPDF2\Core\Type\PdfDictionary
$newWindow : ?bool

Exceptions

Throws \InvalidArgumentException

Methods

__construct()

public LaunchAction::__construct (

string|\setasign\SetaPDF2\Core\Type\PdfDictionary|\setasign\SetaPDF2\Core\Type\IndirectObjectInterface $objectOrDictionary

)

The constructor.

Parameters

$objectOrDictionary : string|\setasign\SetaPDF2\Core\Type\PdfDictionary|\setasign\SetaPDF2\Core\Type\IndirectObjectInterface

Exceptions

Throws \InvalidArgumentException

Throws \setasign\SetaPDF2\Core\Type\Exception

addNext()

public Action::addNext (

\setasign\SetaPDF2\Core\Type\PdfDictionary|Action $next

): void

Adds an additional action to the next value of this action.

Parameters

$next : \setasign\SetaPDF2\Core\Type\PdfDictionary|Action

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getActionDictionary()

public Action::getActionDictionary (

void

): \setasign\SetaPDF2\Core\Type\PdfDictionary

Get the action dictionary.

getFileSpecification()

public LaunchAction::getFileSpecification (

void

): \setasign\SetaPDF2\Core\FileSpecification

Get the file specification.

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getIndirectObject()

public Action::getIndirectObject (

?\setasign\SetaPDF2\Core\Document $document = null

): \setasign\SetaPDF2\Core\Type\IndirectObjectInterface

Get the indirect object of this annotation or creates it in the specific document context.

Parameters

$document : ?\setasign\SetaPDF2\Core\Document: The document instance

getNewWindow()

public LaunchAction::getNewWindow (

void

): ?bool

Get the NewWindow flag specifying whether to open the destination document in a new window.

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getNext()

public Action::getNext (

void

): false|\setasign\SetaPDF2\Core\Type\PdfDictionary|\setasign\SetaPDF2\Core\Type\PdfArray|\setasign\SetaPDF2\Core\Type\PdfIndirectReference

Gets the PDF value of the next entry.

getPdfValue()

public Action::getPdfValue (

void

): \setasign\SetaPDF2\Core\Type\PdfDictionary

Get the PDF value of this action.

getType()

public Action::getType (

void

): string

Get the action type specified in the S key.

setFileSpecification()

public LaunchAction::setFileSpecification (

string|\setasign\SetaPDF2\Core\FileSpecification $fileSpecification

): void

Set the file specification.

Parameters

$fileSpecification : string|\setasign\SetaPDF2\Core\FileSpecification

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

setIndirectObject()

public Action::setIndirectObject (

\setasign\SetaPDF2\Core\Type\IndirectObjectInterface $indirectReference

): void

Set the indirect object of this annotation.

Parameters

$indirectReference : \setasign\SetaPDF2\Core\Type\IndirectObjectInterface

setNewWindow()

public LaunchAction::setNewWindow (

bool $newWindow

): void

Set the NewWindow flag specifying whether to open the destination document in a new window.

Parameters

$newWindow : bool

setNext()

public Action::setNext (

\setasign\SetaPDF2\Core\Type\PdfDictionary|Action|\setasign\SetaPDF2\Core\Type\IndirectObjectInterface $next

): void

Set the next action which should be executed after this one.

Parameters

$next : \setasign\SetaPDF2\Core\Type\PdfDictionary|Action|\setasign\SetaPDF2\Core\Type\IndirectObjectInterface