| FoxitPDFSDKforWeb v11.0.4 Archives Foxit PDF SDK for Web

Public Member Functions | List of all members
Screen Class Reference
PDF » annots

Screen annot object. More...

Inheritance diagram for Screen:

## Public Member Functions
| getAction ()
| Get screen's action. [Support in Server] More...
| getAdditionalAction ()
| Retrives the additional action object. More...
| getImage (type)
| getOpacity ()
| Get opacity value. [Support in Server] This property has effect on markup annotation's appearance. More...
| getRotation ()
| Get the rotation of the image used for the appearance of current screen annotation. More...
| removeAction (trigger=-1, action, isObjectNumber=false)
| Remove screen's action. More...
| setImage (buffer)
| Set screen's image. More...
| setOpacity (opacity)
| Set opacity value. [Support in Server] More...
| setRotation (rotation)
| Set the rotation of the image used for the appearance of current screen annotation. More...
Public Member Functions inherited from Annot
| appendAction (actionSpec)
| Appends a action to the annotation. This function cannot be used to append action which is used as additional action. More...
| exportToJSON ()
| Export the current annotation to a Json object. [Support in Server] More...
| getActionData ()
| Retrieves the action associated with this annotation. This function cannot be used to get action which is used as additional action. More...
| getAllActionData ()
| Gets all action data associated with the annotation. This method retrieves all action data including both primary and additional actions of the annotation. The action will be grouped by action trigger type: ActionTriggerEvents.ANNOT_MOUSE_BUTTON_RELEASED. More...
| getAnnotId ()
| Retrieves the unique identifier of the annotation. The identifier consists of two components: the page index and the object number, which together ensure the annotation's uniqueness within the document. More...
| getBorderColor ()
| Get annotation's border color. [Support in Server] More...
| getBorderInfo ()
| Get annotation's border information. [Support in Server] More...
| getBorderStyle ()
| Get annotation's border style. More...
| getContent ()
| Get annotation's contents. [Support in Server] More...
| getDictionaryEntry (key)
| Get the dictionary property of Annot by key. More...
| getFlags ()
| Get annotation's flag. [Support in Server] More...
| getModifiedDateTime ()
| Get annotation's last modified date time. [Support in Server] More...
| getObjectNumber ()
| Get annotation's object number. More...
| getPage ()
| Get annotation's page. [Support in Server] More...
| getRect ()
| Get annotation's rect. [Support in Server] More...
| getTitle ()
| Get annotation's title. [Support in Server] More...
| getType ()
| Get annotation's type. [Support in Server] More...
| getUniqueID ()
| Get annotation's unique ID. [Support in Server] More...
| isEmpty ()
| Check annotation is empty or not. [Support in Server] More...
| isMarkup ()
| Check if current annotation is a markup annotation. [Support in Server] More...
| removeAction (actionObjNumber)
| Removes a action from the annotation. This function cannot be used to remove action which is used as additional action. More...
| setAction (actionSpec)
| Set the action for the annotation. This function cannot be used to set action which is used as additional action. More...
| setBorderColor (borderColor)
| Set annotation's border color. [Support in Server] More...
| setBorderInfo (borderInfo)
| Set annotation's border information. [Support in Server] More...
| setBorderStyle (borderStyle, styleParam)
| Set annotation's border style. More...
| setContent (content)
| Set contents for the currently gotten annotation. [Support in Server] More...
| setCustomAPStream (appearanceType, appearanceStream)
| setDictionaryEntry (key, value)
| Add a new entry or replace the existing entry of the annotation dictionary. Caller could use this method to store their private data to the annotation. Do not use any standard key of the annotation dictionary, such as 'Type', 'Subtype', 'Rect' defined in PDF Reference. If any standard key is used, this behaviour will be undefined. More...
| setFlags (flag, notTriggerEvent)
| Set annotation's flag. [Support in Server] More...
| setModifiedDateTime (date)
| Set annotation's last modified date time. [Support in Server] More...
| setRect (rect)
| Set annotation's rect. More...
| supportsAction ()
| This method checks the annotation type and returns true if the type is screen, link or sound annotation, Indicating that are supports actions. For other types of annotation, it returns false. More...
| updateAction (actionObjNumber, actionData)
| Updates an existing action in the annotation. This function cannot be used to update action which is used as additional action. More...
Public Member Functions inherited from Disposable
| addDestroyHook (...hooks)
| Add a function to destroyHooks list, which will be called during destroy. More...
| destroy ()
| ownsTo (owner)
| Establishes an ownership relationship where this instance will be destroyed when the owner is destroyed. Additionally, the owner will be automatically removed from the destroyHooks list when this instance is destroyed. More...

## Detailed Description

Screen annot object.

## Member Function Documentation

