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.
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
.
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 |
|
user_data |
gpointer |
User data to be passed to the callback. |
|
attributes |
An array of VteCharAttributes |
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. |