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 \SetaPDF_Core_Type_Dictionary Action::$_actionDictionary

The action dictionary

$_indirectReference

protected \SetaPDF_Core_Type_IndirectObjectInterface Action::$_indirectReference

Static Methods

byObjectOrDictionary()

public static Action::byObjectOrDictionary (

\SetaPDF_Core_Type_IndirectObject|\SetaPDF_Core_Type_IndirectReference|\SetaPDF_Core_Type_Dictionary $objectOrDictionary

): \SetaPDF_Core_Document_Action

Creates an action object by an action dictionary.

Parameters

$objectOrDictionary : \SetaPDF_Core_Type_IndirectObject|\SetaPDF_Core_Type_IndirectReference|\SetaPDF_Core_Type_Dictionary

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

Throws \InvalidArgumentException

createActionDictionary()

public static LaunchAction::createActionDictionary (

string|\SetaPDF_Core_FileSpecification|\SetaPDF_Core_Type_Dictionary $fileSpecification,
?bool $newWindow = null

): \SetaPDF_Core_Type_Dictionary

Create a Launch Action dictionary.

Parameters

$fileSpecification : string|\SetaPDF_Core_FileSpecification|\SetaPDF_Core_Type_Dictionary
$newWindow : ?bool

Exceptions

Throws \InvalidArgumentException

Methods

__construct()

public LaunchAction::__construct (

string|\SetaPDF_Core_Type_Dictionary|\SetaPDF_Core_Type_IndirectObjectInterface $objectOrDictionary

)

The constructor.

Parameters

$objectOrDictionary : string|\SetaPDF_Core_Type_Dictionary|\SetaPDF_Core_Type_IndirectObjectInterface

Exceptions

Throws \InvalidArgumentException

Throws \setasign\SetaPDF2\Core\Type\Exception

addNext()

public Action::addNext (

\SetaPDF_Core_Type_Dictionary|\SetaPDF_Core_Document_Action $next

): void

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

Parameters

$next : \SetaPDF_Core_Type_Dictionary|\SetaPDF_Core_Document_Action

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getActionDictionary()

public Action::getActionDictionary (

void

): \SetaPDF_Core_Type_Dictionary

Get the action dictionary.

getFileSpecification()

public LaunchAction::getFileSpecification (

void

): \SetaPDF_Core_FileSpecification

Get the file specification.

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getIndirectObject()

public Action::getIndirectObject (

?\SetaPDF_Core_Document $document = null

): \SetaPDF_Core_Type_IndirectObjectInterface

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

Parameters

$document : ?\SetaPDF_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|\SetaPDF_Core_Type_Dictionary|\SetaPDF_Core_Type_Array|\SetaPDF_Core_Type_IndirectReference

Gets the PDF value of the next entry.

getPdfValue()

public Action::getPdfValue (

void

): \SetaPDF_Core_Type_Dictionary

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|\SetaPDF_Core_FileSpecification $fileSpecification

): void

Set the file specification.

Parameters

$fileSpecification : string|\SetaPDF_Core_FileSpecification

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

setIndirectObject()

public Action::setIndirectObject (

\SetaPDF_Core_Type_IndirectObjectInterface $indirectReference

): void

Set the indirect object of this annotation.

Parameters

$indirectReference : \SetaPDF_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 (

\SetaPDF_Core_Type_Dictionary|\SetaPDF_Core_Document_Action|\SetaPDF_Core_Type_IndirectObjectInterface $next

): void

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

Parameters

$next : \SetaPDF_Core_Type_Dictionary|\SetaPDF_Core_Document_Action|\SetaPDF_Core_Type_IndirectObjectInterface