Method
GtkStatusIconget_geometry
deprecated: 3.14 since: 2.10
Declaration [src]
gboolean
gtk_status_icon_get_geometry (
GtkStatusIcon* status_icon,
GdkScreen** screen,
GdkRectangle* area,
GtkOrientation* orientation
)
Description [src]
Obtains information about the location of the status icon on screen. This information can be used to e.g. position popups like notification bubbles.
See gtk_status_icon_position_menu() for a more convenient
alternative for positioning menus.
Note that some platforms do not allow GTK+ to provide this information, and even on platforms that do allow it, the information is not reliable unless the status icon is embedded in a notification area, see gtk_status_icon_is_embedded().
Available since: 2.10
Deprecated since: 3.14
Use GNotification and GtkApplication to
provide status notifications; there is no direct replacement
for this function, as the platform is responsible for the
presentation of notifications.
Parameters
screen-
Type:
GdkScreenReturn location for the screen, or
NULLif the information is not needed.The argument will be set by the function. The argument can be NULL.The returned data is owned by the instance. area-
Type:
GdkRectangleReturn location for the area occupied by the status icon, or
NULL.The argument will be set by the function. The argument can be NULL.The returned data is owned by the instance. orientation-
Type:
GtkOrientationReturn location for the orientation of the panel in which the status icon is embedded, or
NULL. A panel at the top or bottom of the screen is horizontal, a panel at the left or right is vertical.The argument will be set by the function. The argument can be NULL.The caller of the method takes ownership of the returned data, and is responsible for freeing it.