Namespace

Vte – 3.91

Virtual TErminal widget

Version0.77.91
AuthorsVTE developers
LicenseLGPL-3.0-or-later
Websitehttps://wiki.gnome.org/Apps/Terminal
Sourcehttps://gitlab.gnome.org/GNOME/vte/

Build

C headersvte/vte.h
pkg-config filesvte-2.91-gtk4

Dependencies

GObject—2.0 The GObject 2.0 toolkit
Browse documentation
Pango—1.0 The Pango 1.0 toolkit
Browse documentation
Graphene—1.0 The GSK 1.0 toolkit
Browse documentation

Additional documentation

Classes

Pty

unstable since: 3.91

Terminal

unstable since: 3.91

Structs

CharAttributes

unstable deprecated: 0.68 since: 3.91

EventContext

Provides context information for a context menu event.

since: 0.76

Regex

unstable since: 3.91

Uuid

unstable since: 3.91

Enumerations

Align

An enumeration type that can be used to specify how the terminal uses extra allocated space.

since: 0.76

CursorBlinkMode

An enumerated type which can be used to indicate the cursor blink mode for the terminal.

unstable since: 3.91

CursorShape

An enumerated type which can be used to indicate what should the terminal draw at the cursor position.

unstable since: 3.91

EraseBinding

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.

unstable since: 3.91

Format

An enumeration type that can be used to specify the format the selection should be copied to the clipboard in.

since: 0.50

PropertyId

An enum containing the IDs of the always-installed termprops.

unstable since: 0.78

PropertyType

An enumeration type describing types of properties.

unstable since: 0.78

TextBlinkMode

An enumerated type which can be used to indicate whether the terminal allows the text contents to be blinked.

since: 0.52

WriteFlags

A flag type to determine how terminal contents should be written to an output stream.

unstable since: 3.91

Bitfields

FeatureFlags

An enumeration type for features.

since: 0.62

PropertyFlags

A flags type.

unstable since: 0.78

PtyFlags

unstable since: 3.91

UuidFormat

unstable since: 3.91

Error Domains

PtyError

unstable since: 3.91

RegexError

An enum type for regex errors. In addition to the values listed above, any PCRE2 error values may occur.

since: 0.46

Callbacks

SelectionFunc

Specifies the type of a selection function used to check whether a cell has to be selected or not.

unstable deprecated: 0.76 since: 3.91

TerminalSpawnAsyncCallback

Callback for vte_terminal_spawn_async().

since: 0.48

Functions

event_context_get_type

unstable since: 3.91

get_encoding_supported

Queries whether the legacy encoding encoding is supported.

deprecated: 0.60 since: 0.60

get_encodings

Gets the list of supported legacy encodings.

deprecated: 0.60 since: 0.60

get_feature_flags

Gets features VTE was compiled with.

since: 0.62

get_features

Gets a list of features vte was compiled with.

since: 0.40

get_major_version

Returns the major version of the VTE library at runtime. Contrast this with VTE_MAJOR_VERSION which represents the version of the VTE library that the code was compiled with.

since: 0.40

get_micro_version

Returns the micro version of the VTE library at runtime. Contrast this with VTE_MICRO_VERSION which represents the version of the VTE library that the code was compiled with.

since: 0.40

get_minor_version

Returns the minor version of the VTE library at runtime. Contrast this with VTE_MINOR_VERSION which represents the version of the VTE library that the code was compiled with.

since: 0.40

get_termprops

Gets the names of the installed termprops in an unspecified order.

unstable since: 0.78

get_test_flags

Gets the test flags; see vte_set_test_flags() for more information. Note that on non-debug builds, this always returns 0.

unstable since: 0.78

get_user_shell

Gets the user’s shell, or NULL. In the latter case, the system default (usually “/bin/sh”) should be used.

unstable since: 3.91

install_termprop

Installs a new terminal property that can be set by the application.

unstable since: 0.78

install_termprop_alias

Installs a new terminal property name as an alias for the terminal property target_name.

unstable since: 0.78

query_termprop

Gets the property type of the termprop. For properties installed by vte_install_termprop(), the name starts with “vte.ext.”.

unstable since: 0.78

query_termprop_by_id

Like vte_query_termprop() except that it takes the termprop by ID. See that function for more information.

unstable since: 0.78

set_test_flags

Sets test flags. This function is only useful for implementing unit tests for vte itself; it is a no-op in non-debug builds.

since: 0.54

Function Macros

CHECK_VERSION

Macro to check the library version at compile time. It returns 1 if the version of VTE is greater or equal to the required one, and 0 otherwise.

unstable since: 3.91

Constants

MAJOR_VERSION

The major version number of the VTE library (e.g. in version 3.1.4 this is 3).

unstable since: 3.91

MICRO_VERSION

The micro version number of the VTE library (e.g. in version 3.1.4 this is 4).

unstable since: 3.91

MINOR_VERSION

The minor version number of the VTE library (e.g. in version 3.1.4 this is 1).

unstable since: 3.91

REGEX_FLAGS_DEFAULT

unstable since: 3.91

SPAWN_NO_PARENT_ENVV

Use this as a spawn flag (together with flags from GSpawnFlags) in vte_pty_spawn_async().

unstable since: 3.91

SPAWN_NO_SYSTEMD_SCOPE

Use this as a spawn flag (together with flags from GSpawnFlags) in vte_pty_spawn_async().

unstable since: 3.91

SPAWN_REQUIRE_SYSTEMD_SCOPE

Use this as a spawn flag (together with flags from GSpawnFlags) in vte_pty_spawn_async().

unstable since: 3.91

TERMPROP_CONTAINER_NAME

A VTE_PROPERTY_STRING termprop that stores the name of the container.

unstable since: 3.91

TERMPROP_CONTAINER_RUNTIME

A VTE_PROPERTY_STRING termprop that stores the runtime of the container.

unstable since: 3.91

TERMPROP_CONTAINER_UID

A VTE_PROPERTY_UINT termprop that stores the user ID of the container.

unstable since: 3.91

TERMPROP_CURRENT_DIRECTORY_URI

A VTE_PROPERTY_URI termprop that stores the current directory URI as set by OSC 7. Use this with vte_terminal_ref_termprop_uri() instead of using vte_terminal_get_current_directory_uri().

unstable since: 3.91

TERMPROP_CURRENT_FILE_URI

A VTE_PROPERTY_URI termprop that stores the current file URI as set by OSC 6. Use this with vte_terminal_ref_termprop_uri() instead of using vte_terminal_get_current_file_uri().

unstable since: 3.91

TERMPROP_NAME_PREFIX

The string prefix that any termprop’s name must start with to be installed by vte_install_termprop().

unstable since: 3.91

TERMPROP_SHELL_POSTEXEC

A VTE_PROPERTY_VALUELESS termprop that signals that the shell has executed the commands entered at the prompt and these commands have returned.

unstable since: 3.91

TERMPROP_SHELL_PRECMD

A VTE_PROPERTY_VALUELESS termprop that signals that the shell is going to prompt.

unstable since: 3.91

TERMPROP_SHELL_PREEXEC

A VTE_PROPERTY_VALUELESS termprop that signals that the shell is preparing to execute the command entered at the prompt.

unstable since: 3.91

TERMPROP_XTERM_TITLE

A VTE_PROPERTY_STRING termprop that stores the xterm window title as set by OSC 0 and OSC 2. Use this with vte_terminal_get_termprop_string() instead of using vte_terminal_get_window_title().

unstable since: 3.91

TEST_FLAGS_ALL

unstable since: 3.91

TEST_FLAGS_NONE

unstable since: 3.91