GI.Notify.Objects.Notification

Exported types

newtype Notification

Constructors

Notification (ManagedPtr Notification)

Instances

GObject Notification

Methods

gobjectType :: Notification -> IO GType

IsObject Notification

IsNotification Notification

class GObject o => IsNotification o

Instances

(GObject a, UnknownAncestorError Constraint Notification a) => IsNotification a

IsNotification Notification

toNotification :: (MonadIO m, IsNotification o) => o -> m Notification

noNotification :: Maybe Notification

Methods

addAction

notificationAddAction

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Text

action: The action ID.

-> Text

label: The human-readable action label.

-> ActionCallback

callback: The action's callback function.

-> m ()

Adds an action to a notification. When the action is invoked, the specified callback function will be called, along with the value passed to userData.

clearActions

notificationClearActions

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> m ()

Clears all actions from the notification.

clearHints

notificationClearHints

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> m ()

Clears all hints from the notification.

close

notificationClose

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> m ()

(Can throw GError)

Synchronously tells the notification server to hide the notification on the screen.

getClosedReason

notificationGetClosedReason

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> m Int32

Returns: The closed reason code.

Returns the closed reason code for the notification. This is valid only after the "closed" signal is emitted.

new

notificationNew

Arguments

:: (HasCallStack, MonadIO m)

=> Text

summary: The required summary text.

-> Maybe Text

body: The optional body text.

-> Maybe Text

icon: The optional icon theme icon name or filename.

-> m Notification

Returns: The new Notification.

Creates a new Notification. The summary text is required, but all other parameters are optional.

setAppName

notificationSetAppName

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: a Notification

-> Text

appName: the localised application name

-> m ()

Sets the application name for the notification. If this function is not called or if appName is Nothing, the application name will be set from the value used in init or overridden with setAppName.

Since: 0.7.3

setCategory

notificationSetCategory

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Text

category: The category.

-> m ()

Sets the category of this notification. This can be used by the notification server to filter or display the data in a certain way.

setHint

notificationSetHint

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: a Notification

-> Text

key: the hint key

-> Maybe GVariant

value: the hint value, or Nothing to unset the hint

-> m ()

Sets a hint for key with value value. If value is Nothing, a previously set hint for key is unset.

If value is floating, it is consumed.

Since: 0.6

setHintByte

notificationSetHintByte

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Text

key: The hint.

-> Word8

value: The hint's value.

-> m ()

Deprecated: (Since version 0.6.)Use notificationSetHint instead

Sets a hint with a byte value.

setHintByteArray

notificationSetHintByteArray

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Text

key: The hint.

-> ByteString

value: The hint's value.

-> m ()

Deprecated: (Since version 0.6.)Use notificationSetHint instead

Sets a hint with a byte array value. The length of value must be passed as len.

setHintDouble

notificationSetHintDouble

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Text

key: The hint.

-> Double

value: The hint's value.

-> m ()

Deprecated: (Since version 0.6.)Use notificationSetHint instead

Sets a hint with a double value.

setHintInt32

notificationSetHintInt32

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Text

key: The hint.

-> Int32

value: The hint's value.

-> m ()

Deprecated: (Since version 0.6.)Use notificationSetHint instead

Sets a hint with a 32-bit integer value.

setHintString

notificationSetHintString

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Text

key: The hint.

-> Text

value: The hint's value.

-> m ()

Deprecated: (Since version 0.6.)Use notificationSetHint instead

Sets a hint with a string value.

setHintUint32

notificationSetHintUint32

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Text

key: The hint.

-> Word32

value: The hint's value.

-> m ()

Deprecated: (Since version 0.6.)Use notificationSetHint instead

Sets a hint with an unsigned 32-bit integer value.

setIconFromPixbuf

notificationSetIconFromPixbuf

Arguments

:: (HasCallStack, MonadIO m, IsNotification a, IsPixbuf b)

=> a

notification: The notification.

-> b

icon: The icon.

-> m ()

