gi-wnck-3.0.4: Wnck bindings

CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (inaki@blueleaf.cc)
Safe HaskellNone
LanguageHaskell2010

GI.Wnck.Objects.Tasklist

Contents

Description

The Tasklist struct contains only private fields and should not be directly accessed.

Synopsis

Exported types

newtype Tasklist Source #

Memory-managed wrapper type.

Constructors

Tasklist (ManagedPtr Tasklist) 
Instances
GObject Tasklist Source # 
Instance details

Defined in GI.Wnck.Objects.Tasklist

Methods

gobjectType :: IO GType

HasParentTypes Tasklist Source # 
Instance details

Defined in GI.Wnck.Objects.Tasklist

type ParentTypes Tasklist Source # 
Instance details

Defined in GI.Wnck.Objects.Tasklist

type ParentTypes Tasklist = Container ': (Widget ': (Object ': (ImplementorIface ': (Buildable ': ([] :: [Type])))))

class (GObject o, IsDescendantOf Tasklist o) => IsTasklist o Source #

Type class for types which can be safely cast to Tasklist, for instance with toTasklist.

Instances
(GObject o, IsDescendantOf Tasklist o) => IsTasklist o Source # 
Instance details

Defined in GI.Wnck.Objects.Tasklist

toTasklist :: (MonadIO m, IsTasklist o) => o -> m Tasklist Source #

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

noTasklist :: Maybe Tasklist Source #

A convenience alias for Nothing :: Maybe Tasklist.

Methods

getScrollEnabled

tasklistGetScrollEnabled Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> m Bool 

Gets the scroll behavior of the tasklist.

Since: 3.24.0

getSizeHintList

tasklistGetSizeHintList Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> Int32

nElements: return location for the number of elements in the array returned by this function. This number should always be pair.

-> m Int32

Returns: a list of size hints that can be used to allocate an appropriate size for tasklist.

Since a Tasklist does not have a fixed size (Window can be grouped when needed, for example), the standard size request mechanism in GTK+ is not enough to announce what sizes can be used by tasklist. The size hints mechanism is a solution for this. See panel_applet_set_size_hints() for more information.

new

tasklistNew Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> m Tasklist

Returns: a newly created Tasklist.

Creates a new Tasklist. The Tasklist will list Window of the Screen it is on.

setButtonRelief

tasklistSetButtonRelief Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> ReliefStyle

relief: a relief type.

-> m () 

Sets the relief type of the buttons in tasklist to relief. The main use of this function is proper integration of Tasklist in panels with non-system backgrounds.

Since: 2.12

setGrouping

tasklistSetGrouping Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> TasklistGroupingType

grouping: a grouping policy.

-> m () 

Sets the grouping policy for tasklist to grouping.

setGroupingLimit

tasklistSetGroupingLimit Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> Int32

limit: a size in pixels.

-> m () 

Sets the maximum size of buttons in tasklist before tasklist tries to group Window in the same Application in only one button. This limit is valid only when the grouping policy of tasklist is TasklistGroupingTypeAutoGroup.

setIncludeAllWorkspaces

tasklistSetIncludeAllWorkspaces Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> Bool

includeAllWorkspaces: whether to display Window from all Workspace in tasklist.

-> m () 

Sets tasklist to display Window from all Workspace or not, according to includeAllWorkspaces.

Note that if the active Workspace has a viewport and if includeAllWorkspaces is False, then only the Window visible in the viewport are displayed in tasklist. The rationale for this is that the viewport is generally used to implement workspace-like behavior. A side-effect of this is that, when using multiple Workspace with viewport, it is not possible to show all Window from a Workspace (even those that are not visible in the viewport) in tasklist without showing all Window from all Workspace.

setMiddleClickClose

tasklistSetMiddleClickClose Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> Bool

middleClickClose: whether to close windows with middle click on button.

-> m () 

Sets tasklist to close windows with mouse middle click on button, according to middleClickClose.

Since: 3.4.6

setOrientation

tasklistSetOrientation Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> Orientation

orient: a GtkOrientation.

-> m () 

Set the orientation of the tasklist to match orient. This function can be used to integrate a Tasklist in vertical panels.

Since: 3.4.6

setScrollEnabled

tasklistSetScrollEnabled Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> Bool

scrollEnabled: a boolean.

-> m () 

Sets the scroll behavior of the tasklist. When set to True, a scroll event over the tasklist will change the current window accordingly.

Since: 3.24.0

setSwitchWorkspaceOnUnminimize

tasklistSetSwitchWorkspaceOnUnminimize Source #

Arguments

:: (HasCallStack, MonadIO m, IsTasklist a) 
=> a

tasklist: a Tasklist.

-> Bool

switchWorkspaceOnUnminimize: whether to activate the Workspace a Window is on when unminimizing it.

-> m () 

Sets tasklist to activate or not the Workspace a Window is on when unminimizing it, according to switchWorkspaceOnUnminimize.

FIXME: does it still work?

Signals

taskEnterNotify

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

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

type TasklistTaskEnterNotifyCallback Source #

Arguments

 = Ptr ()

windows: the List with all the Window belonging to the task.

-> IO () 

Emitted when the task is entered.

afterTasklistTaskEnterNotify :: (IsTasklist a, MonadIO m) => a -> TasklistTaskEnterNotifyCallback -> m SignalHandlerId Source #

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

after tasklist #taskEnterNotify callback

onTasklistTaskEnterNotify :: (IsTasklist a, MonadIO m) => a -> TasklistTaskEnterNotifyCallback -> m SignalHandlerId Source #

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

on tasklist #taskEnterNotify callback

taskLeaveNotify

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

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

type TasklistTaskLeaveNotifyCallback Source #

Arguments

 = Ptr ()

windows: the List with all the Window belonging to the task.

-> IO () 

Emitted when the task is entered.

afterTasklistTaskLeaveNotify :: (IsTasklist a, MonadIO m) => a -> TasklistTaskLeaveNotifyCallback -> m SignalHandlerId Source #

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

after tasklist #taskLeaveNotify callback

onTasklistTaskLeaveNotify :: (IsTasklist a, MonadIO m) => a -> TasklistTaskLeaveNotifyCallback -> m SignalHandlerId Source #

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

on tasklist #taskLeaveNotify callback