Skip to main content

Interface: VteTerminalProps

Defined in: packages/react/src/generated/jsx.ts:7632

Props for the VteTerminal widget.

Extends

Properties

accessibleActiveDescendant?

optional accessibleActiveDescendant: Widget

Defined in: packages/react/src/jsx.ts:1175

Inherited from

WidgetProps.accessibleActiveDescendant


accessibleAutocomplete?

optional accessibleAutocomplete: AccessibleAutocomplete

Defined in: packages/react/src/jsx.ts:1144

Inherited from

WidgetProps.accessibleAutocomplete


accessibleBusy?

optional accessibleBusy: boolean

Defined in: packages/react/src/jsx.ts:1165

Inherited from

WidgetProps.accessibleBusy


accessibleChecked?

optional accessibleChecked: AccessibleTristate

Defined in: packages/react/src/jsx.ts:1166

Inherited from

WidgetProps.accessibleChecked


accessibleColCount?

optional accessibleColCount: number

Defined in: packages/react/src/jsx.ts:1176

Inherited from

WidgetProps.accessibleColCount


accessibleColIndex?

optional accessibleColIndex: number

Defined in: packages/react/src/jsx.ts:1177

Inherited from

WidgetProps.accessibleColIndex


accessibleColIndexText?

optional accessibleColIndexText: string

Defined in: packages/react/src/jsx.ts:1178

Inherited from

WidgetProps.accessibleColIndexText


accessibleColSpan?

optional accessibleColSpan: number

Defined in: packages/react/src/jsx.ts:1179

Inherited from

WidgetProps.accessibleColSpan


accessibleControls?

optional accessibleControls: Widget[]

Defined in: packages/react/src/jsx.ts:1180

Inherited from

WidgetProps.accessibleControls


accessibleDescribedBy?

optional accessibleDescribedBy: Widget[]

Defined in: packages/react/src/jsx.ts:1181

Inherited from

WidgetProps.accessibleDescribedBy


accessibleDescription?

optional accessibleDescription: string

Defined in: packages/react/src/jsx.ts:1145

Inherited from

WidgetProps.accessibleDescription


accessibleDetails?

optional accessibleDetails: Widget[]

Defined in: packages/react/src/jsx.ts:1182

Inherited from

WidgetProps.accessibleDetails


accessibleDisabled?

optional accessibleDisabled: boolean

Defined in: packages/react/src/jsx.ts:1167

Inherited from

WidgetProps.accessibleDisabled


accessibleErrorMessage?

optional accessibleErrorMessage: Widget[]

Defined in: packages/react/src/jsx.ts:1183

Inherited from

WidgetProps.accessibleErrorMessage


accessibleExpanded?

optional accessibleExpanded: boolean

Defined in: packages/react/src/jsx.ts:1168

Inherited from

WidgetProps.accessibleExpanded


accessibleFlowTo?

optional accessibleFlowTo: Widget[]

Defined in: packages/react/src/jsx.ts:1184

Inherited from

WidgetProps.accessibleFlowTo


accessibleHasPopup?

optional accessibleHasPopup: boolean

Defined in: packages/react/src/jsx.ts:1146

Inherited from

WidgetProps.accessibleHasPopup


accessibleHelpText?

optional accessibleHelpText: string

Defined in: packages/react/src/jsx.ts:1163

Inherited from

WidgetProps.accessibleHelpText


accessibleHidden?

optional accessibleHidden: boolean

Defined in: packages/react/src/jsx.ts:1169

Inherited from

WidgetProps.accessibleHidden


accessibleInvalid?

optional accessibleInvalid: AccessibleInvalidState

Defined in: packages/react/src/jsx.ts:1170

Inherited from

WidgetProps.accessibleInvalid


accessibleKeyShortcuts?

optional accessibleKeyShortcuts: string

Defined in: packages/react/src/jsx.ts:1147

Inherited from

WidgetProps.accessibleKeyShortcuts


accessibleLabel?

optional accessibleLabel: string

Defined in: packages/react/src/jsx.ts:1148

Inherited from

WidgetProps.accessibleLabel


accessibleLabelledBy?

optional accessibleLabelledBy: Widget[]

Defined in: packages/react/src/jsx.ts:1185

Inherited from

