Copyright | Will Thompson Iñaki García Etxebarria and Jonas Platte |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria (garetxe@gmail.com) |
Safe Haskell | None |
Language | Haskell2010 |
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.
- newtype AppInfoMonitor = AppInfoMonitor (ManagedPtr AppInfoMonitor)
- class GObject o => IsAppInfoMonitor o
- toAppInfoMonitor :: (MonadIO m, IsAppInfoMonitor o) => o -> m AppInfoMonitor
- noAppInfoMonitor :: Maybe AppInfoMonitor
- appInfoMonitorGet :: (HasCallStack, MonadIO m) => m AppInfoMonitor
- type AppInfoMonitorChangedCallback = IO ()
- type C_AppInfoMonitorChangedCallback = Ptr () -> Ptr () -> IO ()
- afterAppInfoMonitorChanged :: (IsAppInfoMonitor a, MonadIO m) => a -> AppInfoMonitorChangedCallback -> m SignalHandlerId
- genClosure_AppInfoMonitorChanged :: AppInfoMonitorChangedCallback -> IO Closure
- mk_AppInfoMonitorChangedCallback :: C_AppInfoMonitorChangedCallback -> IO (FunPtr C_AppInfoMonitorChangedCallback)
- noAppInfoMonitorChangedCallback :: Maybe AppInfoMonitorChangedCallback
- onAppInfoMonitorChanged :: (IsAppInfoMonitor a, MonadIO m) => a -> AppInfoMonitorChangedCallback -> m SignalHandlerId
- wrap_AppInfoMonitorChangedCallback :: AppInfoMonitorChangedCallback -> Ptr () -> Ptr () -> IO ()
Exported types
newtype AppInfoMonitor Source #
class GObject o => IsAppInfoMonitor o Source #
toAppInfoMonitor :: (MonadIO m, IsAppInfoMonitor o) => o -> m AppInfoMonitor Source #
Methods
get
:: (HasCallStack, MonadIO m) | |
=> m AppInfoMonitor | Returns: a reference to a |
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 () Source #
afterAppInfoMonitorChanged :: (IsAppInfoMonitor a, MonadIO m) => a -> AppInfoMonitorChangedCallback -> m SignalHandlerId Source #
mk_AppInfoMonitorChangedCallback :: C_AppInfoMonitorChangedCallback -> IO (FunPtr C_AppInfoMonitorChangedCallback) Source #
onAppInfoMonitorChanged :: (IsAppInfoMonitor a, MonadIO m) => a -> AppInfoMonitorChangedCallback -> m SignalHandlerId Source #
wrap_AppInfoMonitorChangedCallback :: AppInfoMonitorChangedCallback -> Ptr () -> Ptr () -> IO () Source #