EntryProtocol

public protocol EntryProtocol : CellEditableProtocol, EditableProtocol

GtkEntry is a single line text entry widget.

An example GtkEntry

A fairly large set of key bindings are supported by default. If the entered text is longer than the allocation of the widget, the widget will scroll so that the cursor position is visible.

When using an entry for passwords and other sensitive information, it can be put into “password mode” using [methodGtk.Entry.set_visibility]. In this mode, entered text is displayed using a “invisible” character. By default, GTK picks the best invisible character that is available in the current font, but it can be changed with [methodGtk.Entry.set_invisible_char].

GtkEntry has the ability to display progress or activity information behind the text. To make an entry display such information, use [methodGtk.Entry.set_progress_fraction] or [methodGtk.Entry.set_progress_pulse_step].

Additionally, GtkEntry can show icons at either side of the entry. These icons can be activatable by clicking, can be set up as drag source and can have tooltips. To add an icon, use [methodGtk.Entry.set_icon_from_gicon] or one of the various other functions that set an icon from an icon name or a paintable. To trigger an action when the user clicks an icon, connect to the [signalGtk.Entry::icon-press] signal. To allow DND operations from an icon, use [methodGtk.Entry.set_icon_drag_source]. To set a tooltip on an icon, use [methodGtk.Entry.set_icon_tooltip_text] or the corresponding function for markup.

Note that functionality or information that is only available by clicking on an icon in an entry may not be accessible at all to users which are not able to use a mouse or other pointing device. It is therefore recommended that any such functionality should also be available by other means, e.g. via the context menu of the entry.

CSS nodes

entry[.flat][.warning][.error]
├── text[.readonly]
├── image.left
├── image.right
╰── [progress[.pulse]]

GtkEntry has a main node with the name entry. Depending on the properties of the entry, the style classes .read-only and .flat may appear. The style classes .warning and .error may also be used with entries.

When the entry shows icons, it adds subnodes with the name image and the style class .left or .right, depending on where the icon appears.

When the entry shows progress, it adds a subnode with the name progress. The node has the style class .pulse when the shown progress is pulsing.

For all the subnodes added to the text node in various situations, see [classGtk.Text].

GtkEntry as GtkBuildable

The GtkEntry implementation of the GtkBuildable interface supports a custom <attributes> element, which supports any number of <attribute> elements. The <attribute> element has attributes named “name“, “value“, “start“ and “end“ and allows you to specify PangoAttribute values for this label.

An example of a UI definition fragment specifying Pango attributes:

&lt;object class="GtkEntry"&gt;
  &lt;attributes&gt;
    &lt;attribute name="weight" value="PANGO_WEIGHT_BOLD"/&gt;
    &lt;attribute name="background" value="red" start="5" end="10"/&gt;
  &lt;/attributes&gt;
&lt;/object&gt;

The start and end attributes specify the range of characters to which the Pango attribute applies. If start and end are not specified, the attribute is applied to the whole text. Note that specifying ranges does not make much sense with translatable attributes. Use markup embedded in the translatable content instead.

Accessibility

GtkEntry uses the GTK_ACCESSIBLE_ROLE_TEXT_BOX role.

The EntryProtocol protocol exposes the methods and properties of an underlying GtkEntry instance. The default implementation of these can be found in the protocol extension below. For a concrete class that implements these methods and properties, see Entry. Alternatively, use EntryRef as a lighweight, unowned reference if you already have an instance you just want to use.

  • ptr

    Untyped pointer to the underlying GtkEntry instance.

    Declaration

    Swift

    var ptr: UnsafeMutableRawPointer! { get }
  • entry_ptr Default implementation

    Typed pointer to the underlying GtkEntry instance.

    Default Implementation

    Return the stored, untyped pointer as a typed pointer to the GtkEntry instance.

    Declaration

    Swift

    var entry_ptr: UnsafeMutablePointer<GtkEntry>! { get }
  • Required Initialiser for types conforming to EntryProtocol

    Declaration

    Swift

    init(raw: UnsafeMutableRawPointer)

Entry Class

  • Bind a EntryPropertyName source property to a given target object.

    Declaration

    Swift

    @discardableResult
    @inlinable
    func bind<Q, T>(property source_property: EntryPropertyName, to target: T, _ target_property: Q, flags f: BindingFlags = .default, transformFrom transform_from: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }, transformTo transform_to: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }) -> BindingRef! where Q : PropertyNameProtocol, T : ObjectProtocol

    Parameters

    source_property

    the source property to bind

    target

    the target object to bind to

    target_property

    the target property to bind to

    flags

    the flags to pass to the Binding

    transform_from

    ValueTransformer to use for forward transformation

    transform_to

    ValueTransformer to use for backwards transformation

    Return Value

    binding reference or nil in case of an error

  • get(property:) Extension method

    Get the value of a Entry property

    Declaration

    Swift

    @inlinable
    func get(property: EntryPropertyName) -> GLibObject.Value

    Parameters

    property

    the property to get the value for

    Return Value

    the value of the named property

  • set(property:value:) Extension method

    Set the value of a Entry property. Note that this will only have an effect on properties that are writable and not construct-only!

    Declaration

    Swift

    @inlinable
    func set(property: EntryPropertyName, value v: GLibObject.Value)

    Parameters

    property

    the property to get the value for

    Return Value

    the value of the named property

