get_text_range
Description:
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 |
| attributes |
location for storing text attributes. Deprecated: 0.68: Always pass |
| user_data |
user data to be passed to the callback |
Returns:
|
a newly allocated text string, or |