PDFTron WebViewer

Class: ScreenAnnot

PDFNet. ScreenAnnot

new ScreenAnnot()

A screen annotation (PDF 1.5) specifies a region of a page upon which media clips may be played. It also serves as an object from which actions can be triggered.

Extends

  • Annot

Members

<static> IconCaptionRelation

Properties:
Name Type Description
e_NoIcon number
e_NoCaption number
e_CBelowI number
e_CAboveI number
e_CRightILeft number
e_CLeftIRight number
e_COverlayI number

<static> ScaleCondition

Properties:
Name Type Description
e_Always number
e_WhenBigger number
e_WhenSmaller number
e_Never number

<static> ScaleType

Properties:
Name Type Description
e_Anamorphic number
e_Proportional number

Methods

<static> create(doc, pos)

Creates a new Screen annotation in the specified document.
Parameters:
Name Type Description
doc PDFNet.PDFDoc | PDFNet.SDFDoc | PDFNet.FDFDoc A document to which the annotation is added.
pos PDFNet.Rect A rectangle specifying the annotation's bounds in default user space units.
Returns:
A promise that resolves to a newly created blank Screen annotation.
Type
Promise.<PDFNet.ScreenAnnot>

<static> createFromAnnot(ann)

creates a Screen annotation and initializes it using given annotation object.
Parameters:
Name Type Description
ann PDFNet.Annot Annot object used to initialize the Screen annotation.
Returns:
A promise that resolves to an object of type: "PDFNet.ScreenAnnot"
Type
Promise.<PDFNet.ScreenAnnot>

<static> createFromObj( [d])

creates a Screen annotation and initializes it using given Cos/SDF object.
Parameters:
Name Type Argument Description
d PDFNet.Obj <optional>
 The Cos/SDF object to initialze the annotation with.
Returns:
A promise that resolves to an object of type: "PDFNet.ScreenAnnot"
Type
Promise.<PDFNet.ScreenAnnot>

getAction()

Returns the action of the Screen annotation
Returns:
A promise that resolves to an action object representing the action of the annotation.
Type
Promise.<PDFNet.Action>

getBackgroundColor()

Returns the background color of the annotation.
Returns:
A promise that resolves to a color object that denotes the color of the Screen background.
Type
Promise.<PDFNet.ColorPt>

getBackgroundColorCompNum()

Returns the number indicating background color space of the annotation.
Returns:
A promise that resolves to an integer indicating a color space value from the ColorSpace::Type enum. That is, 1 corresponding to "e_device_gray", 3 corresponding to "e_device_rgb", and 4 corresponding to "e_device_cmyk" if color space is applicable, 0 means no background color was assigned.
Type
Promise.<number>

getBorderColor()

Returns the border color of the annotation.
Returns:
A promise that resolves to a color object that denotes the color of the Screen border.
Type
Promise.<PDFNet.ColorPt>

getBorderColorCompNum()

Returns the number indicating border color space of the annotation.
Returns:
A promise that resolves to an integer indicating a color space value from the ColorSpace::Type enum. That is, 1 corresponding to "e_device_gray", 3 corresponding to "e_device_rgb", and 4 corresponding to "e_device_cmyk". 0 means this annotation had no color assigned.
Type
Promise.<number>

getFitFull()

Returns the "fit full" flag.
Returns:
A promise that resolves to a boolean value indicating the "fit full" flag value.
Type
Promise.<boolean>

getHIconLeftOver()

Returns the horizontal leftover space of the icon within the annotation.
Returns:
A promise that resolves to a number indicating the horizontal leftover space of the icon within the annotation.
Type
Promise.<number>

getIconCaptionRelation()

Returns the Icon and caption relationship of the annotation.
See:
  • IconCaptionRelation
Returns:
A promise that resolves to a value of the "IconCaptionRelation" enum type. Default value: e_NoIcon.
Type
Promise.<number>
Example
Return value enum:
<pre>
PDFNet.ScreenAnnot.IconCaptionRelation = {
	e_NoIcon : 0
	e_NoCaption : 1
	e_CBelowI : 2
	e_CAboveI : 3
	e_CRightILeft : 4
	e_CLeftIRight : 5
	e_COverlayI : 6
}
</pre>

getMouseDownCaptionText()

Returns the button down caption text of the annotation.
Returns:
A promise that resolves to a string containing the button down text of the annotation.
Type
Promise.<string>

getMouseDownIcon()

Returns the Mouse Down icon associated with the annotation.
Returns:
A promise that resolves to an SDF object that represents the Mouse Down icon associated with the annotation.
Type
Promise.<PDFNet.Obj>

getRolloverCaptionText()

Returns the rollover caption text of the annotation.
Returns:
A promise that resolves to a string containing the rollover caption text of the annotation.
Type
Promise.<string>

getRolloverIcon()

Returns the rollover icon associated with the annotation.
Returns:
A promise that resolves to an SDF object that represents the rollover icon associated with the annotation.
Type
Promise.<PDFNet.Obj>

getScaleCondition()

Returns the condition under which the icon should be scaled.
See:
  • ScaleCondition
Returns:
A promise that resolves to a value of the "ScaleCondition" enum type. Default value: e_Always.
Type
Promise.<number>
Example
Return value enum:
<pre>
PDFNet.ScreenAnnot.ScaleCondition = {
	e_Always : 0
	e_WhenBigger : 1
	e_WhenSmaller : 2
	e_Never : 3
}
</pre>

getScaleType()

Returns the Scale Type of the annotation.
See:
  • ScaleType
