Declaration [src]

gdk_screen_get_monitor_workarea (
  GdkScreen* screen,
  gint monitor_num,
  GdkRectangle* dest

Description [src]

Retrieves the GdkRectangle representing the size and position of the “work area” on a monitor within the entire screen area. The returned geometry is in ”application pixels”, not in ”device pixels” (see gdk_screen_get_monitor_scale_factor()).

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.

Monitor numbers start at 0. To obtain the number of monitors of screen, use gdk_screen_get_n_monitors().

Available since:3.4
Deprecated since:3.22

Use gdk_monitor_get_workarea() instead.


monitor_num gint

The monitor number.

dest GdkRectangle

A GdkRectangle to be filled with the monitor workarea.

 The argument will be set by the function.
 The argument can be NULL.
 The data is owned by the caller of the function.