Copyright	Will Thompson Iñaki García Etxebarria and Jonas Platte
License	LGPL-2.1
Maintainer	Iñaki García Etxebarria (inaki@blueleaf.cc)
Safe Haskell	None
Language	Haskell2010

GI.Gtk.Objects.StatusIcon

Contents

Exported types
Methods
Properties
Signals

Description

The “system tray” or notification area is normally used for transient icons that indicate some special state. For example, a system tray icon might appear to tell the user that they have new mail, or have an incoming instant message, or something along those lines. The basic idea is that creating an icon in the notification area is less annoying than popping up a dialog.

A StatusIcon object can be used to display an icon in a “system tray”. The icon can have a tooltip, and the user can interact with it by activating it or popping up a context menu.

It is very important to notice that status icons depend on the existence of a notification area being available to the user; you should not use status icons as the only way to convey critical information regarding your application, as the notification area may not exist on the user's environment, or may have been removed. You should always check that a status icon has been embedded into a notification area by using statusIconIsEmbedded, and gracefully recover if the function returns False.

On X11, the implementation follows the FreeDesktop System Tray Specification. Implementations of the “tray” side of this specification can be found e.g. in the GNOME 2 and KDE panel applications.

Note that a GtkStatusIcon is not a widget, but just a Object. Making it a widget would be impractical, since the system tray on Windows doesn’t allow to embed arbitrary widgets.

GtkStatusIcon has been deprecated in 3.14. You should consider using notifications or more modern platform-specific APIs instead. GLib provides the Notification API which works well with Application on multiple platforms and environments, and should be the preferred mechanism to notify the users of transient status updates. See this HowDoI for code examples.

Synopsis

