Method

GdkScreenget_monitor_workarea

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