<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="GdkDisplay">
<refmeta>
<refentrytitle role="top_of_page" id="GdkDisplay.top_of_page">GdkDisplay</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GDK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GdkDisplay</refname>
<refpurpose>Controls a set of monitors and their associated input devices</refpurpose>
</refnamediv>

<refsect1 id="GdkDisplay.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_return" colwidth="150px"/>
<colspec colname="functions_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-open">gdk_display_open</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-default">gdk_display_get_default</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-name">gdk_display_get_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-device-is-grabbed">gdk_display_device_is_grabbed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-beep">gdk_display_beep</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-sync">gdk_display_sync</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-flush">gdk_display_flush</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-close">gdk_display_close</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-is-closed">gdk_display_is_closed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkEvent"><returnvalue>GdkEvent</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-event">gdk_display_get_event</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkEvent"><returnvalue>GdkEvent</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-peek-event">gdk_display_peek_event</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-put-event">gdk_display_put_event</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-has-pending">gdk_display_has_pending</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-is-rgba">gdk_display_is_rgba</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-is-composited">gdk_display_is_composited</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkSurface"><returnvalue>GdkSurface</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-default-group">gdk_display_get_default_group</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-supports-shapes">gdk_display_supports_shapes</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-supports-input-shapes">gdk_display_supports_input_shapes</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkAppLaunchContext"><returnvalue>GdkAppLaunchContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-app-launch-context">gdk_display_get_app_launch_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-notify-startup-complete">gdk_display_notify_startup_complete</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkSeat"><returnvalue>GdkSeat</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-default-seat">gdk_display_get_default_seat</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GList"><returnvalue>GList</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-list-seats">gdk_display_list_seats</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-get-n-monitors">gdk_display_get_n_monitors</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkMonitor"><returnvalue>GdkMonitor</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-monitor">gdk_display_get_monitor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkMonitor"><returnvalue>GdkMonitor</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-primary-monitor">gdk_display_get_primary_monitor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkMonitor"><returnvalue>GdkMonitor</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-monitor-at-point">gdk_display_get_monitor_at_point</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkMonitor"><returnvalue>GdkMonitor</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-monitor-at-surface">gdk_display_get_monitor_at_surface</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkClipboard"><returnvalue>GdkClipboard</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-clipboard">gdk_display_get_clipboard</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkClipboard"><returnvalue>GdkClipboard</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-primary-clipboard">gdk_display_get_primary_clipboard</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-display-get-setting">gdk_display_get_setting</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkKeymap"><returnvalue>GdkKeymap</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-keymap">gdk_display_get_keymap</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GdkDisplay.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GdkDisplay--composited">composited</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GdkDisplay--rgba">rgba</link></entry><entry role="property_flags">Read</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GdkDisplay.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signals_return" colwidth="150px"/>
<colspec colname="signals_name" colwidth="300px"/>
<colspec colname="signals_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkDisplay-closed">closed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkDisplay-monitor-added">monitor-added</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkDisplay-monitor-removed">monitor-removed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkDisplay-opened">opened</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkDisplay-seat-added">seat-added</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkDisplay-seat-removed">seat-removed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkDisplay-setting-changed">setting-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GdkDisplay.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="name" colwidth="150px"/>
<colspec colname="description"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GdkDisplay-struct">GdkDisplay</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GdkDisplay.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GdkDisplay
</screen>
</refsect1>

<refsect1 id="GdkDisplay.includes"><title>Includes</title><synopsis>#include &lt;gdk/gdk.h&gt;
</synopsis></refsect1>

<refsect1 id="GdkDisplay.description" role="desc">
<title role="desc.title">Description</title>
<para>GdkDisplay objects are the GDK representation of a workstation.</para>
<para>Their purpose are two-fold:</para>
<itemizedlist>
<listitem><para>To manage and provide information about input devices (pointers, keyboards, etc)</para></listitem>
<listitem>
<para>To manage and provide information about output devices (monitors, projectors, etc)</para>
</listitem>
</itemizedlist>
<para>Most of the input device handling has been factored out into separate <link linkend="GdkSeat"><type>GdkSeat</type></link>
objects. Every display has a one or more seats, which can be accessed with
<link linkend="gdk-display-get-default-seat"><function>gdk_display_get_default_seat()</function></link> and <link linkend="gdk-display-list-seats"><function>gdk_display_list_seats()</function></link>.</para>
<para>Output devices are represented by <link linkend="GdkMonitor"><type>GdkMonitor</type></link> objects, which can be accessed
with <link linkend="gdk-display-get-monitor"><function>gdk_display_get_monitor()</function></link> and similar APIs.</para>

