PanedProtocol

public protocol PanedProtocol : OrientableProtocol, WidgetProtocol

GtkPaned has two panes, arranged either horizontally or vertically.

An example GtkPaned

The division between the two panes is adjustable by the user by dragging a handle.

Child widgets are added to the panes of the widget with [methodGtk.Paned.set_start_child] and [methodGtk.Paned.set_end_child]. The division between the two children is set by default from the size requests of the children, but it can be adjusted by the user.

A paned widget draws a separator between the two child widgets and a small handle that the user can drag to adjust the division. It does not draw any relief around the children or around the separator. (The space in which the separator is called the gutter.) Often, it is useful to put each child inside a [classGtk.Frame] so that the gutter appears as a ridge. No separator is drawn if one of the children is missing.

Each child has two options that can be set, resize and shrink. If resize is true, then when the GtkPaned is resized, that child will expand or shrink along with the paned widget. If shrink is true, then that child can be made smaller than its requisition by the user. Setting shrink to false allows the application to set a minimum size. If resize is false for both children, then this is treated as if resize is true for both children.

The application can set the position of the slider as if it were set by the user, by calling [methodGtk.Paned.set_position].

CSS nodes

paned
├── <child>
├── separator[.wide]
╰── <child>

GtkPaned has a main CSS node with name paned, and a subnode for the separator with name separator. The subnode gets a .wide style class when the paned is supposed to be wide.

In horizontal orientation, the nodes are arranged based on the text direction, so in left-to-right mode, :first-child will select the leftmost child, while it will select the rightmost child in RTL layouts.

Creating a paned widget with minimum sizes.

GtkWidget *hpaned = gtk_paned_new (GTK_ORIENTATION_HORIZONTAL);
GtkWidget *frame1 = gtk_frame_new (NULL);
GtkWidget *frame2 = gtk_frame_new (NULL);

gtk_widget_set_size_request (hpaned, 200, -1);

gtk_paned_set_start_child (GTK_PANED (hpaned), frame1);
gtk_paned_set_start_child_resize (GTK_PANED (hpaned), TRUE);
gtk_paned_set_start_child_shrink (GTK_PANED (hpaned), FALSE);
gtk_widget_set_size_request (frame1, 50, -1);

gtk_paned_set_end_child (GTK_PANED (hpaned), frame2);
gtk_paned_set_end_child_resize (GTK_PANED (hpaned), FALSE);
gtk_paned_set_end_child_shrink (GTK_PANED (hpaned), FALSE);
gtk_widget_set_size_request (frame2, 50, -1);

The PanedProtocol protocol exposes the methods and properties of an underlying GtkPaned 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 Paned. Alternatively, use PanedRef as a lighweight, unowned reference if you already have an instance you just want to use.

  • ptr

    Untyped pointer to the underlying GtkPaned instance.

    Declaration

    Swift

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

    Typed pointer to the underlying GtkPaned instance.

    Default Implementation

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

    Declaration

    Swift

    var paned_ptr: UnsafeMutablePointer<GtkPaned>! { get }
  • Required Initialiser for types conforming to PanedProtocol

    Declaration

    Swift

    init(raw: UnsafeMutableRawPointer)

Paned Class

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

    Declaration

    Swift

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

    Parameters

    source_property

    the source property to bind

    target

    the target object to bind to

    target_property

    the target property to bind to

    flags

    the flags to pass to the Binding

    transform_from

    ValueTransformer to use for forward transformation

    transform_to

    ValueTransformer to use for backwards transformation

    Return Value

    binding reference or nil in case of an error

  • get(property:) Extension method

    Get the value of a Paned property

    Declaration

    Swift

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

    Parameters

    property

    the property to get the value for

    Return Value

    the value of the named property

  • set(property:value:) Extension method

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

    Declaration

    Swift

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

    Parameters

    property

    the property to get the value for

    Return Value

    the value of the named property