## ◆ getAction()

Screen::getAction | ( |  | ) |
| inline

Get screen's action. [Support in Server]

Returns
  Action - An action object.

## ◆ getAdditionalAction()

Screen::getAdditionalAction | ( |  | ) |
| inline

Retrives the additional action object.

getAdditionalAction<T>(): AdditionalAction<T>;

Returns
  AdditionalAction<T> - The additional action object for manipulation additional actions.

Since
  11.0.0

## ◆ getImage()

Screen::getImage | ( |  | type | ) |
| inline

Get the image data by the specified type.

Parameters

  [type='canvas'] | 'canvas'|'image'|'buffer' - The data type, valid value: 'canvas' | 'image' | 'buffer'.

Returns
  Promise<ArrayBuffer|HTMLImageElement|HTMLCanvasElement> - The image data by the specified type.
  var imageBuf = getImage('buffer');
  var blob = new Blob([imageBuf], {type: 'image/png'});
  var url = URL.createObjectURL(blob);

Since
  8.4.0

## ◆ getOpacity()

Screen::getOpacity | ( |  | ) |
| inline

Get opacity value. [Support in Server]
This property has effect on markup annotation's appearance.

Returns
  number - The opacity value. Valid range: 0.0 to 1.0. 0.0 means full transparency and 1.0 means full opaque.

## ◆ getRotation()

Screen::getRotation | ( |  | ) |
| inline

Get the rotation of the image used for the appearance of current screen annotation.

Returns
  number - Rotation value of the image.

Since
  8.2.0

## ◆ removeAction()

Screen::removeAction | ( |  | trigger = `-1`,
|  |  | action,
|  |  | isObjectNumber = `false`
| ) |  |
| inline

Remove screen's action.

Parameters

  [trigger=-1] | number - The trigger parameter. If `isObjectNumber` is true, represents the object number of action to remove. If `isObjectNumber` is false, represents the trigger event type.
  [action] | Action - The action to be removed. If first parameter is an object number, this parameter is not required.
  [isObjectNumber=false] | boolean - Whether the first parameter is an object number. If true, it will call the base class's removeAction method.

Returns
  Promise<boolean> - A boolean value indicating whether the action was successfully removed.

Deprecated:
  - For removing additional actions purpose, please use AdditionalAction<T>.removeAction instead
  - For removing action purpose, you must pass the `trigger` parameter as an object number and set `isObjectNumber` to true.
    In the future, this method will be simplified to remove actions only, and no additional parameters will be required.

Note
  For historical reasons, since version 11.0.0, this method add a new parameter `isObjectNumber` to determine whether the first parameter is an object number,
  if it is, it will call the Annot.removeAction method to remove the action with the object number,
  otherwise it will remove an additional action with specified trigger and Action instance.
  The `isObjectNumber` parameter is used for API compatibility, it is not used for removing additional actions.
  - To remove an action, you must pass the `trigger` parameter as an object number and set `isObjectNumber` to true.
    The `action` parameter should be omitted (pass null).
    Example:
    // Remove an action with object number 0
    screenAnnot.removeAction(0, null, true);
  - To remove an additional action, you should use AdditionalAction<T>.removeAction method, this method is only used internally.

See also
  AdditionalAction<T>.removeAction
  Annot.removeAction
  Annot.getActionData

## ◆ setImage()

Screen::setImage | ( |  | buffer | ) |
| inline

Set screen's image.

Parameters

  buffer | ArrayBuffer -The raw image buffer, supported types are jpeg/png/bmp..

Returns
  Promise<boolean> - true for success, otherwise failure.
  async function example(screenAnnot)
  {
  const resp = await fetch('/xxx/xx.jpeg');
  const imageBuffer = await resp.arrayBuffer();
  await screenAnnot.setImage(imageBuffer);
  }

## ◆ setOpacity()

Screen::setOpacity | ( |  | opacity | ) |
| inline

Set opacity value. [Support in Server]

Parameters

  opacity | number - The new opacity value. Valid range: 0.0 to 1.0. 0.0 means full transparency and 1.0 means full opaque.

Returns
  Promise<Annot[]> - An array of annotation objects which has been modified. event PDFViewCtrl.constants.ViewerEvents.annotationUpdated Annot[] PDFPage
  PDFViewCtrl.constants.ViewerEvents.annotationAppearanceUpdated Annot[] PDFPage

## ◆ setRotation()

Screen::setRotation | ( |  | rotation | ) |
| inline

Set the rotation of the image used for the appearance of current screen annotation.

Parameters

  rotation | 0|90|180|270 - Rotation value. this should be one of these values : 0, 90, 180, 270.

Since
  8.2.0

@2025 Foxit Software Incorporated. All rights reserved.