newtype StatusIcon = StatusIcon (ManagedPtr StatusIcon)
class (GObject o, IsDescendantOf StatusIcon o) => IsStatusIcon o
toStatusIcon :: (MonadIO m, IsStatusIcon o) => o -> m StatusIcon
noStatusIcon :: Maybe StatusIcon
statusIconGetGeometry :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m (Bool, Screen, Rectangle, Orientation)
statusIconGetGicon :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m (Maybe Icon)
statusIconGetHasTooltip :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m Bool
statusIconGetIconName :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m (Maybe Text)
statusIconGetPixbuf :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m (Maybe Pixbuf)
statusIconGetScreen :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m Screen
statusIconGetSize :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m Int32
statusIconGetStock :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m (Maybe Text)
statusIconGetStorageType :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m ImageType
statusIconGetTitle :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m Text
statusIconGetTooltipMarkup :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m (Maybe Text)
statusIconGetTooltipText :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m (Maybe Text)
statusIconGetVisible :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m Bool
statusIconGetX11WindowId :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m Word32
statusIconIsEmbedded :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> m Bool
statusIconNew :: (HasCallStack, MonadIO m) => m StatusIcon
statusIconNewFromFile :: (HasCallStack, MonadIO m) => [Char] -> m StatusIcon
statusIconNewFromGicon :: (HasCallStack, MonadIO m, IsIcon a) => a -> m StatusIcon
statusIconNewFromIconName :: (HasCallStack, MonadIO m) => Text -> m StatusIcon
statusIconNewFromPixbuf :: (HasCallStack, MonadIO m, IsPixbuf a) => a -> m StatusIcon
statusIconNewFromStock :: (HasCallStack, MonadIO m) => Text -> m StatusIcon
statusIconPositionMenu :: (HasCallStack, MonadIO m, IsMenu a, IsStatusIcon b) => a -> Int32 -> Int32 -> b -> m (Int32, Int32, Bool)
statusIconSetFromFile :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> [Char] -> m ()
statusIconSetFromGicon :: (HasCallStack, MonadIO m, IsStatusIcon a, IsIcon b) => a -> b -> m ()
statusIconSetFromIconName :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> Text -> m ()
statusIconSetFromPixbuf :: (HasCallStack, MonadIO m, IsStatusIcon a, IsPixbuf b) => a -> Maybe b -> m ()
statusIconSetFromStock :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> Text -> m ()
statusIconSetHasTooltip :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> Bool -> m ()
statusIconSetName :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> Text -> m ()
statusIconSetScreen :: (HasCallStack, MonadIO m, IsStatusIcon a, IsScreen b) => a -> b -> m ()
statusIconSetTitle :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> Text -> m ()
statusIconSetTooltipMarkup :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> Maybe Text -> m ()
statusIconSetTooltipText :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> Text -> m ()
statusIconSetVisible :: (HasCallStack, MonadIO m, IsStatusIcon a) => a -> Bool -> m ()
getStatusIconEmbedded :: (MonadIO m, IsStatusIcon o) => o -> m Bool
clearStatusIconFile :: (MonadIO m, IsStatusIcon o) => o -> m ()
constructStatusIconFile :: IsStatusIcon o => Text -> IO (GValueConstruct o)
setStatusIconFile :: (MonadIO m, IsStatusIcon o) => o -> Text -> m ()
clearStatusIconGicon :: (MonadIO m, IsStatusIcon o) => o -> m ()
constructStatusIconGicon :: (IsStatusIcon o, IsIcon a) => a -> IO (GValueConstruct o)
getStatusIconGicon :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Icon)
setStatusIconGicon :: (MonadIO m, IsStatusIcon o, IsIcon a) => o -> a -> m ()
constructStatusIconHasTooltip :: IsStatusIcon o => Bool -> IO (GValueConstruct o)
getStatusIconHasTooltip :: (MonadIO m, IsStatusIcon o) => o -> m Bool
setStatusIconHasTooltip :: (MonadIO m, IsStatusIcon o) => o -> Bool -> m ()
clearStatusIconIconName :: (MonadIO m, IsStatusIcon o) => o -> m ()
constructStatusIconIconName :: IsStatusIcon o => Text -> IO (GValueConstruct o)
getStatusIconIconName :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Text)
setStatusIconIconName :: (MonadIO m, IsStatusIcon o) => o -> Text -> m ()
getStatusIconOrientation :: (MonadIO m, IsStatusIcon o) => o -> m Orientation
clearStatusIconPixbuf :: (MonadIO m, IsStatusIcon o) => o -> m ()
constructStatusIconPixbuf :: (IsStatusIcon o, IsPixbuf a) => a -> IO (GValueConstruct o)
getStatusIconPixbuf :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Pixbuf)
setStatusIconPixbuf :: (MonadIO m, IsStatusIcon o, IsPixbuf a) => o -> a -> m ()
constructStatusIconScreen :: (IsStatusIcon o, IsScreen a) => a -> IO (GValueConstruct o)
getStatusIconScreen :: (MonadIO m, IsStatusIcon o) => o -> m Screen
setStatusIconScreen :: (MonadIO m, IsStatusIcon o, IsScreen a) => o -> a -> m ()
getStatusIconSize :: (MonadIO m, IsStatusIcon o) => o -> m Int32
clearStatusIconStock :: (MonadIO m, IsStatusIcon o) => o -> m ()
constructStatusIconStock :: IsStatusIcon o => Text -> IO (GValueConstruct o)
getStatusIconStock :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Text)
setStatusIconStock :: (MonadIO m, IsStatusIcon o) => o -> Text -> m ()
getStatusIconStorageType :: (MonadIO m, IsStatusIcon o) => o -> m ImageType
constructStatusIconTitle :: IsStatusIcon o => Text -> IO (GValueConstruct o)
getStatusIconTitle :: (MonadIO m, IsStatusIcon o) => o -> m Text
setStatusIconTitle :: (MonadIO m, IsStatusIcon o) => o -> Text -> m ()
clearStatusIconTooltipMarkup :: (MonadIO m, IsStatusIcon o) => o -> m ()
constructStatusIconTooltipMarkup :: IsStatusIcon o => Text -> IO (GValueConstruct o)
getStatusIconTooltipMarkup :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Text)
setStatusIconTooltipMarkup :: (MonadIO m, IsStatusIcon o) => o -> Text -> m ()
constructStatusIconTooltipText :: IsStatusIcon o => Text -> IO (GValueConstruct o)
getStatusIconTooltipText :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Text)
setStatusIconTooltipText :: (MonadIO m, IsStatusIcon o) => o -> Text -> m ()
constructStatusIconVisible :: IsStatusIcon o => Bool -> IO (GValueConstruct o)
getStatusIconVisible :: (MonadIO m, IsStatusIcon o) => o -> m Bool
setStatusIconVisible :: (MonadIO m, IsStatusIcon o) => o -> Bool -> m ()
type C_StatusIconActivateCallback = Ptr () -> Ptr () -> IO ()
type StatusIconActivateCallback = IO ()
afterStatusIconActivate :: (IsStatusIcon a, MonadIO m) => a -> StatusIconActivateCallback -> m SignalHandlerId
genClosure_StatusIconActivate :: MonadIO m => StatusIconActivateCallback -> m (GClosure C_StatusIconActivateCallback)
mk_StatusIconActivateCallback :: C_StatusIconActivateCallback -> IO (FunPtr C_StatusIconActivateCallback)
noStatusIconActivateCallback :: Maybe StatusIconActivateCallback
onStatusIconActivate :: (IsStatusIcon a, MonadIO m) => a -> StatusIconActivateCallback -> m SignalHandlerId
wrap_StatusIconActivateCallback :: StatusIconActivateCallback -> C_StatusIconActivateCallback
type C_StatusIconButtonPressEventCallback = Ptr () -> Ptr EventButton -> Ptr () -> IO CInt
type StatusIconButtonPressEventCallback = EventButton -> IO Bool
afterStatusIconButtonPressEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconButtonPressEventCallback -> m SignalHandlerId
genClosure_StatusIconButtonPressEvent :: MonadIO m => StatusIconButtonPressEventCallback -> m (GClosure C_StatusIconButtonPressEventCallback)
mk_StatusIconButtonPressEventCallback :: C_StatusIconButtonPressEventCallback -> IO (FunPtr C_StatusIconButtonPressEventCallback)
noStatusIconButtonPressEventCallback :: Maybe StatusIconButtonPressEventCallback
onStatusIconButtonPressEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconButtonPressEventCallback -> m SignalHandlerId
wrap_StatusIconButtonPressEventCallback :: StatusIconButtonPressEventCallback -> C_StatusIconButtonPressEventCallback
type C_StatusIconButtonReleaseEventCallback = Ptr () -> Ptr EventButton -> Ptr () -> IO CInt
type StatusIconButtonReleaseEventCallback = EventButton -> IO Bool
afterStatusIconButtonReleaseEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconButtonReleaseEventCallback -> m SignalHandlerId
genClosure_StatusIconButtonReleaseEvent :: MonadIO m => StatusIconButtonReleaseEventCallback -> m (GClosure C_StatusIconButtonReleaseEventCallback)
mk_StatusIconButtonReleaseEventCallback :: C_StatusIconButtonReleaseEventCallback -> IO (FunPtr C_StatusIconButtonReleaseEventCallback)
noStatusIconButtonReleaseEventCallback :: Maybe StatusIconButtonReleaseEventCallback
onStatusIconButtonReleaseEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconButtonReleaseEventCallback -> m SignalHandlerId
wrap_StatusIconButtonReleaseEventCallback :: StatusIconButtonReleaseEventCallback -> C_StatusIconButtonReleaseEventCallback
type C_StatusIconPopupMenuCallback = Ptr () -> Word32 -> Word32 -> Ptr () -> IO ()
type StatusIconPopupMenuCallback = Word32 -> Word32 -> IO ()
afterStatusIconPopupMenu :: (IsStatusIcon a, MonadIO m) => a -> StatusIconPopupMenuCallback -> m SignalHandlerId
genClosure_StatusIconPopupMenu :: MonadIO m => StatusIconPopupMenuCallback -> m (GClosure C_StatusIconPopupMenuCallback)
mk_StatusIconPopupMenuCallback :: C_StatusIconPopupMenuCallback -> IO (FunPtr C_StatusIconPopupMenuCallback)
noStatusIconPopupMenuCallback :: Maybe StatusIconPopupMenuCallback
onStatusIconPopupMenu :: (IsStatusIcon a, MonadIO m) => a -> StatusIconPopupMenuCallback -> m SignalHandlerId
wrap_StatusIconPopupMenuCallback :: StatusIconPopupMenuCallback -> C_StatusIconPopupMenuCallback
type C_StatusIconQueryTooltipCallback = Ptr () -> Int32 -> Int32 -> CInt -> Ptr Tooltip -> Ptr () -> IO CInt
type StatusIconQueryTooltipCallback = Int32 -> Int32 -> Bool -> Tooltip -> IO Bool
afterStatusIconQueryTooltip :: (IsStatusIcon a, MonadIO m) => a -> StatusIconQueryTooltipCallback -> m SignalHandlerId
genClosure_StatusIconQueryTooltip :: MonadIO m => StatusIconQueryTooltipCallback -> m (GClosure C_StatusIconQueryTooltipCallback)
mk_StatusIconQueryTooltipCallback :: C_StatusIconQueryTooltipCallback -> IO (FunPtr C_StatusIconQueryTooltipCallback)
noStatusIconQueryTooltipCallback :: Maybe StatusIconQueryTooltipCallback
onStatusIconQueryTooltip :: (IsStatusIcon a, MonadIO m) => a -> StatusIconQueryTooltipCallback -> m SignalHandlerId
wrap_StatusIconQueryTooltipCallback :: StatusIconQueryTooltipCallback -> C_StatusIconQueryTooltipCallback
type C_StatusIconScrollEventCallback = Ptr () -> Ptr EventScroll -> Ptr () -> IO CInt
type StatusIconScrollEventCallback = EventScroll -> IO Bool
afterStatusIconScrollEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconScrollEventCallback -> m SignalHandlerId
genClosure_StatusIconScrollEvent :: MonadIO m => StatusIconScrollEventCallback -> m (GClosure C_StatusIconScrollEventCallback)
mk_StatusIconScrollEventCallback :: C_StatusIconScrollEventCallback -> IO (FunPtr C_StatusIconScrollEventCallback)
noStatusIconScrollEventCallback :: Maybe StatusIconScrollEventCallback
onStatusIconScrollEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconScrollEventCallback -> m SignalHandlerId
wrap_StatusIconScrollEventCallback :: StatusIconScrollEventCallback -> C_StatusIconScrollEventCallback
type C_StatusIconSizeChangedCallback = Ptr () -> Int32 -> Ptr () -> IO CInt
type StatusIconSizeChangedCallback = Int32 -> IO Bool
afterStatusIconSizeChanged :: (IsStatusIcon a, MonadIO m) => a -> StatusIconSizeChangedCallback -> m SignalHandlerId
genClosure_StatusIconSizeChanged :: MonadIO m => StatusIconSizeChangedCallback -> m (GClosure C_StatusIconSizeChangedCallback)
mk_StatusIconSizeChangedCallback :: C_StatusIconSizeChangedCallback -> IO (FunPtr C_StatusIconSizeChangedCallback)
noStatusIconSizeChangedCallback :: Maybe StatusIconSizeChangedCallback
onStatusIconSizeChanged :: (IsStatusIcon a, MonadIO m) => a -> StatusIconSizeChangedCallback -> m SignalHandlerId
wrap_StatusIconSizeChangedCallback :: StatusIconSizeChangedCallback -> C_StatusIconSizeChangedCallback

