Package: gdk

Accessor gdk-monitor-workarea

Lambda List

gdk-monitor-workarea (object)

Syntax

(gdk-monitor-workarea object) => workarea

Arguments

object -- a gdk-monitor object
workarea -- a gdk-rectangle with the monitor workarea

Details

Accessor of the workarea slot of the gdk-monitor class.

The slot access function gdk-monitor-workarea retrieves the size and position of the "work area" on a monitor within the display coordinate space. The returned geometry is in "application pixels", not in "device pixels". See the function gdk-monitor-scale-factor for the internal scale factor that maps from monitor coordinates to device pixels.

The work area should be considered when positioning menus and similar popups, to avoid placing them below panels, docks or other desktop components.

Note that not all backends may have a concept of workarea. This function will return the monitor geometry if a workarea is not available, or does not apply.

Since 3.22
 

See also

2020-11-3