### Namespace

# Vte – 2.91

Virtual TErminal widget

Version | 0.80.1
Authors | VTE developers
License | LGPL-3.0-or-later
Website | https://wiki.gnome.org/Apps/Terminal
Source | https://gitlab.gnome.org/GNOME/vte/

#### Build

C headers | `vte/vte.h`
pkg-config files | `vte-2.91`

#### Dependencies

GObject—2.0 | The GObject 2.0 toolkit
| Browse documentation
Pango—1.0 | The Pango 1.0 toolkit
| Browse documentation

#### Additional documentation

- Classes Hierarchy

#### Classes

Pty |
Terminal |

#### Structs

CharAttributes | deprecated: 0.68
EventContext | Provides context information for a context menu event. since: 0.76
Regex |
Uuid |

#### 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.
CursorShape | An enumerated type which can be used to indicate what should the terminal draw at the cursor position.
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.
Format | An enumeration type that can be used to specify the format the selection should be copied to the clipboard in. since: 0.50
ProgressHint | An enum describing how to interpret progress state, for the `VTE_TERMPROP_PROGRESS_HINT` termprop. since: 0.80
PropertyId | An enum containing the IDs of the always-installed termprops. since: 0.78
PropertyType | An enumeration type describing types of properties. 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.

#### Bitfields

FeatureFlags | An enumeration type for features. since: 0.62
PropertyFlags | A flags type. since: 0.78
PtyFlags |
UuidFormat |

#### Error Domains

PtyError |
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. deprecated: 0.76
TerminalSpawnAsyncCallback | Callback for vte_terminal_spawn_async(). since: 0.48

#### Functions

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. 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. 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.
install_termprop | Installs a new terminal property that can be set by the application. since: 0.78
install_termprop_alias | Installs a new terminal property `name` as an alias for the terminal property `target_name`. 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.”. 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. 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 <literal>1</literal> if the version of VTE is greater or equal to the required one, and <literal>0</literal> otherwise.

#### Constants

MAJOR_VERSION | The major version number of the VTE library (e.g. in version 3.1.4 this is 3).
MICRO_VERSION | The micro version number of the VTE library (e.g. in version 3.1.4 this is 4).
MINOR_VERSION | The minor version number of the VTE library (e.g. in version 3.1.4 this is 1).
REGEX_FLAGS_DEFAULT |
SPAWN_NO_PARENT_ENVV | Use this as a spawn flag (together with flags from `GSpawnFlags`) in vte_pty_spawn_async().
SPAWN_NO_SYSTEMD_SCOPE | Use this as a spawn flag (together with flags from `GSpawnFlags`) in vte_pty_spawn_async().
SPAWN_REQUIRE_SYSTEMD_SCOPE | Use this as a spawn flag (together with flags from `GSpawnFlags`) in vte_pty_spawn_async().
TERMPROP_CONTAINER_NAME | A `VTE_PROPERTY_STRING` termprop that stores the name of the container.
TERMPROP_CONTAINER_RUNTIME | A `VTE_PROPERTY_STRING` termprop that stores the runtime of the container.
TERMPROP_CONTAINER_UID | A `VTE_PROPERTY_UINT` termprop that stores the user ID of the container.
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().
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().
TERMPROP_ICON_COLOR |
TERMPROP_ICON_IMAGE | A `VTE_PROPERTY_IMAGE` termprop to specify an image for use as a favicon.
TERMPROP_NAME_PREFIX | The string prefix that any termprop’s name must start with to be installed by vte_install_termprop().
TERMPROP_PROGRESS_HINT | A `VTE_PROPERTY_INT` termprop that stores a hint how to interpret the `VTE_TERMPROP_PROGRESS_VALUE` termprop value. If set, this termprop’s value will be from the `VteProgressHint` enumeration. An unset termprop should be treated as if it had value `VTE_PROGRESS_HINT_ACTIVE` if the `VTE_TERMPROP_PROGRESS_VALUE` termprop has a value.
TERMPROP_PROGRESS_VALUE | A `VTE_PROPERTY_UINT` termprop that stores the progress of the running command as a value between 0 and 100.
TERMPROP_SHELL_POSTEXEC | An ephemeral `VTE_PROPERTY_UINT` termprop that signals that the shell has executed the commands entered at the prompt and these commands have returned. The termprop value is the exit code.
TERMPROP_SHELL_PRECMD | A `VTE_PROPERTY_VALUELESS` termprop that signals that the shell is going to prompt.
TERMPROP_SHELL_PREEXEC | A `VTE_PROPERTY_VALUELESS` termprop that signals that the shell is preparing to execute the command entered at the prompt.
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().
TEST_FLAGS_ALL |
TEST_FLAGS_NONE |