Hoogle Search
Within LTS Haskell 24.45 (ghc-9.10.3)
Note that Stackage only displays results for the latest LTS and Nightly snapshot. Learn more.
-
gi-gio GI.Gio.Objects.Settings Creates a new Settings object with a given schema, backend and path. It should be extremely rare that you ever want to use this function. It is made available for advanced use-cases (such as plugin systems that want to provide access to schemas loaded from custom locations, etc). At the most basic level, a Settings object is a pure composition of 4 things: a SettingsSchema, a SettingsBackend, a path within that backend, and a MainContext to which signals are dispatched. This constructor therefore gives you full control over constructing Settings instances. The first 3 parameters are given directly as schema, backend and path, and the main context is taken from the thread-default (as per settingsNew). If backend is Nothing then the default backend is used. If path is Nothing then the path from the schema is used. It is an error if path is Nothing and the schema has no path of its own or if path is non-Nothing and not equal to the path that the schema does have. Since: 2.32
settingsNewWithBackend :: (HasCallStack, MonadIO m, IsSettingsBackend a) => Text -> a -> m Settingsgi-gio GI.Gio.Objects.Settings Creates a new Settings object with the schema specified by schemaId and a given SettingsBackend. Creating a Settings object with a different backend allows accessing settings from a database other than the usual one. For example, it may make sense to pass a backend corresponding to the "defaults" settings database on the system to get a settings object that modifies the system default settings instead of the settings for this user. Since: 2.26
-
gi-gio GI.Gio.Objects.Settings Creates a new Settings object with the schema specified by schemaId and a given SettingsBackend and path. This is a mix of settingsNewWithBackend and settingsNewWithPath. Since: 2.26
settingsNewWithPath :: (HasCallStack, MonadIO m) => Text -> Text -> m Settingsgi-gio GI.Gio.Objects.Settings Creates a new Settings object with the relocatable schema specified by schemaId and a given path. You only need to do this if you want to directly create a settings object with a schema that doesn't have a specified path of its own. That's quite rare. It is a programmer error to call this function for a schema that has an explicitly specified path. It is a programmer error if path is not a valid path. A valid path begins and ends with '/' and does not contain two consecutive '/' characters. Since: 2.26
settingsRangeCheck :: (HasCallStack, MonadIO m, IsSettings a) => a -> Text -> GVariant -> m Boolgi-gio GI.Gio.Objects.Settings Deprecated: (Since version 2.40)Use settingsSchemaKeyRangeCheck instead.
settingsReset :: (HasCallStack, MonadIO m, IsSettings a) => a -> Text -> m ()gi-gio GI.Gio.Objects.Settings Resets key to its default value. This call resets the key, as much as possible, to its default value. That might be the value specified in the schema or the one set by the administrator.
settingsRevert :: (HasCallStack, MonadIO m, IsSettings a) => a -> m ()gi-gio GI.Gio.Objects.Settings Reverts all non-applied changes to the settings. This function does nothing unless settings is in 'delay-apply' mode; see settingsDelay. In the normal case settings are always applied immediately. Change notifications will be emitted for affected keys.
settingsSetBoolean :: (HasCallStack, MonadIO m, IsSettings a) => a -> Text -> Bool -> m Boolgi-gio GI.Gio.Objects.Settings Sets key in settings to value. A convenience variant of g_settings_set() for booleans. It is a programmer error to give a key that isn't specified as having a boolean type in the schema for settings. Since: 2.26
settingsSetDouble :: (HasCallStack, MonadIO m, IsSettings a) => a -> Text -> Double -> m Boolgi-gio GI.Gio.Objects.Settings Sets key in settings to value. A convenience variant of g_settings_set() for doubles. It is a programmer error to give a key that isn't specified as having a 'double' type in the schema for settings. Since: 2.26
settingsSetEnum :: (HasCallStack, MonadIO m, IsSettings a) => a -> Text -> Int32 -> m Boolgi-gio GI.Gio.Objects.Settings Looks up the enumerated type nick for value and writes it to key, within settings. It is a programmer error to give a key that isn't contained in the schema for settings or is not marked as an enumerated type, or for value not to be a valid value for the named type. After performing the write, accessing key directly with settingsGetString will return the 'nick' associated with value.