<?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_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_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="char"><returnvalue>char</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="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="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="GListModel"><returnvalue>GListModel</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-monitors">gdk_display_get_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-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">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-display-get-startup-notification-id">gdk_display_get_startup_notification_id</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-map-keyval">gdk_display_map_keyval</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-map-keycode">gdk_display_map_keycode</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-translate-key">gdk_display_translate_key</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--input-shapes">input-shapes</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="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_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-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 pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<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-at-surface"><function>gdk_display_get_monitor_at_surface()</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="char"><type>char</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="char"><returnvalue>char</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-x11-display-error-trap-pop"><function>gdk_x11_display_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-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 whether 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>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 whether 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-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-set-input-region"><function>gdk_surface_set_input_region()</function></link> can
be used to modify the input shape of surfaces 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-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="char"><type>char</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>
<para>Note that a display may not have a seat. In this case,
this function will return <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</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>][<acronym>nullable</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-monitors" role="function">
<title>gdk_display_get_monitors&#160;()</title>
<indexterm zone="gdk-display-get-monitors"><primary>gdk_display_get_monitors</primary></indexterm>
<programlisting language="C"><link linkend="GListModel"><returnvalue>GListModel</returnvalue></link>&#160;*
gdk_display_get_monitors (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *self</parameter>);</programlisting>
<para>Gets the list of monitors associated with this display.</para>
<para>Subsequent calls to this function will always return the same list for the
same display.</para>
<para>You can listen to the GListModel::items-changed signal on this list
to monitor changes to the monitor of this display.</para>
<refsect3 id="gdk-display-get-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>self</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-monitors.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GListModel"><type>GListModel</type></link> of <link linkend="GdkMonitor"><type>GdkMonitor</type></link>. </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-startup-notification-id" role="function">
<title>gdk_display_get_startup_notification_id&#160;()</title>
<indexterm zone="gdk-display-get-startup-notification-id"><primary>gdk_display_get_startup_notification_id</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gdk_display_get_startup_notification_id
                               (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>);</programlisting>
<para>Gets the startup notification ID for a Wayland display, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
if no ID has been defined.</para>
<refsect3 id="gdk-display-get-startup-notification-id.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-startup-notification-id.returns" role="returns">
<title>Returns</title>
<para> the startup notification ID for <parameter>display</parameter>
, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></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><link linkend="GdkEvent"><type>GdkEvent</type></link> *event</parameter>);</programlisting>
<para>Appends the given event onto the front of the event
queue for <parameter>display</parameter>
.</para>
<para>This function is only useful in very special situations
and should not be used by applications.</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"><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-display-map-keyval" role="function">
<title>gdk_display_map_keyval&#160;()</title>
<indexterm zone="gdk-display-map-keyval"><primary>gdk_display_map_keyval</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_map_keyval (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                        <parameter><link linkend="guint"><type>guint</type></link> keyval</parameter>,
                        <parameter><link linkend="GdkKeymapKey"><type>GdkKeymapKey</type></link> **keys</parameter>,
                        <parameter><link linkend="int"><type>int</type></link> *n_keys</parameter>);</programlisting>
