ObjectRef

public struct ObjectRef : ObjectProtocol

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

All the fields in the GObject structure are private to the GObject implementation and should never be accessed directly.

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

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

    Declaration

    Swift

    public let ptr: UnsafeMutableRawPointer

Object Class

  • Designated initialiser from the underlying C data type

    Declaration

    Swift

    init(_ p: UnsafeMutablePointer<GObject>)
  • Reference intialiser for a related type that implements ObjectProtocol

    Declaration

    Swift

    init<T>(_ other: T) where T : ObjectProtocol
  • Unsafe typed initialiser. Do not use unless you know the underlying data type the pointer points to conforms to ObjectProtocol.

    Declaration

    Swift

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

    Declaration

    Swift

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

    Declaration

    Swift

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

    Declaration

    Swift

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

    Declaration

    Swift

    init(opaquePointer: OpaquePointer)
  • Creates a new instance of a GObject subtype and sets its properties.

    Construction parameters (see G_PARAM_CONSTRUCT, G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values.

    Declaration

    Swift

    init(valist object_type: GType, firstPropertyName first_property_name: UnsafePointer<gchar>, varArgs var_args: CVaListPointer)
  • Creates a new instance of a GObject subtype and sets its properties using the provided arrays. Both arrays must have exactly n_properties elements, and the names and values correspond by index.

    Construction parameters (see G_PARAM_CONSTRUCT, G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values.

    Declaration

    Swift

    init(properties object_type: GType, nProperties n_properties: CUnsignedInt, names: UnsafePointer<UnsafePointer<CChar>>, values: UnsafePointer<GValue>)
  • Creates a new instance of a GObject subtype and sets its properties.

    Construction parameters (see G_PARAM_CONSTRUCT, G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values.

    newv is deprecated: Use g_object_new_with_properties() instead. deprecated. See #GParameter for more information.

    Declaration

    Swift

    @available(*, deprecated)
    init(objectType object_type: GType, nParameters n_parameters: CUnsignedInt, parameters: UnsafeMutablePointer<GParameter>)
  • Creates a new instance of a GObject subtype and sets its properties.

    Construction parameters (see G_PARAM_CONSTRUCT, G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values.

    Declaration

    Swift

    static func new(valist object_type: GType, firstPropertyName first_property_name: UnsafePointer<gchar>, varArgs var_args: CVaListPointer) -> ObjectRef!
  • Creates a new instance of a GObject subtype and sets its properties using the provided arrays. Both arrays must have exactly n_properties elements, and the names and values correspond by index.

    Construction parameters (see G_PARAM_CONSTRUCT, G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values.

    Declaration

    Swift

    static func newWith(properties object_type: GType, nProperties n_properties: CUnsignedInt, names: UnsafePointer<UnsafePointer<CChar>>, values: UnsafePointer<GValue>) -> ObjectRef!
  • Creates a new instance of a GObject subtype and sets its properties.

    Construction parameters (see G_PARAM_CONSTRUCT, G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values.

    newv is deprecated: Use g_object_new_with_properties() instead. deprecated. See #GParameter for more information.

    Declaration

    Swift

    @available(*, deprecated)
    static func newv(objectType object_type: GType, nParameters n_parameters: CUnsignedInt, parameters: UnsafeMutablePointer<GParameter>) -> ObjectRef!