WidgetPaintableRef
public struct WidgetPaintableRef : WidgetPaintableProtocol, GWeakCapturing
GtkWidgetPaintable
is a GdkPaintable
that displays the contents
of a widget.
GtkWidgetPaintable
will also take care of the widget not being in a
state where it can be drawn (like when it isn’t shown) and just draw
nothing or where it does not have a size (like when it is hidden) and
report no size in that case.
Of course, GtkWidgetPaintable
allows you to monitor widgets for size
changes by emitting the [signalGdk.Paintable::invalidate-size
] signal
whenever the size of the widget changes as well as for visual changes by
emitting the [signalGdk.Paintable::invalidate-contents
] signal whenever
the widget changes.
You can use a GtkWidgetPaintable
everywhere a GdkPaintable
is allowed,
including using it on a GtkPicture
(or one of its parents) that it was
set on itself via gtk_picture_set_paintable()
. The paintable will take care
of recursion when this happens. If you do this however, ensure that the
[propertyGtk.Picture:can-shrink
] property is set to true
or you might
end up with an infinitely growing widget.
The WidgetPaintableRef
type acts as a lightweight Swift reference to an underlying GtkWidgetPaintable
instance.
It exposes methods that can operate on this data type through WidgetPaintableProtocol
conformance.
Use WidgetPaintableRef
only as an unowned
reference to an existing GtkWidgetPaintable
instance.
-
Untyped pointer to the underlying `GtkWidgetPaintable` instance.
For type-safe access, use the generated, typed pointer
widget_paintable_ptr
property instead.Declaration
Swift
public let ptr: UnsafeMutableRawPointer!
-
Designated initialiser from the underlying
C
data typeDeclaration
Swift
@inlinable init(_ p: UnsafeMutablePointer<GtkWidgetPaintable>)
-
Designated initialiser from a constant pointer to the underlying
C
data typeDeclaration
Swift
@inlinable init(_ p: UnsafePointer<GtkWidgetPaintable>)
-
Conditional initialiser from an optional pointer to the underlying
C
data typeDeclaration
Swift
@inlinable init!(_ maybePointer: UnsafeMutablePointer<GtkWidgetPaintable>?)
-
Conditional initialiser from an optional, non-mutable pointer to the underlying
C
data typeDeclaration
Swift
@inlinable init!(_ maybePointer: UnsafePointer<GtkWidgetPaintable>?)
-
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
WidgetPaintableProtocol
Declaration
Swift
@inlinable init<T>(_ other: T) where T : WidgetPaintableProtocol
-
This factory is syntactic sugar for setting weak pointers wrapped in
GWeak<T>
Declaration
Swift
@inlinable static func unowned<T>(_ other: T) -> WidgetPaintableRef where T : WidgetPaintableProtocol
-
Unsafe typed initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
WidgetPaintableProtocol
.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
WidgetPaintableProtocol
.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
WidgetPaintableProtocol
.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
WidgetPaintableProtocol
.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
WidgetPaintableProtocol
.Declaration
Swift
@inlinable init(opaquePointer: OpaquePointer)