TextViewSignalName
public enum TextViewSignalName : String, SignalNameProtocol
Undocumented
-
Gets emitted when the user asks for it.
The
backspace
signal is a keybinding signal.The default bindings for this signal are <kbd>Backspace</kbd> and <kbd>Shift</kbd>-<kbd>Backspace</kbd>.
Declaration
Swift
case backspace = "backspace"
-
Gets emitted to copy the selection to the clipboard.
The
copy-clipboard
signal is a keybinding signal.The default bindings for this signal are <kbd>Ctrl</kbd>-<kbd>c</kbd> and <kbd>Ctrl</kbd>-<kbd>Insert</kbd>.
Declaration
Swift
case copyClipboard = "copy-clipboard"
-
Gets emitted to cut the selection to the clipboard.
The
cut-clipboard
signal is a keybinding signal.The default bindings for this signal are <kbd>Ctrl</kbd>-<kbd>x</kbd> and <kbd>Shift</kbd>-<kbd>Delete</kbd>.
Declaration
Swift
case cutClipboard = "cut-clipboard"
-
Gets emitted when the user initiates a text deletion.
The
delete-from-cursor
signal is a keybinding signal.If the
type
isGTK_DELETE_CHARS
, GTK deletes the selection if there is one, otherwise it deletes the requested number of characters.The default bindings for this signal are <kbd>Delete</kbd> for deleting a character, <kbd>Ctrl</kbd>-<kbd>Delete</kbd> for deleting a word and <kbd>Ctrl</kbd>-<kbd>Backspace</kbd> for deleting a word backwards.
Declaration
Swift
case deleteFromCursor = "delete-from-cursor"
-
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.
Declaration
Swift
case destroy = "destroy"
-
Emitted when the text direction of a widget changes.
Declaration
Swift
case directionChanged = "direction-changed"
-
Emitted when the selection needs to be extended at
location
.Declaration
Swift
case extendSelection = "extend-selection"
-
Emitted when
widget
is hidden.Declaration
Swift
case hide = "hide"
-
Gets emitted when the user initiates the insertion of a fixed string at the cursor.
The
insert-at-cursor
signal is a keybinding signal.This signal has no default bindings.
Declaration
Swift
case insertAtCursor = "insert-at-cursor"
-
Gets emitted to present the Emoji chooser for the
text_view
.The
insert-emoji
signal is a keybinding signal.The default bindings for this signal are <kbd>Ctrl</kbd>-<kbd>.</kbd> and <kbd>Ctrl</kbd>-<kbd>;</kbd>
Declaration
Swift
case insertEmoji = "insert-emoji"
-
Emitted if keyboard navigation fails.
See [method
Gtk.Widget.keynav_failed
] for details.Declaration
Swift
case keynavFailed = "keynav-failed"
-
Emitted when
widget
is going to be mapped.A widget is mapped when the widget is visible (which is controlled with [property
Gtk.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 [signalGtk.Widget::unmap
].Declaration
Swift
case map = "map"
-
Emitted when a widget is activated via a mnemonic.
The default handler for this signal activates
widget
ifgroup_cycling
isfalse
, or just makeswidget
grab focus ifgroup_cycling
istrue
.Declaration
Swift
case mnemonicActivate = "mnemonic-activate"
-
Gets emitted when the user initiates a cursor movement.
The
move-cursor
signal is a keybinding signal. If the cursor is not visible intext_view
, this signal causes the viewport to be moved instead.Applications should not connect to it, but may emit it with
g_signal_emit_by_name()
if they need to control the cursor programmatically.The default bindings for this signal come in two variants, the variant with the <kbd>Shift</kbd> modifier extends the selection, the variant without it does not. There are too many key combinations to list them all here.
- <kbd>←</kbd>, <kbd>→</kbd>, <kbd>↑</kbd>, <kbd>↓</kbd> move by individual characters/lines
- <kbd>Ctrl</kbd>-<kbd>→</kbd>, etc. move by words/paragraphs
- <kbd>Home</kbd>, <kbd>End</kbd> move to the ends of the buffer
- <kbd>PgUp</kbd>, <kbd>PgDn</kbd> move vertically by pages
- <kbd>Ctrl</kbd>-<kbd>PgUp</kbd>, <kbd>Ctrl</kbd>-<kbd>PgDn</kbd> move horizontally by pages
Declaration
Swift
case moveCursor = "move-cursor"
-
Emitted when the focus is moved.
Declaration
Swift
case moveFocus = "move-focus"
-
Gets emitted to move the viewport.
The
move-viewport
signal is a keybinding signal, which can be bound to key combinations to allow the user to move the viewport, i.e. change what part of the text view is visible in a containing scrolled window.There are no default bindings for this signal.
Declaration
Swift
case moveViewport = "move-viewport"
-
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 tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_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:(C Language Example):
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 as detail strings for the notify signal.
Declaration
Swift
case notify = "notify"
-
Gets emitted to paste the contents of the clipboard into the text view.
The
paste-clipboard
signal is a keybinding signal.The default bindings for this signal are <kbd>Ctrl</kbd>-<kbd>v</kbd> and <kbd>Shift</kbd>-<kbd>Insert</kbd>.
Declaration
Swift
case pasteClipboard = "paste-clipboard"
-
Emitted when preedit text of the active IM changes.
If an input method is used, the typed text will not immediately be committed to the buffer. So if you are interested in the text, connect to this signal.
This signal is only emitted if the text at the given position is actually editable.
Declaration
Swift
case preeditChanged = "preedit-changed"
-
Emitted when the widgets tooltip is about to be shown.
This happens when the [property
Gtk.Widget:has-tooltip
] property istrue
and the hover timeout has expired with the cursor hovering “above”widget
; or emitted whenwidget
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 casetrue
should be returned,false
otherwise. Note that ifkeyboard_mode
istrue
, the values ofx
andy
are undefined and should not be used.The signal handler is free to manipulate
tooltip
with the therefore destined function calls.Declaration
Swift
case queryTooltip = "query-tooltip"
-
Emitted when
widget
is associated with aGdkSurface
.This means that [method
Gtk.Widget.realize
] has been called or the widget has been mapped (that is, it is going to be drawn).Declaration
Swift
case realize = "realize"
-
Gets emitted to select or unselect the complete contents of the text view.
The
select-all
signal is a keybinding signal.The default bindings for this signal are <kbd>Ctrl</kbd>-<kbd>a</kbd> and <kbd>Ctrl</kbd>-<kbd>/</kbd> for selecting and <kbd>Shift</kbd>-<kbd>Ctrl</kbd>-<kbd>a</kbd> and <kbd>Ctrl</kbd>-<kbd></kbd> for unselecting.
Declaration
Swift
case selectAll = "select-all"
-
Gets emitted when the user initiates settings the “anchor” mark.
The
set-anchor
signal is a keybinding signal which gets emitted when the user initiates setting the “anchor” mark. The “anchor” mark gets placed at the same position as the “insert” mark.This signal has no default bindings.
Declaration
Swift
case setAnchor = "set-anchor"
-
Emitted when
widget
is shown.Declaration
Swift
case show = "show"
-
Emitted when the widget state changes.
See [method
Gtk.Widget.get_state_flags
].Declaration
Swift
case stateFlagsChanged = "state-flags-changed"
-
Gets emitted to toggle the
cursor-visible
property.The
toggle-cursor-visible
signal is a keybinding signal.The default binding for this signal is <kbd>F7</kbd>.
Declaration
Swift
case toggleCursorVisible = "toggle-cursor-visible"
-
Gets emitted to toggle the overwrite mode of the text view.
The
toggle-overwrite
signal is a keybinding signal.The default binding for this signal is <kbd>Insert</kbd>.
Declaration
Swift
case toggleOverwrite = "toggle-overwrite"
-
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.Declaration
Swift
case unmap = "unmap"
-
Emitted when the
GdkSurface
associated withwidget
is destroyed.This means that [method
Gtk.Widget.unrealize
] has been called or the widget has been unmapped (that is, it is going to be hidden).Declaration
Swift
case unrealize = "unrealize"
-
Whether Tab will result in a tab character being entered.
Declaration
Swift
case notifyAcceptsTab = "notify::accepts-tab"
-
The bottom margin for text in the text view.
Note that this property is confusingly named. In CSS terms, the value set here is padding, and it is applied in addition to the padding from the theme.
Don’t confuse this property with [property
Gtk.Widget:margin-bottom
].Declaration
Swift
case notifyBottomMargin = "notify::bottom-margin"
-
The buffer which is displayed.
Declaration
Swift
case notifyBuffer = "notify::buffer"
-
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.
Declaration
Swift
case notifyCanFocus = "notify::can-focus"
-
Whether the widget can receive pointer events.
Declaration
Swift
case notifyCanTarget = "notify::can-target"
-
A list of css classes applied to this widget.
Declaration
Swift
case notifyCssClasses = "notify::css-classes"
-
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.
Declaration
Swift
case notifyCssName = "notify::css-name"
-
The cursor used by
widget
.Declaration
Swift
case notifyCursor = "notify::cursor"
-
If the insertion cursor is shown.
Declaration
Swift
case notifyCursorVisible = "notify::cursor-visible"
-
Undocumented
Declaration
Swift
case notifyEditable = "notify::editable"
-
A menu model whose contents will be appended to the context menu.
Declaration
Swift
case notifyExtraMenu = "notify::extra-menu"
-
Whether the widget should grab focus when it is clicked with the mouse.
This property is only relevant for widgets that can take focus.
Declaration
Swift
case notifyFocusOnClick = "notify::focus-on-click"
-
Whether this widget itself will accept the input focus.
Declaration
Swift
case notifyFocusable = "notify::focusable"
-
How to distribute horizontal space if widget gets extra space.
Declaration
Swift
case notifyHalign = "notify::halign"
-
Whether the widget is the default widget.
Declaration
Swift
case notifyHasDefault = "notify::has-default"
-
Whether the widget has the input focus.
Declaration
Swift
case notifyHasFocus = "notify::has-focus"
-
Enables or disables the emission of the
query-tooltip
signal onwidget
.A value of
true
indicates thatwidget
can have a tooltip, in this case the widget will be queried using [signalGtk.Widget::query-tooltip
] to determine whether it will provide a tooltip or not.Declaration
Swift
case notifyHasTooltip = "notify::has-tooltip"
-
Override for height request of the widget.
If this is -1, the natural request will be used.
Declaration
Swift
case notifyHeightRequest = "notify::height-request"
-
Whether to expand horizontally.
Declaration
Swift
case notifyHexpand = "notify::hexpand"
-
Whether to use the
hexpand
property.Declaration
Swift
case notifyHexpandSet = "notify::hexpand-set"
-
Which IM (input method) module should be used for this text_view.
See [class
Gtk.IMMulticontext
].Setting this to a non-
nil
value overrides the system-wide IM module setting. See the GtkSettings [propertyGtk.Settings:gtk-im-module
] property.Declaration
Swift
case notifyImModule = "notify::im-module"
-
Amount to indent the paragraph, in pixels.
Declaration
Swift
case notifyIndent = "notify::indent"
-
Additional hints (beyond [property
Gtk.TextView:input-purpose
]) that allow input methods to fine-tune their behaviour.Declaration
Swift
case notifyInputHints = "notify::input-hints"
-
The purpose of this text field.
This property can be used by on-screen keyboards and other input methods to adjust their behaviour.
Declaration
Swift
case notifyInputPurpose = "notify::input-purpose"
-
Undocumented
Declaration
Swift
case notifyJustification = "notify::justification"
-
The
GtkLayoutManager
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.
Declaration
Swift
case notifyLayoutManager = "notify::layout-manager"
-
The default left margin for text in the text view.
Tags in the buffer may override the default.
Note that this property is confusingly named. In CSS terms, the value set here is padding, and it is applied in addition to the padding from the theme.
Declaration
Swift
case notifyLeftMargin = "notify::left-margin"
-
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 [method
Gtk.Widget.set_size_request
] for example.Declaration
Swift
case notifyMarginBottom = "notify::margin-bottom"
-
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 [method
Gtk.Widget.set_size_request
] for example.Declaration
Swift
case notifyMarginEnd = "notify::margin-end"
-
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 [method
Gtk.Widget.set_size_request
] for example.Declaration
Swift
case notifyMarginStart = "notify::margin-start"
-
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 [method
Gtk.Widget.set_size_request
] for example.Declaration
Swift
case notifyMarginTop = "notify::margin-top"
-
Whether text should be displayed in a monospace font.
If
true
, set the .monospace style class on the text view to indicate that a monospace font is desired.Declaration
Swift
case notifyMonospace = "notify::monospace"
-
The name of the widget.
Declaration
Swift
case notifyName = "notify::name"
-
The requested opacity of the widget.
Declaration
Swift
case notifyOpacity = "notify::opacity"
-
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.
Declaration
Swift
case notifyOverflow = "notify::overflow"
-
Whether entered text overwrites existing contents.
Declaration
Swift
case notifyOverwrite = "notify::overwrite"
-
The parent widget of this widget.
Declaration
Swift
case notifyParent = "notify::parent"
-
Undocumented
Declaration
Swift
case notifyPixelsAboveLines = "notify::pixels-above-lines"
-
Undocumented
Declaration
Swift
case notifyPixelsBelowLines = "notify::pixels-below-lines"
-
Undocumented
Declaration
Swift
case notifyPixelsInsideWrap = "notify::pixels-inside-wrap"
-
Whether the widget will receive the default action when it is focused.
Declaration
Swift
case notifyReceivesDefault = "notify::receives-default"
-
The default right margin for text in the text view.
Tags in the buffer may override the default.
Note that this property is confusingly named. In CSS terms, the value set here is padding, and it is applied in addition to the padding from the theme.
Declaration
Swift
case notifyRightMargin = "notify::right-margin"
-
The
GtkRoot
widget of the widget tree containing this widget.This will be
nil
if the widget is not contained in a root widget.Declaration
Swift
case notifyRoot = "notify::root"
-
The scale factor of the widget.
Declaration
Swift
case notifyScaleFactor = "notify::scale-factor"
-
Whether the widget responds to input.
Declaration
Swift
case notifySensitive = "notify::sensitive"
-
Undocumented
Declaration
Swift
case notifyTabs = "notify::tabs"
-
Sets the text of tooltip to be the given string, which is marked up with Pango markup.
Also see [method
Gtk.Tooltip.set_markup
].This is a convenience property which will take care of getting the tooltip shown if the given string is not
nil
: [propertyGtk.Widget:has-tooltip
] will automatically be set totrue
and there will be taken care of [signalGtk.Widget::query-tooltip
] in the default signal handler.Note that if both [property
Gtk.Widget:tooltip-text
] and [propertyGtk.Widget:tooltip-markup
] are set, the last one wins.Declaration
Swift
case notifyTooltipMarkup = "notify::tooltip-markup"
-
Sets the text of tooltip to be the given string.
Also see [method
Gtk.Tooltip.set_text
].This is a convenience property which will take care of getting the tooltip shown if the given string is not
nil
: [propertyGtk.Widget:has-tooltip
] will automatically be set totrue
and there will be taken care of [signalGtk.Widget::query-tooltip
] in the default signal handler.Note that if both [property
Gtk.Widget:tooltip-text
] and [propertyGtk.Widget:tooltip-markup
] are set, the last one wins.Declaration
Swift
case notifyTooltipText = "notify::tooltip-text"
-
The top margin for text in the text view.
Note that this property is confusingly named. In CSS terms, the value set here is padding, and it is applied in addition to the padding from the theme.
Don’t confuse this property with [property
Gtk.Widget:margin-top
].Declaration
Swift
case notifyTopMargin = "notify::top-margin"
-
How to distribute vertical space if widget gets extra space.
Declaration
Swift
case notifyValign = "notify::valign"
-
Whether to expand vertically.
Declaration
Swift
case notifyVexpand = "notify::vexpand"
-
Whether to use the
vexpand
property.Declaration
Swift
case notifyVexpandSet = "notify::vexpand-set"
-
Whether the widget is visible.
Declaration
Swift
case notifyVisible = "notify::visible"
-
Override for width request of the widget.
If this is -1, the natural request will be used.
Declaration
Swift
case notifyWidthRequest = "notify::width-request"
-
Undocumented
Declaration
Swift
case notifyWrapMode = "notify::wrap-mode"