Composed line range

ComposedLineRange ¶

Bases: _IndexRange

A composed-line span of a [TextDocument][].

Created via TextDocument.composed_line_range( composed_line_index_start, signed_composed_line_index_end). Point text derives its lines from the paragraphs (always fresh). Box text reads the layout cache AE persisted at save time; after a layout-affecting py-side write the calibrated composed-line resolver recomposes it (see TextDocument.composition_stale). When no calibrated composer is available the stale cache behaves like AE's own un-reapplied TextDocument values: line boundaries clamp to the current text and lines falling wholly outside it raise ValueError.

See: https://ae-scripting.docsforadobe.dev/text/composedlinerange/

Attributes¶

character_end ¶

character_end: int

The range's last character index + 1. Read-only.

character_start ¶

character_start: int

The range's first character index. Read-only.

is_range_valid ¶

is_range_valid: bool

True while the range lies within the document bounds. Read-only.

Functions¶

character_range ¶

character_range() -> CharacterRange

A [CharacterRange][] fixed to the current character bounds.

The returned range holds resolved indices and does not follow later changes to this range's paragraphs or lines.