WidgetProps.accessibleLabelledBy


accessibleLevel?

optional accessibleLevel: number

Defined in: packages/react/src/jsx.ts:1149

Inherited from

WidgetProps.accessibleLevel


accessibleModal?

optional accessibleModal: boolean

Defined in: packages/react/src/jsx.ts:1150

Inherited from

WidgetProps.accessibleModal


accessibleMultiLine?

optional accessibleMultiLine: boolean

Defined in: packages/react/src/jsx.ts:1151

Inherited from

WidgetProps.accessibleMultiLine


accessibleMultiSelectable?

optional accessibleMultiSelectable: boolean

Defined in: packages/react/src/jsx.ts:1152

Inherited from

WidgetProps.accessibleMultiSelectable


accessibleOrientation?

optional accessibleOrientation: Orientation

Defined in: packages/react/src/jsx.ts:1153

Inherited from

WidgetProps.accessibleOrientation


accessibleOwns?

optional accessibleOwns: Widget[]

Defined in: packages/react/src/jsx.ts:1186

Inherited from

WidgetProps.accessibleOwns


accessiblePlaceholder?

optional accessiblePlaceholder: string

Defined in: packages/react/src/jsx.ts:1154

Inherited from

WidgetProps.accessiblePlaceholder


accessiblePosInSet?

optional accessiblePosInSet: number

Defined in: packages/react/src/jsx.ts:1187

Inherited from

WidgetProps.accessiblePosInSet


accessiblePressed?

optional accessiblePressed: AccessibleTristate

Defined in: packages/react/src/jsx.ts:1171

Inherited from

WidgetProps.accessiblePressed


accessibleReadOnly?

optional accessibleReadOnly: boolean

Defined in: packages/react/src/jsx.ts:1155

Inherited from

WidgetProps.accessibleReadOnly


accessibleRequired?

optional accessibleRequired: boolean

Defined in: packages/react/src/jsx.ts:1156

Inherited from

WidgetProps.accessibleRequired


accessibleRole?

optional accessibleRole: AccessibleRole

Defined in: packages/react/src/generated/jsx.ts:187

The accessible role of the given GtkAccessible implementation.

The accessible role cannot be changed once set.

Inherited from

WidgetProps.accessibleRole


accessibleRoleDescription?

optional accessibleRoleDescription: string

Defined in: packages/react/src/jsx.ts:1157

Inherited from

WidgetProps.accessibleRoleDescription


accessibleRowCount?

optional accessibleRowCount: number

Defined in: packages/react/src/jsx.ts:1188

Inherited from

WidgetProps.accessibleRowCount


accessibleRowIndex?

optional accessibleRowIndex: number

Defined in: packages/react/src/jsx.ts:1189

Inherited from

WidgetProps.accessibleRowIndex


accessibleRowIndexText?

optional accessibleRowIndexText: string

Defined in: packages/react/src/jsx.ts:1190

Inherited from

WidgetProps.accessibleRowIndexText


accessibleRowSpan?

optional accessibleRowSpan: number

Defined in: packages/react/src/jsx.ts:1191

Inherited from

WidgetProps.accessibleRowSpan


accessibleSelected?

optional accessibleSelected: boolean

Defined in: packages/react/src/jsx.ts:1172

Inherited from

WidgetProps.accessibleSelected


accessibleSetSize?

optional accessibleSetSize: number

Defined in: packages/react/src/jsx.ts:1192

Inherited from

WidgetProps.accessibleSetSize


accessibleSort?

optional accessibleSort: AccessibleSort

Defined in: packages/react/src/jsx.ts:1158

Inherited from

WidgetProps.accessibleSort


accessibleValueMax?

optional accessibleValueMax: number

Defined in: packages/react/src/jsx.ts:1159

Inherited from

WidgetProps.accessibleValueMax


accessibleValueMin?

optional accessibleValueMin: number

Defined in: packages/react/src/jsx.ts:1160

Inherited from

WidgetProps.accessibleValueMin


accessibleValueNow?

optional accessibleValueNow: number

Defined in: packages/react/src/jsx.ts:1161

Inherited from

WidgetProps.accessibleValueNow


accessibleValueText?

optional accessibleValueText: string