Paned signals

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

    Declaration

    Swift

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

    Parameters

    signal

    The signal to connect

    flags

    The connection flags to use

    data

    A pointer to user data to provide to the callback

    destroyData

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

    handler

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

    Return Value

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

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

    Declaration

    Swift

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

    Parameters

    signal

    The signal to connect

    flags

    The connection flags to use

    data

    A pointer to user data to provide to the callback

    destroyData

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

    signalHandler

    The C function to be called on the given signal

    Return Value

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

  • Emitted to accept the current position of the handle when moving it using key bindings.

    This is a keybinding signal.

    The default binding for this signal is Return or Space.

    Note

    This represents the underlying accept-position signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onAcceptPosition(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef) -> Bool) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    handler

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

  • acceptPositionSignal Extension method

    Typed accept-position signal for using the connect(signal:) methods

    Declaration

    Swift

    static var acceptPositionSignal: PanedSignalName { get }
  • Emitted to cancel moving the position of the handle using key bindings.

    The position of the handle will be reset to the value prior to moving it.

    This is a keybinding signal.

    The default binding for this signal is Escape.

    Note

    This represents the underlying cancel-position signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onCancelPosition(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef) -> Bool) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    handler

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

  • cancelPositionSignal Extension method

    Typed cancel-position signal for using the connect(signal:) methods

    Declaration

    Swift

    static var cancelPositionSignal: PanedSignalName { get }
  • Emitted to cycle the focus between the children of the paned.

    This is a keybinding signal.

    The default binding is F6.

    Note

    This represents the underlying cycle-child-focus signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onCycleChildFocus(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ reversed: Bool) -> Bool) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    reversed

    whether cycling backward or forward

    handler

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

  • cycleChildFocusSignal Extension method

    Typed cycle-child-focus signal for using the connect(signal:) methods

    Declaration

    Swift

    static var cycleChildFocusSignal: PanedSignalName { get }
  • Emitted to cycle whether the paned should grab focus to allow the user to change position of the handle by using key bindings.

    This is a keybinding signal.

    The default binding for this signal is F8.

    Note

    This represents the underlying cycle-handle-focus signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onCycleHandleFocus(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ reversed: Bool) -> Bool) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    reversed

    whether cycling backward or forward

    handler

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

  • cycleHandleFocusSignal Extension method

    Typed cycle-handle-focus signal for using the connect(signal:) methods

    Declaration

    Swift

    static var cycleHandleFocusSignal: PanedSignalName { get }
  • onMoveHandle(flags:handler:) Extension method

    Emitted to move the handle with key bindings.

    This is a keybinding signal.

    Note

    This represents the underlying move-handle signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onMoveHandle(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ scrollType: ScrollType) -> Bool) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    scrollType

    a GtkScrollType

    handler

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

  • moveHandleSignal Extension method

    Typed move-handle signal for using the connect(signal:) methods

    Declaration

    Swift

    static var moveHandleSignal: PanedSignalName { get }
  • Emitted to accept the current position of the handle and then move focus to the next widget in the focus chain.

    This is a keybinding signal.

    The default binding is Tab.

    Note

    This represents the underlying toggle-handle-focus signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onToggleHandleFocus(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef) -> Bool) -> Int

    Parameters

    flags

    Flags

    unownedSelf

    Reference to instance of self

    handler

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

  • toggleHandleFocusSignal Extension method

    Typed toggle-handle-focus signal for using the connect(signal:) methods

    Declaration

    Swift

    static var toggleHandleFocusSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::end-child signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyEndChild(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyEndChild signal is emitted

  • notifyEndChildSignal Extension method

    Typed notify::end-child signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyEndChildSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::max-position signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyMaxPosition(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyMaxPosition signal is emitted

  • notifyMaxPositionSignal Extension method

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

    Declaration

    Swift

    static var notifyMaxPositionSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::min-position signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyMinPosition(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyMinPosition signal is emitted

  • notifyMinPositionSignal Extension method

    Typed notify::min-position signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyMinPositionSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::position signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPosition(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyPosition signal is emitted

  • notifyPositionSignal Extension method

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

    Declaration

    Swift

    static var notifyPositionSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::position-set signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyPositionSet(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyPositionSet signal is emitted

  • notifyPositionSetSignal Extension method

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

    Declaration

    Swift

    static var notifyPositionSetSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::resize-end-child signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyResizeEndChild(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyResizeEndChild signal is emitted

  • notifyResizeEndChildSignal Extension method

    Typed notify::resize-end-child signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyResizeEndChildSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::resize-start-child signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyResizeStartChild(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyResizeStartChild signal is emitted

  • notifyResizeStartChildSignal Extension method

    Typed notify::resize-start-child signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyResizeStartChildSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::shrink-end-child signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyShrinkEndChild(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyShrinkEndChild signal is emitted

  • notifyShrinkEndChildSignal Extension method

    Typed notify::shrink-end-child signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyShrinkEndChildSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::shrink-start-child signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyShrinkStartChild(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyShrinkStartChild signal is emitted

  • notifyShrinkStartChildSignal Extension method

    Typed notify::shrink-start-child signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyShrinkStartChildSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::start-child signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyStartChild(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyStartChild signal is emitted

  • notifyStartChildSignal Extension method

    Typed notify::start-child signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyStartChildSignal: PanedSignalName { get }
  • The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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

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

    (C Language Example):

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

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

    Note

    This represents the underlying notify::wide-handle signal

    Declaration

    Swift

    @discardableResult
    @inlinable
    func onNotifyWideHandle(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: PanedRef, _ 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 notifyWideHandle signal is emitted

  • notifyWideHandleSignal Extension method

    Typed notify::wide-handle signal for using the connect(signal:) methods

    Declaration

    Swift

    static var notifyWideHandleSignal: PanedSignalName { get }

Paned Class: PanedProtocol extension (methods and fields)

  • getEndChild() Extension method

    Retrieves the end child of the given GtkPaned.

    See also: GtkPaned:end-child

    Declaration

    Swift

    @inlinable
    func getEndChild() -> WidgetRef!
  • getPosition() Extension method

    Obtains the position of the divider between the two panes.

    Declaration

    Swift

    @inlinable
    func getPosition() -> Int
  • getResizeEndChild() Extension method

    Returns whether the end child can be resized.

    Declaration

    Swift

    @inlinable
    func getResizeEndChild() -> Bool
  • getResizeStartChild() Extension method

    Returns whether the start child can be resized.

    Declaration

    Swift

    @inlinable
    func getResizeStartChild() -> Bool
  • getShrinkEndChild() Extension method

    Returns whether the end child can be shrunk.

    Declaration

    Swift

    @inlinable
    func getShrinkEndChild() -> Bool
  • getShrinkStartChild() Extension method

    Returns whether the start child can be shrunk.

    Declaration

    Swift

    @inlinable
    func getShrinkStartChild() -> Bool
  • getStartChild() Extension method

    Retrieves the start child of the given GtkPaned.

    See also: GtkPaned:start-child

    Declaration

    Swift

    @inlinable
    func getStartChild() -> WidgetRef!
  • getWideHandle() Extension method

    Gets whether the separator should be wide.

    Declaration

    Swift

    @inlinable
    func getWideHandle() -> Bool
  • setEnd(child:) Extension method

    Sets the end child of paned to child.

    Declaration

    Swift

    @inlinable
    func setEnd<WidgetT>(child: WidgetT) where WidgetT : WidgetProtocol
  • set(position:) Extension method

    Sets the position of the divider between the two panes.

    Declaration

    Swift

    @inlinable
    func set(position: Int)
  • setResizeEndChild(resize:) Extension method

    Sets the GtkPaned:resize-end-child property

    Declaration

    Swift

    @inlinable
    func setResizeEndChild(resize: Bool)
  • setResizeStartChild(resize:) Extension method

    Sets the GtkPaned:resize-start-child property

    Declaration

    Swift

    @inlinable
    func setResizeStartChild(resize: Bool)
  • setShrinkEndChild(resize:) Extension method

    Sets the GtkPaned:shrink-end-child property

    Declaration

    Swift

    @inlinable
    func setShrinkEndChild(resize: Bool)
  • setShrinkStartChild(resize:) Extension method

    Sets the GtkPaned:shrink-start-child property

    Declaration

    Swift

    @inlinable
    func setShrinkStartChild(resize: Bool)
  • setStart(child:) Extension method

    Sets the start child of paned to child.

    Declaration

    Swift

    @inlinable
    func setStart<WidgetT>(child: WidgetT) where WidgetT : WidgetProtocol
  • setWideHandle(wide:) Extension method

    Sets whether the separator should be wide.

    Declaration

    Swift

    @inlinable
    func setWideHandle(wide: Bool)
  • endChild Extension method

    Retrieves the end child of the given GtkPaned.

    See also: GtkPaned:end-child

    Declaration

    Swift

    @inlinable
    var endChild: WidgetRef! { get nonmutating set }
  • position Extension method

    Position of the separator in pixels, from the left/top.

    Declaration

    Swift

    @inlinable
    var position: Int { get nonmutating set }
  • resizeEndChild Extension method

    Returns whether the end child can be resized.

    Declaration

    Swift

    @inlinable
    var resizeEndChild: Bool { get nonmutating set }
  • resizeStartChild Extension method

    Returns whether the start child can be resized.

    Declaration

    Swift

    @inlinable
    var resizeStartChild: Bool { get nonmutating set }
  • shrinkEndChild Extension method

    Returns whether the end child can be shrunk.

    Declaration

    Swift

    @inlinable
    var shrinkEndChild: Bool { get nonmutating set }
  • shrinkStartChild Extension method

    Returns whether the start child can be shrunk.

    Declaration

    Swift

    @inlinable
    var shrinkStartChild: Bool { get nonmutating set }
  • startChild Extension method

    Retrieves the start child of the given GtkPaned.

    See also: GtkPaned:start-child

    Declaration

    Swift

    @inlinable
    var startChild: WidgetRef! { get nonmutating set }
  • wideHandle Extension method

    Gets whether the separator should be wide.

    Declaration

    Swift

    @inlinable
    var wideHandle: Bool { get nonmutating set }