pub struct SettingsSchema { /* private fields */ }Expand description
schema_source, schema_id, FALSE);
if (schema == NULL) { … disable the plugin or abort, etc … }
return g_settings_new_full (schema, NULL, NULL); }
The code above shows how hooks should be added to the code that
initialises (or enables) the plugin to create the schema source and
how an API can be added to the plugin system to provide a convenient
way for the plugin to access its settings, using the schemas that it
ships.
From the standpoint of the plugin, it would need to ensure that it
ships a gschemas.compiled file as part of itself, and then simply do
the following:
```c
{
GSettings *settings;
gint some_value;
settings = plugin_get_settings (self, NULL);
some_value = g_settings_get_int (settings, "some-value");
…
}
```text
It's also possible that the plugin system expects the schema source
files (ie: `.gschema.xml` files) instead of a `gschemas.compiled` file.
In that case, the plugin loading system must compile the schemas for
itself before attempting to create the settings source.
GLib type: Shared boxed type with reference counted clone semantics.Implementations§
Source§impl SettingsSchema
impl SettingsSchema
Sourcepub fn as_ptr(&self) -> *mut GSettingsSchema
pub fn as_ptr(&self) -> *mut GSettingsSchema
Return the inner pointer to the underlying C value.
Sourcepub unsafe fn from_glib_ptr_borrow(ptr: &*mut GSettingsSchema) -> &Self
pub unsafe fn from_glib_ptr_borrow(ptr: &*mut GSettingsSchema) -> &Self
Borrows the underlying C value.
Source§impl SettingsSchema
impl SettingsSchema
Sourcepub fn key(&self, name: &str) -> SettingsSchemaKey
pub fn key(&self, name: &str) -> SettingsSchemaKey
Sourcepub fn path(&self) -> Option<GString>
pub fn path(&self) -> Option<GString>
Gets the path associated with @self, or None.
Schemas may be single-instance or relocatable. Single-instance schemas correspond to exactly one set of keys in the backend database: those located at the path returned by this function.
Relocatable schemas can be referenced by other schemas and can
therefore describe multiple sets of keys at different locations. For
relocatable schemas, this function will return None.
§Returns
the path of the schema, or None
Sourcepub fn list_children(&self) -> Vec<GString>
pub fn list_children(&self) -> Vec<GString>
Gets the list of children in @self.
You should free the return value with g_strfreev() when you are done with it.
§Returns
a list of the children on @settings, in no defined order
Sourcepub fn list_keys(&self) -> Vec<GString>
pub fn list_keys(&self) -> Vec<GString>
Introspects the list of keys on @self.
You should probably not be calling this function from “normal” code (since you should already know what keys are in your schema). This function is intended for introspection reasons.
§Returns
a list of the keys on @self, in no defined order
Trait Implementations§
Source§impl Clone for SettingsSchema
impl Clone for SettingsSchema
Source§impl Debug for SettingsSchema
impl Debug for SettingsSchema
impl Eq for SettingsSchema
Source§impl From<SettingsSchema> for Value
impl From<SettingsSchema> for Value
Source§fn from(s: SettingsSchema) -> Self
fn from(s: SettingsSchema) -> Self
Source§impl HasParamSpec for SettingsSchema
impl HasParamSpec for SettingsSchema
type ParamSpec = ParamSpecBoxed
Source§type SetValue = SettingsSchema
type SetValue = SettingsSchema
type BuilderFn = fn(&str) -> ParamSpecBoxedBuilder<'_, SettingsSchema>
fn param_spec_builder() -> Self::BuilderFn
Source§impl Hash for SettingsSchema
impl Hash for SettingsSchema
Source§impl Ord for SettingsSchema
impl Ord for SettingsSchema
Source§fn cmp(&self, other: &SettingsSchema) -> Ordering
fn cmp(&self, other: &SettingsSchema) -> Ordering
1.21.0 (const: unstable) · Source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
Source§impl PartialEq for SettingsSchema
impl PartialEq for SettingsSchema
Source§impl PartialOrd for SettingsSchema
impl PartialOrd for SettingsSchema
Source§impl StaticType for SettingsSchema
impl StaticType for SettingsSchema
Source§fn static_type() -> Type
fn static_type() -> Type
Self.