GI.Gio.Objects.AppInfoMonitor

AppInfoMonitor is a very simple object used for monitoring the app info database for changes (ie: newly installed or removed applications).

Call appInfoMonitorGet to get a AppInfoMonitor and connect to the "changed" signal.

In the usual case, applications should try to make note of the change (doing things like invalidating caches) but not act on it. In particular, applications should avoid making calls to AppInfo APIs in response to the change signal, deferring these until the time that the data is actually required. The exception to this case is when application information is actually being displayed on the screen (eg: during a search or when the list of all applications is shown). The reason for this is that changes to the list of installed applications often come in groups (like during system updates) and rescanning the list on every change is pointless and expensive.

Since: 2.40

Exported types

newtype AppInfoMonitor

Memory-managed wrapper type.

Constructors

AppInfoMonitor (ManagedPtr AppInfoMonitor)

Instances

Eq AppInfoMonitor

Defined in GI.Gio.Objects.AppInfoMonitor

Methods

(==) :: AppInfoMonitor -> AppInfoMonitor -> Bool

(/=) :: AppInfoMonitor -> AppInfoMonitor -> Bool

GObject AppInfoMonitor

Defined in GI.Gio.Objects.AppInfoMonitor

Methods

gobjectType :: IO GType

IsGValue AppInfoMonitor

Convert AppInfoMonitor to and from GValue with toGValue and fromGValue.

Defined in GI.Gio.Objects.AppInfoMonitor

Methods

toGValue :: AppInfoMonitor -> IO GValue

fromGValue :: GValue -> IO AppInfoMonitor

HasParentTypes AppInfoMonitor

Defined in GI.Gio.Objects.AppInfoMonitor

type ParentTypes AppInfoMonitor

Defined in GI.Gio.Objects.AppInfoMonitor

type ParentTypes AppInfoMonitor = '[Object]

class (GObject o, IsDescendantOf AppInfoMonitor o) => IsAppInfoMonitor o

Type class for types which can be safely cast to AppInfoMonitor, for instance with toAppInfoMonitor.

Instances

(GObject o, IsDescendantOf AppInfoMonitor o) => IsAppInfoMonitor o

Defined in GI.Gio.Objects.AppInfoMonitor

toAppInfoMonitor :: (MonadIO m, IsAppInfoMonitor o) => o -> m AppInfoMonitor

Cast to AppInfoMonitor, for types for which this is known to be safe. For general casts, use castTo.

noAppInfoMonitor :: Maybe AppInfoMonitor

A convenience alias for Nothing :: Maybe AppInfoMonitor.

Methods

Overloaded methods

get

appInfoMonitorGet

Arguments

:: (HasCallStack, MonadIO m)

=> m AppInfoMonitor

Returns: a reference to a AppInfoMonitor

Gets the AppInfoMonitor for the current thread-default main context.

The AppInfoMonitor will emit a "changed" signal in the thread-default main context whenever the list of installed applications (as reported by appInfoGetAll) may have changed.

You must only call objectUnref on the return value from under the same main context as you created it.

Since: 2.40

Signals

changed

type AppInfoMonitorChangedCallback = IO ()

Signal emitted when the app info database for changes (ie: newly installed or removed applications).

type C_AppInfoMonitorChangedCallback = Ptr () -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

afterAppInfoMonitorChanged :: (IsAppInfoMonitor a, MonadIO m) => a -> AppInfoMonitorChangedCallback -> m SignalHandlerId

Connect a signal handler for the changed signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after appInfoMonitor #changed callback

genClosure_AppInfoMonitorChanged :: MonadIO m => AppInfoMonitorChangedCallback -> m (GClosure C_AppInfoMonitorChangedCallback)

Wrap the callback into a GClosure.

mk_AppInfoMonitorChangedCallback :: C_AppInfoMonitorChangedCallback -> IO (FunPtr C_AppInfoMonitorChangedCallback)

Generate a function pointer callable from C code, from a C_AppInfoMonitorChangedCallback.

noAppInfoMonitorChangedCallback :: Maybe AppInfoMonitorChangedCallback

A convenience synonym for Nothing :: Maybe AppInfoMonitorChangedCallback.

onAppInfoMonitorChanged :: (IsAppInfoMonitor a, MonadIO m) => a -> AppInfoMonitorChangedCallback -> m SignalHandlerId

Connect a signal handler for the changed signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on appInfoMonitor #changed callback

wrap_AppInfoMonitorChangedCallback :: AppInfoMonitorChangedCallback -> C_AppInfoMonitorChangedCallback

Wrap a AppInfoMonitorChangedCallback into a C_AppInfoMonitorChangedCallback.