1.164.1 Instance variables

terminal_image <-> bindings: key_binding

Key bindings active in the image.

terminal_image <- font: font

Default (regular-weight) font used to draw text.

terminal_image <- bold_font: font*

Optional bold font; bold text falls back to terminal_image<-font if @nil.

terminal_image <- italic_font: font*

Optional slanted font (SGR 3); italic text falls back to terminal_image<-font if @nil.

terminal_image <- bold_italic_font: font*

Optional bold slanted font (SGR 1 and 3 together). If @nil, bold italic text falls back to terminal_image<-italic_font, then terminal_image<-bold_font, then terminal_image<-font.

terminal_image <- background: [colour]

Background colour of the buffer.

terminal_image <- selection_style: [style]

style applied to selected cells.

terminal_image <- isearch_style: style*

style applied to the hit of an incremental search, in place of terminal_image<-selection_style, so that what a search found can be told from what the user picked with the mouse.

terminal_image <- isearch_other_style: style*

style applied to the matches on the screen other than the one the user is on, or @nil to leave them alone. It serves an incremental search and a selection alike: what a search is looking for while one runs, and otherwise the selected text (see terminal_image<-selection_string). Only the visible ones: they are worked out afresh every time the window is painted, so scrolling brings the ones it reaches into view without the search or the selection doing anything about it.

terminal_image <- nfd_style: style*

Style applied to NFD grapheme clusters (e.g. accented composed characters), or @nil to disable highlighting.

terminal_image <- link_style: style*

Style applied to detected hyperlinks.

terminal_image <- link_armed_style: style*

Style applied to the hyperlink under the mouse pointer.

terminal_image <- fold_style: style*

Style of the fold marker and the tally beside a folded command. @nil takes both away, and with them the click that toggles a fold.

terminal_image <- ansi_colours: vector*

Vector of 16 colour objects: the 8 base ANSI colours followed by their bright variants.

terminal_image <- armed_link: bool

@on when the pointer is over a hyperlink.

terminal_image <- armed_fold: bool

@on when the pointer is over the marker of a fold, i.e. in the left margin beside a command whose output can be hidden.

terminal_image <- blocks: chain

The commands the client has run, as terminal_block objects, oldest first. Empty unless the client marks its prompts; see class terminal_block.

terminal_image <-> link_message: code*

Optional code invoked when a hyperlink is activated. A link is followed by Control-clicking it, or, on MacOS, by Command-clicking it: Control-click asks for the popup menu there. See event ->is_popup.

terminal_image <-> scroll_bar: scroll_bar*

Associated scroll_bar (driven by terminal_image->bubble_scroll_bar).

terminal_image <- save_lines: int

Number of past lines retained in the scroll-back buffer.

terminal_image <-> syntax: syntax_table

Syntax table used for word boundaries in selection.

terminal_image <- focus_function: name*

Method that is sent every keystroke while it succeeds, ahead of everything terminal_image->typed normally does. @nil unless an incremental search is running.

terminal_image <- search_string: string*

What the incremental search is looking for, or @nil.

terminal_image <- selection_string: string*

The selected text, when it is a selection whose other occurrences are highlighted, and @nil when it is not. See terminal_image->selection; it is also what terminal_image->isearch_selection_forward searches for.

terminal_image <-match_word: bool ->

Whether matching asks for whole words now: terminal_image<->search_word, or a selection made by double clicking a word. A search takes this from the selection it was seeded with; one started with \C-\S-f has no selection to take it from. This, not terminal_image<->search_word, is what the window should show as the state of a Word box, so that the box says what the tally beside it was counted with.

terminal_image <- search_direction: {forward,backward}

Direction the incremental search is going.

terminal_image <- exact_case: bool

Whether the incremental search is case sensitive.

terminal_image <- search_word: bool

Whether matching asks for whole words only, in the sense of terminal_image<-syntax.

Both decide what counts as a match for a selection as well as for a search. Both outlive the search that used them, and setting either looks again at once, so the hit or the selection, the tally and what is painted all follow.

A selection can ask for whole words on its own account -- see terminal_image<-match_word -- so turning terminal_image->search_word off also takes that back: the setting means what it says.