Exported types

newtype StatusIcon Source #

Memory-managed wrapper type.

Constructors

StatusIcon (ManagedPtr StatusIcon)

Instances

GObject StatusIcon Source #
Instance details Defined in GI.Gtk.Objects.StatusIcon Methods gobjectType :: IO GType #
HasParentTypes StatusIcon Source #
Instance details Defined in GI.Gtk.Objects.StatusIcon
type ParentTypes StatusIcon Source #
Instance details Defined in GI.Gtk.Objects.StatusIcon type ParentTypes StatusIcon = Object ': ([] :: [Type])

class (GObject o, IsDescendantOf StatusIcon o) => IsStatusIcon o Source #

Type class for types which can be safely cast to StatusIcon, for instance with toStatusIcon.

Instances

(GObject o, IsDescendantOf StatusIcon o) => IsStatusIcon o Source #
Instance details Defined in GI.Gtk.Objects.StatusIcon

toStatusIcon :: (MonadIO m, IsStatusIcon o) => o -> m StatusIcon Source #

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

noStatusIcon :: Maybe StatusIcon Source #

A convenience alias for Nothing :: Maybe StatusIcon.

Methods

getGeometry

statusIconGetGeometry Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m (Bool, Screen, Rectangle, Orientation)	Returns: `True` if the location information has been filled in

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function, as the platform is responsible for the presentation of notifications

Obtains information about the location of the status icon on screen. This information can be used to e.g. position popups like notification bubbles.

See statusIconPositionMenu for a more convenient alternative for positioning menus.

Note that some platforms do not allow GTK+ to provide this information, and even on platforms that do allow it, the information is not reliable unless the status icon is embedded in a notification area, see statusIconIsEmbedded.

Since: 2.10

getGicon

statusIconGetGicon Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m (Maybe Icon)	Returns: the displayed icon, or `Nothing` if the image is empty

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Retrieves the Icon being displayed by the StatusIcon. The storage type of the status icon must be ImageTypeEmpty or ImageTypeGicon (see statusIconGetStorageType). The caller of this function does not own a reference to the returned Icon.

If this function fails, icon is left unchanged;

Since: 2.14

getHasTooltip

statusIconGetHasTooltip Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m Bool	Returns: current value of has-tooltip on `statusIcon`.

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Returns the current value of the has-tooltip property. See StatusIcon:has-tooltip for more information.

Since: 2.16

getIconName

statusIconGetIconName Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m (Maybe Text)	Returns: name of the displayed icon, or `Nothing` if the image is empty.

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Gets the name of the icon being displayed by the StatusIcon. The storage type of the status icon must be ImageTypeEmpty or ImageTypeIconName (see statusIconGetStorageType). The returned string is owned by the StatusIcon and should not be freed or modified.

Since: 2.10

getPixbuf

statusIconGetPixbuf Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m (Maybe Pixbuf)	Returns: the displayed pixbuf, or `Nothing` if the image is empty.

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Gets the Pixbuf being displayed by the StatusIcon. The storage type of the status icon must be ImageTypeEmpty or ImageTypePixbuf (see statusIconGetStorageType). The caller of this function does not own a reference to the returned pixbuf.

Since: 2.10

getScreen

statusIconGetScreen Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m Screen	Returns: a `Screen`.

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function, as notifications are managed by the platform

Returns the Screen associated with statusIcon.

Since: 2.12

getSize

statusIconGetSize Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m Int32	Returns: the size that is available for the image

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function, as the representation of a notification is left to the platform

Gets the size in pixels that is available for the image. Stock icons and named icons adapt their size automatically if the size of the notification area changes. For other storage types, the size-changed signal can be used to react to size changes.

Note that the returned size is only meaningful while the status icon is embedded (see statusIconIsEmbedded).

Since: 2.10

getStock

statusIconGetStock Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m (Maybe Text)	Returns: stock id of the displayed stock icon, or `Nothing` if the image is empty.