Defined in: packages/react/src/jsx.ts:1162

Inherited from

WidgetProps.accessibleValueText


accessibleVisited?

optional accessibleVisited: boolean

Defined in: packages/react/src/jsx.ts:1173

Inherited from

WidgetProps.accessibleVisited


allowBold?

optional allowBold: boolean

Defined in: packages/react/src/generated/jsx.ts:7637

Controls whether or not the terminal will attempt to draw bold text, by using a bold font variant.


optional allowHyperlink: boolean

Defined in: packages/react/src/generated/jsx.ts:7639

Controls whether or not hyperlinks (OSC 8 escape sequence) are recognized and displayed.


audibleBell?

optional audibleBell: boolean

Defined in: packages/react/src/generated/jsx.ts:7644

Controls whether or not the terminal will beep when the child outputs the "bl" sequence.


backspaceBinding?

optional backspaceBinding: EraseBinding

Defined in: packages/react/src/generated/jsx.ts:7649

Controls what string or control sequence the terminal sends to its child when the user presses the backspace key.


boldIsBright?

optional boldIsBright: boolean

Defined in: packages/react/src/generated/jsx.ts:7655

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.


canFocus?

optional canFocus: boolean

Defined in: packages/react/src/generated/jsx.ts:24

Whether the widget or any of its descendents can accept the input focus.

This property is meant to be set by widget implementations, typically in their instance init function.

Inherited from

WidgetProps.canFocus


canTarget?

optional canTarget: boolean

Defined in: packages/react/src/generated/jsx.ts:26

Whether the widget can receive pointer events.

Inherited from

WidgetProps.canTarget


cellHeightScale?

optional cellHeightScale: number

Defined in: packages/react/src/generated/jsx.ts:7657