Returns:
A promise that resolves to a value of the "ScaleType" enum which represents the Scale Type of the annotation. Default value: P.
Type
Promise.<number>
Example
Return value enum:
<pre>
PDFNet.ScreenAnnot.ScaleType = {
	e_Anamorphic : 0
	e_Proportional : 1
}
</pre>

getStaticCaptionText()

Returns static caption text of the annotation.
Returns:
A promise that resolves to a string containing the static caption text of the annotation.
Type
Promise.<string>

getStaticIcon()

Returns the static icon associated with the annotation.
Returns:
A promise that resolves to an SDF object that represents the static icon associated with the annotation.
Type
Promise.<PDFNet.Obj>

getTitle()

Returns the title of the annotation.
Returns:
A promise that resolves to a string representing the title of the annotation.
Type
Promise.<string>

getVIconLeftOver()

Returns the vertical leftover space of the icon within the annotation.
Returns:
A promise that resolves to a number indicating the vertical leftover space of the icon within the annotation.
Type
Promise.<number>

setAction(action)

sets the action of the Screen annotation (Optional; PDF 1.1 )
Parameters:
Name Type Description
action PDFNet.Action An action object representing the action of the annotation.
Returns:
Type
Promise.<void>

setBackgroundColor(col, numcomp)

sets the background color of the annotation. (Optional)
Parameters:
Name Type Description
col PDFNet.ColorPt A color point that denotes the color of the screen background.
numcomp number An integer which value indicates the color space used for the parameter c.
Returns:
Type
Promise.<void>

setBorderColor(col, numcomp)

sets the border color of the annotation. (Optional)
Parameters:
Name Type Description
col PDFNet.ColorPt A color object that denotes the color of the screen border.
numcomp number An integer which value indicates the color space used for the parameter c.
Returns:
Type
Promise.<void>

setFitFull(ff)

sets the "fit full" flag. (Optional)
Parameters:
Name Type Description
ff boolean A boolean value indicating the "fit full" flag value.
Returns:
Type
Promise.<void>

setHIconLeftOver(hl)

sets the horizontal leftover space of the icon within the annotation. (Optional)
Parameters:
Name Type Description
hl number A number indicating the horizontal leftover space of the icon within the annotation.
Returns:
Type
Promise.<void>

setIconCaptionRelation(icr)

sets the Icon and caption relationship of the annotation. (Optional; pushbutton fields only)
Parameters:
Name Type Description
icr number 
PDFNet.ScreenAnnot.IconCaptionRelation = {
	e_NoIcon : 0
	e_NoCaption : 1
	e_CBelowI : 2
	e_CAboveI : 3
	e_CRightILeft : 4
	e_CLeftIRight : 5
	e_COverlayI : 6
}
A value of the "IconCaptionRelation" enum type. Default value: e_NoIcon.
See:
  • IconCaptionRelation
Returns:
Type
Promise.<void>

setMouseDownCaptionText(contents)

sets the button down caption text of the annotation. (Optional; button fields only)
Parameters:
Name Type Description
contents string A string containing the button down text of the annotation.
Returns:
Type
Promise.<void>

setMouseDownIcon(icon)

sets the Mouse Down icon associated with the annotation. (Optional; button fields only)
Parameters:
Name Type Description
icon PDFNet.Obj An SDF object that represents the Mouse Down icon associated with the annotation.
Returns:
Type
Promise.<void>

setRolloverCaptionText(contents)

sets the roll over caption text of the annotation. (Optional; button fields only)
Parameters:
Name Type Description
contents string A string containing the roll over caption text of the annotation.
Returns:
Type
Promise.<void>

setRolloverIcon(icon)

sets the rollover icon associated with the annotation. (Optional; button fields only)
Parameters:
Name Type Description
icon PDFNet.Obj An SDF object that represents the rollover icon associated with the annotation.
Returns:
Type
Promise.<void>

setScaleCondition(sc)

sets the condition under which the icon should be scaled. (Optional)
Parameters:
Name Type Description
sc number 
PDFNet.ScreenAnnot.ScaleCondition = {
	e_Always : 0
	e_WhenBigger : 1
	e_WhenSmaller : 2
	e_Never : 3
}
A value of the "ScaleCondition" enum type. Default value: e_Always.
Returns:
Type
Promise.<void>

setScaleType(st)

sets the Scale Type of the annotation. (Optional)
Parameters:
Name Type Description
st number 
PDFNet.ScreenAnnot.ScaleType = {
	e_Anamorphic : 0
	e_Proportional : 1
}
An entry of the "ScaleType" enum which represents the Scale Type of the annotation. Default value: P.
See:
  • ScaleType
Returns:
Type
Promise.<void>

setStaticCaptionText(contents)

sets static caption text of the annotation. (Optional; button fields only)
Parameters:
Name Type Description
contents string A string containing the static caption text of the annotation.
Returns:
Type
Promise.<void>

setStaticIcon(icon)

sets the static icon associated with the annotation. (Optional; button fields only)
Parameters:
Name Type Description
icon PDFNet.Obj An SDF object that represents the static icon associated with the annotation.
Returns:
Type
Promise.<void>

setTitle(title)

sets the title of the Annotation. (Optional)
Parameters:
Name Type Description
title string A string representing the title of the annotation.
Returns:
Type
Promise.<void>

setVIconLeftOver(vl)

sets the vertical leftover space of the icon within the annotation. (Optional)
Parameters:
Name Type Description
vl number A number indicating the vertical leftover space of the icon within the annotation.
Returns:
Type
Promise.<void>