Deprecated: (Since version 3.10)Use statusIconGetIconName instead.

Gets the id of the stock icon being displayed by the StatusIcon. The storage type of the status icon must be ImageTypeEmpty or ImageTypeStock (see statusIconGetStorageType). The returned string is owned by the StatusIcon and should not be freed or modified.

Since: 2.10

getStorageType

statusIconGetStorageType Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m ImageType	Returns: the image representation being used

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function, and Notification only supports Icon instances

Gets the type of representation being used by the StatusIcon to store image data. If the StatusIcon has no image data, the return value will be ImageTypeEmpty.

Since: 2.10

getTitle

statusIconGetTitle Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m Text	Returns: the title of the status icon

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Gets the title of this tray icon. See statusIconSetTitle.

Since: 2.18

getTooltipMarkup

statusIconGetTooltipMarkup Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m (Maybe Text)	Returns: the tooltip text, or `Nothing`. You should free the returned string with `free` when done.

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Gets the contents of the tooltip for statusIcon.

Since: 2.16

getTooltipText

statusIconGetTooltipText Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m (Maybe Text)	Returns: the tooltip text, or `Nothing`. You should free the returned string with `free` when done.

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Gets the contents of the tooltip for statusIcon.

Since: 2.16

getVisible

statusIconGetVisible Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m Bool	Returns: `True` if the status icon is visible

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Returns whether the status icon is visible or not. Note that being visible does not guarantee that the user can actually see the icon, see also statusIconIsEmbedded.

Since: 2.10

getX11WindowId

statusIconGetX11WindowId Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m Word32	Returns: An 32 bit unsigned integer identifier for the underlying X11 Window

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

This function is only useful on the X11/freedesktop.org platform.

It returns a window ID for the widget in the underlying status icon implementation. This is useful for the Galago notification service, which can send a window ID in the protocol in order for the server to position notification windows pointing to a status icon reliably.

This function is not intended for other use cases which are more likely to be met by one of the non-X11 specific methods, such as statusIconPositionMenu.

Since: 2.14

isEmbedded

statusIconIsEmbedded Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> m Bool	Returns: `True` if the status icon is embedded in a notification area.

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Returns whether the status icon is embedded in a notification area.

Since: 2.10

new

statusIconNew Source #

Arguments

:: (HasCallStack, MonadIO m)
=> m StatusIcon	Returns: a new `StatusIcon`

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications

Creates an empty status icon object.

Since: 2.10

newFromFile

statusIconNewFromFile Source #

Arguments

:: (HasCallStack, MonadIO m)
=> [Char]	`filename`: a filename
-> m StatusIcon	Returns: a new `StatusIcon`

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications

Creates a status icon displaying the file filename.

The image will be scaled down to fit in the available space in the notification area, if necessary.

Since: 2.10

newFromGicon

statusIconNewFromGicon Source #

Arguments

:: (HasCallStack, MonadIO m, IsIcon a)
=> a	`icon`: a `Icon`
-> m StatusIcon	Returns: a new `StatusIcon`

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications

Creates a status icon displaying a Icon. If the icon is a themed icon, it will be updated when the theme changes.

Since: 2.14

newFromIconName

statusIconNewFromIconName Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Text	`iconName`: an icon name
-> m StatusIcon	Returns: a new `StatusIcon`

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications

Creates a status icon displaying an icon from the current icon theme. If the current icon theme is changed, the icon will be updated appropriately.

Since: 2.10

newFromPixbuf

statusIconNewFromPixbuf Source #

Arguments

:: (HasCallStack, MonadIO m, IsPixbuf a)
=> a	`pixbuf`: a `Pixbuf`
-> m StatusIcon	Returns: a new `StatusIcon`

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications

Creates a status icon displaying pixbuf.

The image will be scaled down to fit in the available space in the notification area, if necessary.

Since: 2.10

newFromStock

statusIconNewFromStock Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Text	`stockId`: a stock icon id
-> m StatusIcon	Returns: a new `StatusIcon`

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications

Creates a status icon displaying a stock icon. Sample stock icon names are STOCK_OPEN, STOCK_QUIT. You can register your own stock icon names, see iconFactoryAddDefault and iconFactoryAdd.

Since: 2.10

positionMenu

statusIconPositionMenu Source #

Arguments

:: (HasCallStack, MonadIO m, IsMenu a, IsStatusIcon b)
=> a	`menu`: the `Menu`
-> Int32	`x`: return location for the x position
-> Int32	`y`: return location for the y position
-> b	`userData`: the status icon to position the menu on
-> m (Int32, Int32, Bool)

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; notifications do not have menus, but can have buttons, and actions associated with each button

Menu positioning function to use with menuPopup to position menu aligned to the status icon userData.

Since: 2.10

setFromFile

statusIconSetFromFile Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> [Char]	`filename`: a filename
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; you can use notificationSetIcon to associate a Icon with a notification

Makes statusIcon display the file filename. See statusIconNewFromFile for details.

Since: 2.10

setFromGicon

statusIconSetFromGicon Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a, IsIcon b)
=> a	`statusIcon`: a `StatusIcon`
-> b	`icon`: a GIcon
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; you can use notificationSetIcon to associate a Icon with a notification

Makes statusIcon display the Icon. See statusIconNewFromGicon for details.

Since: 2.14

setFromIconName

statusIconSetFromIconName Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> Text	`iconName`: an icon name
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; you can use notificationSetIcon to associate a Icon with a notification

Makes statusIcon display the icon named iconName from the current icon theme. See statusIconNewFromIconName for details.

Since: 2.10

setFromPixbuf

statusIconSetFromPixbuf Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a, IsPixbuf b)
=> a	`statusIcon`: a `StatusIcon`
-> Maybe b	`pixbuf`: a `Pixbuf` or `Nothing`
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; you can use notificationSetIcon to associate a Icon with a notification

Makes statusIcon display pixbuf. See statusIconNewFromPixbuf for details.

Since: 2.10

setFromStock

statusIconSetFromStock Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> Text	`stockId`: a stock icon id
-> m ()

Deprecated: (Since version 3.10)Use statusIconSetFromIconName instead.

Makes statusIcon display the stock icon with the id stockId. See statusIconNewFromStock for details.

Since: 2.10

setHasTooltip

statusIconSetHasTooltip Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> Bool	`hasTooltip`: whether or not `statusIcon` has a tooltip
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function, but notifications can display an arbitrary amount of text using notificationSetBody

