FlowBoxChildProtocol
public protocol FlowBoxChildProtocol : WidgetProtocol
GtkFlowBoxChild is the kind of widget that can be added to a GtkFlowBox.
The FlowBoxChildProtocol protocol exposes the methods and properties of an underlying GtkFlowBoxChild 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 FlowBoxChild.
Alternatively, use FlowBoxChildRef as a lighweight, unowned reference if you already have an instance you just want to use.
-
Untyped pointer to the underlying
GtkFlowBoxChildinstance.Declaration
Swift
var ptr: UnsafeMutableRawPointer! { get } -
flow_box_child_ptrDefault implementationTyped pointer to the underlying
GtkFlowBoxChildinstance.Default Implementation
Return the stored, untyped pointer as a typed pointer to the
GtkFlowBoxChildinstance.Declaration
Swift
var flow_box_child_ptr: UnsafeMutablePointer<GtkFlowBoxChild>! { get } -
Required Initialiser for types conforming to
FlowBoxChildProtocolDeclaration
Swift
init(raw: UnsafeMutableRawPointer)
-
bind(property:Extension methodto: _: flags: transformFrom: transformTo: ) Bind a
FlowBoxChildPropertyNamesource property to a given target object.Declaration
Swift
@discardableResult @inlinable func bind<Q, T>(property source_property: FlowBoxChildPropertyName, 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 : ObjectProtocolParameters
source_propertythe source property to bind
targetthe target object to bind to
target_propertythe target property to bind to
flagsthe flags to pass to the
Bindingtransform_fromValueTransformerto use for forward transformationtransform_toValueTransformerto use for backwards transformationReturn Value
binding reference or
nilin case of an error -
get(property:Extension method) Get the value of a FlowBoxChild property
Declaration
Swift
@inlinable func get(property: FlowBoxChildPropertyName) -> GLibObject.ValueParameters
propertythe property to get the value for
Return Value
the value of the named property
-
set(property:Extension methodvalue: ) Set the value of a FlowBoxChild property. Note that this will only have an effect on properties that are writable and not construct-only!
Declaration
Swift
@inlinable func set(property: FlowBoxChildPropertyName, value v: GLibObject.Value)Parameters
propertythe 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
FlowBoxChildSignalNamesignalDeclaration
Swift
@discardableResult @inlinable func connect(signal s: FlowBoxChildSignalName, flags f: ConnectFlags = ConnectFlags(0), handler h: @escaping SignalHandler) -> IntParameters
signalThe signal to connect
flagsThe connection flags to use
dataA pointer to user data to provide to the callback
destroyDataA
GClosureNotifyC function to destroy the data pointed to byuserDatahandlerThe 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
FlowBoxChildSignalNamesignalDeclaration
Swift
@discardableResult @inlinable func connect(signal s: FlowBoxChildSignalName, flags f: ConnectFlags = ConnectFlags(0), data userData: gpointer!, destroyData destructor: GClosureNotify? = nil, signalHandler h: @escaping GCallback) -> IntParameters
signalThe signal to connect
flagsThe connection flags to use
dataA pointer to user data to provide to the callback
destroyDataA
GClosureNotifyC function to destroy the data pointed to byuserDatasignalHandlerThe 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 user activates a child widget in a
GtkFlowBox.This can be happen either by clicking or double-clicking, or via a keybinding.
This is a keybinding signal, but it can be used by applications for their own purposes.
The default bindings are <kbd>Space</kbd> and <kbd>Enter</kbd>.
Note
This represents the underlyingactivatesignalDeclaration
Swift
@discardableResult @inlinable func onActivate(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: FlowBoxChildRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
handlerThe signal handler to call Run the given callback whenever the
activatesignal is emitted -
activateSignalExtension methodTyped
activatesignal for using theconnect(signal:)methodsDeclaration
Swift
static var activateSignal: FlowBoxChildSignalName { get } -
onNotifyChild(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 innotifybeing 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::childsignalDeclaration
Swift
@discardableResult @inlinable func onNotifyChild(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: FlowBoxChildRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyChildsignal is emitted -
notifyChildSignalExtension methodTyped
notify::childsignal for using theconnect(signal:)methodsDeclaration
Swift
static var notifyChildSignal: FlowBoxChildSignalName { get }
-
changed()Extension methodMarks
childas changed, causing any state that depends on this to be updated.This affects sorting and filtering.
Note that calls to this method must be in sync with the data used for the sorting and filtering functions. For instance, if the list is mirroring some external data set, and two children changed in the external data set when you call
gtk_flow_box_child_changed()on the first child, the sort function must only read the new data for the first of the two changed children, otherwise the resorting of the children will be wrong.This generally means that if you don’t fully control the data model, you have to duplicate the data that affects the sorting and filtering functions into the widgets themselves.
Another alternative is to call [method
Gtk.FlowBox.invalidate_sort] on any model change, but that is more expensive.Declaration
Swift
@inlinable func changed() -
getChild()Extension methodGets the child widget of
self.Declaration
Swift
@inlinable func getChild() -> WidgetRef! -
getIndex()Extension methodGets the current index of the
childin itsGtkFlowBoxcontainer.Declaration
Swift
@inlinable func getIndex() -> Int -
set(child:Extension method) Sets the child widget of
self.Declaration
Swift
@inlinable func set(child: WidgetRef? = nil) -
set(child:Extension method) Sets the child widget of
self.Declaration
Swift
@inlinable func set<WidgetT>(child: WidgetT?) where WidgetT : WidgetProtocol -
childExtension methodThe child widget.
Declaration
Swift
@inlinable var child: WidgetRef! { get nonmutating set } -
indexExtension methodGets the current index of the
childin itsGtkFlowBoxcontainer.Declaration
Swift
@inlinable var index: Int { get } -
isSelectedExtension methodReturns whether the
childis currently selected in itsGtkFlowBoxcontainer.Declaration
Swift
@inlinable var isSelected: Bool { get }
View on GitHub
Install in Dash
FlowBoxChildProtocol Protocol Reference