Entry signals

  • Connect a Swift signal handler to the given, typed EntrySignalName signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func connect(signal s: EntrySignalName, flags f: ConnectFlags = ConnectFlags(0), handler h: @escaping SignalHandler) -> Int

    Parameters

    signal

    The signal to connect

    flags

    The connection flags to use

    data

    A pointer to user data to provide to the callback

    destroyData

    A GClosureNotify C function to destroy the data pointed to by userData

    handler

    The Swift signal handler (function or callback) to invoke on the given signal

    Return Value

    The signal handler ID (always greater than 0 for successful connections)

  • Connect a C signal handler to the given, typed EntrySignalName signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func connect(signal s: EntrySignalName, flags f: ConnectFlags = ConnectFlags(0), data userData: gpointer!, destroyData destructor: GClosureNotify? = nil, signalHandler h: @escaping GCallback) -> Int

    Parameters

    signal

    The signal to connect

    flags

    The connection flags to use

    data

    A pointer to user data to provide to the callback

    destroyData

    A GClosureNotify C function to destroy the data pointed to by userData

    signalHandler

    The C function to be called on the given signal

    Return Value

    The signal handler ID (always greater than 0 for successful connections)

  • onActivate(flags:handler:) Extension method

    Emitted when the entry is activated.

    The keybindings for this signal are all forms of the Enter key.

    Note

    This represents the underlying activate signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onActivate(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    handler

    The signal handler to call Run the given callback whenever the activate signal is emitted

  • activateSignal Extension method

    Typed activate signal for using the connect(signal:) methods

    Declaration

    Swift

    static var activateSignal: EntrySignalName { get }
  • onIconPress(flags:handler:) Extension method

    Emitted when an activatable icon is clicked.

    Note

    This represents the underlying icon-press signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onIconPress(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ iconPos: EntryIconPosition) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    iconPos

    The position of the clicked icon

    handler

    The signal handler to call Run the given callback whenever the iconPress signal is emitted

  • iconPressSignal Extension method

    Typed icon-press signal for using the connect(signal:) methods

    Declaration

    Swift

    static var iconPressSignal: EntrySignalName { get }
  • Emitted on the button release from a mouse click over an activatable icon.

    Note

    This represents the underlying icon-release signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onIconRelease(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ iconPos: EntryIconPosition) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    iconPos

    The position of the clicked icon

    handler

    The signal handler to call Run the given callback whenever the iconRelease signal is emitted

  • iconReleaseSignal Extension method

    Typed icon-release signal for using the connect(signal:) methods

    Declaration

    Swift

    static var iconReleaseSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::activates-default signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyActivatesDefault(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyActivatesDefault signal is emitted

  • notifyActivatesDefaultSignal Extension method

    Typed notify::activates-default signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyActivatesDefaultSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::attributes signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyAttributes(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyAttributes signal is emitted

  • notifyAttributesSignal Extension method

    Typed notify::attributes signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyAttributesSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::buffer signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyBuffer(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyBuffer signal is emitted

  • notifyBufferSignal Extension method

    Typed notify::buffer signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyBufferSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::completion signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyCompletion(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyCompletion signal is emitted

  • notifyCompletionSignal Extension method

    Typed notify::completion signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyCompletionSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::enable-emoji-completion signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyEnableEmojiCompletion(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyEnableEmojiCompletion signal is emitted

  • Typed notify::enable-emoji-completion signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyEnableEmojiCompletionSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::extra-menu signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyExtraMenu(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyExtraMenu signal is emitted

  • notifyExtraMenuSignal Extension method

    Typed notify::extra-menu signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyExtraMenuSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::has-frame signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyHasFrame(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyHasFrame signal is emitted

  • notifyHasFrameSignal Extension method

    Typed notify::has-frame signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyHasFrameSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::im-module signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyImModule(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyImModule signal is emitted

  • notifyImModuleSignal Extension method

    Typed notify::im-module signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyImModuleSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::input-hints signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyInputHints(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyInputHints signal is emitted

  • notifyInputHintsSignal Extension method

    Typed notify::input-hints signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyInputHintsSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::input-purpose signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyInputPurpose(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyInputPurpose signal is emitted

  • notifyInputPurposeSignal Extension method

    Typed notify::input-purpose signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyInputPurposeSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::invisible-char signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyInvisibleChar(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyInvisibleChar signal is emitted

  • notifyInvisibleCharSignal Extension method

    Typed notify::invisible-char signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyInvisibleCharSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::invisible-char-set signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyInvisibleCharSet(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyInvisibleCharSet signal is emitted

  • notifyInvisibleCharSetSignal Extension method

    Typed notify::invisible-char-set signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyInvisibleCharSetSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::max-length signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyMaxLength(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyMaxLength signal is emitted

  • notifyMaxLengthSignal Extension method

    Typed notify::max-length signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyMaxLengthSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::overwrite-mode signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyOverwriteMode(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyOverwriteMode signal is emitted

  • notifyOverwriteModeSignal Extension method

    Typed notify::overwrite-mode signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyOverwriteModeSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::placeholder-text signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPlaceholderText(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPlaceholderText signal is emitted

  • notifyPlaceholderTextSignal Extension method

    Typed notify::placeholder-text signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPlaceholderTextSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::primary-icon-activatable signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPrimaryIconActivatable(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPrimaryIconActivatable signal is emitted

  • Typed notify::primary-icon-activatable signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPrimaryIconActivatableSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::primary-icon-gicon signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPrimaryIconGicon(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPrimaryIconGicon signal is emitted

  • notifyPrimaryIconGiconSignal Extension method

    Typed notify::primary-icon-gicon signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPrimaryIconGiconSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::primary-icon-name signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPrimaryIconName(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPrimaryIconName signal is emitted

  • notifyPrimaryIconNameSignal Extension method

    Typed notify::primary-icon-name signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPrimaryIconNameSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::primary-icon-paintable signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPrimaryIconPaintable(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPrimaryIconPaintable signal is emitted

  • Typed notify::primary-icon-paintable signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPrimaryIconPaintableSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::primary-icon-sensitive signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPrimaryIconSensitive(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPrimaryIconSensitive signal is emitted

  • Typed notify::primary-icon-sensitive signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPrimaryIconSensitiveSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::primary-icon-storage-type signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPrimaryIconStorageType(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPrimaryIconStorageType signal is emitted

  • Typed notify::primary-icon-storage-type signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPrimaryIconStorageTypeSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::primary-icon-tooltip-markup signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPrimaryIconTooltipMarkup(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPrimaryIconTooltipMarkup signal is emitted

  • Typed notify::primary-icon-tooltip-markup signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPrimaryIconTooltipMarkupSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::primary-icon-tooltip-text signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPrimaryIconTooltipText(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyPrimaryIconTooltipText signal is emitted

  • Typed notify::primary-icon-tooltip-text signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyPrimaryIconTooltipTextSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::progress-fraction signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyProgressFraction(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyProgressFraction signal is emitted

  • notifyProgressFractionSignal Extension method

    Typed notify::progress-fraction signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyProgressFractionSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::progress-pulse-step signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyProgressPulseStep(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyProgressPulseStep signal is emitted

  • Typed notify::progress-pulse-step signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyProgressPulseStepSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::scroll-offset signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyScrollOffset(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyScrollOffset signal is emitted

  • notifyScrollOffsetSignal Extension method

    Typed notify::scroll-offset signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyScrollOffsetSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::secondary-icon-activatable signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifySecondaryIconActivatable(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifySecondaryIconActivatable signal is emitted

  • Typed notify::secondary-icon-activatable signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifySecondaryIconActivatableSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::secondary-icon-gicon signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifySecondaryIconGicon(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifySecondaryIconGicon signal is emitted

  • Typed notify::secondary-icon-gicon signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifySecondaryIconGiconSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::secondary-icon-name signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifySecondaryIconName(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifySecondaryIconName signal is emitted

  • Typed notify::secondary-icon-name signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifySecondaryIconNameSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::secondary-icon-paintable signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifySecondaryIconPaintable(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifySecondaryIconPaintable signal is emitted

  • Typed notify::secondary-icon-paintable signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifySecondaryIconPaintableSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::secondary-icon-sensitive signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifySecondaryIconSensitive(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifySecondaryIconSensitive signal is emitted

  • Typed notify::secondary-icon-sensitive signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifySecondaryIconSensitiveSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::secondary-icon-storage-type signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifySecondaryIconStorageType(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifySecondaryIconStorageType signal is emitted

  • Typed notify::secondary-icon-storage-type signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifySecondaryIconStorageTypeSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::secondary-icon-tooltip-markup signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifySecondaryIconTooltipMarkup(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifySecondaryIconTooltipMarkup signal is emitted

  • Typed notify::secondary-icon-tooltip-markup signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifySecondaryIconTooltipMarkupSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::secondary-icon-tooltip-text signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifySecondaryIconTooltipText(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifySecondaryIconTooltipText signal is emitted

  • Typed notify::secondary-icon-tooltip-text signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifySecondaryIconTooltipTextSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::show-emoji-icon signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyShowEmojiIcon(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyShowEmojiIcon signal is emitted

  • notifyShowEmojiIconSignal Extension method

    Typed notify::show-emoji-icon signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyShowEmojiIconSignal: EntrySignalName { get }
  • onNotifyTabs(flags:handler:) Extension method

    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:

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

    Note

    This represents the underlying notify::tabs signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyTabs(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyTabs signal is emitted

  • notifyTabsSignal Extension method

    Typed notify::tabs signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyTabsSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::text-length signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyTextLength(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyTextLength signal is emitted

  • notifyTextLengthSignal Extension method

    Typed notify::text-length signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyTextLengthSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::truncate-multiline signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyTruncateMultiline(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyTruncateMultiline signal is emitted

  • Typed notify::truncate-multiline signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyTruncateMultilineSignal: EntrySignalName { get }
  • 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:

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

    Note

    This represents the underlying notify::visibility signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyVisibility(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EntryRef, _ pspec: ParamSpecRef) -> Void) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    pspec

    the GParamSpec of the property which changed.

    handler

    The signal handler to call Run the given callback whenever the notifyVisibility signal is emitted

  • notifyVisibilitySignal Extension method

    Typed notify::visibility signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyVisibilitySignal: EntrySignalName { get }

Entry Class: EntryProtocol extension (methods and fields)

  • getActivatesDefault() Extension method

    Retrieves the value set by gtk_entry_set_activates_default().

    Declaration

    Swift

    @inlinable
    func getActivatesDefault() -> Bool
  • getAlignment() Extension method

    Gets the value set by gtk_entry_set_alignment().

    See also: [propertyGtk.Editable:xalign]

    Declaration

    Swift

    @inlinable
    func getAlignment() -> CFloat
  • getAttributes() Extension method

    Gets the attribute list of the GtkEntry.

    See [methodGtk.Entry.set_attributes].

    Declaration

    Swift

    @inlinable
    func getAttributes() -> Pango.AttrListRef!
  • getBuffer() Extension method

    Get the GtkEntryBuffer object which holds the text for this widget.

    Declaration

    Swift

    @inlinable
    func getBuffer() -> EntryBufferRef!
  • getCompletion() Extension method

    Returns the auxiliary completion object currently in use by entry.

    Declaration

    Swift

    @inlinable
    func getCompletion() -> EntryCompletionRef!
  • getCurrentIconDragSource() Extension method

    Returns the index of the icon which is the source of the current DND operation, or -1.

    Declaration

    Swift

    @inlinable
    func getCurrentIconDragSource() -> Int
  • getExtraMenu() Extension method

    Gets the menu model set with gtk_entry_set_extra_menu().

    Declaration

    Swift

    @inlinable
    func getExtraMenu() -> GIO.MenuModelRef!
  • getHasFrame() Extension method

    Gets the value set by gtk_entry_set_has_frame().

    Declaration

    Swift

    @inlinable
    func getHasFrame() -> Bool
  • getIconActivatable(iconPos:) Extension method

    Returns whether the icon is activatable.

    Declaration

    Swift

    @inlinable
    func getIconActivatable(iconPos: GtkEntryIconPosition) -> Bool
  • Gets the area where entry’s icon at icon_pos is drawn.

    This function is useful when drawing something to the entry in a draw callback.

    If the entry is not realized or has no icon at the given position, icon_area is filled with zeros. Otherwise, icon_area will be filled with the icon’s allocation, relative to entry‘s allocation.

    Declaration

    Swift

    @inlinable
    func getIconArea<RectangleT>(iconPos: GtkEntryIconPosition, iconArea: RectangleT) where RectangleT : RectangleProtocol
  • getIconAtPos(x:y:) Extension method

    Finds the icon at the given position and return its index.

    The position’s coordinates are relative to the entry’s top left corner. If x, y doesn’t lie inside an icon, -1 is returned. This function is intended for use in a [signalGtk.Widget::query-tooltip] signal handler.

    Declaration

    Swift

    @inlinable
    func getIconAtPos(x: Int, y: Int) -> Int
  • getIconGicon(iconPos:) Extension method

    Retrieves the GIcon used for the icon.

    nil will be returned if there is no icon or if the icon was set by some other method (e.g., by GdkPaintable or icon name).

    Declaration

    Swift

    @inlinable
    func getIconGicon(iconPos: GtkEntryIconPosition) -> GIO.IconRef!
  • getIconName(iconPos:) Extension method

    Retrieves the icon name used for the icon.

    nil is returned if there is no icon or if the icon was set by some other method (e.g., by GdkPaintable or gicon).

    Declaration

    Swift

    @inlinable
    func getIconName(iconPos: GtkEntryIconPosition) -> String!
  • getIconPaintable(iconPos:) Extension method

    Retrieves the GdkPaintable used for the icon.

    If no GdkPaintable was used for the icon, nil is returned.

    Declaration

    Swift

    @inlinable
    func getIconPaintable(iconPos: GtkEntryIconPosition) -> Gdk.PaintableRef!
  • getIconSensitive(iconPos:) Extension method

    Returns whether the icon appears sensitive or insensitive.

    Declaration

    Swift

    @inlinable
    func getIconSensitive(iconPos: GtkEntryIconPosition) -> Bool
  • getIconStorageType(iconPos:) Extension method

    Gets the type of representation being used by the icon to store image data.

    If the icon has no image data, the return value will be GTK_IMAGE_EMPTY.

    Declaration

    Swift

    @inlinable
    func getIconStorageType(iconPos: GtkEntryIconPosition) -> GtkImageType
  • Gets the contents of the tooltip on the icon at the specified position in entry.

    Declaration

    Swift

    @inlinable
    func getIconTooltipMarkup(iconPos: GtkEntryIconPosition) -> String!
  • getIconTooltipText(iconPos:) Extension method

    Gets the contents of the tooltip on the icon at the specified position in entry.

    Declaration

    Swift

    @inlinable
    func getIconTooltipText(iconPos: GtkEntryIconPosition) -> String!
  • getInputHints() Extension method

    Gets the input hints of this GtkEntry.

    Declaration

    Swift

    @inlinable
    func getInputHints() -> InputHints
  • getInputPurpose() Extension method

    Gets the input purpose of the GtkEntry.

    Declaration

    Swift

    @inlinable
    func getInputPurpose() -> GtkInputPurpose
  • getInvisibleChar() Extension method

    Retrieves the character displayed in place of the actual text in “password mode”.

    Declaration

    Swift

    @inlinable
    func getInvisibleChar() -> gunichar
  • getMaxLength() Extension method

    Retrieves the maximum allowed length of the text in entry.

    See [methodGtk.Entry.set_max_length].

    Declaration

    Swift

    @inlinable
    func getMaxLength() -> Int
  • getOverwriteMode() Extension method

    Gets whether the GtkEntry is in overwrite mode.

    Declaration

    Swift

    @inlinable
    func getOverwriteMode() -> Bool
  • getPlaceholderText() Extension method

    Retrieves the text that will be displayed when entry is empty and unfocused

    Declaration

    Swift

    @inlinable
    func getPlaceholderText() -> String!
  • getProgressFraction() Extension method

    Returns the current fraction of the task that’s been completed.

    See [methodGtk.Entry.set_progress_fraction].

    Declaration

    Swift

    @inlinable
    func getProgressFraction() -> CDouble
  • getProgressPulseStep() Extension method

    Retrieves the pulse step set with gtk_entry_set_progress_pulse_step().

    Declaration

    Swift

    @inlinable
    func getProgressPulseStep() -> CDouble
  • getTabs() Extension method

    Gets the tabstops of the `GtkEntry.

    See [methodGtk.Entry.set_tabs].

    Declaration

    Swift

    @inlinable
    func getTabs() -> Pango.TabArrayRef!
  • getTextLength() Extension method

    Retrieves the current length of the text in entry.

    This is equivalent to getting entry‘s GtkEntryBuffer and calling [methodGtk.EntryBuffer.get_length] on it.

    Declaration

    Swift

    @inlinable
    func getTextLength() -> guint16
  • getVisibility() Extension method

    Retrieves whether the text in entry is visible.

    See [methodGtk.Entry.set_visibility].

    Declaration

    Swift

    @inlinable
    func getVisibility() -> Bool
  • grabFocusWithoutSelecting() Extension method

    Causes entry to have keyboard focus.

    It behaves like [methodGtk.Widget.grab_focus], except that it doesn’t select the contents of the entry. You only want to call this on some special entries which the user usually doesn’t want to replace all text in, such as search-as-you-type entries.

    Declaration

    Swift

    @inlinable
    func grabFocusWithoutSelecting() -> Bool
  • progressPulse() Extension method

    Indicates that some progress is made, but you don’t know how much.

    Causes the entry’s progress indicator to enter “activity mode”, where a block bounces back and forth. Each call to gtk_entry_progress_pulse() causes the block to move by a little bit (the amount of movement per pulse is determined by [methodGtk.Entry.set_progress_pulse_step]).

    Declaration

    Swift

    @inlinable
    func progressPulse()
  • resetImContext() Extension method

    Reset the input method context of the entry if needed.

    This can be necessary in the case where modifying the buffer would confuse on-going input method behavior.

    Declaration

    Swift

    @inlinable
    func resetImContext()
  • Sets whether pressing Enter in the entry will activate the default widget for the window containing the entry.

    This usually means that the dialog containing the entry will be closed, since the default widget is usually one of the dialog buttons.

    Declaration

    Swift

    @inlinable
    func setActivatesDefault(setting: Bool)
  • setAlignment(xalign:) Extension method

    Sets the alignment for the contents of the entry.

    This controls the horizontal positioning of the contents when the displayed text is shorter than the width of the entry.

    See also: [propertyGtk.Editable:xalign]

    Declaration

    Swift

    @inlinable
    func setAlignment(xalign: CFloat)
  • setAttributes(attrs:) Extension method

    Sets a PangoAttrList.

    The attributes in the list are applied to the entry text.

    Since the attributes will be applies to text that changes as the user types, it makes most sense to use attributes with unlimited extent.

    Declaration

    Swift

    @inlinable
    func setAttributes<AttrListT>(attrs: AttrListT) where AttrListT : AttrListProtocol
  • set(buffer:) Extension method

    Set the GtkEntryBuffer object which holds the text for this widget.

    Declaration

    Swift

    @inlinable
    func set<EntryBufferT>(buffer: EntryBufferT) where EntryBufferT : EntryBufferProtocol
  • set(completion:) Extension method

    Sets completion to be the auxiliary completion object to use with entry.

    All further configuration of the completion mechanism is done on completion using the GtkEntryCompletion API. Completion is disabled if completion is set to nil.

    Declaration

    Swift

    @inlinable
    func set(completion: EntryCompletionRef? = nil)
  • set(completion:) Extension method

    Sets completion to be the auxiliary completion object to use with entry.

    All further configuration of the completion mechanism is done on completion using the GtkEntryCompletion API. Completion is disabled if completion is set to nil.

    Declaration

    Swift

    @inlinable
    func set<EntryCompletionT>(completion: EntryCompletionT?) where EntryCompletionT : EntryCompletionProtocol
  • setExtraMenu(model:) Extension method

    Sets a menu model to add when constructing the context menu for entry.

    Declaration

    Swift

    @inlinable
    func setExtraMenu(model: GIO.MenuModelRef? = nil)
  • setExtraMenu(model:) Extension method

    Sets a menu model to add when constructing the context menu for entry.

    Declaration

    Swift

    @inlinable
    func setExtraMenu<MenuModelT>(model: MenuModelT?) where MenuModelT : MenuModelProtocol
  • setHasFrame(setting:) Extension method

    Sets whether the entry has a beveled frame around it.

    Declaration

    Swift

    @inlinable
    func setHasFrame(setting: Bool)
  • Sets whether the icon is activatable.

    Declaration

    Swift

    @inlinable
    func setIconActivatable(iconPos: GtkEntryIconPosition, activatable: Bool)
  • Sets up the icon at the given position as drag source.

    This makes it so that GTK will start a drag operation when the user clicks and drags the icon.

    Declaration

    Swift

    @inlinable
    func setIconDragSource<ContentProviderT>(iconPos: GtkEntryIconPosition, provider: ContentProviderT, actions: Gdk.DragAction) where ContentProviderT : ContentProviderProtocol
  • Sets the icon shown in the entry at the specified position from the current icon theme.

    If the icon isn’t known, a “broken image” icon will be displayed instead.

    If icon is nil, no icon will be shown in the specified position.

    Declaration

    Swift

    @inlinable
    func setIconFromGicon(iconPos: GtkEntryIconPosition, icon: GIO.IconRef? = nil)
  • Sets the icon shown in the entry at the specified position from the current icon theme.

    If the icon isn’t known, a “broken image” icon will be displayed instead.

    If icon is nil, no icon will be shown in the specified position.

    Declaration

    Swift

    @inlinable
    func setIconFromGicon<IconT>(iconPos: GtkEntryIconPosition, icon: IconT?) where IconT : IconProtocol
  • Sets the icon shown in the entry at the specified position from the current icon theme.

    If the icon name isn’t known, a “broken image” icon will be displayed instead.

    If icon_name is nil, no icon will be shown in the specified position.

    Declaration

    Swift

    @inlinable
    func setIconFromIconName(iconPos: GtkEntryIconPosition, iconName: UnsafePointer<CChar>? = nil)
  • Sets the icon shown in the specified position using a GdkPaintable.

    If paintable is nil, no icon will be shown in the specified position.

    Declaration

    Swift

    @inlinable
    func setIconFromPaintable(iconPos: GtkEntryIconPosition, paintable: Gdk.PaintableRef? = nil)
  • Sets the icon shown in the specified position using a GdkPaintable.

    If paintable is nil, no icon will be shown in the specified position.

    Declaration

    Swift

    @inlinable
    func setIconFromPaintable<PaintableT>(iconPos: GtkEntryIconPosition, paintable: PaintableT?) where PaintableT : PaintableProtocol
  • Sets the sensitivity for the specified icon.

    Declaration

    Swift

    @inlinable
    func setIconSensitive(iconPos: GtkEntryIconPosition, sensitive: Bool)
  • Sets tooltip as the contents of the tooltip for the icon at the specified position.

    tooltip is assumed to be marked up with Pango Markup.

    Use nil for tooltip to remove an existing tooltip.

    See also [methodGtk.Widget.set_tooltip_markup] and [methodGtk.Entry.set_icon_tooltip_text].

    Declaration

    Swift

    @inlinable
    func setIconTooltipMarkup(iconPos: GtkEntryIconPosition, tooltip: UnsafePointer<CChar>? = nil)
  • Sets tooltip as the contents of the tooltip for the icon at the specified position.

    Use nil for tooltip to remove an existing tooltip.

    See also [methodGtk.Widget.set_tooltip_text] and [methodGtk.Entry.set_icon_tooltip_markup].

    If you unset the widget tooltip via [methodGtk.Widget.set_tooltip_text] or [methodGtk.Widget.set_tooltip_markup], this sets [propertyGtk.Widget:has-tooltip] to false, which suppresses icon tooltips too. You can resolve this by then calling [methodGtk.Widget.set_has_tooltip] to set [propertyGtk.Widget:has-tooltip] back to true, or setting at least one non-empty tooltip on any icon achieves the same result.

    Declaration

    Swift

    @inlinable
    func setIconTooltipText(iconPos: GtkEntryIconPosition, tooltip: UnsafePointer<CChar>? = nil)
  • setInput(hints:) Extension method

    Set additional hints which allow input methods to fine-tune their behavior.

    Declaration

    Swift

    @inlinable
    func setInput(hints: InputHints)
  • setInput(purpose:) Extension method

    Sets the input purpose which can be used by input methods to adjust their behavior.

    Declaration

    Swift

    @inlinable
    func setInput(purpose: GtkInputPurpose)
  • setInvisibleChar(ch:) Extension method

    Sets the character to use in place of the actual text in “password mode”.

    See [methodGtk.Entry.set_visibility] for how to enable “password mode”.

    By default, GTK picks the best invisible char available in the current font. If you set the invisible char to 0, then the user will get no feedback at all; there will be no text on the screen as they type.

    Declaration

    Swift

    @inlinable
    func setInvisibleChar(ch: gunichar)
  • setMaxLength(max:) Extension method

    Sets the maximum allowed length of the contents of the widget.

    If the current contents are longer than the given length, then they will be truncated to fit. The length is is in characters.

    This is equivalent to getting entry‘s GtkEntryBuffer and calling [methodGtk.EntryBuffer.set_max_length] on it.

    Declaration

    Swift

    @inlinable
    func setMaxLength(max: Int)
  • setOverwriteMode(overwrite:) Extension method

    Sets whether the text is overwritten when typing in the GtkEntry.

    Declaration

    Swift

    @inlinable
    func setOverwriteMode(overwrite: Bool)
  • setPlaceholder(text:) Extension method

    Sets text to be displayed in entry when it is empty.

    This can be used to give a visual hint of the expected contents of the GtkEntry.

    Declaration

    Swift

    @inlinable
    func setPlaceholder(text: UnsafePointer<CChar>? = nil)
  • setProgress(fraction:) Extension method

    Causes the entry’s progress indicator to “fill in” the given fraction of the bar.

    The fraction should be between 0.0 and 1.0, inclusive.

    Declaration

    Swift

    @inlinable
    func setProgress(fraction: CDouble)
  • Sets the fraction of total entry width to move the progress bouncing block for each pulse.

    Use [methodGtk.Entry.progress_pulse] to pulse the progress.

    Declaration

    Swift

    @inlinable
    func setProgressPulseStep(fraction: CDouble)
  • set(tabs:) Extension method

    Sets a PangoTabArray.

    The tabstops in the array are applied to the entry text.

    Declaration

    Swift

    @inlinable
    func set(tabs: Pango.TabArrayRef? = nil)
  • set(tabs:) Extension method

    Sets a PangoTabArray.

    The tabstops in the array are applied to the entry text.

    Declaration

    Swift

    @inlinable
    func set<TabArrayT>(tabs: TabArrayT?) where TabArrayT : TabArrayProtocol
  • setVisibility(visible:) Extension method

    Sets whether the contents of the entry are visible or not.

    When visibility is set to false, characters are displayed as the invisible char, and will also appear that way when the text in the entry widget is copied elsewhere.

    By default, GTK picks the best invisible character available in the current font, but it can be changed with [methodGtk.Entry.set_invisible_char].

    Note that you probably want to set [propertyGtk.Entry:input-purpose] to GTK_INPUT_PURPOSE_PASSWORD or GTK_INPUT_PURPOSE_PIN to inform input methods about the purpose of this entry, in addition to setting visibility to false.

    Declaration

    Swift

    @inlinable
    func setVisibility(visible: Bool)
  • unsetInvisibleChar() Extension method

    Unsets the invisible char, so that the default invisible char is used again. See [methodGtk.Entry.set_invisible_char].

    Declaration

    Swift

    @inlinable
    func unsetInvisibleChar()
  • activatesDefault Extension method

    Retrieves the value set by gtk_entry_set_activates_default().

    Declaration

    Swift

    @inlinable
    var activatesDefault: Bool { get nonmutating set }
  • alignment Extension method

    Gets the value set by gtk_entry_set_alignment().

    See also: [propertyGtk.Editable:xalign]

    Declaration

    Swift

    @inlinable
    var alignment: CFloat { get nonmutating set }
  • attributes Extension method

    A list of Pango attributes to apply to the text of the entry.

    This is mainly useful to change the size or weight of the text.

    The PangoAttribute‘s start_index and end_index must refer to the [classGtk.EntryBuffer] text, i.e. without the preedit string.

    Declaration

    Swift

    @inlinable
    var attributes: Pango.AttrListRef! { get nonmutating set }
  • buffer Extension method

    The buffer object which actually stores the text.

    Declaration

    Swift

    @inlinable
    var buffer: EntryBufferRef! { get nonmutating set }
  • completion Extension method

    The auxiliary completion object to use with the entry.

    Declaration

    Swift

    @inlinable
    var completion: EntryCompletionRef! { get nonmutating set }
  • currentIconDragSource Extension method

    Returns the index of the icon which is the source of the current DND operation, or -1.

    Declaration

    Swift

    @inlinable
    var currentIconDragSource: Int { get }
  • extraMenu Extension method

    Gets the menu model set with gtk_entry_set_extra_menu().

    Declaration

    Swift

    @inlinable
    var extraMenu: GIO.MenuModelRef! { get nonmutating set }
  • hasFrame Extension method

    Gets the value set by gtk_entry_set_has_frame().

    Declaration

    Swift

    @inlinable
    var hasFrame: Bool { get nonmutating set }
  • inputHints Extension method

    Gets the input hints of this GtkEntry.

    Declaration

    Swift

    @inlinable
    var inputHints: InputHints { get nonmutating set }
  • inputPurpose Extension method

    Gets the input purpose of the GtkEntry.

    Declaration

    Swift

    @inlinable
    var inputPurpose: GtkInputPurpose { get nonmutating set }
  • invisibleChar Extension method

    Retrieves the character displayed in place of the actual text in “password mode”.

    Declaration

    Swift

    @inlinable
    var invisibleChar: gunichar { get nonmutating set }
  • maxLength Extension method

    Retrieves the maximum allowed length of the text in entry.

    See [methodGtk.Entry.set_max_length].

    Declaration

    Swift

    @inlinable
    var maxLength: Int { get nonmutating set }
  • overwriteMode Extension method

    Gets whether the GtkEntry is in overwrite mode.

    Declaration

    Swift

    @inlinable
    var overwriteMode: Bool { get nonmutating set }
  • placeholderText Extension method

    Retrieves the text that will be displayed when entry is empty and unfocused

    Declaration

    Swift

    @inlinable
    var placeholderText: String! { get nonmutating set }
  • progressFraction Extension method

    Returns the current fraction of the task that’s been completed.

    See [methodGtk.Entry.set_progress_fraction].

    Declaration

    Swift

    @inlinable
    var progressFraction: CDouble { get nonmutating set }
  • progressPulseStep Extension method

    Retrieves the pulse step set with gtk_entry_set_progress_pulse_step().

    Declaration

    Swift

    @inlinable
    var progressPulseStep: CDouble { get nonmutating set }
  • tabs Extension method

    Undocumented

    Declaration

    Swift

    @inlinable
    var tabs: Pango.TabArrayRef! { get nonmutating set }
  • textLength Extension method

    Retrieves the current length of the text in entry.

    This is equivalent to getting entry‘s GtkEntryBuffer and calling [methodGtk.EntryBuffer.get_length] on it.

    Declaration

    Swift

    @inlinable
    var textLength: guint16 { get }
  • visibility Extension method

    Whether the entry should show the “invisible char” instead of the actual text (“password mode”).

    Declaration

    Swift

    @inlinable
    var visibility: Bool { get nonmutating set }