Method

GdkScreenget_monitor_workarea

deprecated: 3.22 since: 3.4

Declaration [src]

void
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.

Parameters

monitor_num

Type: gint

The monitor number.

dest

Type: GdkRectangle

A GdkRectangle to be filled with the monitor workarea.

The argument will be set by the function.
The argument can be NULL.
The returned data is owned by the instance.