2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GdkScreen
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
object representing a physical screen
|
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2002-05-01 21:29:49 +00:00
|
|
|
#GdkScreen objects are the GDK representation of a physical screen. It is used
|
|
|
|
throughout GDK and GTK+ to specify which screen the top level windows
|
2002-04-30 18:07:51 +00:00
|
|
|
are to be displayed on.
|
|
|
|
It is also used to query the screen specification and default settings such as
|
|
|
|
the default colormap (gdk_screen_get_default_colormap()),
|
|
|
|
the screen width (gdk_screen_get_width()), etc.
|
|
|
|
</para>
|
2002-05-01 21:29:49 +00:00
|
|
|
<para>Note that a screen may consist of multiple monitors which are merged to
|
|
|
|
form a large screen area.
|
|
|
|
</para>
|
2002-04-30 18:07:51 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-05-01 21:29:49 +00:00
|
|
|
<!-- ##### STRUCT GdkScreen ##### -->
|
|
|
|
<para>
|
2002-05-14 20:55:22 +00:00
|
|
|
This is a currently just a placeholder typedef for the first argument of
|
|
|
|
the @window_at_pointer function in #GdkPointerHooks. It will be used
|
|
|
|
when GDK gets multihead support.
|
2002-05-01 21:29:49 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2002-06-20 23:59:27 +00:00
|
|
|
<!-- ##### FUNCTION gdk_screen_get_default ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### FUNCTION gdk_screen_get_default_colormap ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_set_default_colormap ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@colormap:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_system_colormap ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_system_visual ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_rgb_colormap ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_rgb_visual ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_root_window ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_display ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_number ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_window_at_pointer ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@win_x:
|
|
|
|
@win_y:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_height ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_width_mm ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_height_mm ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_list_visuals ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_toplevel_windows ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_n_monitors ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_monitor_geometry ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@monitor_num:
|
2002-05-01 21:29:49 +00:00
|
|
|
@dest:
|
|
|
|
<!-- # Unused Parameters # -->
|
2002-04-30 18:07:51 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_monitor_at_point ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_monitor_at_window ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
2002-05-01 21:29:49 +00:00
|
|
|
@window:
|
2002-04-30 18:07:51 +00:00
|
|
|
@Returns:
|
2002-05-01 21:29:49 +00:00
|
|
|
<!-- # Unused Parameters # -->
|
|
|
|
@anid:
|
2002-04-30 18:07:51 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_broadcast_client_message ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@event:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_screen_get_setting ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@name:
|
|
|
|
@value:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-10-04 15:58:19 +00:00
|
|
|
<!-- ##### SIGNAL GdkScreen::size-changed ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@gdkscreen: the object which received the signal.
|
|
|
|
|