comet.CHyperlink

class comet.CHyperlink

Methods

CHyperlink.isValid() → bool

Determine whether this hyperlink destination is still valid and exists.

Returns:

Whether this hyperlink is still valid and exists

Return type:

bool

Available:

InDesign® comet_pdf®

CScript:

hyperlink::is_valid

CHyperlink.getType() → int

Determine the type of the hyperlink.

Returns:

The type of the hyperlink

• 0 : Undefined

• 1 : URL

• 2 : External File

• 3 : Mail (comet_pdf only). InDesign® returns 1 (URL) here too.

• 4 : Page

• 5 : Text Anchor

• 8 : Named Destination (comet_pdf only)

Return type:

int

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign® comet_pdf®

CScript:

hyperlink::type

CHyperlink.getDocument() → CDocument

Get the document this link belongs to.

Returns:

The owning document

Return type:

CDocument

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign® comet_pdf®

CHyperlink.getSource() → CHyperlinkSource

Get the source attached to this link.

Returns:

The source of this link

Return type:

CHyperlinkSource

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign® comet_pdf®

CHyperlink.getDestination() → CHyperlinkDestination

Get the destination this hyperlink points to.

Returns:

The target destination

Return type:

CHyperlinkDestination

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign® comet_pdf®

CScript:

hyperlink::destination

CHyperlink.getName() → str

Determine the name of the hyperlink.

Returns:

The name of the hyperlink

Return type:

str

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign® comet_pdf®

CScript:

hyperlink::name

CHyperlink.setName(name: str) → None

Set the name of the hyperlink.

Parameters:

name (str) – The new name

Return type:

None

Raises:

• TypeError – When parameter types are invalid

• ValueError – When parameter name is empty

• CometError –

  • When the hyperlink is not valid

  • On internal error

Available:

InDesign® comet_pdf®

CScript:

hyperlink::setname

CHyperlink.getVisible() → bool

Determine whether the hyperlink border is visible.

Returns:

Whether the hyperlink is visible

Return type:

bool

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign® comet_pdf®

CScript:

hyperlink::visible

CHyperlink.setVisible(visible: bool) → None

Set the border visibility of the hyperlink.

Parameters:

visible (bool) – The new visibility state

Return type:

bool

Raises:

• TypeError – When parameter types are invalid

• CometError – When the hyperlink is not valid

Available:

InDesign® comet_pdf®

CScript:

• hyperlink::show

• hyperlink::hide

CHyperlink.getColor() → CSwatch

Get the color of the hyperlink border.

Returns:

The color of the hyperlink border

Return type:

CSwatch

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign®

CScript:

hyperlink::color

CHyperlink.setColor(color: CColor | CSwatch) → None

Set the color of the hyperlink border.

Parameters:

color –

The new hyperlink border color.

The parameter type can be:

• CColor

  Color with space RGB, CMYK or LAB

• CSwatch

  Swatch

  Must belong to the same document as the hyperlink

Return type:

None

Raises:

• TypeError – When parameter types are invalid

• ValueError –

  • When parameter color is CColor and has unsupported type

  • When parameter color is CSwatch and is from a different document

• CometError –

  • When the hyperlink is not valid

  • On internal error

Available:

InDesign®

CScript:

hyperlink::appearance

CHyperlink.getBorderWidth() → int

Get the width of the hyperlink border.

Returns:

The width setting of the border

Return type:

int

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign®

CScript:

hyperlink::borderwidth

CHyperlink.setBorderWidth(width: int) → None

Set the width of the hyperlink border.

Parameters:

width (int) – The width setting

Return type:

None

Raises:

• TypeError – When parameter types are invalid

• ValueError – When parameter width has invalid value

• CometError –

  • When the hyperlink is not valid

  • On internal error

Available:

InDesign®

CScript:

hyperlink::appearance

CHyperlink.getHilight() → int

Get the hilight state of the hyperlink.

The hilight state is not used in InDesign® , it only matters when the file is exported to PDF.

To change the visibility of the hyperlink, please use setVisible()

Returns:

The hilight state

Return type:

int

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign®

CScript:

hyperlink::hilight

CHyperlink.setHilight(hilight: int) → None

Set the hilight state of the hyperlink.

The hilight state is not used in InDesign® , it only matters when the file is exported to PDF.

To change the visibility of the hyperlink, please use setVisible()

Parameters:

hilight (int) – The new hilight state

Return type:

None

Raises:

• TypeError – When parameter types are invalid

• ValueError – When parameter hilight has invalid value

• CometError – When the hyperlink is not valid

Available:

InDesign®

CScript:

hyperlink::appearance

CHyperlink.getOutlineStyle() → int

Get the outline style of the hyperlink.

Returns:

The outline style of the hyperlink

• 0: Solid

• 1: Dashed

Return type:

int

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign®

CHyperlink.setOutlineStyle(style: int) → None

Set the outline style of the hyperlink.

Parameters:

style (int) –

The new outline style

• 0: Solid

• 1: Dashed

Return type:

None

Raises:

• TypeError – When parameter types are invalid

• ValueError – When parameter style has invalid value

• CometError – When the hyperlink is not valid

Available:

InDesign®

CScript:

hyperlink::appearance

CHyperlink.remove() → None

Remove this hyperlink from the document.

The object will be left in an invalid state.

Return type:

None

Raises:

CometError – When the hyperlink is not valid

Available:

InDesign® comet_pdf®

CScript:

hyperlink::delete_

Special methods

CHyperlink.__repr__() → str

String representation.

Returns:

<CHyperlink> Name: Name

Example

<CHyperlink> Name: text1

Return type:

str