pdftools_toolbox.pdf.content.text

Classes

Text(handle)

class pdftools_toolbox.pdf.content.text.Text(handle)

Bases: _NativeObject, list

static create(target_document: Document) → Text

Create a text

The returned text object is not yet used on any page, but it is associated with the given target document.

Parameters:

targetDocument (pdftools_toolbox.pdf.document.Document) – the output document with which the returned object is associated

Returns:

the newly created text object

Return type:

pdftools_toolbox.pdf.content.text.Text

Raises:

• ValueError – if the targetDocument argument has already been closed

• ValueError – if the targetDocument argument is read-only

clear() → None

Remove all items from list.

remove(index: int) → None

Remove first occurrence of value.

Raises ValueError if the value is not present.

extend(items: Text) → None

Extend list by appending elements from the iterable.

insert(index: int, value: Any) → None

Insert object before index.

pop(index: int = -1) → Any

Remove and return item at index (default last).

Raises IndexError if list is empty or index is out of range.

copy() → Text

Return a shallow copy of the list.

sort(key=None, reverse=False) → None

Sort the list in ascending order and return None.

The sort is in-place (i.e. the list itself is modified) and stable (i.e. the order of two equal elements is maintained).

If a key function is given, apply it once to each list item and sort them, ascending or descending, according to their function values.

The reverse flag can be set to sort in descending order.

reverse() → None

Reverse IN PLACE.

append(value: TextFragment) → None

Append object to the end of the list.

index(value: TextFragment, start: int = 0, stop: int | None = None) → int

Return first index of value.

Raises ValueError if the value is not present.