Struct TypeModule

pub struct TypeModule { /* private fields */ }

GTypeModule provides a simple implementation of the GTypePlugin interface.

The model of GTypeModule is a dynamically loaded module which implements some number of types and interface implementations.

When the module is loaded, it registers its types and interfaces using [methodObject.register_type] and [methodObject.add_interface]. As long as any instances of these types and interface implementations are in use, the module is kept loaded. When the types and interfaces are gone, the module may be unloaded. If the types and interfaces become used again, the module will be reloaded. Note that the last reference cannot be released from within the module code, since that would lead to the caller’s code being unloaded before g_object_unref() returns to it.

Keeping track of whether the module should be loaded or not is done by using a use count - it starts at zero, and whenever it is greater than zero, the module is loaded. The use count is maintained internally by the type system, but also can be explicitly controlled by [methodObject.use] and [methodObject.unuse]. Typically, when loading a module for the first type, [TypeModuleExtManual::use_()][crate::prelude::TypeModuleExtManual::use_()] will be used to load it so that it can initialize its types. At some later point, when the module no longer needs to be loaded except for the type implementations it contains, [TypeModuleExtManual::unuse()][crate::prelude::TypeModuleExtManual::unuse()] is called.

GTypeModule does not actually provide any implementation of module loading and unloading. To create a particular module type you must derive from GTypeModule and implement the load and unload functions in GTypeModuleClass.

This is an Abstract Base Class, you cannot instantiate it.

Implements

ObjectExt, TypePluginExt

GLib type: GObject with reference counted clone semantics.

Implementations

impl TypeModule

pub const NONE: Option<&'static TypeModule> = None

Trait Implementations

impl Clone for TypeModule

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TypeModule

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DynamicObjectRegisterExt for TypeModule

fn add_dynamic_interface( &self, instance_type: Type, interface_type: Type, interface_info: &InterfaceInfo, )

fn register_dynamic_enum( &self, name: &str, const_static_values: &'static EnumValues, ) -> Type

fn register_dynamic_flags( &self, name: &str, const_static_values: &'static FlagsValues, ) -> Type

fn register_dynamic_type( &self, parent_type: Type, type_name: &str, type_info: &TypeInfo, flags: TypeFlags, ) -> Type

impl HasParamSpec for TypeModule

type ParamSpec = ParamSpecObject

type SetValue = TypeModule

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, TypeModule>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for TypeModule

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: TypeModuleImpl> IsSubclassable<T> for TypeModule

fn class_init(class: &mut Class<Self>)

Override the virtual methods of this class for the given subclass and do other class initialization.

fn instance_init(instance: &mut InitializingObject<T>)

Instance specific initialization.

impl Ord for TypeModule

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl ParentClassIs for TypeModule

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for TypeModule

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for TypeModule

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for TypeModule

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for TypeModule

impl IsA<TypePlugin> for TypeModule