get_text_range


Description:

public string? get_text_range (long start_row, long start_col, long end_row, long end_col, SelectionFunc? is_selected, out Array<CharAttributes?>? attributes)

Extracts a view of the visible part of the terminal.

The entire scrollback buffer is scanned, so it is possible to read the entire contents of the buffer using this function.

This method is unaware of BiDi. The columns passed in start_col and end_row, and returned in attributes are logical columns.

Since 0.68, passing a non-%NULL array parameter is deprecated. Since 0.72, passing a non-%NULL array parameter will make this function itself return null. Since 0.72, passing a non-%NULL is_selected function will make this function itself return null.

Parameters:

this

a Terminal

start_row

first row to search for data

start_col

first column to search for data

end_row

last row to search for data

end_col

last column to search for data

is_selected

a SelectionFunc callback. Deprecated: 0.44: Always pass null here

attributes

location for storing text attributes. Deprecated: 0.68: Always pass null here.

user_data

user data to be passed to the callback

Returns:

a newly allocated text string, or null.