<para>Obtains a list of keycode/group/level combinations that will
generate <parameter>keyval</parameter>
. Groups and levels are two kinds of keyboard mode;
in general, the level determines whether the top or bottom symbol
on a key is used, and the group determines whether the left or
right symbol is used.</para>
<para>On US keyboards, the shift key changes the keyboard level, and there
are no groups. A group switch key might convert a keyboard between
Hebrew to English modes, for example.</para>
<para><link linkend="GdkEventKey"><type>GdkEventKey</type></link> contains a <link linkend="group"><literal>group</literal></link> field that indicates the active
keyboard group. The level is computed from the modifier mask.</para>
<para>The returned array should be freed with <link linkend="g-free"><function>g_free()</function></link>.</para>
<refsect3 id="gdk-display-map-keyval.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>keyval</para></entry>
<entry role="parameter_description"><para>a keyval, such as <link linkend="GDK-KEY-a"><literal>GDK_KEY_a</literal></link>, <link linkend="GDK-KEY-Up"><literal>GDK_KEY_Up</literal></link>, <link linkend="GDK-KEY-Return"><literal>GDK_KEY_Return</literal></link>, etc.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>keys</para></entry>
<entry role="parameter_description"><para>return location
for an array of <link linkend="GdkKeymapKey"><type>GdkKeymapKey</type></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>array</acronym> length=n_keys][<acronym>transfer full</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>n_keys</para></entry>
<entry role="parameter_description"><para>return location for number of elements in returned array</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-map-keyval.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if keys were found and returned</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-map-keycode" role="function">
<title>gdk_display_map_keycode&#160;()</title>
<indexterm zone="gdk-display-map-keycode"><primary>gdk_display_map_keycode</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_map_keycode (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                         <parameter><link linkend="guint"><type>guint</type></link> keycode</parameter>,
                         <parameter><link linkend="GdkKeymapKey"><type>GdkKeymapKey</type></link> **keys</parameter>,
                         <parameter><link linkend="guint"><type>guint</type></link> **keyvals</parameter>,
                         <parameter><link linkend="int"><type>int</type></link> *n_entries</parameter>);</programlisting>
<para>Returns the keyvals bound to <parameter>keycode</parameter>
. The Nth <link linkend="GdkKeymapKey"><type>GdkKeymapKey</type></link>
in <parameter>keys</parameter>
 is bound to the Nth keyval in <parameter>keyvals</parameter>
.</para>
<para>When a keycode is pressed by the user, the keyval from
this list of entries is selected by considering the effective
keyboard group and level.</para>
<para>Free the returned arrays with <link linkend="g-free"><function>g_free()</function></link>.</para>
<refsect3 id="gdk-display-map-keycode.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>keycode</para></entry>
<entry role="parameter_description"><para>a keycode</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>keys</para></entry>
<entry role="parameter_description"><para>return
location for array of <link linkend="GdkKeymapKey"><type>GdkKeymapKey</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>array</acronym> length=n_entries][<acronym>transfer full</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>keyvals</para></entry>
<entry role="parameter_description"><para>return
location for array of keyvals, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>array</acronym> length=n_entries][<acronym>transfer full</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>n_entries</para></entry>
<entry role="parameter_description"><para>length of <parameter>keys</parameter>
and <parameter>keyvals</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-map-keycode.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if there were any entries</para>
</refsect3></refsect2>
<refsect2 id="gdk-display-translate-key" role="function">
<title>gdk_display_translate_key&#160;()</title>
<indexterm zone="gdk-display-translate-key"><primary>gdk_display_translate_key</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_display_translate_key (<parameter><link linkend="GdkDisplay"><type>GdkDisplay</type></link> *display</parameter>,
                           <parameter><link linkend="guint"><type>guint</type></link> keycode</parameter>,
                           <parameter><link linkend="GdkModifierType"><type>GdkModifierType</type></link> state</parameter>,
                           <parameter><link linkend="int"><type>int</type></link> group</parameter>,
                           <parameter><link linkend="guint"><type>guint</type></link> *keyval</parameter>,
                           <parameter><link linkend="int"><type>int</type></link> *effective_group</parameter>,
                           <parameter><link linkend="int"><type>int</type></link> *level</parameter>,
                           <parameter><link linkend="GdkModifierType"><type>GdkModifierType</type></link> *consumed</parameter>);</programlisting>
<para>Translates the contents of a <link linkend="GdkEventKey"><type>GdkEventKey</type></link> (ie <parameter>keycode</parameter>
, <parameter>state</parameter>
, and <parameter>group</parameter>
)
into a keyval, effective group, and level. Modifiers that affected the
translation and are thus unavailable for application use are returned in
<parameter>consumed_modifiers</parameter>
.</para>
<para>The <parameter>effective_group</parameter>
 is the group that was actually used for the translation;
some keys such as Enter are not affected by the active keyboard group.
The <parameter>level</parameter>
 is derived from <parameter>state</parameter>
.</para>
<para><parameter>consumed_modifiers</parameter>
 gives modifiers that should be masked outfrom <parameter>state</parameter>

when comparing this key press to a keyboard shortcut. For instance, on a US
keyboard, the <literal>plus</literal> symbol is shifted, so when comparing a key press to a
<literal>&lt;Control&gt;plus</literal> accelerator <literal>&lt;Shift&gt;</literal> should be masked out.</para>
<para>This function should rarely be needed, since <link linkend="GdkEventKey"><type>GdkEventKey</type></link> already contains
the translated keyval. It is exported for the benefit of virtualized test
environments.</para>
<refsect3 id="gdk-display-translate-key.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>keycode</para></entry>
<entry role="parameter_description"><para>a keycode</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>state</para></entry>
<entry role="parameter_description"><para>a modifier state</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group</para></entry>
<entry role="parameter_description"><para>active keyboard group</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>keyval</para></entry>
<entry role="parameter_description"><para>return location for keyval, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>effective_group</para></entry>
<entry role="parameter_description"><para>return location for effective
group, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>level</para></entry>
<entry role="parameter_description"><para>return location for level, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>consumed</para></entry>
<entry role="parameter_description"><para>return location for modifiers
that were used to determine the group or level, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-display-translate-key.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if there was a keyval bound to keycode/state/group.</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 composites the alpha channel.
See <link linkend="gdk-display-is-composited"><function>gdk_display_is_composited()</function></link> for details.</para>
<para>Owner: GdkDisplay</para>
<para>Flags: Read</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GdkDisplay--input-shapes" role="property"><title>The <literal>“input-shapes”</literal> property</title>
<indexterm zone="GdkDisplay--input-shapes"><primary>GdkDisplay:input-shapes</primary></indexterm>
<programlisting>  “input-shapes”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the display supports input shapes. See
<link linkend="gdk-display-supports-input-shapes"><function>gdk_display_supports_input_shapes()</function></link> for details.</para>
<para>Owner: GdkDisplay</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>Owner: GdkDisplay</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-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="char"><type>char</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>
