EntryProtocol
public protocol EntryProtocol : CellEditableProtocol, EditableProtocol
GtkEntry
is a single line text entry widget.
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:
<object class="GtkEntry">
<attributes>
<attribute name="weight" value="PANGO_WEIGHT_BOLD"/>
<attribute name="background" value="red" start="5" end="10"/>
</attributes>
</object>
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.
-
Untyped pointer to the underlying
GtkEntry
instance.Declaration
Swift
var ptr: UnsafeMutableRawPointer! { get }
-
entry_ptr
Default implementationTyped 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)
-
bind(property:
Extension methodto: _: flags: transformFrom: transformTo: ) 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 transformationtransform_to
ValueTransformer
to use for backwards transformationReturn 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:
Extension methodvalue: ) 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
-
connect(signal:
Extension methodflags: handler: ) Connect a Swift signal handler to the given, typed
EntrySignalName
signalDeclaration
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 byuserData
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(signal:
Extension methodflags: data: destroyData: signalHandler: ) Connect a C signal handler to the given, typed
EntrySignalName
signalDeclaration
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 byuserData
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:
Extension methodhandler: ) Emitted when the entry is activated.
The keybindings for this signal are all forms of the Enter key.
Note
This represents the underlyingactivate
signalDeclaration
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 methodTyped
activate
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var activateSignal: EntrySignalName { get }
-
onIconPress(flags:
Extension methodhandler: ) Emitted when an activatable icon is clicked.
Note
This represents the underlyingicon-press
signalDeclaration
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 methodTyped
icon-press
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var iconPressSignal: EntrySignalName { get }
-
onIconRelease(flags:
Extension methodhandler: ) Emitted on the button release from a mouse click over an activatable icon.
Note
This represents the underlyingicon-release
signalDeclaration
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 methodTyped
icon-release
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var iconReleaseSignal: EntrySignalName { get }
-
onNotifyActivatesDefault(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::activates-default
signalDeclaration
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 methodTyped
notify::activates-default
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyActivatesDefaultSignal: EntrySignalName { get }
-
onNotifyAttributes(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::attributes
signalDeclaration
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 methodTyped
notify::attributes
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyAttributesSignal: EntrySignalName { get }
-
onNotifyBuffer(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::buffer
signalDeclaration
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 methodTyped
notify::buffer
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyBufferSignal: EntrySignalName { get }
-
onNotifyCompletion(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::completion
signalDeclaration
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 methodTyped
notify::completion
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyCompletionSignal: EntrySignalName { get }
-
onNotifyEnableEmojiCompletion(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::enable-emoji-completion
signalDeclaration
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 -
notifyEnableEmojiCompletionSignal
Extension methodTyped
notify::enable-emoji-completion
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyEnableEmojiCompletionSignal: EntrySignalName { get }
-
onNotifyExtraMenu(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::extra-menu
signalDeclaration
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 methodTyped
notify::extra-menu
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyExtraMenuSignal: EntrySignalName { get }
-
onNotifyHasFrame(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::has-frame
signalDeclaration
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 methodTyped
notify::has-frame
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyHasFrameSignal: EntrySignalName { get }
-
onNotifyImModule(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::im-module
signalDeclaration
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 methodTyped
notify::im-module
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyImModuleSignal: EntrySignalName { get }
-
onNotifyInputHints(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::input-hints
signalDeclaration
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 methodTyped
notify::input-hints
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyInputHintsSignal: EntrySignalName { get }
-
onNotifyInputPurpose(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::input-purpose
signalDeclaration
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 methodTyped
notify::input-purpose
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyInputPurposeSignal: EntrySignalName { get }
-
onNotifyInvisibleChar(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::invisible-char
signalDeclaration
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 methodTyped
notify::invisible-char
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyInvisibleCharSignal: EntrySignalName { get }
-
onNotifyInvisibleCharSet(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::invisible-char-set
signalDeclaration
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 methodTyped
notify::invisible-char-set
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyInvisibleCharSetSignal: EntrySignalName { get }
-
onNotifyMaxLength(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::max-length
signalDeclaration
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 methodTyped
notify::max-length
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyMaxLengthSignal: EntrySignalName { get }
-
onNotifyOverwriteMode(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::overwrite-mode
signalDeclaration
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 methodTyped
notify::overwrite-mode
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyOverwriteModeSignal: EntrySignalName { get }
-
onNotifyPlaceholderText(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::placeholder-text
signalDeclaration
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 methodTyped
notify::placeholder-text
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPlaceholderTextSignal: EntrySignalName { get }
-
onNotifyPrimaryIconActivatable(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::primary-icon-activatable
signalDeclaration
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 -
notifyPrimaryIconActivatableSignal
Extension methodTyped
notify::primary-icon-activatable
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPrimaryIconActivatableSignal: EntrySignalName { get }
-
onNotifyPrimaryIconGicon(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::primary-icon-gicon
signalDeclaration
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 methodTyped
notify::primary-icon-gicon
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPrimaryIconGiconSignal: EntrySignalName { get }
-
onNotifyPrimaryIconName(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::primary-icon-name
signalDeclaration
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 methodTyped
notify::primary-icon-name
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPrimaryIconNameSignal: EntrySignalName { get }
-
onNotifyPrimaryIconPaintable(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::primary-icon-paintable
signalDeclaration
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 -
notifyPrimaryIconPaintableSignal
Extension methodTyped
notify::primary-icon-paintable
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPrimaryIconPaintableSignal: EntrySignalName { get }
-
onNotifyPrimaryIconSensitive(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::primary-icon-sensitive
signalDeclaration
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 -
notifyPrimaryIconSensitiveSignal
Extension methodTyped
notify::primary-icon-sensitive
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPrimaryIconSensitiveSignal: EntrySignalName { get }
-
onNotifyPrimaryIconStorageType(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::primary-icon-storage-type
signalDeclaration
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 -
notifyPrimaryIconStorageTypeSignal
Extension methodTyped
notify::primary-icon-storage-type
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPrimaryIconStorageTypeSignal: EntrySignalName { get }
-
onNotifyPrimaryIconTooltipMarkup(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::primary-icon-tooltip-markup
signalDeclaration
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 -
notifyPrimaryIconTooltipMarkupSignal
Extension methodTyped
notify::primary-icon-tooltip-markup
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPrimaryIconTooltipMarkupSignal: EntrySignalName { get }
-
onNotifyPrimaryIconTooltipText(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::primary-icon-tooltip-text
signalDeclaration
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 -
notifyPrimaryIconTooltipTextSignal
Extension methodTyped
notify::primary-icon-tooltip-text
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyPrimaryIconTooltipTextSignal: EntrySignalName { get }
-
onNotifyProgressFraction(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::progress-fraction
signalDeclaration
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 methodTyped
notify::progress-fraction
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyProgressFractionSignal: EntrySignalName { get }
-
onNotifyProgressPulseStep(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::progress-pulse-step
signalDeclaration
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 -
notifyProgressPulseStepSignal
Extension methodTyped
notify::progress-pulse-step
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyProgressPulseStepSignal: EntrySignalName { get }
-
onNotifyScrollOffset(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::scroll-offset
signalDeclaration
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 methodTyped
notify::scroll-offset
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyScrollOffsetSignal: EntrySignalName { get }
-
onNotifySecondaryIconActivatable(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::secondary-icon-activatable
signalDeclaration
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 -
notifySecondaryIconActivatableSignal
Extension methodTyped
notify::secondary-icon-activatable
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifySecondaryIconActivatableSignal: EntrySignalName { get }
-
onNotifySecondaryIconGicon(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::secondary-icon-gicon
signalDeclaration
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 -
notifySecondaryIconGiconSignal
Extension methodTyped
notify::secondary-icon-gicon
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifySecondaryIconGiconSignal: EntrySignalName { get }
-
onNotifySecondaryIconName(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::secondary-icon-name
signalDeclaration
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 -
notifySecondaryIconNameSignal
Extension methodTyped
notify::secondary-icon-name
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifySecondaryIconNameSignal: EntrySignalName { get }
-
onNotifySecondaryIconPaintable(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::secondary-icon-paintable
signalDeclaration
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 -
notifySecondaryIconPaintableSignal
Extension methodTyped
notify::secondary-icon-paintable
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifySecondaryIconPaintableSignal: EntrySignalName { get }
-
onNotifySecondaryIconSensitive(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::secondary-icon-sensitive
signalDeclaration
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 -
notifySecondaryIconSensitiveSignal
Extension methodTyped
notify::secondary-icon-sensitive
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifySecondaryIconSensitiveSignal: EntrySignalName { get }
-
onNotifySecondaryIconStorageType(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::secondary-icon-storage-type
signalDeclaration
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 -
notifySecondaryIconStorageTypeSignal
Extension methodTyped
notify::secondary-icon-storage-type
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifySecondaryIconStorageTypeSignal: EntrySignalName { get }
-
onNotifySecondaryIconTooltipMarkup(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::secondary-icon-tooltip-markup
signalDeclaration
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 -
notifySecondaryIconTooltipMarkupSignal
Extension methodTyped
notify::secondary-icon-tooltip-markup
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifySecondaryIconTooltipMarkupSignal: EntrySignalName { get }
-
onNotifySecondaryIconTooltipText(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::secondary-icon-tooltip-text
signalDeclaration
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 -
notifySecondaryIconTooltipTextSignal
Extension methodTyped
notify::secondary-icon-tooltip-text
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifySecondaryIconTooltipTextSignal: EntrySignalName { get }
-
onNotifyShowEmojiIcon(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::show-emoji-icon
signalDeclaration
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 methodTyped
notify::show-emoji-icon
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyShowEmojiIconSignal: EntrySignalName { get }
-
onNotifyTabs(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::tabs
signalDeclaration
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 methodTyped
notify::tabs
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyTabsSignal: EntrySignalName { get }
-
onNotifyTextLength(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::text-length
signalDeclaration
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 methodTyped
notify::text-length
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyTextLengthSignal: EntrySignalName { get }
-
onNotifyTruncateMultiline(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::truncate-multiline
signalDeclaration
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 -
notifyTruncateMultilineSignal
Extension methodTyped
notify::truncate-multiline
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyTruncateMultilineSignal: EntrySignalName { get }
-
onNotifyVisibility(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::visibility
signalDeclaration
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 methodTyped
notify::visibility
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyVisibilitySignal: EntrySignalName { get }
-
getActivatesDefault()
Extension methodRetrieves the value set by
gtk_entry_set_activates_default()
.Declaration
Swift
@inlinable func getActivatesDefault() -> Bool
-
getAlignment()
Extension methodGets the value set by
gtk_entry_set_alignment()
.See also: [property
Gtk.Editable:xalign
]Declaration
Swift
@inlinable func getAlignment() -> CFloat
-
getAttributes()
Extension methodGets the attribute list of the
GtkEntry
.See [method
Gtk.Entry.set_attributes
].Declaration
Swift
@inlinable func getAttributes() -> Pango.AttrListRef!
-
getBuffer()
Extension methodGet the
GtkEntryBuffer
object which holds the text for this widget.Declaration
Swift
@inlinable func getBuffer() -> EntryBufferRef!
-
getCompletion()
Extension methodReturns the auxiliary completion object currently in use by
entry
.Declaration
Swift
@inlinable func getCompletion() -> EntryCompletionRef!
-
getCurrentIconDragSource()
Extension methodReturns the index of the icon which is the source of the current DND operation, or -1.
Declaration
Swift
@inlinable func getCurrentIconDragSource() -> Int
-
getExtraMenu()
Extension methodGets the menu model set with
gtk_entry_set_extra_menu()
.Declaration
Swift
@inlinable func getExtraMenu() -> GIO.MenuModelRef!
-
getHasFrame()
Extension methodGets 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
-
getIconArea(iconPos:
Extension methodiconArea: ) 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 toentry
‘s allocation.Declaration
Swift
@inlinable func getIconArea<RectangleT>(iconPos: GtkEntryIconPosition, iconArea: RectangleT) where RectangleT : RectangleProtocol
-
getIconAtPos(x:
Extension methody: ) Finds the icon at the given position and return its index.
The position’s coordinates are relative to the
entry
’s top left corner. Ifx
,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., byGdkPaintable
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., byGdkPaintable
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
-
getIconTooltipMarkup(iconPos:
Extension method) 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 methodGets the input hints of this
GtkEntry
.Declaration
Swift
@inlinable func getInputHints() -> InputHints
-
getInputPurpose()
Extension methodGets the input purpose of the
GtkEntry
.Declaration
Swift
@inlinable func getInputPurpose() -> GtkInputPurpose
-
getInvisibleChar()
Extension methodRetrieves the character displayed in place of the actual text in “password mode”.
Declaration
Swift
@inlinable func getInvisibleChar() -> gunichar
-
getMaxLength()
Extension methodRetrieves the maximum allowed length of the text in
entry
.See [method
Gtk.Entry.set_max_length
].Declaration
Swift
@inlinable func getMaxLength() -> Int
-
getOverwriteMode()
Extension methodGets whether the
GtkEntry
is in overwrite mode.Declaration
Swift
@inlinable func getOverwriteMode() -> Bool
-
getPlaceholderText()
Extension methodRetrieves the text that will be displayed when
entry
is empty and unfocusedDeclaration
Swift
@inlinable func getPlaceholderText() -> String!
-
getProgressFraction()
Extension methodReturns the current fraction of the task that’s been completed.
See [method
Gtk.Entry.set_progress_fraction
].Declaration
Swift
@inlinable func getProgressFraction() -> CDouble
-
getProgressPulseStep()
Extension methodRetrieves the pulse step set with
gtk_entry_set_progress_pulse_step()
.Declaration
Swift
@inlinable func getProgressPulseStep() -> CDouble
-
getTabs()
Extension methodGets the tabstops of the `GtkEntry.
See [method
Gtk.Entry.set_tabs
].Declaration
Swift
@inlinable func getTabs() -> Pango.TabArrayRef!
-
getTextLength()
Extension methodRetrieves the current length of the text in
entry
.This is equivalent to getting
entry
‘sGtkEntryBuffer
and calling [methodGtk.EntryBuffer.get_length
] on it.Declaration
Swift
@inlinable func getTextLength() -> guint16
-
getVisibility()
Extension methodRetrieves whether the text in
entry
is visible.See [method
Gtk.Entry.set_visibility
].Declaration
Swift
@inlinable func getVisibility() -> Bool
-
grabFocusWithoutSelecting()
Extension methodCauses
entry
to have keyboard focus.It behaves like [method
Gtk.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 methodIndicates 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 methodReset 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()
-
setActivatesDefault(setting:
Extension method) 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: [property
Gtk.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 withentry
.All further configuration of the completion mechanism is done on
completion
using theGtkEntryCompletion
API. Completion is disabled ifcompletion
is set tonil
.Declaration
Swift
@inlinable func set(completion: EntryCompletionRef? = nil)
-
set(completion:
Extension method) Sets
completion
to be the auxiliary completion object to use withentry
.All further configuration of the completion mechanism is done on
completion
using theGtkEntryCompletion
API. Completion is disabled ifcompletion
is set tonil
.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)
-
setIconActivatable(iconPos:
Extension methodactivatable: ) Sets whether the icon is activatable.
Declaration
Swift
@inlinable func setIconActivatable(iconPos: GtkEntryIconPosition, activatable: Bool)
-
setIconDragSource(iconPos:
Extension methodprovider: actions: ) 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
-
setIconFromGicon(iconPos:
Extension methodicon: ) 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
isnil
, no icon will be shown in the specified position.Declaration
Swift
@inlinable func setIconFromGicon(iconPos: GtkEntryIconPosition, icon: GIO.IconRef? = nil)
-
setIconFromGicon(iconPos:
Extension methodicon: ) 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
isnil
, no icon will be shown in the specified position.Declaration
Swift
@inlinable func setIconFromGicon<IconT>(iconPos: GtkEntryIconPosition, icon: IconT?) where IconT : IconProtocol
-
setIconFromIconName(iconPos:
Extension methodiconName: ) 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
isnil
, no icon will be shown in the specified position.Declaration
Swift
@inlinable func setIconFromIconName(iconPos: GtkEntryIconPosition, iconName: UnsafePointer<CChar>? = nil)
-
setIconFromPaintable(iconPos:
Extension methodpaintable: ) Sets the icon shown in the specified position using a
GdkPaintable
.If
paintable
isnil
, no icon will be shown in the specified position.Declaration
Swift
@inlinable func setIconFromPaintable(iconPos: GtkEntryIconPosition, paintable: Gdk.PaintableRef? = nil)
-
setIconFromPaintable(iconPos:
Extension methodpaintable: ) Sets the icon shown in the specified position using a
GdkPaintable
.If
paintable
isnil
, no icon will be shown in the specified position.Declaration
Swift
@inlinable func setIconFromPaintable<PaintableT>(iconPos: GtkEntryIconPosition, paintable: PaintableT?) where PaintableT : PaintableProtocol
-
setIconSensitive(iconPos:
Extension methodsensitive: ) Sets the sensitivity for the specified icon.
Declaration
Swift
@inlinable func setIconSensitive(iconPos: GtkEntryIconPosition, sensitive: Bool)
-
setIconTooltipMarkup(iconPos:
Extension methodtooltip: ) 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
fortooltip
to remove an existing tooltip.See also [method
Gtk.Widget.set_tooltip_markup
] and [methodGtk.Entry.set_icon_tooltip_text
].Declaration
Swift
@inlinable func setIconTooltipMarkup(iconPos: GtkEntryIconPosition, tooltip: UnsafePointer<CChar>? = nil)
-
setIconTooltipText(iconPos:
Extension methodtooltip: ) Sets
tooltip
as the contents of the tooltip for the icon at the specified position.Use
nil
fortooltip
to remove an existing tooltip.See also [method
Gtk.Widget.set_tooltip_text
] and [methodGtk.Entry.set_icon_tooltip_markup
].If you unset the widget tooltip via [method
Gtk.Widget.set_tooltip_text
] or [methodGtk.Widget.set_tooltip_markup
], this sets [propertyGtk.Widget:has-tooltip
] tofalse
, which suppresses icon tooltips too. You can resolve this by then calling [methodGtk.Widget.set_has_tooltip
] to set [propertyGtk.Widget:has-tooltip
] back totrue
, 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 [method
Gtk.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
‘sGtkEntryBuffer
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)
-
setProgressPulseStep(fraction:
Extension method) Sets the fraction of total entry width to move the progress bouncing block for each pulse.
Use [method
Gtk.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 [method
Gtk.Entry.set_invisible_char
].Note that you probably want to set [property
Gtk.Entry:input-purpose
] toGTK_INPUT_PURPOSE_PASSWORD
orGTK_INPUT_PURPOSE_PIN
to inform input methods about the purpose of this entry, in addition to setting visibility tofalse
.Declaration
Swift
@inlinable func setVisibility(visible: Bool)
-
unsetInvisibleChar()
Extension methodUnsets the invisible char, so that the default invisible char is used again. See [method
Gtk.Entry.set_invisible_char
].Declaration
Swift
@inlinable func unsetInvisibleChar()
-
activatesDefault
Extension methodRetrieves the value set by
gtk_entry_set_activates_default()
.Declaration
Swift
@inlinable var activatesDefault: Bool { get nonmutating set }
-
alignment
Extension methodGets the value set by
gtk_entry_set_alignment()
.See also: [property
Gtk.Editable:xalign
]Declaration
Swift
@inlinable var alignment: CFloat { get nonmutating set }
-
attributes
Extension methodA 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
‘sstart_index
andend_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 methodThe buffer object which actually stores the text.
Declaration
Swift
@inlinable var buffer: EntryBufferRef! { get nonmutating set }
-
completion
Extension methodThe auxiliary completion object to use with the entry.
Declaration
Swift
@inlinable var completion: EntryCompletionRef! { get nonmutating set }
-
currentIconDragSource
Extension methodReturns 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 methodGets the menu model set with
gtk_entry_set_extra_menu()
.Declaration
Swift
@inlinable var extraMenu: GIO.MenuModelRef! { get nonmutating set }
-
hasFrame
Extension methodGets the value set by
gtk_entry_set_has_frame()
.Declaration
Swift
@inlinable var hasFrame: Bool { get nonmutating set }
-
inputHints
Extension methodGets the input hints of this
GtkEntry
.Declaration
Swift
@inlinable var inputHints: InputHints { get nonmutating set }
-
inputPurpose
Extension methodGets the input purpose of the
GtkEntry
.Declaration
Swift
@inlinable var inputPurpose: GtkInputPurpose { get nonmutating set }
-
invisibleChar
Extension methodRetrieves the character displayed in place of the actual text in “password mode”.
Declaration
Swift
@inlinable var invisibleChar: gunichar { get nonmutating set }
-
maxLength
Extension methodRetrieves the maximum allowed length of the text in
entry
.See [method
Gtk.Entry.set_max_length
].Declaration
Swift
@inlinable var maxLength: Int { get nonmutating set }
-
overwriteMode
Extension methodGets whether the
GtkEntry
is in overwrite mode.Declaration
Swift
@inlinable var overwriteMode: Bool { get nonmutating set }
-
placeholderText
Extension methodRetrieves the text that will be displayed when
entry
is empty and unfocusedDeclaration
Swift
@inlinable var placeholderText: String! { get nonmutating set }
-
progressFraction
Extension methodReturns the current fraction of the task that’s been completed.
See [method
Gtk.Entry.set_progress_fraction
].Declaration
Swift
@inlinable var progressFraction: CDouble { get nonmutating set }
-
progressPulseStep
Extension methodRetrieves the pulse step set with
gtk_entry_set_progress_pulse_step()
.Declaration
Swift
@inlinable var progressPulseStep: CDouble { get nonmutating set }
-
tabs
Extension methodUndocumented
Declaration
Swift
@inlinable var tabs: Pango.TabArrayRef! { get nonmutating set }
-
textLength
Extension methodRetrieves the current length of the text in
entry
.This is equivalent to getting
entry
‘sGtkEntryBuffer
and calling [methodGtk.EntryBuffer.get_length
] on it.Declaration
Swift
@inlinable var textLength: guint16 { get }
-
visibility
Extension methodWhether the entry should show the “invisible char” instead of the actual text (“password mode”).
Declaration
Swift
@inlinable var visibility: Bool { get nonmutating set }