LinkButtonRef

public struct LinkButtonRef : LinkButtonProtocol, GWeakCapturing

A GtkLinkButton is a GtkButton with a hyperlink, similar to the one used by web browsers, which triggers an action when clicked. It is useful to show quick links to resources.

A link button is created by calling either gtk_link_button_new() or gtk_link_button_new_with_label(). If using the former, the URI you pass to the constructor is used as a label for the widget.

The URI bound to a GtkLinkButton can be set specifically using gtk_link_button_set_uri(), and retrieved using gtk_link_button_get_uri().

By default, GtkLinkButton calls gtk_show_uri_on_window() when the button is clicked. This behaviour can be overridden by connecting to the GtkLinkButton::activate-link signal and returning true from the signal handler.

CSS nodes

GtkLinkButton has a single CSS node with name button. To differentiate it from a plain GtkButton, it gets the .link style class.

The LinkButtonRef type acts as a lightweight Swift reference to an underlying GtkLinkButton instance. It exposes methods that can operate on this data type through LinkButtonProtocol conformance. Use LinkButtonRef only as an unowned reference to an existing GtkLinkButton instance.

  • ptr
    Untyped pointer to the underlying `GtkLinkButton` instance.
    

    For type-safe access, use the generated, typed pointer link_button_ptr property instead.

    Declaration

    Swift

    public let ptr: UnsafeMutableRawPointer!

LinkButton Class

  • Designated initialiser from the underlying C data type

    Declaration

    Swift

    @inlinable
    init(_ p: UnsafeMutablePointer<GtkLinkButton>)
  • Designated initialiser from a constant pointer to the underlying C data type

    Declaration

    Swift

    @inlinable
    init(_ p: UnsafePointer<GtkLinkButton>)
  • Conditional initialiser from an optional pointer to the underlying C data type

    Declaration

    Swift

    @inlinable
    init!(_ maybePointer: UnsafeMutablePointer<GtkLinkButton>?)
  • Conditional initialiser from an optional, non-mutable pointer to the underlying C data type

    Declaration

    Swift

    @inlinable
    init!(_ maybePointer: UnsafePointer<GtkLinkButton>?)
  • Conditional initialiser from an optional gpointer

    Declaration

    Swift

    @inlinable
    init!(gpointer g: gpointer?)
  • Conditional initialiser from an optional, non-mutable gconstpointer

    Declaration

    Swift

    @inlinable
    init!(gconstpointer g: gconstpointer?)
  • Reference intialiser for a related type that implements LinkButtonProtocol

    Declaration

    Swift

    @inlinable
    init<T>(_ other: T) where T : LinkButtonProtocol
  • This factory is syntactic sugar for setting weak pointers wrapped in GWeak<T>

    Declaration

    Swift

    @inlinable
    static func unowned<T>(_ other: T) -> LinkButtonRef where T : LinkButtonProtocol
  • Unsafe typed initialiser. Do not use unless you know the underlying data type the pointer points to conforms to LinkButtonProtocol.

    Declaration

    Swift

    @inlinable
    init<T>(cPointer: UnsafeMutablePointer<T>)
  • Unsafe typed initialiser. Do not use unless you know the underlying data type the pointer points to conforms to LinkButtonProtocol.

    Declaration

    Swift

    @inlinable
    init<T>(constPointer: UnsafePointer<T>)
  • Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to LinkButtonProtocol.

    Declaration

    Swift

    @inlinable
    init(mutating raw: UnsafeRawPointer)
  • Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to LinkButtonProtocol.

    Declaration

    Swift

    @inlinable
    init(raw: UnsafeMutableRawPointer)
  • Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to LinkButtonProtocol.

    Declaration

    Swift

    @inlinable
    init(opaquePointer: OpaquePointer)
  • Creates a new GtkLinkButton with the URI as its text.

    Declaration

    Swift

    @inlinable
    init(uri: UnsafePointer<gchar>!)
  • Creates a new GtkLinkButton containing a label.

    Declaration

    Swift

    @inlinable
    init(label uri: UnsafePointer<gchar>!, label: UnsafePointer<gchar>? = nil)
  • Creates a new GtkLinkButton containing a label.

    Declaration

    Swift

    @inlinable
    static func linkButtonNewWith(label uri: UnsafePointer<gchar>!, label: UnsafePointer<gchar>? = nil) -> WidgetRef!