Scale factor for the cell height, to increase line spacing. (The font's height is not affected.)


cellWidthScale?

optional cellWidthScale: number

Defined in: packages/react/src/generated/jsx.ts:7659

Scale factor for the cell width, to increase letter spacing. (The font's width is not affected.)


children?

optional children: ReactNode

Defined in: packages/react/src/generated/jsx.ts:314

Children elements (child widgets or event controllers).

Inherited from

WidgetProps.children


cjkAmbiguousWidth?

optional cjkAmbiguousWidth: number

Defined in: packages/react/src/generated/jsx.ts:7669

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().


contextMenu?

optional contextMenu: Popover | null

Defined in: packages/react/src/generated/jsx.ts:7675

The menu used for context menus. Note that context menu model set with the #VteTerminal::context-menu-model property or vte_terminal_set_context_menu_model() takes precedence over this.


contextMenuModel?

optional contextMenuModel: MenuModel | null

Defined in: packages/react/src/generated/jsx.ts:7681

The menu model used for context menus. If non-%NULL, the context menu is generated from this model, and overrides a context menu set with the #VteTerminal::context-menu property or vte_terminal_set_context_menu().


cssClasses?

optional cssClasses: string[]

Defined in: packages/react/src/generated/jsx.ts:28

A list of css classes applied to this widget.

Inherited from

WidgetProps.cssClasses


cssName?

optional cssName: string

Defined in: packages/react/src/generated/jsx.ts:35

The name of this widget in the CSS tree.

This property is meant to be set by widget implementations, typically in their instance init function.

Inherited from

WidgetProps.cssName


cursor?

optional cursor: Cursor | null

Defined in: packages/react/src/generated/jsx.ts:37

The cursor used by widget.

Inherited from

AdwWindowProps.cursor


cursorBlinkMode?

optional cursorBlinkMode: CursorBlinkMode

Defined in: packages/react/src/generated/jsx.ts:7686

Sets whether or not the cursor will blink. Using %VTE_CURSOR_BLINK_SYSTEM will use the #GtkSettings:gtk-cursor-blink setting.


cursorShape?

optional cursorShape: CursorShape

Defined in: packages/react/src/generated/jsx.ts:7688

Controls the shape of the cursor.


deleteBinding?

optional deleteBinding: EraseBinding

Defined in: packages/react/src/generated/jsx.ts:7693

Controls what string or control sequence the terminal sends to its child when the user presses the delete key.


enableA11y?

optional enableA11y: boolean

Defined in: packages/react/src/generated/jsx.ts:7695

Controls whether or not a11y is enabled for the widget.


enableBidi?

optional enableBidi: boolean

Defined in: packages/react/src/generated/jsx.ts:7697

Controls whether or not the terminal will perform bidirectional text rendering.


enableFallbackScrolling?

optional enableFallbackScrolling: boolean

Defined in: packages/react/src/generated/jsx.ts:7698


enableLegacyOsc777?

optional enableLegacyOsc777: boolean

Defined in: packages/react/src/generated/jsx.ts:7703

Whether legacy OSC 777 sequences are translated to their corresponding termprops.


enableShaping?

optional enableShaping: boolean

Defined in: packages/react/src/generated/jsx.ts:7705

Controls whether or not the terminal will shape Arabic text.


enableSixel?

optional enableSixel: boolean

Defined in: packages/react/src/generated/jsx.ts:7707

Controls whether SIXEL image support is enabled.


encoding?

optional encoding: string | null

Defined in: packages/react/src/generated/jsx.ts:7714

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.


focusable?

optional focusable: boolean

Defined in: packages/react/src/generated/jsx.ts:45

Whether this widget itself will accept the input focus.

Inherited from

WidgetProps.focusable


focusOnClick?

optional focusOnClick: boolean

Defined in: packages/react/src/generated/jsx.ts:43

Whether the widget should grab focus when it is clicked with the mouse.

This property is only relevant for widgets that can take focus.

Inherited from

WidgetProps.focusOnClick


fontOptions?

optional fontOptions: FontOptionsImpl | null

Defined in: packages/react/src/generated/jsx.ts:7723

The terminal's font options, or %NULL to use the default font options.

Note that on GTK4, the terminal by default uses font options with %CAIRO_HINT_METRICS_ON set; to override that, use this function to set a #cairo_font_options_t that has %CAIRO_HINT_METRICS_OFF set.


fontScale?

optional fontScale: number

Defined in: packages/react/src/generated/jsx.ts:7725

The terminal's font scale.


hadjustment?

optional hadjustment: Adjustment

Defined in: packages/react/src/generated/jsx.ts:7800

Horizontal GtkAdjustment of the scrollable widget.

This adjustment is shared between the scrollable widget and its parent.


halign?

optional halign: Align

Defined in: packages/react/src/generated/jsx.ts:47

How to distribute horizontal space if widget gets extra space.

Inherited from

WidgetProps.halign


hasTooltip?

optional hasTooltip: boolean

Defined in: packages/react/src/generated/jsx.ts:56

Enables or disables the emission of the Widget.:query-tooltip signal on widget.

A true value indicates that widget can have a tooltip, in this case the widget will be queried using Widget.:query-tooltip to determine whether it will provide a tooltip or not.

Inherited from

WidgetProps.hasTooltip


heightRequest?

optional heightRequest: number

Defined in: packages/react/src/generated/jsx.ts:62

Overrides for height request of the widget.

If this is -1, the natural request will be used.

Inherited from

WidgetProps.heightRequest


hexpand?

optional hexpand: boolean

Defined in: packages/react/src/generated/jsx.ts:64

Whether to expand horizontally.

Inherited from

WidgetProps.hexpand


hexpandSet?

optional hexpandSet: boolean

Defined in: packages/react/src/generated/jsx.ts:66

Whether to use the hexpand property.

Inherited from

WidgetProps.hexpandSet


hscrollPolicy?

optional hscrollPolicy: ScrollablePolicy

Defined in: packages/react/src/generated/jsx.ts:7802

Determines when horizontal scrolling should start.


inputEnabled?

optional inputEnabled: boolean

Defined in: packages/react/src/generated/jsx.ts:7731

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.


layoutManager?

optional layoutManager: LayoutManager | null

Defined in: packages/react/src/generated/jsx.ts:74

The LayoutManager instance to use to compute the preferred size of the widget, and allocate its children.

This property is meant to be set by widget implementations, typically in their instance init function.

Inherited from

AdwWindowProps.layoutManager


limitEvents?

optional limitEvents: boolean

Defined in: packages/react/src/generated/jsx.ts:83

Makes this widget act like a modal dialog, with respect to event delivery.

Global event controllers will not handle events with targets inside the widget, unless they are set up to ignore propagation limits. See EventController.set_propagation_limit.

Inherited from

WidgetProps.limitEvents


marginBottom?

optional marginBottom: number

Defined in: packages/react/src/generated/jsx.ts:91

Margin on bottom side of widget.

This property adds margin outside of the widget's normal size request, the margin will be added in addition to the size from Widget.set_size_request for example.

Inherited from

WidgetProps.marginBottom


marginEnd?

optional marginEnd: number

Defined in: packages/react/src/generated/jsx.ts:102

Margin on end of widget, horizontally.

This property supports left-to-right and right-to-left text directions.

This property adds margin outside of the widget's normal size request, the margin will be added in addition to the size from Widget.set_size_request for example.

Inherited from

WidgetProps.marginEnd


marginStart?

optional marginStart: number

Defined in: packages/react/src/generated/jsx.ts:113

Margin on start of widget, horizontally.

This property supports left-to-right and right-to-left text directions.

This property adds margin outside of the widget's normal size request, the margin will be added in addition to the size from Widget.set_size_request for example.

Inherited from

WidgetProps.marginStart


marginTop?

optional marginTop: number

Defined in: packages/react/src/generated/jsx.ts:121

Margin on top side of widget.

This property adds margin outside of the widget's normal size request, the margin will be added in addition to the size from Widget.set_size_request for example.

Inherited from

WidgetProps.marginTop


name?

optional name: string

Defined in: packages/react/src/generated/jsx.ts:123

The name of the widget.

Inherited from

WidgetProps.name


onBell?

optional onBell: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7815

This signal is emitted when the a child sends a bell request to the terminal.


onCharSizeChanged?

optional onCharSizeChanged: (width, height, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7822

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".


onChildExited?

optional onChildExited: (status, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7827

This signal is emitted when the terminal detects that a child watched using vte_terminal_watch_child() has exited.


onCommit?

optional onCommit: (text, size, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7832

Emitted whenever the terminal receives input from the user and prepares to send it to the child process.


onContentsChanged?

optional onContentsChanged: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7837

Emitted whenever the visible appearance of the terminal has changed. Used primarily by #VteTerminalAccessible.


onCopyClipboard?

optional onCopyClipboard: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7839

Emitted whenever vte_terminal_copy_clipboard() is called.


onCurrentDirectoryUriChanged?

optional onCurrentDirectoryUriChanged: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7841

Emitted when the current directory URI is modified.


onCurrentFileUriChanged?

optional onCurrentFileUriChanged: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7843

Emitted when the current file URI is modified.


onCursorMoved?

optional onCursorMoved: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7848

Emitted whenever the cursor moves to a new character cell. Used primarily by #VteTerminalAccessible.


onDecreaseFontSize?

optional onDecreaseFontSize: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7850

Emitted when the user hits the '-' key while holding the Control key.


onDeiconifyWindow?

optional onDeiconifyWindow: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7852

Never emitted.


onDestroy?

optional onDestroy: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:196

Signals that all holders of a reference to the widget should release the reference that they hold.

May result in finalization of the widget if all references are released.

This signal is not suitable for saving widget state.

Inherited from

WidgetProps.onDestroy


onDirectionChanged?

optional onDirectionChanged: (previousDirection, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:198

Emitted when the text direction of a widget changes.

Inherited from

WidgetProps.onDirectionChanged


onEncodingChanged?

optional onEncodingChanged: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7858

Emitted whenever the terminal's current encoding has changed.

Note: support for non-UTF-8 is deprecated.


onEof?

optional onEof: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7864

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 #VteTerminal::child-exited signal.


onHide?

optional onHide: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:200

Emitted when widget is hidden.

Inherited from

WidgetProps.onHide


onHyperlinkHoverUriChanged?

optional onHyperlinkHoverUriChanged: (object, p0, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7874

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.


onIconifyWindow?

optional onIconifyWindow: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7877

Never emitted.


onIconTitleChanged?

optional onIconTitleChanged: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7875


onIncreaseFontSize?

optional onIncreaseFontSize: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7879

Emitted when the user hits the '+' key while holding the Control key.


onKeynavFailed?

optional onKeynavFailed: (direction, self) => boolean | null

Defined in: packages/react/src/generated/jsx.ts:206

Emitted if keyboard navigation fails.

See Widget.keynav_failed for details.

Inherited from

WidgetProps.onKeynavFailed


onLowerWindow?

optional onLowerWindow: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7881

Never emitted.


onMap?

optional onMap: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:218

Emitted when widget is going to be mapped.

A widget is mapped when the widget is visible (which is controlled with Widget.visible) and all its parents up to the toplevel widget are also visible.

The ::map signal can be used to determine whether a widget will be drawn, for instance it can resume an animation that was stopped during the emission of Widget.:unmap.

Inherited from

WidgetProps.onMap


onMaximizeWindow?

optional onMaximizeWindow: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7883

Never emitted.


onMnemonicActivate?

optional onMnemonicActivate: (groupCycling, self) => boolean | null

Defined in: packages/react/src/generated/jsx.ts:225

Emitted when a widget is activated via a mnemonic.

The default handler for this signal activates widget if group_cycling is false, or just makes widget grab focus if group_cycling is true.

Inherited from

WidgetProps.onMnemonicActivate


onMoveFocus?

optional onMoveFocus: (direction, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:234

Emitted when the focus is moved.

The ::move-focus signal is a keybinding signal.

The default bindings for this signal are Tab to move forward, and Shift+Tab to move backward.

Inherited from

WidgetProps.onMoveFocus


onMoveWindow?

optional onMoveWindow: (x, y, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7885

Never emitted.


onNotify?

optional onNotify: (pspec, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:312

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with %G_PARAM_EXPLICIT_NOTIFY, then any call to g_object_set_property() results in ::notify being emitted, even if the new value is the same as the old. If they did pass %G_PARAM_EXPLICIT_NOTIFY, then this signal is emitted only when they explicitly call g_object_notify() or g_object_notify_by_pspec(), and common practice is to do that only when the value has actually changed.

This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the g_signal_connect() call, like this:

|[ g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view) ]|

It is important to note that you must use [canonical parameter names]GObjectParamSpec#parameter-names as detail strings for the notify signal.

Inherited from

WidgetProps.onNotify


onPasteClipboard?

optional onPasteClipboard: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7887

Emitted whenever vte_terminal_paste_clipboard() is called.


onQueryTooltip?

optional onQueryTooltip: (x, y, keyboardMode, tooltip, self) => boolean | null

Defined in: packages/react/src/generated/jsx.ts:250

Emitted when the widget’s tooltip is about to be shown.

This happens when the Widget.has-tooltip property is true and the hover timeout has expired with the cursor hovering above widget; or emitted when widget got focus in keyboard mode.

Using the given coordinates, the signal handler should determine whether a tooltip should be shown for widget. If this is the case true should be returned, false otherwise. Note that if keyboard_mode is true, the values of x and y are undefined and should not be used.

The signal handler is free to manipulate tooltip with the therefore destined function calls.

Inherited from

WidgetProps.onQueryTooltip


onRaiseWindow?

optional onRaiseWindow: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7889

Never emitted.


onRealize?

optional onRealize: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:259

Emitted when widget is associated with a GdkSurface.

This means that Widget.realize has been called or the widget has been mapped (that is, it is going to be drawn).

Inherited from

WidgetProps.onRealize


onRefreshWindow?

optional onRefreshWindow: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7891

Never emitted.


onResizeWindow?

optional onResizeWindow: (width, height, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7893

Emitted at the child application's request.


onRestoreWindow?

optional onRestoreWindow: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7895

Never emitted.


onSelectionChanged?

optional onSelectionChanged: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7897

Emitted whenever the contents of terminal's selection changes.


onSetupContextMenu?

optional onSetupContextMenu: (context, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7913

Emitted with non-%NULL context before terminal shows a context menu. The handler may set either a menu model using vte_terminal_set_context_menu_model(), or a menu using vte_terminal_set_context_menu(), which will then be used as context menu, or keep a previously set context menu or context menu model, but update the menu and/or its #GAction:s visibility and sensitivity. If neither a menu model nor a menu are set, a context menu will not be shown.

Note that context is only valid during the signal emission; you may not retain it to call methods on it afterwards.

Also emitted with %NULL context after the context menu has been dismissed.


onShow?

optional onShow: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:261

Emitted when widget is shown.

Inherited from

WidgetProps.onShow


onStateFlagsChanged?

optional onStateFlagsChanged: (flags, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:267

Emitted when the widget state changes.

See Widget.get_state_flags.

Inherited from

WidgetProps.onStateFlagsChanged


onTermpropChanged?

optional onTermpropChanged: (name, self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7927

The "termprop-changed" signal is emitted when a termprop has changed or been reset.

The handler may use the vte_terminal_get_termprop_*() functions (and their by-ID variants), to retrieve the value of any termprop (not just name); but it must not call any other API on terminal, including API of its parent classes.

This signal supports detailed connections, so e.g. subscribing to "termprop-changed::name" only runs the callback when the termprop "name" has changed.


onTermpropsChanged?

optional onTermpropsChanged: (props, nProps, self) => boolean | null

Defined in: packages/react/src/generated/jsx.ts:7947

Emitted when termprops have changed. props is an array containing the IDs of the terminal properties that may have changed since the last emission of this signal, in an undefined order. Note that emission of this signal is delayed from the receipt of the OSC sequences, and a termprop may have been changed more than once inbetween signal emissions, but only the value set last is retrievable.

The default handler for this signal emits the "termprop-changed" signal for each changed property. Returning %TRUE from a handler running before the default will prevent this.

The handler may use the vte_terminal_get_termprop_*() functions (and their by-ID variants), to retrieve the value of any termprop, as well as call vte_terminal_reset_termprop() (and its by-ID variant) to reset any termprop, or emit the VteTerminal::termprop-changed signal; but it must not call any other API on terminal, including API of its parent classes.


onUnmap?

optional onUnmap: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:277

Emitted when widget is going to be unmapped.

A widget is unmapped when either it or any of its parents up to the toplevel widget have been set as hidden.

As ::unmap indicates that a widget will not be shown any longer, it can be used to, for example, stop an animation on the widget.

Inherited from

WidgetProps.onUnmap


onUnrealize?

optional onUnrealize: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:284

Emitted when the GdkSurface associated with widget is destroyed.

This means that Widget.unrealize has been called or the widget has been unmapped (that is, it is going to be hidden).

Inherited from

WidgetProps.onUnrealize


onWindowTitleChanged?

optional onWindowTitleChanged: (self) => void | null

Defined in: packages/react/src/generated/jsx.ts:7949

Emitted when the #VteTerminal:window-title property is modified.


opacity?

optional opacity: number

Defined in: packages/react/src/generated/jsx.ts:125

The requested opacity of the widget.

Inherited from

WidgetProps.opacity


overflow?

optional overflow: Overflow

Defined in: packages/react/src/generated/jsx.ts:132

How content outside the widget's content area is treated.

This property is meant to be set by widget implementations, typically in their instance init function.

Inherited from

WidgetProps.overflow


pointerAutohide?

optional pointerAutohide: boolean

Defined in: packages/react/src/generated/jsx.ts:7737

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.


pty?

optional pty: Pty | null

Defined in: packages/react/src/generated/jsx.ts:7739

The PTY object for the terminal.


receivesDefault?

optional receivesDefault: boolean

Defined in: packages/react/src/generated/jsx.ts:134

Whether the widget will receive the default action when it is focused.

Inherited from

WidgetProps.receivesDefault


ref?

optional ref: Ref<Terminal>

Defined in: packages/react/src/generated/jsx.ts:7950


rewrapOnResize?

optional rewrapOnResize: boolean

Defined in: packages/react/src/generated/jsx.ts:7744

Controls whether or not the terminal will rewrap its contents, including the scrollback buffer, whenever the terminal's width changes.


scrollbackLines?

optional scrollbackLines: number

Defined in: packages/react/src/generated/jsx.ts:7779

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.

Note that any value greater or equal to %G_MAXINT is interpreted as unlimited scrollback, i.e. like -1 when passed to vte_terminal_set_scrollback_lines(), and the value of this property for unlimited scrollback is %G_MAXUINT.


scrollOnInsert?

optional scrollOnInsert: boolean

Defined in: packages/react/src/generated/jsx.ts:7749

Controls whether or not the terminal will forcibly scroll to the bottom of the viewable history when the text is inserted (e.g. by a paste).


scrollOnKeystroke?

optional scrollOnKeystroke: boolean

Defined in: packages/react/src/generated/jsx.ts:7755

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.


scrollOnOutput?

optional scrollOnOutput: boolean

Defined in: packages/react/src/generated/jsx.ts:7760

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.


scrollUnitIsPixels?

optional scrollUnitIsPixels: boolean

Defined in: packages/react/src/generated/jsx.ts:7766

Controls whether the terminal's GtkAdjustment values unit is lines or pixels. This can be enabled when the terminal is the child of a GtkScrolledWindow to fix some bugs with its kinetic scrolling.


sensitive?

optional sensitive: boolean

Defined in: packages/react/src/generated/jsx.ts:136

Whether the widget responds to input.

Inherited from

WidgetProps.sensitive


textBlinkMode?

optional textBlinkMode: TextBlinkMode

Defined in: packages/react/src/generated/jsx.ts:7781

Controls whether or not the terminal will allow blinking text.


tooltipMarkup?

optional tooltipMarkup: string | null

Defined in: packages/react/src/generated/jsx.ts:152

Sets the text of tooltip to be the given string, which is marked up with Pango markup.

Also see Tooltip.set_markup.

This is a convenience property which will take care of getting the tooltip shown if the given string is not NULL: Widget.has-tooltip will automatically be set to true and there will be taken care of Widget.:query-tooltip in the default signal handler.

Note that if both Widget.tooltip-text and Widget.tooltip-markup are set, the last one wins.

Inherited from

AdwWindowProps.tooltipMarkup


tooltipText?

optional tooltipText: string | null

Defined in: packages/react/src/generated/jsx.ts:167

Sets the text of tooltip to be the given string.

Also see Tooltip.set_text.

This is a convenience property which will take care of getting the tooltip shown if the given string is not NULL: Widget.has-tooltip will automatically be set to true and there will be taken care of Widget.:query-tooltip in the default signal handler.

Note that if both Widget.tooltip-text and Widget.tooltip-markup are set, the last one wins.

Inherited from

AdwWindowProps.tooltipText


vadjustment?

optional vadjustment: Adjustment

Defined in: packages/react/src/generated/jsx.ts:7808

Vertical GtkAdjustment of the scrollable widget.

This adjustment is shared between the scrollable widget and its parent.


valign?

optional valign: Align

Defined in: packages/react/src/generated/jsx.ts:169

How to distribute vertical space if widget gets extra space.

Inherited from

WidgetProps.valign


vexpand?

optional vexpand: boolean

Defined in: packages/react/src/generated/jsx.ts:171

Whether to expand vertically.

Inherited from

WidgetProps.vexpand


vexpandSet?

optional vexpandSet: boolean

Defined in: packages/react/src/generated/jsx.ts:173

Whether to use the vexpand property.

Inherited from

WidgetProps.vexpandSet


visible?

optional visible: boolean

Defined in: packages/react/src/generated/jsx.ts:175

Whether the widget is visible.

Inherited from

WidgetProps.visible


vscrollPolicy?

optional vscrollPolicy: ScrollablePolicy

Defined in: packages/react/src/generated/jsx.ts:7810

Determines when vertical scrolling should start.


widthRequest?

optional widthRequest: number

Defined in: packages/react/src/generated/jsx.ts:181

Overrides for width request of the widget.

If this is -1, the natural request will be used.

Inherited from

WidgetProps.widthRequest


xalign?

optional xalign: Align

Defined in: packages/react/src/generated/jsx.ts:7783

The horizontal alignment of terminal within its allocation.


xfill?

optional xfill: boolean

Defined in: packages/react/src/generated/jsx.ts:7785

The horizontal fillment of terminal within its allocation.


yalign?

optional yalign: Align

Defined in: packages/react/src/generated/jsx.ts:7787

The vertical alignment of terminal within its allocation


yfill?

optional yfill: boolean

Defined in: packages/react/src/generated/jsx.ts:7794

The vertical fillment of terminal within its allocation. Note that #VteTerminal:yfill=%TRUE is only supported with #VteTerminal:yalign=%VTE_ALIGN_START, and is ignored for all other yalign values.