Deprecated: use notificationSetImageFromPixbuf instead.

Sets the icon in the notification from a Pixbuf.

setImageFromPixbuf

notificationSetImageFromPixbuf

Arguments

:: (HasCallStack, MonadIO m, IsNotification a, IsPixbuf b)

=> a

notification: The notification.

-> b

pixbuf: The image.

-> m ()

Sets the image in the notification from a Pixbuf.

setTimeout

notificationSetTimeout

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Int32

timeout: The timeout in milliseconds.

-> m ()

Sets the timeout of the notification. To set the default time, pass EXPIRES_DEFAULT as timeout. To set the notification to never expire, pass EXPIRES_NEVER.

Note that the timeout may be ignored by the server.

setUrgency

notificationSetUrgency

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> Urgency

urgency: The urgency level.

-> m ()

Sets the urgency level of this notification.

See: Urgency

show

notificationShow

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification.

-> m ()

(Can throw GError)

Tells the notification server to display the notification on the screen.

update

notificationUpdate

Arguments

:: (HasCallStack, MonadIO m, IsNotification a)

=> a

notification: The notification to update.

-> Text

summary: The new required summary text.

-> Maybe Text

body: The optional body text.

-> Maybe Text

icon: The optional icon theme icon name or filename.

-> m Bool

Returns: True, unless an invalid parameter was passed.

Updates the notification text and icon. This won't send the update out and display it on the screen. For that, you will need to call notificationShow.

Properties

appName

constructNotificationAppName :: IsNotification o => Text -> IO (GValueConstruct o)

getNotificationAppName :: (MonadIO m, IsNotification o) => o -> m (Maybe Text)

setNotificationAppName :: (MonadIO m, IsNotification o) => o -> Text -> m ()

body

clearNotificationBody :: (MonadIO m, IsNotification o) => o -> m ()

constructNotificationBody :: IsNotification o => Text -> IO (GValueConstruct o)

getNotificationBody :: (MonadIO m, IsNotification o) => o -> m (Maybe Text)

setNotificationBody :: (MonadIO m, IsNotification o) => o -> Text -> m ()

closedReason

getNotificationClosedReason :: (MonadIO m, IsNotification o) => o -> m Int32

iconName

clearNotificationIconName :: (MonadIO m, IsNotification o) => o -> m ()

constructNotificationIconName :: IsNotification o => Text -> IO (GValueConstruct o)

getNotificationIconName :: (MonadIO m, IsNotification o) => o -> m (Maybe Text)

setNotificationIconName :: (MonadIO m, IsNotification o) => o -> Text -> m ()

id

constructNotificationId :: IsNotification o => Int32 -> IO (GValueConstruct o)

getNotificationId :: (MonadIO m, IsNotification o) => o -> m Int32

setNotificationId :: (MonadIO m, IsNotification o) => o -> Int32 -> m ()

summary

clearNotificationSummary :: (MonadIO m, IsNotification o) => o -> m ()

constructNotificationSummary :: IsNotification o => Text -> IO (GValueConstruct o)

getNotificationSummary :: (MonadIO m, IsNotification o) => o -> m (Maybe Text)

setNotificationSummary :: (MonadIO m, IsNotification o) => o -> Text -> m ()

Signals

closed

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

type NotificationClosedCallback = IO ()

afterNotificationClosed :: (IsNotification a, MonadIO m) => a -> NotificationClosedCallback -> m SignalHandlerId

genClosure_NotificationClosed :: NotificationClosedCallback -> IO Closure

mk_NotificationClosedCallback :: C_NotificationClosedCallback -> IO (FunPtr C_NotificationClosedCallback)

noNotificationClosedCallback :: Maybe NotificationClosedCallback

onNotificationClosed :: (IsNotification a, MonadIO m) => a -> NotificationClosedCallback -> m SignalHandlerId

wrap_NotificationClosedCallback :: NotificationClosedCallback -> Ptr () -> Ptr () -> IO ()