Method
VteTerminalget_text_range
Declaration [src]
char*
vte_terminal_get_text_range (
VteTerminal* terminal,
glong start_row,
glong start_col,
glong end_row,
glong end_col,
VteSelectionFunc is_selected,
gpointer user_data,
GArray* attributes
)
Description [src]
Extracts a view of the visible part of the terminal. If is_selected is not
NULL, characters will only be read if is_selected returns TRUE after being
passed the column and row, respectively. A VteCharAttributes structure
is added to attributes for each byte added to the returned string detailing
the character’s position, colors, and other characteristics. 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.
Note: since 0.68, passing a non-NULL array parameter is deprecated. Starting with
0.72, passing a non-NULL array parameter will make this function itself return NULL.
Parameters
start_row |
glong |
First row to search for data. |
|
start_col |
glong |
First column to search for data. |
|
end_row |
glong |
Last row to search for data. |
|
end_col |
glong |
Last column to search for data. |
|
is_selected |
VteSelectionFunc |
A |
|
The argument can be NULL. | |
user_data |
gpointer |
User data to be passed to the callback. |
|
The argument can be NULL. | |
| The data is owned by the caller of the function. | |
attributes |
An array of None |
Location for storing text attributes. Deprecated: 0.68: Always pass |
|
| The argument will be set by the function. | |
The argument can be set to NULL. | |
| The instance takes ownership of the data, and is responsible for freeing it. |