Sets the has-tooltip property on statusIcon to hasTooltip. See StatusIcon:has-tooltip for more information.

Since: 2.16

setName

statusIconSetName Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> Text	`name`: the name
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function, as notifications are associated with a unique application identifier by Application

Sets the name of this tray icon. This should be a string identifying this icon. It is may be used for sorting the icons in the tray and will not be shown to the user.

Since: 2.20

setScreen

statusIconSetScreen Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a, IsScreen b)
=> a	`statusIcon`: a `StatusIcon`
-> b	`screen`: a `Screen`
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function, as GTK typically only has one Screen and notifications are managed by the platform

Sets the Screen where statusIcon is displayed; if the icon is already mapped, it will be unmapped, and then remapped on the new screen.

Since: 2.12

setTitle

statusIconSetTitle Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> Text	`title`: the title
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; you should use notificationSetTitle and notificationSetBody to present text inside your notification

Sets the title of this tray icon. This should be a short, human-readable, localized string describing the tray icon. It may be used by tools like screen readers to render the tray icon.

Since: 2.18

setTooltipMarkup

statusIconSetTooltipMarkup Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> Maybe Text	`markup`: the contents of the tooltip for `statusIcon`, or `Nothing`
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Sets markup as the contents of the tooltip, which is marked up with the [Pango text markup language][PangoMarkupFormat].

This function will take care of setting StatusIcon:has-tooltip to True and of the default handler for the StatusIcon::query-tooltip signal.

See also the StatusIcon:tooltip-markup property and tooltipSetMarkup.

Since: 2.16

setTooltipText

statusIconSetTooltipText Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> Text	`text`: the contents of the tooltip for `statusIcon`
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function

Sets text as the contents of the tooltip.

This function will take care of setting StatusIcon:has-tooltip to True and of the default handler for the StatusIcon::query-tooltip signal.

See also the StatusIcon:tooltip-text property and tooltipSetText.

Since: 2.16

setVisible

statusIconSetVisible Source #

Arguments

:: (HasCallStack, MonadIO m, IsStatusIcon a)
=> a	`statusIcon`: a `StatusIcon`
-> Bool	`visible`: `True` to show the status icon, `False` to hide it
-> m ()

Deprecated: (Since version 3.14)Use Notification and Application to provide status notifications; there is no direct replacement for this function, as notifications are managed by the platform

Shows or hides a status icon.

Since: 2.10

Properties

embedded

True if the statusicon is embedded in a notification area.

Since: 2.12

getStatusIconEmbedded :: (MonadIO m, IsStatusIcon o) => o -> m Bool Source #

Get the value of the “embedded” property. When overloading is enabled, this is equivalent to

get statusIcon #embedded

file

No description available in the introspection data.

clearStatusIconFile :: (MonadIO m, IsStatusIcon o) => o -> m () Source #

Set the value of the “file” property to Nothing. When overloading is enabled, this is equivalent to

clear #file

constructStatusIconFile :: IsStatusIcon o => Text -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “file” property. This is rarely needed directly, but it is used by new.

setStatusIconFile :: (MonadIO m, IsStatusIcon o) => o -> Text -> m () Source #

Set the value of the “file” property. When overloading is enabled, this is equivalent to

set statusIcon [ #file := value ]

gicon

The Icon displayed in the StatusIcon. For themed icons, the image will be updated automatically if the theme changes.

Since: 2.14

clearStatusIconGicon :: (MonadIO m, IsStatusIcon o) => o -> m () Source #

Set the value of the “gicon” property to Nothing. When overloading is enabled, this is equivalent to

clear #gicon

constructStatusIconGicon :: (IsStatusIcon o, IsIcon a) => a -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “gicon” property. This is rarely needed directly, but it is used by new.

getStatusIconGicon :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Icon) Source #

Get the value of the “gicon” property. When overloading is enabled, this is equivalent to

get statusIcon #gicon

setStatusIconGicon :: (MonadIO m, IsStatusIcon o, IsIcon a) => o -> a -> m () Source #

Set the value of the “gicon” property. When overloading is enabled, this is equivalent to