</refsect1>
<refsect1 id="GdkDisplay.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gdk-display-open" role="function">
<title>gdk_display_open&#160;()</title>
<indexterm zone="gdk-display-open"><primary>gdk_display_open</primary></indexterm>
<programlisting language="C"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
gdk_display_open (<parameter>const <link linkend="gchar"><type>gchar</type></link> *display_name</parameter>);</programlisting>
<para>Opens a display.</para>
<refsect3 id="gdk-display-open.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display_name</para></entry>
<entry role="parameter_description"><para>the name of the display to open</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-open.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the
display could not be opened. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-default" role="function">
<title>gdk_display_get_default&#160;()</title>
<indexterm zone="gdk-display-get-default"><primary>gdk_display_get_default</primary></indexterm>
<programlisting language="C"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
gdk_display_get_default (<parameter><type>void</type></parameter>);</programlisting>
<para>Gets the default <link linkend="GdkDisplay"><type>GdkDisplay</type></link>. This is a convenience
function for:
<literal>gdk_display_manager_get_default_display (<link linkend="gdk-display-manager-get"><function>gdk_display_manager_get()</function></link>)</literal>.</para>
<refsect3 id="gdk-display-get-default.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if
there is no default display. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-name" role="function">
<title>gdk_display_get_name&#160;()</title>
<indexterm zone="gdk-display-get-name"><primary>gdk_display_get_name</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gdk_display_get_name (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Gets the name of the display.</para>
<refsect3 id="gdk-display-get-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-name.returns" role="returns">
<title>Returns</title>
<para> a string representing the display name. This string is owned
by GDK and should not be modified or freed.</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-device-is-grabbed" role="function">
<title>gdk_display_device_is_grabbed&#160;()</title>
<indexterm zone="gdk-display-device-is-grabbed"><primary>gdk_display_device_is_grabbed</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_device_is_grabbed (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                               <parameter><link linkend="GdkDevice"><type>GdkDevice</type></link> *device</parameter>);</programlisting>
<para>Returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if there is an ongoing grab on <parameter>device</parameter>
 for <parameter>display</parameter>
.</para>
<refsect3 id="gdk-display-device-is-grabbed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>device</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDevice"><type>GdkDevice</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-device-is-grabbed.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if there is a grab in effect for <parameter>device</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-beep" role="function">
<title>gdk_display_beep&#160;()</title>
<indexterm zone="gdk-display-beep"><primary>gdk_display_beep</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_display_beep (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Emits a short beep on <parameter>display</parameter>
</para>
<refsect3 id="gdk-display-beep.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-display-sync" role="function">
<title>gdk_display_sync&#160;()</title>
<indexterm zone="gdk-display-sync"><primary>gdk_display_sync</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_display_sync (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Flushes any requests queued for the windowing system and waits until all
requests have been handled. This is often used for making sure that the
display is synchronized with the current state of the program. Calling
<link linkend="gdk-display-sync"><function>gdk_display_sync()</function></link> before <link linkend="gdk-error-trap-pop"><function>gdk_error_trap_pop()</function></link> makes sure that any errors
generated from earlier requests are handled before the error trap is
removed.</para>
<para>This is most useful for X11. On windowing systems where requests are
handled synchronously, this function will do nothing.</para>
<refsect3 id="gdk-display-sync.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-display-flush" role="function">
<title>gdk_display_flush&#160;()</title>
<indexterm zone="gdk-display-flush"><primary>gdk_display_flush</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_display_flush (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Flushes any requests queued for the windowing system; this happens automatically
when the main loop blocks waiting for new events, but if your application
is drawing without returning control to the main loop, you may need
to call this function explicitly. A common case where this function
needs to be called is when an application is executing drawing commands
from a thread other than the thread where the main loop is running.</para>
<para>This is most useful for X11. On windowing systems where requests are
handled synchronously, this function will do nothing.</para>
<refsect3 id="gdk-display-flush.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-display-close" role="function">
<title>gdk_display_close&#160;()</title>
<indexterm zone="gdk-display-close"><primary>gdk_display_close</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_display_close (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Closes the connection to the windowing system for the given display,
and cleans up associated resources.</para>
<refsect3 id="gdk-display-close.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-display-is-closed" role="function">
<title>gdk_display_is_closed&#160;()</title>
<indexterm zone="gdk-display-is-closed"><primary>gdk_display_is_closed</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_is_closed (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Finds out if the display has been closed.</para>
<refsect3 id="gdk-display-is-closed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-is-closed.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the display is closed.</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-event" role="function">
<title>gdk_display_get_event&#160;()</title>
<indexterm zone="gdk-display-get-event"><primary>gdk_display_get_event</primary></indexterm>
<programlisting language="C"><link linkend="GdkEvent"><returnvalue>GdkEvent</returnvalue></link>&#160;*
gdk_display_get_event (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Gets the next <link linkend="GdkEvent"><type>GdkEvent</type></link> to be processed for <parameter>display</parameter>
, fetching events from the
windowing system if necessary.</para>
<refsect3 id="gdk-display-get-event.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-event.returns" role="returns">
<title>Returns</title>
<para>the next <link linkend="GdkEvent"><type>GdkEvent</type></link> to be processed,
or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if no events are pending. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-peek-event" role="function">
<title>gdk_display_peek_event&#160;()</title>
<indexterm zone="gdk-display-peek-event"><primary>gdk_display_peek_event</primary></indexterm>
<programlisting language="C"><link linkend="GdkEvent"><returnvalue>GdkEvent</returnvalue></link>&#160;*
gdk_display_peek_event (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Gets a copy of the first <link linkend="GdkEvent"><type>GdkEvent</type></link> in the <parameter>display</parameter>
’s event queue, without
removing the event from the queue.  (Note that this function will
not get more events from the windowing system.  It only checks the events
that have already been moved to the GDK event queue.)</para>
<refsect3 id="gdk-display-peek-event.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link> </para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-peek-event.returns" role="returns">
<title>Returns</title>
<para>the first <link linkend="GdkEvent"><type>GdkEvent</type></link> on the
event queue. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-put-event" role="function">
<title>gdk_display_put_event&#160;()</title>
<indexterm zone="gdk-display-put-event"><primary>gdk_display_put_event</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_display_put_event (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                       <parameter>const <link linkend="GdkEvent"><type>GdkEvent</type></link> *event</parameter>);</programlisting>
<para>Appends a copy of the given event onto the front of the event
queue for <parameter>display</parameter>
.</para>
<refsect3 id="gdk-display-put-event.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>event</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkEvent"><type>GdkEvent</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-display-has-pending" role="function">
<title>gdk_display_has_pending&#160;()</title>
<indexterm zone="gdk-display-has-pending"><primary>gdk_display_has_pending</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_has_pending (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns whether the display has events that are waiting
to be processed.</para>
<refsect3 id="gdk-display-has-pending.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-has-pending.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if there are events ready to be processed.</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-is-rgba" role="function">
<title>gdk_display_is_rgba&#160;()</title>
<indexterm zone="gdk-display-is-rgba"><primary>gdk_display_is_rgba</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_is_rgba (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns wether surfaces on this <parameter>display</parameter>
 are created with an
alpha channel.</para>
<para>Even if a <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> is returned, it is possible that the
surface’s alpha channel won’t be honored when displaying the
surface on the screen: in particular, for X an appropriate
windowing manager and compositing manager must be running to
provide appropriate display. Use <link linkend="gdk-display-is-composited"><function>gdk_display_is_composited()</function></link>
to check if that is the case.</para>
<para>For setting an overall opacity for a top-level surface, see
<link linkend="gdk-surface-set-opacity"><function>gdk_surface_set_opacity()</function></link>.</para>
<para>On modern displays, this value is always <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para>
<refsect3 id="gdk-display-is-rgba.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-is-rgba.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if surfaces are created with an alpha channel or
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if the display does not support this functionality.</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-is-composited" role="function">
<title>gdk_display_is_composited&#160;()</title>
<indexterm zone="gdk-display-is-composited"><primary>gdk_display_is_composited</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_is_composited (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns whether surfaces can reasonably be expected to have
their alpha channel drawn correctly on the screen. Check
<link linkend="gdk-display-is-rgba"><function>gdk_display_is_rgba()</function></link> for wether the display supports an
alpha channel.</para>
<para>On X11 this function returns whether a compositing manager is
compositing on <parameter>display</parameter>
.</para>
<para>On modern displays, this value is always <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para>
<refsect3 id="gdk-display-is-composited.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-is-composited.returns" role="returns">
<title>Returns</title>
<para> Whether surfaces with RGBA visuals can reasonably be
expected to have their alpha channels drawn correctly on the screen.</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-default-group" role="function">
<title>gdk_display_get_default_group&#160;()</title>
<indexterm zone="gdk-display-get-default-group"><primary>gdk_display_get_default_group</primary></indexterm>
<programlisting language="C"><link linkend="GdkSurface"><returnvalue>GdkSurface</returnvalue></link>&#160;*
gdk_display_get_default_group (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns the default group leader surface for all toplevel surfaces
on <parameter>display</parameter>
. This surface is implicitly created by GDK.
See <link linkend="gdk-surface-set-group"><function>gdk_surface_set_group()</function></link>.</para>
<refsect3 id="gdk-display-get-default-group.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-default-group.returns" role="returns">
<title>Returns</title>
<para>The default group leader surface
for <parameter>display</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-supports-shapes" role="function">
<title>gdk_display_supports_shapes&#160;()</title>
<indexterm zone="gdk-display-supports-shapes"><primary>gdk_display_supports_shapes</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_supports_shapes (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <link linkend="gdk-surface-shape-combine-mask"><function>gdk_surface_shape_combine_mask()</function></link> can
be used to create shaped windows on <parameter>display</parameter>
.</para>
<refsect3 id="gdk-display-supports-shapes.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-supports-shapes.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if shaped windows are supported</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-supports-input-shapes" role="function">
<title>gdk_display_supports_input_shapes&#160;()</title>
<indexterm zone="gdk-display-supports-input-shapes"><primary>gdk_display_supports_input_shapes</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_supports_input_shapes (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <link linkend="gdk-surface-input-shape-combine-mask"><function>gdk_surface_input_shape_combine_mask()</function></link> can
be used to modify the input shape of surfaces on <parameter>display</parameter>
.</para>
<refsect3 id="gdk-display-supports-input-shapes.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-supports-input-shapes.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if surfaces with modified input shape are supported</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-app-launch-context" role="function">
<title>gdk_display_get_app_launch_context&#160;()</title>
<indexterm zone="gdk-display-get-app-launch-context"><primary>gdk_display_get_app_launch_context</primary></indexterm>
<programlisting language="C"><link linkend="GdkAppLaunchContext"><returnvalue>GdkAppLaunchContext</returnvalue></link>&#160;*
gdk_display_get_app_launch_context (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns a <link linkend="GdkAppLaunchContext"><type>GdkAppLaunchContext</type></link> suitable for launching
applications on the given display.</para>
<refsect3 id="gdk-display-get-app-launch-context.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-app-launch-context.returns" role="returns">
<title>Returns</title>
<para>a new <link linkend="GdkAppLaunchContext"><type>GdkAppLaunchContext</type></link> for <parameter>display</parameter>
.
Free with <link linkend="g-object-unref"><function>g_object_unref()</function></link> when done. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-notify-startup-complete" role="function">
<title>gdk_display_notify_startup_complete&#160;()</title>
<indexterm zone="gdk-display-notify-startup-complete"><primary>gdk_display_notify_startup_complete</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_display_notify_startup_complete (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *startup_id</parameter>);</programlisting>
<para>Indicates to the GUI environment that the application has
finished loading, using a given identifier.</para>
<para>GTK+ will call this function automatically for <link linkend="GtkWindow"><type>GtkWindow</type></link>
with custom startup-notification identifier unless
<link linkend="gtk-window-set-auto-startup-notification"><function>gtk_window_set_auto_startup_notification()</function></link> is called to
disable that feature.</para>
<refsect3 id="gdk-display-notify-startup-complete.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>startup_id</para></entry>
<entry role="parameter_description"><para>a startup-notification identifier, for which
notification process should be completed</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-default-seat" role="function">
<title>gdk_display_get_default_seat&#160;()</title>
<indexterm zone="gdk-display-get-default-seat"><primary>gdk_display_get_default_seat</primary></indexterm>
<programlisting language="C"><link linkend="GdkSeat"><returnvalue>GdkSeat</returnvalue></link>&#160;*
gdk_display_get_default_seat (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns the default <link linkend="GdkSeat"><type>GdkSeat</type></link> for this display.</para>
<refsect3 id="gdk-display-get-default-seat.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-default-seat.returns" role="returns">
<title>Returns</title>
<para>the default seat. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-list-seats" role="function">
<title>gdk_display_list_seats&#160;()</title>
<indexterm zone="gdk-display-list-seats"><primary>gdk_display_list_seats</primary></indexterm>
<programlisting language="C"><link linkend="GList"><returnvalue>GList</returnvalue></link>&#160;*
gdk_display_list_seats (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns the list of seats known to <parameter>display</parameter>
.</para>
<refsect3 id="gdk-display-list-seats.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-list-seats.returns" role="returns">
<title>Returns</title>
<para>the
list of seats known to the <link linkend="GdkDisplay"><type>GdkDisplay</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer container</acronym>][<acronym>element-type</acronym> GdkSeat]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-n-monitors" role="function">
<title>gdk_display_get_n_monitors&#160;()</title>
<indexterm zone="gdk-display-get-n-monitors"><primary>gdk_display_get_n_monitors</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gdk_display_get_n_monitors (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Gets the number of monitors that belong to <parameter>display</parameter>
.</para>
<para>The returned number is valid until the next emission of the
<link linkend="GdkDisplay-monitor-added"><type>“monitor-added”</type></link> or <link linkend="GdkDisplay-monitor-removed"><type>“monitor-removed”</type></link> signal.</para>
<refsect3 id="gdk-display-get-n-monitors.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-n-monitors.returns" role="returns">
<title>Returns</title>
<para> the number of monitors</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-monitor" role="function">
<title>gdk_display_get_monitor&#160;()</title>
<indexterm zone="gdk-display-get-monitor"><primary>gdk_display_get_monitor</primary></indexterm>
<programlisting language="C"><link linkend="GdkMonitor"><returnvalue>GdkMonitor</returnvalue></link>&#160;*
gdk_display_get_monitor (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                         <parameter><link linkend="int"><type>int</type></link> monitor_num</parameter>);</programlisting>
<para>Gets a monitor associated with this display.</para>
<refsect3 id="gdk-display-get-monitor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>monitor_num</para></entry>
<entry role="parameter_description"><para>number of the monitor</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-monitor.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="GdkMonitor"><type>GdkMonitor</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if
<parameter>monitor_num</parameter>
is not a valid monitor number. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-primary-monitor" role="function">
<title>gdk_display_get_primary_monitor&#160;()</title>
<indexterm zone="gdk-display-get-primary-monitor"><primary>gdk_display_get_primary_monitor</primary></indexterm>
<programlisting language="C"><link linkend="GdkMonitor"><returnvalue>GdkMonitor</returnvalue></link>&#160;*
gdk_display_get_primary_monitor (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Gets the primary monitor for the display.</para>
<para>The primary monitor is considered the monitor where the “main desktop”
lives. While normal application surfaces typically allow the window
manager to place the surfaces, specialized desktop applications
such as panels should place themselves on the primary monitor.</para>
<para>If no monitor is the designated primary monitor, any monitor
(usually the first) may be returned. To make sure there is a dedicated
primary monitor, use <link linkend="gdk-monitor-is-primary"><function>gdk_monitor_is_primary()</function></link> on the returned monitor.</para>
<refsect3 id="gdk-display-get-primary-monitor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-primary-monitor.returns" role="returns">
<title>Returns</title>
<para>the primary monitor, or any monitor if no
primary monitor is configured by the user. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-monitor-at-point" role="function">
<title>gdk_display_get_monitor_at_point&#160;()</title>
<indexterm zone="gdk-display-get-monitor-at-point"><primary>gdk_display_get_monitor_at_point</primary></indexterm>
<programlisting language="C"><link linkend="GdkMonitor"><returnvalue>GdkMonitor</returnvalue></link>&#160;*
gdk_display_get_monitor_at_point (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                                  <parameter><link linkend="int"><type>int</type></link> x</parameter>,
                                  <parameter><link linkend="int"><type>int</type></link> y</parameter>);</programlisting>
<para>Gets the monitor in which the point (<parameter>x</parameter>
, <parameter>y</parameter>
) is located,
or a nearby monitor if the point is not in any monitor.</para>
<refsect3 id="gdk-display-get-monitor-at-point.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x coordinate of the point</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y coordinate of the point</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-monitor-at-point.returns" role="returns">
<title>Returns</title>
<para>the monitor containing the point. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-monitor-at-surface" role="function">
<title>gdk_display_get_monitor_at_surface&#160;()</title>
<indexterm zone="gdk-display-get-monitor-at-surface"><primary>gdk_display_get_monitor_at_surface</primary></indexterm>
<programlisting language="C"><link linkend="GdkMonitor"><returnvalue>GdkMonitor</returnvalue></link>&#160;*
gdk_display_get_monitor_at_surface (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                                    <parameter><link linkend="GdkSurface"><type>GdkSurface</type></link> *surface</parameter>);</programlisting>
<para>Gets the monitor in which the largest area of <parameter>surface</parameter>

resides, or a monitor close to <parameter>surface</parameter>
 if it is outside
of all monitors.</para>
<refsect3 id="gdk-display-get-monitor-at-surface.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>surface</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkSurface"><type>GdkSurface</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-monitor-at-surface.returns" role="returns">
<title>Returns</title>
<para>the monitor with the largest overlap with <parameter>surface</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-clipboard" role="function">
<title>gdk_display_get_clipboard&#160;()</title>
<indexterm zone="gdk-display-get-clipboard"><primary>gdk_display_get_clipboard</primary></indexterm>
<programlisting language="C"><link linkend="GdkClipboard"><returnvalue>GdkClipboard</returnvalue></link>&#160;*
gdk_display_get_clipboard (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Gets the clipboard used for copy/paste operations.</para>
<refsect3 id="gdk-display-get-clipboard.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-clipboard.returns" role="returns">
<title>Returns</title>
<para>the display's clipboard. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-primary-clipboard" role="function">
<title>gdk_display_get_primary_clipboard&#160;()</title>
<indexterm zone="gdk-display-get-primary-clipboard"><primary>gdk_display_get_primary_clipboard</primary></indexterm>
<programlisting language="C"><link linkend="GdkClipboard"><returnvalue>GdkClipboard</returnvalue></link>&#160;*
gdk_display_get_primary_clipboard (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Gets the clipboard used for the primary selection. On backends where the
primary clipboard is not supported natively, GDK emulates this clipboard
locally.</para>
<refsect3 id="gdk-display-get-primary-clipboard.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-primary-clipboard.returns" role="returns">
<title>Returns</title>
<para>the primary clipboard. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-setting" role="function">
<title>gdk_display_get_setting&#160;()</title>
<indexterm zone="gdk-display-get-setting"><primary>gdk_display_get_setting</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_get_setting (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                         <parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Retrieves a desktop-wide setting such as double-click time
for the <parameter>display</parameter>
.</para>
<refsect3 id="gdk-display-get-setting.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the setting</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>location to store the value of the setting</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-setting.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the setting existed and a value was stored
in <parameter>value</parameter>
, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-get-keymap" role="function">
<title>gdk_display_get_keymap&#160;()</title>
<indexterm zone="gdk-display-get-keymap"><primary>gdk_display_get_keymap</primary></indexterm>
<programlisting language="C"><link linkend="GdkKeymap"><returnvalue>GdkKeymap</returnvalue></link>&#160;*
gdk_display_get_keymap (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Returns the <link linkend="GdkKeymap"><type>GdkKeymap</type></link> attached to <parameter>display</parameter>
.</para>
<refsect3 id="gdk-display-get-keymap.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>the <link linkend="GdkDisplay"><type>GdkDisplay</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-get-keymap.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="GdkKeymap"><type>GdkKeymap</type></link> attached to <parameter>display</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GdkDisplay.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GdkDisplay-struct" role="struct">
<title>GdkDisplay</title>
<indexterm zone="GdkDisplay-struct"><primary>GdkDisplay</primary></indexterm>
<programlisting language="C">typedef struct _GdkDisplay GdkDisplay;</programlisting>
<para>The GdkDisplay struct contains only private fields and should not
be accessed directly.</para>
</refsect2>

</refsect1>
<refsect1 id="GdkDisplay.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GdkDisplay--composited" role="property"><title>The <literal>“composited”</literal> property</title>
<indexterm zone="GdkDisplay--composited"><primary>GdkDisplay:composited</primary></indexterm>
<programlisting>  “composited”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the display properly composits the alpha channel.
See <link linkend="gdk-display-is-composited"><function>gdk_display_is_composited()</function></link> for details.</para>
<para>Flags: Read</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GdkDisplay--rgba" role="property"><title>The <literal>“rgba”</literal> property</title>
<indexterm zone="GdkDisplay--rgba"><primary>GdkDisplay:rgba</primary></indexterm>
<programlisting>  “rgba”                     <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the display supports an alpha channel. See <link linkend="gdk-display-is-rgba"><function>gdk_display_is_rgba()</function></link>
for details.</para>
<para>Flags: Read</para>
<para>Default value: TRUE</para>
</refsect2>

</refsect1>
<refsect1 id="GdkDisplay.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GdkDisplay-closed" role="signal"><title>The <literal>“closed”</literal> signal</title>
<indexterm zone="GdkDisplay-closed"><primary>GdkDisplay::closed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display,
               <link linkend="gboolean"><type>gboolean</type></link>    is_error,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>The ::closed signal is emitted when the connection to the windowing
system for <parameter>display</parameter>
 is closed.</para>
<refsect3 id="GdkDisplay-closed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>is_error</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the display was closed due to an error</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GdkDisplay-monitor-added" role="signal"><title>The <literal>“monitor-added”</literal> signal</title>
<indexterm zone="GdkDisplay-monitor-added"><primary>GdkDisplay::monitor-added</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display,
               <link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>The ::monitor-added signal is emitted whenever a monitor is
added.</para>
<refsect3 id="GdkDisplay-monitor-added.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>the objedct on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>the monitor that was just added</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GdkDisplay-monitor-removed" role="signal"><title>The <literal>“monitor-removed”</literal> signal</title>
<indexterm zone="GdkDisplay-monitor-removed"><primary>GdkDisplay::monitor-removed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display,
               <link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>The ::monitor-removed signal is emitted whenever a monitor is
removed.</para>
<refsect3 id="GdkDisplay-monitor-removed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>the monitor that was just removed</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GdkDisplay-opened" role="signal"><title>The <literal>“opened”</literal> signal</title>
<indexterm zone="GdkDisplay-opened"><primary>GdkDisplay::opened</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>The ::opened signal is emitted when the connection to the windowing
system for <parameter>display</parameter>
 is opened.</para>
<refsect3 id="GdkDisplay-opened.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GdkDisplay-seat-added" role="signal"><title>The <literal>“seat-added”</literal> signal</title>
<indexterm zone="GdkDisplay-seat-added"><primary>GdkDisplay::seat-added</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display,
               <link linkend="GdkSeat"><type>GdkSeat</type></link>    *seat,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>The ::seat-added signal is emitted whenever a new seat is made
known to the windowing system.</para>
<refsect3 id="GdkDisplay-seat-added.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>seat</para></entry>
<entry role="parameter_description"><para>the seat that was just added</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GdkDisplay-seat-removed" role="signal"><title>The <literal>“seat-removed”</literal> signal</title>
<indexterm zone="GdkDisplay-seat-removed"><primary>GdkDisplay::seat-removed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display,
               <link linkend="GdkSeat"><type>GdkSeat</type></link>    *seat,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>The ::seat-removed signal is emitted whenever a seat is removed
by the windowing system.</para>
<refsect3 id="GdkDisplay-seat-removed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>seat</para></entry>
<entry role="parameter_description"><para>the seat that was just removed</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GdkDisplay-setting-changed" role="signal"><title>The <literal>“setting-changed”</literal> signal</title>
<indexterm zone="GdkDisplay-setting-changed"><primary>GdkDisplay::setting-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display,
               <link linkend="gchar"><type>gchar</type></link>      *setting,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>The ::setting-changed signal is emitted whenever a setting
changes its value.</para>
<refsect3 id="GdkDisplay-setting-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>display</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>setting</para></entry>
<entry role="parameter_description"><para>the name of the setting that changed</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2>
</refsect1>

</refentry>
