Top | ![]() |
![]() |
![]() |
![]() |
void | bell | Run Last |
void | char-size-changed | Run Last |
void | child-exited | Run Last |
void | commit | Run Last |
void | contents-changed | Run Last |
void | copy-clipboard | Action |
void | current-directory-uri-changed | Run Last |
void | current-file-uri-changed | Run Last |
void | cursor-moved | Run Last |
void | decrease-font-size | Run Last |
void | deiconify-window | Run Last |
void | encoding-changed | Run Last |
void | eof | Run Last |
void | hyperlink-hover-uri-changed | Run Last |
void | icon-title-changed | Run Last |
void | iconify-window | Run Last |
void | increase-font-size | Run Last |
void | lower-window | Run Last |
void | maximize-window | Run Last |
void | move-window | Run Last |
void | paste-clipboard | Action |
void | raise-window | Run Last |
void | refresh-window | Run Last |
void | resize-window | Run Last |
void | restore-window | Run Last |
void | selection-changed | Run Last |
void | text-deleted | Run Last |
void | text-inserted | Run Last |
void | text-modified | Run Last |
void | text-scrolled | Run Last |
void | window-title-changed | Run Last |
struct | VteTerminal |
enum | VteCursorBlinkMode |
enum | VteCursorShape |
enum | VteEraseBinding |
enum | VteTextBlinkMode |
enum | VteFormat |
enum | VteWriteFlags |
GEnum ├── VteCursorBlinkMode ├── VteCursorShape ├── VteEraseBinding ├── VteTextBlinkMode ╰── VteWriteFlags GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── VteTerminal
gboolean (*VteSelectionFunc) (VteTerminal *terminal
,glong column
,glong row
,gpointer data
);
Specifies the type of a selection function used to check whether a cell has to be selected or not.
void vte_terminal_feed (VteTerminal *terminal
,const char *data
,gssize length
);
Interprets data
as if it were data received from a child process. This
can either be used to drive the terminal without a child process, or just
to mess with your users.
void vte_terminal_feed_child (VteTerminal *terminal
,const char *text
,gssize length
);
Sends a block of UTF-8 text to the child as if it were entered by the user at the keyboard.
void vte_terminal_feed_child_binary (VteTerminal *terminal
,const guint8 *data
,gsize length
);
Sends a block of binary data to the child.
void
vte_terminal_select_all (VteTerminal *terminal
);
Selects all text within the terminal (including the scrollback buffer).
void
vte_terminal_unselect_all (VteTerminal *terminal
);
Clears the current selection.
void vte_terminal_copy_clipboard_format (VteTerminal *terminal
,VteFormat format
);
Places the selected text in the terminal in the GDK_SELECTION_CLIPBOARD
selection in the form specified by format
.
For all formats, the selection data (see GtkSelectionData) will include the
text targets (see gtk_target_list_add_text_targets()
and
gtk_selection_data_targets_includes_text()
). For VTE_FORMAT_HTML
,
the selection will also include the "text/html" target, which when requested,
returns the HTML data in UTF-16 with a U+FEFF BYTE ORDER MARK character at
the start.
Since: 0.50
void
vte_terminal_paste_clipboard (VteTerminal *terminal
);
Sends the contents of the GDK_SELECTION_CLIPBOARD selection to the terminal's child. It's called on paste menu item, or when user presses Shift+Insert.
void
vte_terminal_copy_primary (VteTerminal *terminal
);
Places the selected text in the terminal in the GDK_SELECTION_PRIMARY selection.
void
vte_terminal_paste_primary (VteTerminal *terminal
);
Sends the contents of the GDK_SELECTION_PRIMARY selection to the terminal's child. The terminal will call also paste the GDK_SELECTION_PRIMARY selection when the user clicks with the the second mouse button.
void vte_terminal_set_size (VteTerminal *terminal
,glong columns
,glong rows
);
Attempts to change the terminal's size in terms of rows and columns. If the attempt succeeds, the widget will resize itself to the proper size.
void vte_terminal_set_font_scale (VteTerminal *terminal
,gdouble scale
);
Sets the terminal's font scale to scale
.
void vte_terminal_set_audible_bell (VteTerminal *terminal
,gboolean is_audible
);
Controls whether or not the terminal will beep when the child outputs the "bl" sequence.
gboolean
vte_terminal_get_audible_bell (VteTerminal *terminal
);
Checks whether or not the terminal will beep when the child outputs the "bl" sequence.
void vte_terminal_set_allow_bold (VteTerminal *terminal
,gboolean allow_bold
);
Controls whether or not the terminal will attempt to draw bold text, either by using a bold font variant or by repainting text with a different offset.
gboolean
vte_terminal_get_allow_bold (VteTerminal *terminal
);
Checks whether or not the terminal will attempt to draw bold text, either by using a bold font variant or by repainting text with a different offset.
void vte_terminal_set_bold_is_bright (VteTerminal *terminal
,gboolean bold_is_bright
);
Sets whether the SGR 1 attribute also switches to the bright counterpart of the first 8 palette colors, in addition to making them bold (legacy behavior) or if SGR 1 only enables bold and leaves the color intact.
Since: 0.52
gboolean
vte_terminal_get_bold_is_bright (VteTerminal *terminal
);
Checks whether the SGR 1 attribute also switches to the bright counterpart of the first 8 palette colors, in addition to making them bold (legacy behavior) or if SGR 1 only enables bold and leaves the color intact.
Since: 0.52
void vte_terminal_set_allow_hyperlink (VteTerminal *terminal
,gboolean allow_hyperlink
);
Controls whether or not hyperlinks (OSC 8 escape sequence) are allowed.
Since: 0.50
gboolean
vte_terminal_get_allow_hyperlink (VteTerminal *terminal
);
Checks whether or not hyperlinks (OSC 8 escape sequence) are allowed.
Since: 0.50
void vte_terminal_set_scroll_on_output (VteTerminal *terminal
,gboolean scroll
);
Controls whether or not the terminal will forcibly scroll to the bottom of the viewable history when the new data is received from the child.
gboolean
vte_terminal_get_scroll_on_output (VteTerminal *terminal
);
whether or not the terminal will forcibly scroll to the bottom of the viewable history when the new data is received from the child.
Since: 0.52
void vte_terminal_set_scroll_on_keystroke (VteTerminal *terminal
,gboolean scroll
);
Controls whether or not the terminal will forcibly scroll to the bottom of the viewable history when the user presses a key. Modifier keys do not trigger this behavior.
gboolean
vte_terminal_get_scroll_on_keystroke (VteTerminal *terminal
);
whether or not the terminal will forcibly scroll to the bottom of the viewable history when the user presses a key. Modifier keys do not trigger this behavior.
Since: 0.52
void vte_terminal_set_rewrap_on_resize (VteTerminal *terminal
,gboolean rewrap
);
Controls whether or not the terminal will rewrap its contents, including the scrollback history, whenever the terminal's width changes.
gboolean
vte_terminal_get_rewrap_on_resize (VteTerminal *terminal
);
Checks whether or not the terminal will rewrap its contents upon resize.
void vte_terminal_set_cell_height_scale (VteTerminal *terminal
,double scale
);
Sets the terminal's cell height scale to scale
.
This can be used to increase the line spacing. (The font's height is not affected.) Valid values go from 1.0 (default) to 2.0 ("double spacing").
Since: 0.52
double
vte_terminal_get_cell_height_scale (VteTerminal *terminal
);
Since: 0.52
void vte_terminal_set_cell_width_scale (VteTerminal *terminal
,double scale
);
Sets the terminal's cell width scale to scale
.
This can be used to increase the letter spacing. (The font's width is not affected.) Valid values go from 1.0 (default) to 2.0.
Since: 0.52
double
vte_terminal_get_cell_width_scale (VteTerminal *terminal
);
Since: 0.52
void vte_terminal_set_color_bold (VteTerminal *terminal
,const GdkRGBA *bold
);
Sets the color used to draw bold text in the default foreground color.
If bold
is NULL
then the default color is used.
void vte_terminal_set_color_foreground (VteTerminal *terminal
,const GdkRGBA *foreground
);
Sets the foreground color used to draw normal text.
void vte_terminal_set_color_background (VteTerminal *terminal
,const GdkRGBA *background
);
Sets the background color for text which does not have a specific background color assigned. Only has effect when no background image is set and when the terminal is not transparent.
void vte_terminal_set_color_cursor (VteTerminal *terminal
,const GdkRGBA *cursor_background
);
Sets the background color for text which is under the cursor. If NULL
, text
under the cursor will be drawn with foreground and background colors
reversed.
terminal |
||
cursor_background |
the new color to use for the text cursor, or |
[allow-none] |
void vte_terminal_set_color_cursor_foreground (VteTerminal *terminal
,const GdkRGBA *cursor_foreground
);
Sets the foreground color for text which is under the cursor. If NULL
, text
under the cursor will be drawn with foreground and background colors
reversed.
terminal |
||
cursor_foreground |
the new color to use for the text cursor, or |
[allow-none] |
Since: 0.44
void vte_terminal_set_color_highlight (VteTerminal *terminal
,const GdkRGBA *highlight_background
);
Sets the background color for text which is highlighted. If NULL
,
it is unset. If neither highlight background nor highlight foreground are set,
highlighted text (which is usually highlighted because it is selected) will
be drawn with foreground and background colors reversed.
terminal |
||
highlight_background |
the new color to use for highlighted text, or |
[allow-none] |
void vte_terminal_set_color_highlight_foreground (VteTerminal *terminal
,const GdkRGBA *highlight_foreground
);
Sets the foreground color for text which is highlighted. If NULL
,
it is unset. If neither highlight background nor highlight foreground are set,
highlighted text (which is usually highlighted because it is selected) will
be drawn with foreground and background colors reversed.
terminal |
||
highlight_foreground |
the new color to use for highlighted text, or |
[allow-none] |
void vte_terminal_set_colors (VteTerminal *terminal
,const GdkRGBA *foreground
,const GdkRGBA *background
,const GdkRGBA *palette
,gsize palette_size
);
palette
specifies the new values for the 256 palette colors: 8 standard colors,
their 8 bright counterparts, 6x6x6 color cube, and 24 grayscale colors.
Omitted entries will default to a hardcoded value.
palette_size
must be 0, 8, 16, 232 or 256.
If foreground
is NULL
and palette_size
is greater than 0, the new foreground
color is taken from palette
[7]. If background
is NULL
and palette_size
is
greater than 0, the new background color is taken from palette
[0].
void
vte_terminal_set_default_colors (VteTerminal *terminal
);
Reset the terminal palette to reasonable compiled-in default color.
void vte_terminal_set_cursor_shape (VteTerminal *terminal
,VteCursorShape shape
);
Sets the shape of the cursor drawn.
VteCursorShape
vte_terminal_get_cursor_shape (VteTerminal *terminal
);
Returns the currently set cursor shape.
VteCursorBlinkMode
vte_terminal_get_cursor_blink_mode (VteTerminal *terminal
);
Returns the currently set cursor blink mode.
void vte_terminal_set_cursor_blink_mode (VteTerminal *terminal
,VteCursorBlinkMode mode
);
Sets whether or not the cursor will blink. Using VTE_CURSOR_BLINK_SYSTEM
will use the “gtk-cursor-blink” setting.
VteTextBlinkMode
vte_terminal_get_text_blink_mode (VteTerminal *terminal
);
Checks whether or not the terminal will allow blinking text.
Since: 0.52
void vte_terminal_set_text_blink_mode (VteTerminal *terminal
,VteTextBlinkMode text_blink_mode
);
Controls whether or not the terminal will allow blinking text.
Since: 0.52
void vte_terminal_set_scrollback_lines (VteTerminal *terminal
,glong lines
);
Sets the length of the scrollback buffer used by the terminal. The size of the scrollback buffer will be set to the larger of this value and the number of visible rows the widget can display, so 0 can safely be used to disable scrollback.
A negative value means "infinite scrollback".
Note that this setting only affects the normal screen buffer. No scrollback is allowed on the alternate screen buffer.
glong
vte_terminal_get_scrollback_lines (VteTerminal *terminal
);
length of the scrollback buffer used by the terminal. A negative value means "infinite scrollback".
Since: 0.52
void vte_terminal_set_font (VteTerminal *terminal
,const PangoFontDescription *font_desc
);
Sets the font used for rendering all text displayed by the terminal,
overriding any fonts set using gtk_widget_modify_font()
. The terminal
will immediately attempt to load the desired font, retrieve its
metrics, and attempt to resize itself to keep the same number of rows
and columns. The font scale is applied to the specified font.
const PangoFontDescription *
vte_terminal_get_font (VteTerminal *terminal
);
Queries the terminal for information about the fonts which will be used to draw text in the terminal. The actual font takes the font scale into account, this is not reflected in the return value, the unscaled font is returned.
a PangoFontDescription describing the font the terminal uses to render text at the default font scale of 1.0.
[transfer none]
gboolean
vte_terminal_get_has_selection (VteTerminal *terminal
);
Checks if the terminal currently contains selected text. Note that this is different from determining if the terminal is the owner of any GtkClipboard items.
void vte_terminal_set_backspace_binding (VteTerminal *terminal
,VteEraseBinding binding
);
Modifies the terminal's backspace key binding, which controls what string or control sequence the terminal sends to its child when the user presses the backspace key.
void vte_terminal_set_delete_binding (VteTerminal *terminal
,VteEraseBinding binding
);
Modifies the terminal's delete key binding, which controls what string or control sequence the terminal sends to its child when the user presses the delete key.
void vte_terminal_set_mouse_autohide (VteTerminal *terminal
,gboolean setting
);
Changes the value of the terminal's mouse autohide setting. When autohiding
is enabled, the mouse cursor will be hidden when the user presses a key and
shown when the user moves the mouse. This setting can be read using
vte_terminal_get_mouse_autohide()
.
gboolean
vte_terminal_get_mouse_autohide (VteTerminal *terminal
);
Determines the value of the terminal's mouse autohide setting. When
autohiding is enabled, the mouse cursor will be hidden when the user presses
a key and shown when the user moves the mouse. This setting can be changed
using vte_terminal_set_mouse_autohide()
.
void vte_terminal_reset (VteTerminal *terminal
,gboolean clear_tabstops
,gboolean clear_history
);
Resets as much of the terminal's internal state as possible, discarding any unprocessed input data, resetting character attributes, cursor state, national character set state, status line, terminal modes (insert/delete), selection state, and encoding.
char * vte_terminal_get_text (VteTerminal *terminal
,VteSelectionFunc is_selected
,gpointer user_data
,GArray *attributes
);
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.
terminal |
||
is_selected |
a VteSelectionFunc callback. |
[scope call][allow-none] |
user_data |
user data to be passed to the callback. |
[closure] |
attributes |
location for storing text attributes. |
[out caller-allocates][transfer full][array][element-type Vte.CharAttributes] |
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
);
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.
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 VteSelectionFunc callback. |
[scope call][allow-none] |
user_data |
user data to be passed to the callback. |
[closure] |
attributes |
location for storing text attributes. |
[out caller-allocates][transfer full][array][element-type Vte.CharAttributes] |
void vte_terminal_get_cursor_position (VteTerminal *terminal
,glong *column
,glong *row
);
Reads the location of the insertion cursor and returns it. The row coordinate is absolute.
char * vte_terminal_hyperlink_check_event (VteTerminal *terminal
,GdkEvent *event
);
Returns a nonempty string: the target of the explicit hyperlink (printed using the OSC 8
escape sequence) at the position of the event, or NULL
.
Proper use of the escape sequence should result in URI-encoded URIs with a proper scheme like "http://", "https://", "file://", "mailto:" etc. This is, however, not enforced by VTE. The caller must tolerate the returned string potentially not being a valid URI.
Since: 0.50
int vte_terminal_match_add_regex (VteTerminal *terminal
,VteRegex *regex
,guint32 flags
);
Adds the regular expression regex
to the list of matching expressions. When the
user moves the mouse cursor over a section of displayed text which matches
this expression, the text will be highlighted.
Since: 0.46
void vte_terminal_match_remove (VteTerminal *terminal
,int tag
);
Removes the regular expression which is associated with the given tag
from
the list of expressions which the terminal will highlight when the user
moves the mouse cursor over matching text.
void
vte_terminal_match_remove_all (VteTerminal *terminal
);
Clears the list of regular expressions the terminal uses to highlight text when the user moves the mouse cursor.
char * vte_terminal_match_check (VteTerminal *terminal
,glong column
,glong row
,int *tag
);
vte_terminal_match_check
has been deprecated since version 0.46 and should not be used in newly-written code.
Use vte_terminal_match_check_event()
instead.
Checks if the text in and around the specified position matches any of the
regular expressions previously set using vte_terminal_match_add()
. If a
match exists, the text string is returned and if tag
is not NULL
, the number
associated with the matched regular expression will be stored in tag
.
If more than one regular expression has been set with
vte_terminal_match_add()
, then expressions are checked in the order in
which they were added.
terminal |
||
column |
the text column |
|
row |
the text row |
|
tag |
a location to store the tag, or |
[out][allow-none] |
char * vte_terminal_match_check_event (VteTerminal *terminal
,GdkEvent *event
,int *tag
);
Checks if the text in and around the position of the event matches any of the
regular expressions previously set using vte_terminal_match_add()
. If a
match exists, the text string is returned and if tag
is not NULL
, the number
associated with the matched regular expression will be stored in tag
.
If more than one regular expression has been set with
vte_terminal_match_add()
, then expressions are checked in the order in
which they were added.
void vte_terminal_match_set_cursor_name (VteTerminal *terminal
,int tag
,const char *cursor_name
);
Sets which cursor the terminal will use if the pointer is over the pattern
specified by tag
.
void vte_terminal_set_cjk_ambiguous_width (VteTerminal *terminal
,int width
);
This setting controls whether ambiguous-width characters are narrow or wide.
(Note that when using a non-UTF-8 encoding set via vte_terminal_set_encoding()
,
the width of ambiguous-width characters is fixed and determined by the encoding
itself.)
int
vte_terminal_get_cjk_ambiguous_width (VteTerminal *terminal
);
Returns whether ambiguous-width characters are narrow or wide.
(Note that when using a non-UTF-8 encoding set via vte_terminal_set_encoding()
,
the width of ambiguous-width characters is fixed and determined by the encoding
itself.)
void vte_terminal_set_word_char_exceptions (VteTerminal *terminal
,const char *exceptions
);
With this function you can provide a set of characters which will be considered parts of a word when doing word-wise selection, in addition to the default which only considers alphanumeric characters part of a word.
The characters in exceptions
must be non-alphanumeric, each character
must occur only once, and if exceptions
contains the character
U+002D HYPHEN-MINUS, it must be at the start of the string.
Use NULL
to reset the set of exception characters to the default.
Since: 0.40
const char *
vte_terminal_get_word_char_exceptions (VteTerminal *terminal
);
Returns the set of characters which will be considered parts of a word when doing word-wise selection, in addition to the default which only considers alphanumeric characters part of a word.
If NULL
, a built-in set is used.
Since: 0.40
void vte_terminal_set_input_enabled (VteTerminal *terminal
,gboolean enabled
);
Enables or disables user input. When user input is disabled, the terminal's child will not receive any key press, or mouse button press or motion events sent to it.
gboolean
vte_terminal_get_input_enabled (VteTerminal *terminal
);
Returns whether the terminal allow user input.
gboolean vte_terminal_write_contents_sync (VteTerminal *terminal
,GOutputStream *stream
,VteWriteFlags flags
,GCancellable *cancellable
,GError **error
);
Write contents of the current contents of terminal
(including any
scrollback history) to stream
according to flags
.
If cancellable
is not NULL
, then the operation can be cancelled by triggering
the cancellable object from another thread. If the operation was cancelled,
the error G_IO_ERROR_CANCELLED
will be returned in error
.
This is a synchronous operation and will make the widget (and input
processing) during the write operation, which may take a long time
depending on scrollback history and stream
availability for writing.
terminal |
||
stream |
a GOutputStream to write to |
|
flags |
a set of VteWriteFlags |
|
cancellable |
a GCancellable object, or |
[allow-none] |
error |
[allow-none] |
gboolean
vte_terminal_search_find_next (VteTerminal *terminal
);
Searches the next string matching the search regex set with
vte_terminal_search_set_regex()
.
gboolean
vte_terminal_search_find_previous (VteTerminal *terminal
);
Searches the previous string matching the search regex set with
vte_terminal_search_set_regex()
.
VteRegex *
vte_terminal_search_get_regex (VteTerminal *terminal
);
Since: 0.46
gboolean
vte_terminal_search_get_wrap_around (VteTerminal *terminal
);
void vte_terminal_search_set_regex (VteTerminal *terminal
,VteRegex *regex
,guint32 flags
);
Sets the regex to search for. Unsets the search regex when passed NULL
.
Since: 0.46
void vte_terminal_search_set_wrap_around (VteTerminal *terminal
,gboolean wrap_around
);
Sets whether search should wrap around to the beginning of the terminal content when reaching its end.
gboolean vte_terminal_event_check_regex_simple (VteTerminal *terminal
,GdkEvent *event
,VteRegex **regexes
,gsize n_regexes
,guint32 match_flags
,char **matches
);
Checks each regex in regexes
if the text in and around the position of
the event matches the regular expressions. If a match exists, the matched
text is stored in matches
at the position of the regex in regexes
; otherwise
NULL
is stored there.
Since: 0.46
char *
vte_get_user_shell (void
);
Gets the user's shell, or NULL
. In the latter case, the
system default (usually "/bin/sh") should be used.
const char *
vte_get_features (void
);
Gets a list of features vte was compiled with.
Since: 0.40
void (*VteTerminalSpawnAsyncCallback) (VteTerminal *terminal
,GPid pid
,GError *error
,gpointer user_data
);
Callback for vte_terminal_spawn_async()
.
On success, pid
contains the PID of the spawned process, and error
is NULL
.
On failure, pid
is -1 and error
contains the error information.
terminal |
the VteTerminal |
|
pid |
a GPid |
|
error |
||
user_data |
user data that was passed to vte_terminal_spawn_async |
Since: 0.48
void vte_terminal_spawn_async (VteTerminal *terminal
,VtePtyFlags pty_flags
,const char *working_directory
,char **argv
,char **envv
,GSpawnFlags spawn_flags_
,GSpawnChildSetupFunc child_setup
,gpointer child_setup_data
,GDestroyNotify child_setup_data_destroy
,int timeout
,GCancellable *cancellable
,VteTerminalSpawnAsyncCallback callback
,gpointer user_data
);
A convenience function that wraps creating the VtePty and spawning
the child process on it. See vte_pty_new_sync()
, vte_pty_spawn_async()
,
and vte_pty_spawn_finish()
for more information.
When the operation is finished successfully, callback
will be called
with the child GPid, and a NULL
GError. The child PID will already be
watched via vte_terminal_watch_child()
.
When the operation fails, callback
will be called with a -1 GPid,
and a non-NULL
GError containing the error information.
Note that if terminal
has been destroyed before the operation is called,
callback
will be called with a NULL
terminal
; you must not do anything
in the callback besides freeing any resources associated with user_data
,
but taking care not to access the now-destroyed VteTerminal. Note that
in this case, if spawning was successful, the child process will be aborted
automatically.
Beginning with 0.52, sets PWD to working_directory
in order to preserve symlink components.
The caller should also make sure that symlinks were preserved while constructing the value of working_directory
,
e.g. by using vte_terminal_get_current_directory_uri()
, g_get_current_dir()
or get_current_dir_name()
.
terminal |
||
pty_flags |
flags from VtePtyFlags |
|
working_directory |
the name of a directory the command should start
in, or |
[allow-none] |
argv |
child's argument vector. |
[array zero-terminated=1][element-type filename] |
envv |
a list of environment
variables to be added to the environment before starting the process, or |
[allow-none][array zero-terminated=1][element-type filename] |
spawn_flags_ |
flags from GSpawnFlags |
|
child_setup |
an extra child setup function to run in the child just before |
[allow-none][scope async] |
child_setup_data |
user data for |
[closure child_setup] |
child_setup_data_destroy |
a GDestroyNotify for |
[destroy child_setup_data] |
timeout |
a timeout value in ms, or -1 to wait indefinitely |
|
cancellable |
a GCancellable, or |
[allow-none] |
callback |
||
user_data |
user data for |
Since: 0.48
VtePty *
vte_terminal_get_pty (VteTerminal *terminal
);
Returns the VtePty of terminal
.
void vte_terminal_set_pty (VteTerminal *terminal
,VtePty *pty
);
Sets pty
as the PTY to use in terminal
.
Use NULL
to unset the PTY.
VtePty * vte_terminal_pty_new_sync (VteTerminal *terminal
,VtePtyFlags flags
,GCancellable *cancellable
,GError **error
);
Creates a new VtePty, and sets the emulation property from “emulation”.
See vte_pty_new()
for more information.
terminal |
||
flags |
flags from VtePtyFlags |
|
cancellable |
a GCancellable, or |
[allow-none] |
error |
[allow-none] |
void vte_terminal_watch_child (VteTerminal *terminal
,GPid child_pid
);
Watches child_pid
. When the process exists, the “child-exited”
signal will be called with the child's exit status.
Prior to calling this function, a VtePty must have been set in terminal
using vte_terminal_set_pty()
.
When the child exits, the terminal's VtePty will be set to NULL
.
Note: g_child_watch_add()
or g_child_watch_add_full()
must not have
been called for child_pid
, nor a GSource for it been created with
g_child_watch_source_new()
.
Note: when using the g_spawn_async()
family of functions,
the G_SPAWN_DO_NOT_REAP_CHILD
flag MUST have been passed.
void vte_terminal_set_clear_background (VteTerminal *terminal
,gboolean setting
);
Sets whether to paint the background with the background colour.
The default is TRUE
.
This function is rarely useful. One use for it is to add a background image to the terminal.
Since: 0.52
void vte_terminal_get_color_background_for_draw (VteTerminal *terminal
,GdkRGBA *color
);
Returns the background colour, as used by terminal
when
drawing the background, which may be different from
the color set by vte_terminal_set_color_background()
.
Note: you must only call this function while handling the GtkWidget::draw signal.
This function is rarely useful. One use for it is if you disable
drawing the background (see vte_terminal_set_clear_background()
)
and then need to draw the background yourself.
Since: 0.54
const char *
vte_terminal_get_window_title (VteTerminal *terminal
);
const char *
vte_terminal_get_current_directory_uri
(VteTerminal *terminal
);
the URI of the current directory of the
process running in the terminal, or NULL
.
[nullable][transfer none]
const char *
vte_terminal_get_current_file_uri (VteTerminal *terminal
);
the URI of the current file the
process running in the terminal is operating on, or NULL
if
not set.
[nullable][transfer none]
void
vte_terminal_copy_clipboard (VteTerminal *terminal
);
vte_terminal_copy_clipboard
has been deprecated since version 0.50 and should not be used in newly-written code.
Use vte_terminal_copy_clipboard_format()
with VTE_FORMAT_TEXT
instead.
Places the selected text in the terminal in the GDK_SELECTION_CLIPBOARD selection.
void vte_terminal_match_set_cursor (VteTerminal *terminal
,int tag
,GdkCursor *cursor
);
vte_terminal_match_set_cursor
has been deprecated since version 0.40 and should not be used in newly-written code.
Use vte_terminal_match_set_cursor_name()
instead.
Sets which cursor the terminal will use if the pointer is over the pattern
specified by tag
. The terminal keeps a reference to cursor
.
void vte_terminal_match_set_cursor_type (VteTerminal *terminal
,int tag
,GdkCursorType cursor_type
);
vte_terminal_match_set_cursor_type
has been deprecated since version 0.54 and should not be used in newly-written code.
Use vte_terminal_match_set_cursor_name()
instead.
Sets which cursor the terminal will use if the pointer is over the pattern
specified by tag
.
int vte_terminal_match_add_gregex (VteTerminal *terminal
,GRegex *gregex
,GRegexMatchFlags gflags
);
vte_terminal_match_add_gregex
has been deprecated since version 0.46 and should not be used in newly-written code.
Use vte_terminal_match_add_regex()
or vte_terminal_match_add_regex_full()
instead.
Adds the regular expression regex
to the list of matching expressions. When the
user moves the mouse cursor over a section of displayed text which matches
this expression, the text will be highlighted.
an integer associated with this expression, or -1 if gregex
could not be
transformed into a VteRegex or gflags
were incompatible
GRegex *
vte_terminal_search_get_gregex (VteTerminal *terminal
);
vte_terminal_search_get_gregex
has been deprecated since version 0.46 and should not be used in newly-written code.
use vte_terminal_search_get_regex()
instead.
void vte_terminal_search_set_gregex (VteTerminal *terminal
,GRegex *gregex
,GRegexMatchFlags gflags
);
vte_terminal_search_set_gregex
has been deprecated since version 0.46 and should not be used in newly-written code.
use vte_terminal_search_set_regex()
instead.
Sets the GRegex regex to search for. Unsets the search regex when passed NULL
.
gboolean vte_terminal_event_check_gregex_simple (VteTerminal *terminal
,GdkEvent *event
,GRegex **regexes
,gsize n_regexes
,GRegexMatchFlags match_flags
,char **matches
);
vte_terminal_event_check_gregex_simple
has been deprecated since version 0.46 and should not be used in newly-written code.
Use vte_terminal_event_check_regex_simple()
instead.
This function does nothing.
terminal |
||
event |
a GdkEvent |
|
regexes |
an array of GRegex. |
[array length=n_regexes] |
n_regexes |
number of items in |
|
match_flags |
the GRegexMatchFlags to use when matching the regexes |
|
matches |
a location to store the matches. |
[out caller-allocates][array length=n_regexes] |
Since: 0.44
gboolean vte_terminal_spawn_sync (VteTerminal *terminal
,VtePtyFlags pty_flags
,const char *working_directory
,char **argv
,char **envv
,GSpawnFlags spawn_flags
,GSpawnChildSetupFunc child_setup
,gpointer child_setup_data
,GPid *child_pid
,GCancellable *cancellable
,GError **error
);
vte_terminal_spawn_sync
has been deprecated since version 0.48 and should not be used in newly-written code.
Use vte_terminal_spawn_async()
instead.
Starts the specified command under a newly-allocated controlling
pseudo-terminal. The argv
and envv
lists should be NULL
-terminated.
The "TERM" environment variable is automatically set to a default value,
but can be overridden from envv
.
pty_flags
controls logging the session to the specified system log files.
Note that G_SPAWN_DO_NOT_REAP_CHILD
will always be added to spawn_flags
.
Note that all open file descriptors will be closed in the child. If you want to keep some file descriptor open for use in the child process, you need to use a child setup function that unsets the FD_CLOEXEC flag on that file descriptor.
See vte_pty_new()
, g_spawn_async()
and vte_terminal_watch_child()
for more information.
Beginning with 0.52, sets PWD to working_directory
in order to preserve symlink components.
The caller should also make sure that symlinks were preserved while constructing the value of working_directory
,
e.g. by using vte_terminal_get_current_directory_uri()
, g_get_current_dir()
or get_current_dir_name()
.
terminal |
||
pty_flags |
flags from VtePtyFlags |
|
working_directory |
the name of a directory the command should start
in, or |
[allow-none] |
argv |
child's argument vector. |
[array zero-terminated=1][element-type filename] |
envv |
a list of environment
variables to be added to the environment before starting the process, or |
[allow-none][array zero-terminated=1][element-type filename] |
spawn_flags |
flags from GSpawnFlags |
|
child_setup |
an extra child setup function to run in the child just before |
[allow-none][scope call] |
child_setup_data |
user data for |
|
child_pid |
a location to store the child PID, or |
[out][allow-none][transfer full] |
cancellable |
a GCancellable, or |
[allow-none] |
error |
[allow-none] |
void vte_terminal_get_geometry_hints (VteTerminal *terminal
,GdkGeometry *hints
,int min_rows
,int min_columns
);
vte_terminal_get_geometry_hints
has been deprecated since version 0.52 and should not be used in newly-written code.
Fills in some hints
from terminal
's geometry. The hints
filled are those covered by the GDK_HINT_RESIZE_INC
,
GDK_HINT_MIN_SIZE
and GDK_HINT_BASE_SIZE
flags.
See gtk_window_set_geometry_hints()
for more information.
terminal
must be realized (see gtk_widget_get_realized()
).
terminal |
||
hints |
a GdkGeometry to fill in. |
[out caller-allocates] |
min_rows |
the minimum number of rows to request |
|
min_columns |
the minimum number of columns to request |
void vte_terminal_set_geometry_hints_for_window (VteTerminal *terminal
,GtkWindow *window
);
vte_terminal_set_geometry_hints_for_window
has been deprecated since version 0.52 and should not be used in newly-written code.
Sets terminal
as window
's geometry widget. See
gtk_window_set_geometry_hints()
for more information.
terminal
must be realized (see gtk_widget_get_realized()
).
const char *
vte_terminal_get_icon_title (VteTerminal *terminal
);
vte_terminal_get_icon_title
has been deprecated since version 0.54 and should not be used in newly-written code.
gboolean vte_terminal_set_encoding (VteTerminal *terminal
,const char *codeset
,GError **error
);
vte_terminal_set_encoding
has been deprecated since version 0.54 and should not be used in newly-written code.
Support for non-UTF-8 is deprecated.
Changes the encoding the terminal will expect data from the child to
be encoded with. For certain terminal types, applications executing in the
terminal can change the encoding. If codeset
is NULL
, it uses "UTF-8".
Note: Support for non-UTF-8 is deprecated and may get removed altogether. Instead of this function, you should use a wrapper like luit(1) when spawning the child process.
TRUE
if the encoding could be changed to the specified one,
or FALSE
with error
set to G_CONVERT_ERROR_NO_CONVERSION
.
const char *
vte_terminal_get_encoding (VteTerminal *terminal
);
vte_terminal_get_encoding
has been deprecated since version 0.54 and should not be used in newly-written code.
Support for non-UTF-8 is deprecated.
Determines the name of the encoding in which the terminal expects data to be
encoded, or NULL
if UTF-8 is in use.
char * vte_terminal_get_text_include_trailing_spaces (VteTerminal *terminal
,VteSelectionFunc is_selected
,gpointer user_data
,GArray *attributes
);
vte_terminal_get_text_include_trailing_spaces
has been deprecated since version 0.56 and should not be used in newly-written code.
Use vte_terminal_get_text()
instead.
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.
terminal |
||
is_selected |
a VteSelectionFunc callback. |
[scope call][allow-none] |
user_data |
user data to be passed to the callback. |
[closure] |
attributes |
location for storing text attributes. |
[out caller-allocates][transfer full][array][element-type Vte.CharAttributes] |
An enumerated type which can be used to indicate the cursor blink mode for the terminal.
An enumerated type which can be used to indicate what should the terminal draw at the cursor position.
An enumerated type which can be used to indicate which string the terminal should send to an application when the user presses the Delete or Backspace keys.
An enumerated type which can be used to indicate whether the terminal allows the text contents to be blinked.
Since: 0.52
An enumeratio type that can be used to specify the format the selection should be copied to the clipboard in.
Since: 0.50
“allow-bold”
property“allow-bold” gboolean
Controls whether or not the terminal will attempt to draw bold text. This may happen either by using a bold font variant, or by repainting text with a different offset.
Flags: Read / Write
Default value: TRUE
“allow-hyperlink”
property“allow-hyperlink” gboolean
Controls whether or not hyperlinks (OSC 8 escape sequence) are recognized and displayed.
Flags: Read / Write
Default value: FALSE
Since: 0.50
“audible-bell”
property“audible-bell” gboolean
Controls whether or not the terminal will beep when the child outputs the "bl" sequence.
Flags: Read / Write
Default value: TRUE
“backspace-binding”
property“backspace-binding” VteEraseBinding
Controls what string or control sequence the terminal sends to its child when the user presses the backspace key.
Flags: Read / Write
Default value: VTE_ERASE_AUTO
“bold-is-bright”
property“bold-is-bright” gboolean
Whether the SGR 1 attribute also switches to the bright counterpart of the first 8 palette colors, in addition to making them bold (legacy behavior) or if SGR 1 only enables bold and leaves the color intact.
Flags: Read / Write
Default value: FALSE
Since: 0.52
“cell-height-scale”
property“cell-height-scale” gdouble
Scale factor for the cell height, to increase line spacing. (The font's height is not affected.)
Flags: Read / Write
Allowed values: [1,2]
Default value: 1
Since: 0.52
“cell-width-scale”
property“cell-width-scale” gdouble
Scale factor for the cell width, to increase letter spacing. (The font's width is not affected.)
Flags: Read / Write
Allowed values: [1,2]
Default value: 1
Since: 0.52
“cjk-ambiguous-width”
property“cjk-ambiguous-width” gint
This setting controls whether ambiguous-width characters are narrow or wide.
(Note that when using a non-UTF-8 encoding set via vte_terminal_set_encoding()
,
the width of ambiguous-width characters is fixed and determined by the encoding
itself.)
This setting only takes effect the next time the terminal is reset, either
via escape sequence or with vte_terminal_reset()
.
Flags: Read / Write
Allowed values: [1,2]
Default value: 1
“current-directory-uri”
property“current-directory-uri” gchar *
The current directory URI, or NULL
if unset.
Flags: Read
Default value: NULL
“current-file-uri”
property“current-file-uri” gchar *
The current file URI, or NULL
if unset.
Flags: Read
Default value: NULL
“cursor-blink-mode”
property“cursor-blink-mode” VteCursorBlinkMode
Sets whether or not the cursor will blink. Using VTE_CURSOR_BLINK_SYSTEM
will use the “gtk-cursor-blink” setting.
Flags: Read / Write
Default value: VTE_CURSOR_BLINK_SYSTEM
“cursor-shape”
property“cursor-shape” VteCursorShape
Controls the shape of the cursor.
Flags: Read / Write
Default value: VTE_CURSOR_SHAPE_BLOCK
“delete-binding”
property“delete-binding” VteEraseBinding
Controls what string or control sequence the terminal sends to its child when the user presses the delete key.
Flags: Read / Write
Default value: VTE_ERASE_AUTO
“encoding”
property“encoding” gchar *
Controls the encoding the terminal will expect data from the child to be encoded with. For certain terminal types, applications executing in the terminal can change the encoding. The default is defined by the application's locale settings.
VteTerminal:encoding
has been deprecated since version 0.54 and should not be used in newly-written code.
Instead of using this, you should use a tool like luit(1) when support for non-UTF-8 is required
Flags: Read / Write
Default value: NULL
“font-desc”
property“font-desc” PangoFontDescription *
Specifies the font used for rendering all text displayed by the terminal,
overriding any fonts set using gtk_widget_modify_font()
. The terminal
will immediately attempt to load the desired font, retrieve its
metrics, and attempt to resize itself to keep the same number of rows
and columns.
Flags: Read / Write
“font-scale”
property“font-scale” gdouble
The terminal's font scale.
Flags: Read / Write
Allowed values: [0.25,4]
Default value: 1
“hyperlink-hover-uri”
property“hyperlink-hover-uri” gchar *
The currently hovered hyperlink URI, or NULL
if unset.
Flags: Read
Default value: NULL
Since: 0.50
“icon-title”
property“icon-title” gchar *
VteTerminal:icon-title
has been deprecated since version 0.54 and should not be used in newly-written code.
This property is always NULL
.
Flags: Read
Default value: NULL
“input-enabled”
property“input-enabled” gboolean
Controls whether the terminal allows user input. When user input is disabled, key press and mouse button press and motion events are not sent to the terminal's child.
Flags: Read / Write
Default value: TRUE
“pointer-autohide”
property“pointer-autohide” gboolean
Controls the value of the terminal's mouse autohide setting. When autohiding is enabled, the mouse cursor will be hidden when the user presses a key and shown when the user moves the mouse.
Flags: Read / Write
Default value: FALSE
“rewrap-on-resize”
property“rewrap-on-resize” gboolean
Controls whether or not the terminal will rewrap its contents, including the scrollback buffer, whenever the terminal's width changes.
Flags: Read / Write
Default value: TRUE
“scroll-on-keystroke”
property“scroll-on-keystroke” gboolean
Controls whether or not the terminal will forcibly scroll to the bottom of the viewable history when the user presses a key. Modifier keys do not trigger this behavior.
Flags: Read / Write
Default value: FALSE
“scroll-on-output”
property“scroll-on-output” gboolean
Controls whether or not the terminal will forcibly scroll to the bottom of the viewable history when the new data is received from the child.
Flags: Read / Write
Default value: TRUE
“scrollback-lines”
property“scrollback-lines” guint
The length of the scrollback buffer used by the terminal. The size of the scrollback buffer will be set to the larger of this value and the number of visible rows the widget can display, so 0 can safely be used to disable scrollback. Note that this setting only affects the normal screen buffer. For terminal types which have an alternate screen buffer, no scrollback is allowed on the alternate screen buffer.
Flags: Read / Write
Default value: 512
“text-blink-mode”
property“text-blink-mode” VteTextBlinkMode
Controls whether or not the terminal will allow blinking text.
Flags: Read / Write
Default value: VTE_TEXT_BLINK_ALWAYS
Since: 0.52
“window-title”
property“window-title” gchar *
The terminal's title.
Flags: Read
Default value: NULL
“word-char-exceptions”
property“word-char-exceptions” gchar *
The set of characters which will be considered parts of a word when doing word-wise selection, in addition to the default which only considers alphanumeric characters part of a word.
If NULL
, a built-in set is used.
Flags: Read
Default value: NULL
Since: 0.40
“bell”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
This signal is emitted when the a child sends a bell request to the terminal.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“char-size-changed”
signalvoid user_function (VteTerminal *vteterminal, guint width, guint height, gpointer user_data)
Emitted whenever the cell size changes, e.g. due to a change in font, font-scale or cell-width/height-scale.
Note that this signal should rather be called "cell-size-changed".
vteterminal |
the object which received the signal |
|
width |
the new character cell width |
|
height |
the new character cell height |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“child-exited”
signalvoid user_function (VteTerminal *vteterminal, gint status, gpointer user_data)
This signal is emitted when the terminal detects that a child
watched using vte_terminal_watch_child()
has exited.
vteterminal |
the object which received the signal |
|
status |
the child's exit status |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“commit”
signalvoid user_function (VteTerminal *vteterminal, gchar *text, guint size, gpointer user_data)
Emitted whenever the terminal receives input from the user and prepares to send it to the child process. The signal is emitted even when there is no child process.
vteterminal |
the object which received the signal |
|
text |
a string of text |
|
size |
the length of that string of text |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“contents-changed”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted whenever the visible appearance of the terminal has changed. Used primarily by VteTerminalAccessible.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“copy-clipboard”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted whenever vte_terminal_copy_clipboard()
is called.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Action
“current-directory-uri-changed”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted when the current directory URI is modified.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“current-file-uri-changed”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted when the current file URI is modified.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“cursor-moved”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted whenever the cursor moves to a new character cell. Used primarily by VteTerminalAccessible.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“decrease-font-size”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted when the user hits the '-' key while holding the Control key.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“deiconify-window”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“encoding-changed”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted whenever the terminal's current encoding has changed.
Note: support for non-UTF-8 is deprecated.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“eof”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted when the terminal receives an end-of-file from a child which is running in the terminal. This signal is frequently (but not always) emitted with a “child-exited” signal.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“hyperlink-hover-uri-changed”
signalvoid user_function (VteTerminal *vteterminal, gchar *uri, GdkRectangle *bbox, gpointer user_data)
Emitted when the hovered hyperlink changes.
uri
and bbox
are owned by VTE, must not be modified, and might
change after the signal handlers returns.
The signal is not re-emitted when the bounding box changes for the same hyperlink. This might change in a future VTE version without notice.
vteterminal |
the object which received the signal |
|
uri |
the nonempty target URI under the mouse, or NULL |
|
bbox |
the bounding box of the hyperlink anchor text, or NULL |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 0.50
“icon-title-changed”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
VteTerminal::icon-title-changed
has been deprecated since version 0.54 and should not be used in newly-written code.
This signal is never emitted.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“iconify-window”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“increase-font-size”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted when the user hits the '+' key while holding the Control key.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“lower-window”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“maximize-window”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“move-window”
signalvoid user_function (VteTerminal *vteterminal, guint x, guint y, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
x |
the terminal's desired location, X coordinate |
|
y |
the terminal's desired location, Y coordinate |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“paste-clipboard”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted whenever vte_terminal_paste_clipboard()
is called.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Action
“raise-window”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“refresh-window”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“resize-window”
signalvoid user_function (VteTerminal *vteterminal, guint width, guint height, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
width |
the desired number of columns |
|
height |
the desired number of rows |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“restore-window”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted at the child application's request.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“selection-changed”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted whenever the contents of terminal's selection changes.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“text-deleted”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
An internal signal used for communication between the terminal and its accessibility peer. May not be emitted under certain circumstances.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“text-inserted”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
An internal signal used for communication between the terminal and its accessibility peer. May not be emitted under certain circumstances.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“text-modified”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
An internal signal used for communication between the terminal and its accessibility peer. May not be emitted under certain circumstances.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“text-scrolled”
signalvoid user_function (VteTerminal *vteterminal, gint delta, gpointer user_data)
An internal signal used for communication between the terminal and its accessibility peer. May not be emitted under certain circumstances.
vteterminal |
the object which received the signal |
|
delta |
the number of lines scrolled |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“window-title-changed”
signalvoid user_function (VteTerminal *vteterminal, gpointer user_data)
Emitted when the terminal's window_title
field is modified.
vteterminal |
the object which received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last