set statusIcon [ #gicon := value ]

hasTooltip

Enables or disables the emission of StatusIcon::query-tooltip on statusIcon. A value of True indicates that statusIcon can have a tooltip, in this case the status icon will be queried using StatusIcon::query-tooltip to determine whether it will provide a tooltip or not.

Note that setting this property to True for the first time will change the event masks of the windows of this status icon to include leave-notify and motion-notify events. This will not be undone when the property is set to False again.

Whether this property is respected is platform dependent. For plain text tooltips, use StatusIcon:tooltip-text in preference.

Since: 2.16

constructStatusIconHasTooltip :: IsStatusIcon o => Bool -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “has-tooltip” property. This is rarely needed directly, but it is used by new.

getStatusIconHasTooltip :: (MonadIO m, IsStatusIcon o) => o -> m Bool Source #

Get the value of the “has-tooltip” property. When overloading is enabled, this is equivalent to

get statusIcon #hasTooltip

setStatusIconHasTooltip :: (MonadIO m, IsStatusIcon o) => o -> Bool -> m () Source #

Set the value of the “has-tooltip” property. When overloading is enabled, this is equivalent to

set statusIcon [ #hasTooltip := value ]

iconName

No description available in the introspection data.

clearStatusIconIconName :: (MonadIO m, IsStatusIcon o) => o -> m () Source #

Set the value of the “icon-name” property to Nothing. When overloading is enabled, this is equivalent to

clear #iconName

constructStatusIconIconName :: IsStatusIcon o => Text -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “icon-name” property. This is rarely needed directly, but it is used by new.

getStatusIconIconName :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Text) Source #

Get the value of the “icon-name” property. When overloading is enabled, this is equivalent to

get statusIcon #iconName

setStatusIconIconName :: (MonadIO m, IsStatusIcon o) => o -> Text -> m () Source #

Set the value of the “icon-name” property. When overloading is enabled, this is equivalent to

set statusIcon [ #iconName := value ]

orientation

The orientation of the tray in which the statusicon is embedded.

Since: 2.12

getStatusIconOrientation :: (MonadIO m, IsStatusIcon o) => o -> m Orientation Source #

Get the value of the “orientation” property. When overloading is enabled, this is equivalent to

get statusIcon #orientation

pixbuf

No description available in the introspection data.

clearStatusIconPixbuf :: (MonadIO m, IsStatusIcon o) => o -> m () Source #

Set the value of the “pixbuf” property to Nothing. When overloading is enabled, this is equivalent to

clear #pixbuf

constructStatusIconPixbuf :: (IsStatusIcon o, IsPixbuf a) => a -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “pixbuf” property. This is rarely needed directly, but it is used by new.

getStatusIconPixbuf :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Pixbuf) Source #

Get the value of the “pixbuf” property. When overloading is enabled, this is equivalent to

get statusIcon #pixbuf

setStatusIconPixbuf :: (MonadIO m, IsStatusIcon o, IsPixbuf a) => o -> a -> m () Source #

Set the value of the “pixbuf” property. When overloading is enabled, this is equivalent to

set statusIcon [ #pixbuf := value ]

screen

No description available in the introspection data.

constructStatusIconScreen :: (IsStatusIcon o, IsScreen a) => a -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “screen” property. This is rarely needed directly, but it is used by new.

getStatusIconScreen :: (MonadIO m, IsStatusIcon o) => o -> m Screen Source #

Get the value of the “screen” property. When overloading is enabled, this is equivalent to

get statusIcon #screen

setStatusIconScreen :: (MonadIO m, IsStatusIcon o, IsScreen a) => o -> a -> m () Source #

Set the value of the “screen” property. When overloading is enabled, this is equivalent to

set statusIcon [ #screen := value ]

size

No description available in the introspection data.

getStatusIconSize :: (MonadIO m, IsStatusIcon o) => o -> m Int32 Source #

Get the value of the “size” property. When overloading is enabled, this is equivalent to

get statusIcon #size

stock

No description available in the introspection data.

clearStatusIconStock :: (MonadIO m, IsStatusIcon o) => o -> m () Source #

Set the value of the “stock” property to Nothing. When overloading is enabled, this is equivalent to

clear #stock

constructStatusIconStock :: IsStatusIcon o => Text -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “stock” property. This is rarely needed directly, but it is used by new.

getStatusIconStock :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Text) Source #

Get the value of the “stock” property. When overloading is enabled, this is equivalent to

get statusIcon #stock

setStatusIconStock :: (MonadIO m, IsStatusIcon o) => o -> Text -> m () Source #

Set the value of the “stock” property. When overloading is enabled, this is equivalent to

set statusIcon [ #stock := value ]

storageType

No description available in the introspection data.

getStatusIconStorageType :: (MonadIO m, IsStatusIcon o) => o -> m ImageType Source #

Get the value of the “storage-type” property. When overloading is enabled, this is equivalent to

get statusIcon #storageType

title

The title of this tray icon. This should be a short, human-readable, localized string describing the tray icon. It may be used by tools like screen readers to render the tray icon.

Since: 2.18

constructStatusIconTitle :: IsStatusIcon o => Text -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “title” property. This is rarely needed directly, but it is used by new.

getStatusIconTitle :: (MonadIO m, IsStatusIcon o) => o -> m Text Source #

Get the value of the “title” property. When overloading is enabled, this is equivalent to

get statusIcon #title

setStatusIconTitle :: (MonadIO m, IsStatusIcon o) => o -> Text -> m () Source #

Set the value of the “title” property. When overloading is enabled, this is equivalent to

set statusIcon [ #title := value ]

tooltipMarkup

Sets the text of tooltip to be the given string, which is marked up with the [Pango text markup language][PangoMarkupFormat]. Also see tooltipSetMarkup.

This is a convenience property which will take care of getting the tooltip shown if the given string is not Nothing. StatusIcon:has-tooltip will automatically be set to True and the default handler for the StatusIcon::query-tooltip signal will take care of displaying the tooltip.

On some platforms, embedded markup will be ignored.

Since: 2.16

clearStatusIconTooltipMarkup :: (MonadIO m, IsStatusIcon o) => o -> m () Source #

Set the value of the “tooltip-markup” property to Nothing. When overloading is enabled, this is equivalent to

clear #tooltipMarkup

constructStatusIconTooltipMarkup :: IsStatusIcon o => Text -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “tooltip-markup” property. This is rarely needed directly, but it is used by new.

getStatusIconTooltipMarkup :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Text) Source #

Get the value of the “tooltip-markup” property. When overloading is enabled, this is equivalent to

get statusIcon #tooltipMarkup

setStatusIconTooltipMarkup :: (MonadIO m, IsStatusIcon o) => o -> Text -> m () Source #

Set the value of the “tooltip-markup” property. When overloading is enabled, this is equivalent to

set statusIcon [ #tooltipMarkup := value ]

tooltipText

Sets the text of tooltip to be the given string.

Also see tooltipSetText.

This is a convenience property which will take care of getting the tooltip shown if the given string is not Nothing. StatusIcon:has-tooltip will automatically be set to True and the default handler for the StatusIcon::query-tooltip signal will take care of displaying the tooltip.

Note that some platforms have limitations on the length of tooltips that they allow on status icons, e.g. Windows only shows the first 64 characters.

Since: 2.16

constructStatusIconTooltipText :: IsStatusIcon o => Text -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “tooltip-text” property. This is rarely needed directly, but it is used by new.

getStatusIconTooltipText :: (MonadIO m, IsStatusIcon o) => o -> m (Maybe Text) Source #

Get the value of the “tooltip-text” property. When overloading is enabled, this is equivalent to

get statusIcon #tooltipText

setStatusIconTooltipText :: (MonadIO m, IsStatusIcon o) => o -> Text -> m () Source #

Set the value of the “tooltip-text” property. When overloading is enabled, this is equivalent to

set statusIcon [ #tooltipText := value ]

visible

No description available in the introspection data.

constructStatusIconVisible :: IsStatusIcon o => Bool -> IO (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “visible” property. This is rarely needed directly, but it is used by new.

getStatusIconVisible :: (MonadIO m, IsStatusIcon o) => o -> m Bool Source #

Get the value of the “visible” property. When overloading is enabled, this is equivalent to

get statusIcon #visible

setStatusIconVisible :: (MonadIO m, IsStatusIcon o) => o -> Bool -> m () Source #

Set the value of the “visible” property. When overloading is enabled, this is equivalent to

set statusIcon [ #visible := value ]

Signals

activate

type C_StatusIconActivateCallback = Ptr () -> Ptr () -> IO () Source #

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

type StatusIconActivateCallback = IO () Source #

Gets emitted when the user activates the status icon. If and how status icons can activated is platform-dependent.

Unlike most G_SIGNAL_ACTION signals, this signal is meant to be used by applications and should be wrapped by language bindings.

Since: 2.10

afterStatusIconActivate :: (IsStatusIcon a, MonadIO m) => a -> StatusIconActivateCallback -> m SignalHandlerId Source #

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

after statusIcon #activate callback

genClosure_StatusIconActivate :: MonadIO m => StatusIconActivateCallback -> m (GClosure C_StatusIconActivateCallback) Source #

Wrap the callback into a GClosure.

mk_StatusIconActivateCallback :: C_StatusIconActivateCallback -> IO (FunPtr C_StatusIconActivateCallback) Source #

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

noStatusIconActivateCallback :: Maybe StatusIconActivateCallback Source #

A convenience synonym for Nothing :: Maybe StatusIconActivateCallback.

onStatusIconActivate :: (IsStatusIcon a, MonadIO m) => a -> StatusIconActivateCallback -> m SignalHandlerId Source #

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

on statusIcon #activate callback

wrap_StatusIconActivateCallback :: StatusIconActivateCallback -> C_StatusIconActivateCallback Source #

Wrap a StatusIconActivateCallback into a C_StatusIconActivateCallback.

buttonPressEvent

type C_StatusIconButtonPressEventCallback = Ptr () -> Ptr EventButton -> Ptr () -> IO CInt Source #

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

type StatusIconButtonPressEventCallback Source #

Arguments

= EventButton	`event`: the `EventButton` which triggered this signal
-> IO Bool	Returns: `True` to stop other handlers from being invoked for the event. `False` to propagate the event further.

The ::button-press-event signal will be emitted when a button (typically from a mouse) is pressed.

Whether this event is emitted is platform-dependent. Use the ::activate and ::popup-menu signals in preference.

Since: 2.14

afterStatusIconButtonPressEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconButtonPressEventCallback -> m SignalHandlerId Source #

Connect a signal handler for the “button-press-event” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after statusIcon #buttonPressEvent callback

genClosure_StatusIconButtonPressEvent :: MonadIO m => StatusIconButtonPressEventCallback -> m (GClosure C_StatusIconButtonPressEventCallback) Source #

Wrap the callback into a GClosure.

mk_StatusIconButtonPressEventCallback :: C_StatusIconButtonPressEventCallback -> IO (FunPtr C_StatusIconButtonPressEventCallback) Source #

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

noStatusIconButtonPressEventCallback :: Maybe StatusIconButtonPressEventCallback Source #

A convenience synonym for Nothing :: Maybe StatusIconButtonPressEventCallback.

onStatusIconButtonPressEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconButtonPressEventCallback -> m SignalHandlerId Source #

Connect a signal handler for the “button-press-event” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on statusIcon #buttonPressEvent callback

wrap_StatusIconButtonPressEventCallback :: StatusIconButtonPressEventCallback -> C_StatusIconButtonPressEventCallback Source #

Wrap a StatusIconButtonPressEventCallback into a C_StatusIconButtonPressEventCallback.

buttonReleaseEvent

type C_StatusIconButtonReleaseEventCallback = Ptr () -> Ptr EventButton -> Ptr () -> IO CInt Source #

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

type StatusIconButtonReleaseEventCallback Source #

Arguments

= EventButton	`event`: the `EventButton` which triggered this signal
-> IO Bool	Returns: `True` to stop other handlers from being invoked for the event. `False` to propagate the event further.

The ::button-release-event signal will be emitted when a button (typically from a mouse) is released.

Whether this event is emitted is platform-dependent. Use the ::activate and ::popup-menu signals in preference.

Since: 2.14

afterStatusIconButtonReleaseEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconButtonReleaseEventCallback -> m SignalHandlerId Source #

Connect a signal handler for the “button-release-event” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after statusIcon #buttonReleaseEvent callback

genClosure_StatusIconButtonReleaseEvent :: MonadIO m => StatusIconButtonReleaseEventCallback -> m (GClosure C_StatusIconButtonReleaseEventCallback) Source #

Wrap the callback into a GClosure.

mk_StatusIconButtonReleaseEventCallback :: C_StatusIconButtonReleaseEventCallback -> IO (FunPtr C_StatusIconButtonReleaseEventCallback) Source #

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

noStatusIconButtonReleaseEventCallback :: Maybe StatusIconButtonReleaseEventCallback Source #

A convenience synonym for Nothing :: Maybe StatusIconButtonReleaseEventCallback.

onStatusIconButtonReleaseEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconButtonReleaseEventCallback -> m SignalHandlerId Source #

Connect a signal handler for the “button-release-event” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on statusIcon #buttonReleaseEvent callback

wrap_StatusIconButtonReleaseEventCallback :: StatusIconButtonReleaseEventCallback -> C_StatusIconButtonReleaseEventCallback Source #

Wrap a StatusIconButtonReleaseEventCallback into a C_StatusIconButtonReleaseEventCallback.

popupMenu

type C_StatusIconPopupMenuCallback = Ptr () -> Word32 -> Word32 -> Ptr () -> IO () Source #

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

type StatusIconPopupMenuCallback Source #

Arguments

= Word32	`button`: the button that was pressed, or 0 if the signal is not emitted in response to a button press event
-> Word32	`activateTime`: the timestamp of the event that triggered the signal emission
-> IO ()

Gets emitted when the user brings up the context menu of the status icon. Whether status icons can have context menus and how these are activated is platform-dependent.

The button and activateTime parameters should be passed as the last to arguments to menuPopup.

Unlike most G_SIGNAL_ACTION signals, this signal is meant to be used by applications and should be wrapped by language bindings.

Since: 2.10

afterStatusIconPopupMenu :: (IsStatusIcon a, MonadIO m) => a -> StatusIconPopupMenuCallback -> m SignalHandlerId Source #

Connect a signal handler for the “popup-menu” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after statusIcon #popupMenu callback

genClosure_StatusIconPopupMenu :: MonadIO m => StatusIconPopupMenuCallback -> m (GClosure C_StatusIconPopupMenuCallback) Source #

Wrap the callback into a GClosure.

mk_StatusIconPopupMenuCallback :: C_StatusIconPopupMenuCallback -> IO (FunPtr C_StatusIconPopupMenuCallback) Source #

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

noStatusIconPopupMenuCallback :: Maybe StatusIconPopupMenuCallback Source #

A convenience synonym for Nothing :: Maybe StatusIconPopupMenuCallback.

onStatusIconPopupMenu :: (IsStatusIcon a, MonadIO m) => a -> StatusIconPopupMenuCallback -> m SignalHandlerId Source #

Connect a signal handler for the “popup-menu” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on statusIcon #popupMenu callback

wrap_StatusIconPopupMenuCallback :: StatusIconPopupMenuCallback -> C_StatusIconPopupMenuCallback Source #

Wrap a StatusIconPopupMenuCallback into a C_StatusIconPopupMenuCallback.

queryTooltip

type C_StatusIconQueryTooltipCallback = Ptr () -> Int32 -> Int32 -> CInt -> Ptr Tooltip -> Ptr () -> IO CInt Source #

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

type StatusIconQueryTooltipCallback Source #

Arguments

= Int32	`x`: the x coordinate of the cursor position where the request has been emitted, relative to `statusIcon`
-> Int32	`y`: the y coordinate of the cursor position where the request has been emitted, relative to `statusIcon`
-> Bool	`keyboardMode`: `True` if the tooltip was trigged using the keyboard
-> Tooltip	`tooltip`: a `Tooltip`
-> IO Bool	Returns: `True` if `tooltip` should be shown right now, `False` otherwise.

Emitted when the hover timeout has expired with the cursor hovering above statusIcon; or emitted when statusIcon got focus in keyboard mode.

Using the given coordinates, the signal handler should determine whether a tooltip should be shown for statusIcon. If this is the case True should be returned, False otherwise. Note that if keyboardMode is True, the values of x and y are undefined and should not be used.

The signal handler is free to manipulate tooltip with the therefore destined function calls.

Whether this signal is emitted is platform-dependent. For plain text tooltips, use StatusIcon:tooltip-text in preference.

Since: 2.16

afterStatusIconQueryTooltip :: (IsStatusIcon a, MonadIO m) => a -> StatusIconQueryTooltipCallback -> m SignalHandlerId Source #

Connect a signal handler for the “query-tooltip” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after statusIcon #queryTooltip callback

genClosure_StatusIconQueryTooltip :: MonadIO m => StatusIconQueryTooltipCallback -> m (GClosure C_StatusIconQueryTooltipCallback) Source #

Wrap the callback into a GClosure.

mk_StatusIconQueryTooltipCallback :: C_StatusIconQueryTooltipCallback -> IO (FunPtr C_StatusIconQueryTooltipCallback) Source #

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

noStatusIconQueryTooltipCallback :: Maybe StatusIconQueryTooltipCallback Source #

A convenience synonym for Nothing :: Maybe StatusIconQueryTooltipCallback.

onStatusIconQueryTooltip :: (IsStatusIcon a, MonadIO m) => a -> StatusIconQueryTooltipCallback -> m SignalHandlerId Source #

Connect a signal handler for the “query-tooltip” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on statusIcon #queryTooltip callback

wrap_StatusIconQueryTooltipCallback :: StatusIconQueryTooltipCallback -> C_StatusIconQueryTooltipCallback Source #

Wrap a StatusIconQueryTooltipCallback into a C_StatusIconQueryTooltipCallback.

scrollEvent

type C_StatusIconScrollEventCallback = Ptr () -> Ptr EventScroll -> Ptr () -> IO CInt Source #

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

type StatusIconScrollEventCallback Source #

Arguments

= EventScroll	`event`: the `EventScroll` which triggered this signal
-> IO Bool	Returns: `True` to stop other handlers from being invoked for the event. `False` to propagate the event further.

The ::scroll-event signal is emitted when a button in the 4 to 7 range is pressed. Wheel mice are usually configured to generate button press events for buttons 4 and 5 when the wheel is turned.

Whether this event is emitted is platform-dependent.

Since: 2.16

afterStatusIconScrollEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconScrollEventCallback -> m SignalHandlerId Source #

Connect a signal handler for the “scroll-event” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after statusIcon #scrollEvent callback

genClosure_StatusIconScrollEvent :: MonadIO m => StatusIconScrollEventCallback -> m (GClosure C_StatusIconScrollEventCallback) Source #

Wrap the callback into a GClosure.

mk_StatusIconScrollEventCallback :: C_StatusIconScrollEventCallback -> IO (FunPtr C_StatusIconScrollEventCallback) Source #

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

noStatusIconScrollEventCallback :: Maybe StatusIconScrollEventCallback Source #

A convenience synonym for Nothing :: Maybe StatusIconScrollEventCallback.

onStatusIconScrollEvent :: (IsStatusIcon a, MonadIO m) => a -> StatusIconScrollEventCallback -> m SignalHandlerId Source #

Connect a signal handler for the “scroll-event” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on statusIcon #scrollEvent callback

wrap_StatusIconScrollEventCallback :: StatusIconScrollEventCallback -> C_StatusIconScrollEventCallback Source #

Wrap a StatusIconScrollEventCallback into a C_StatusIconScrollEventCallback.

sizeChanged

type C_StatusIconSizeChangedCallback = Ptr () -> Int32 -> Ptr () -> IO CInt Source #

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

type StatusIconSizeChangedCallback Source #

Arguments

= Int32	`size`: the new size
-> IO Bool	Returns: `True` if the icon was updated for the new size. Otherwise, GTK+ will scale the icon as necessary.

Gets emitted when the size available for the image changes, e.g. because the notification area got resized.

Since: 2.10

afterStatusIconSizeChanged :: (IsStatusIcon a, MonadIO m) => a -> StatusIconSizeChangedCallback -> m SignalHandlerId Source #

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

after statusIcon #sizeChanged callback

genClosure_StatusIconSizeChanged :: MonadIO m => StatusIconSizeChangedCallback -> m (GClosure C_StatusIconSizeChangedCallback) Source #

Wrap the callback into a GClosure.

mk_StatusIconSizeChangedCallback :: C_StatusIconSizeChangedCallback -> IO (FunPtr C_StatusIconSizeChangedCallback) Source #

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

noStatusIconSizeChangedCallback :: Maybe StatusIconSizeChangedCallback Source #

A convenience synonym for Nothing :: Maybe StatusIconSizeChangedCallback.

onStatusIconSizeChanged :: (IsStatusIcon a, MonadIO m) => a -> StatusIconSizeChangedCallback -> m SignalHandlerId Source #

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

on statusIcon #sizeChanged callback

wrap_StatusIconSizeChangedCallback :: StatusIconSizeChangedCallback -> C_StatusIconSizeChangedCallback Source #

Wrap a StatusIconSizeChangedCallback into a C_StatusIconSizeChangedCallback.