docs/reference/gdk/html/gdk3-Application-launching.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Application launching</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GDK 3 Reference Manual">
   8 <link rel="up" href="reference.html" title="API Reference">
   9 <link rel="prev" href="gdk3-X-Window-System-Interaction.html" title="X Window System Interaction">
  10 <link rel="next" href="api-index-full.html" title="Index of all symbols">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="gdk3-X-Window-System-Interaction.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GDK 3 Reference Manual</th>
  21 <td><a accesskey="n" href="api-index-full.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#gdk3-Application-launching.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gdk3-Application-launching.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#gdk3-Application-launching.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#gdk3-Application-launching.properties" class="shortcut">Properties</a>
  31 </td></tr>
  32 </table>
  33 <div class="refentry">
  34 <a name="gdk3-Application-launching"></a><div class="titlepage"></div>
  35 <div class="refnamediv"><table width="100%"><tr>
  36 <td valign="top">
  37 <h2><span class="refentrytitle"><a name="gdk3-Application-launching.top_of_page"></a>Application launching</span></h2>
  38 <p>Application launching — Startup notification for applications</p>
  39 </td>
  40 <td valign="top" align="right"></td>
  41 </tr></table></div>
  42 <div class="refsynopsisdiv">
  43 <a name="gdk3-Application-launching.synopsis"></a><h2>Synopsis</h2>
  44 <a name="GdkAppLaunchContext"></a><pre class="synopsis">
  45 #include &lt;gdk/gdk.h&gt;
  46
  47                     <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext-struct" title="GdkAppLaunchContext">GdkAppLaunchContext</a>;
  48 <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="returnvalue">GdkAppLaunchContext</span></a> * <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-new" title="gdk_app_launch_context_new ()">gdk_app_launch_context_new</a>        (<em class="parameter"><code><span class="type">void</span></code></em>);
  49 <span class="returnvalue">void</span>                <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-display" title="gdk_app_launch_context_set_display ()">gdk_app_launch_context_set_display</a>  (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
  50                                                          <em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);
  51 <span class="returnvalue">void</span>                <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-screen" title="gdk_app_launch_context_set_screen ()">gdk_app_launch_context_set_screen</a>   (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
  52                                                          <em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
  53 <span class="returnvalue">void</span>                <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-desktop" title="gdk_app_launch_context_set_desktop ()">gdk_app_launch_context_set_desktop</a>  (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
  54                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> desktop</code></em>);
  55 <span class="returnvalue">void</span>                <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-timestamp" title="gdk_app_launch_context_set_timestamp ()">gdk_app_launch_context_set_timestamp</a>
  56                                                         (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
  57                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);
  58 <span class="returnvalue">void</span>                <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-icon" title="gdk_app_launch_context_set_icon ()">gdk_app_launch_context_set_icon</a>     (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
  59                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *icon</code></em>);
  60 <span class="returnvalue">void</span>                <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-icon-name" title="gdk_app_launch_context_set_icon_name ()">gdk_app_launch_context_set_icon_name</a>
  61                                                         (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
  62                                                          <em class="parameter"><code>const <span class="type">char</span> *icon_name</code></em>);
  63 </pre>
  64 </div>
  65 <div class="refsect1">
  66 <a name="gdk3-Application-launching.object-hierarchy"></a><h2>Object Hierarchy</h2>
  67 <pre class="synopsis">
  68   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  69    +----<a href="http://library.gnome.org/devel/gio/unstable/GAppInfo.html#GAppLaunchContext">GAppLaunchContext</a>
  70          +----GdkAppLaunchContext
  71 </pre>
  72 </div>
  73 <div class="refsect1">
  74 <a name="gdk3-Application-launching.properties"></a><h2>Properties</h2>
  75 <pre class="synopsis">
  76   "<a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext--display" title='The "display" property'>display</a>"                  <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>*           : Read / Write / Construct Only
  77 </pre>
  78 </div>
  79 <div class="refsect1">
  80 <a name="gdk3-Application-launching.description"></a><h2>Description</h2>
  81 <p>
  82 GdkAppLaunchContext is an implementation of <a href="http://library.gnome.org/devel/gio/unstable/GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a> that
  83 handles launching an application in a graphical context. It provides
  84 startup notification and allows to launch applications on a specific
  85 screen or workspace.
  86 </p>
  87 <div class="example">
  88 <a name="id608509"></a><p class="title"><b>Example 6. Launching an application</b></p>
  89 <div class="example-contents"><div class="informalexample">
  90   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
  91     <tbody>
  92       <tr>
  93         <td class="listing_lines" align="right"><pre>1
  94 2
  95 3
  96 4
  97 5
  98 6
  99 7
 100 8
 101 9
 102 10
 103 11</pre></td>
 104         <td class="listing_code"><pre class="programlisting"><span class="usertype">GdkAppLaunchContext</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">context</span><span class="symbol">;</span>
 105
 106 <span class="normal">context </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GdkDisplay.html#gdk-display-get-app-launch-context">gdk_display_get_app_launch_context</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">display</span><span class="symbol">);</span>
 107
 108 <span class="function"><a href="gdk3-Application-launching.html#gdk-app-launch-context-set-screen">gdk_app_launch_context_set_screen</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">screen</span><span class="symbol">);</span>
 109 <span class="function"><a href="gdk3-Application-launching.html#gdk-app-launch-context-set-timestamp">gdk_app_launch_context_set_timestamp</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">time</span><span class="symbol">);</span>
 110
 111 <span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="http://library.gnome.org/devel/gio/unstable/GAppInfo.html#g-app-info-launch-default-for-uri">g_app_info_launch_default_for_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"http://www.gtk.org"</span><span class="symbol">,</span><span class="normal"> context</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">))</span>
 112 <span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-warning">g_warning</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Launching failed: %s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
 113
 114 <span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">);</span></pre></td>
 115       </tr>
 116     </tbody>
 117   </table>
 118 </div>
 119 </div>
 120 </div>
 121 <p><br class="example-break">
 122 </p>
 123 </div>
 124 <div class="refsect1">
 125 <a name="gdk3-Application-launching.details"></a><h2>Details</h2>
 126 <div class="refsect2">
 127 <a name="GdkAppLaunchContext-struct"></a><h3>GdkAppLaunchContext</h3>
 128 <pre class="programlisting">typedef struct _GdkAppLaunchContext GdkAppLaunchContext;</pre>
 129 </div>
 130 <hr>
 131 <div class="refsect2">
 132 <a name="gdk-app-launch-context-new"></a><h3>gdk_app_launch_context_new ()</h3>
 133 <pre class="programlisting"><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="returnvalue">GdkAppLaunchContext</span></a> * gdk_app_launch_context_new        (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 134 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 135 <h3 class="title">Warning</h3>
 136 <p><code class="literal">gdk_app_launch_context_new</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GdkDisplay.html#gdk-display-get-app-launch-context" title="gdk_display_get_app_launch_context ()"><code class="function">gdk_display_get_app_launch_context()</code></a> instead</p>
 137 </div>
 138 <p>
 139 Creates a new <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a>.
 140 </p>
 141 <div class="variablelist"><table border="0">
 142 <col align="left" valign="top">
 143 <tbody><tr>
 144 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 145 <td>a new <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a>
 146 </td>
 147 </tr></tbody>
 148 </table></div>
 149 <p class="since">Since 2.14</p>
 150 </div>
 151 <hr>
 152 <div class="refsect2">
 153 <a name="gdk-app-launch-context-set-display"></a><h3>gdk_app_launch_context_set_display ()</h3>
 154 <pre class="programlisting"><span class="returnvalue">void</span>                gdk_app_launch_context_set_display  (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
 155                                                          <em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
 156 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 157 <h3 class="title">Warning</h3>
 158 <p><code class="literal">gdk_app_launch_context_set_display</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GdkDisplay.html#gdk-display-get-app-launch-context" title="gdk_display_get_app_launch_context ()"><code class="function">gdk_display_get_app_launch_context()</code></a> instead</p>
 159 </div>
 160 <p>
 161 Sets the display on which applications will be launched when
 162 using this context. See also <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-screen" title="gdk_app_launch_context_set_screen ()"><code class="function">gdk_app_launch_context_set_screen()</code></a>.
 163 </p>
 164 <div class="variablelist"><table border="0">
 165 <col align="left" valign="top">
 166 <tbody>
 167 <tr>
 168 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 169 <td>a <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a>
 170 </td>
 171 </tr>
 172 <tr>
 173 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 174 <td>a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
 175 </td>
 176 </tr>
 177 </tbody>
 178 </table></div>
 179 <p class="since">Since 2.14</p>
 180 </div>
 181 <hr>
 182 <div class="refsect2">
 183 <a name="gdk-app-launch-context-set-screen"></a><h3>gdk_app_launch_context_set_screen ()</h3>
 184 <pre class="programlisting"><span class="returnvalue">void</span>                gdk_app_launch_context_set_screen   (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
 185                                                          <em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 186 <p>
 187 Sets the screen on which applications will be launched when
 188 using this context. See also <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-display" title="gdk_app_launch_context_set_display ()"><code class="function">gdk_app_launch_context_set_display()</code></a>.
 189 </p>
 190 <p>
 191 If both <em class="parameter"><code>screen</code></em> and <em class="parameter"><code>display</code></em> are set, the <em class="parameter"><code>screen</code></em> takes priority.
 192 If neither <em class="parameter"><code>screen</code></em> or <em class="parameter"><code>display</code></em> are set, the default screen and
 193 display are used.
 194 </p>
 195 <div class="variablelist"><table border="0">
 196 <col align="left" valign="top">
 197 <tbody>
 198 <tr>
 199 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 200 <td>a <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a>
 201 </td>
 202 </tr>
 203 <tr>
 204 <td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 205 <td>a <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a>
 206 </td>
 207 </tr>
 208 </tbody>
 209 </table></div>
 210 <p class="since">Since 2.14</p>
 211 </div>
 212 <hr>
 213 <div class="refsect2">
 214 <a name="gdk-app-launch-context-set-desktop"></a><h3>gdk_app_launch_context_set_desktop ()</h3>
 215 <pre class="programlisting"><span class="returnvalue">void</span>                gdk_app_launch_context_set_desktop  (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
 216                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> desktop</code></em>);</pre>
 217 <p>
 218 Sets the workspace on which applications will be launched when
 219 using this context when running under a window manager that
 220 supports multiple workspaces, as described in the
 221 <a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended
 222 Window Manager Hints</a>.
 223 </p>
 224 <p>
 225 When the workspace is not specified or <em class="parameter"><code>desktop</code></em> is set to -1,
 226 it is up to the window manager to pick one, typically it will
 227 be the current workspace.
 228 </p>
 229 <div class="variablelist"><table border="0">
 230 <col align="left" valign="top">
 231 <tbody>
 232 <tr>
 233 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 234 <td>a <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a>
 235 </td>
 236 </tr>
 237 <tr>
 238 <td><p><span class="term"><em class="parameter"><code>desktop</code></em> :</span></p></td>
 239 <td>the number of a workspace, or -1</td>
 240 </tr>
 241 </tbody>
 242 </table></div>
 243 <p class="since">Since 2.14</p>
 244 </div>
 245 <hr>
 246 <div class="refsect2">
 247 <a name="gdk-app-launch-context-set-timestamp"></a><h3>gdk_app_launch_context_set_timestamp ()</h3>
 248 <pre class="programlisting"><span class="returnvalue">void</span>                gdk_app_launch_context_set_timestamp
 249                                                         (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
 250                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);</pre>
 251 <p>
 252 Sets the timestamp of <em class="parameter"><code>context</code></em>. The timestamp should ideally
 253 be taken from the event that triggered the launch.
 254 </p>
 255 <p>
 256 Window managers can use this information to avoid moving the
 257 focus to the newly launched application when the user is busy
 258 typing in another window. This is also known as 'focus stealing
 259 prevention'.
 260 </p>
 261 <div class="variablelist"><table border="0">
 262 <col align="left" valign="top">
 263 <tbody>
 264 <tr>
 265 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 266 <td>a <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a>
 267 </td>
 268 </tr>
 269 <tr>
 270 <td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td>
 271 <td>a timestamp</td>
 272 </tr>
 273 </tbody>
 274 </table></div>
 275 <p class="since">Since 2.14</p>
 276 </div>
 277 <hr>
 278 <div class="refsect2">
 279 <a name="gdk-app-launch-context-set-icon"></a><h3>gdk_app_launch_context_set_icon ()</h3>
 280 <pre class="programlisting"><span class="returnvalue">void</span>                gdk_app_launch_context_set_icon     (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
 281                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *icon</code></em>);</pre>
 282 <p>
 283 Sets the icon for applications that are launched with this
 284 context.
 285 </p>
 286 <p>
 287 Window Managers can use this information when displaying startup
 288 notification.
 289 </p>
 290 <p>
 291 See also <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-icon-name" title="gdk_app_launch_context_set_icon_name ()"><code class="function">gdk_app_launch_context_set_icon_name()</code></a>.
 292 </p>
 293 <div class="variablelist"><table border="0">
 294 <col align="left" valign="top">
 295 <tbody>
 296 <tr>
 297 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 298 <td>a <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a>
 299 </td>
 300 </tr>
 301 <tr>
 302 <td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
 303 <td>a <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 304 </td>
 305 </tr>
 306 </tbody>
 307 </table></div>
 308 <p class="since">Since 2.14</p>
 309 </div>
 310 <hr>
 311 <div class="refsect2">
 312 <a name="gdk-app-launch-context-set-icon-name"></a><h3>gdk_app_launch_context_set_icon_name ()</h3>
 313 <pre class="programlisting"><span class="returnvalue">void</span>                gdk_app_launch_context_set_icon_name
 314                                                         (<em class="parameter"><code><a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a> *context</code></em>,
 315                                                          <em class="parameter"><code>const <span class="type">char</span> *icon_name</code></em>);</pre>
 316 <p>
 317 Sets the icon for applications that are launched with this context.
 318 The <em class="parameter"><code>icon_name</code></em> will be interpreted in the same way as the Icon field
 319 in desktop files. See also <a class="link" href="gdk3-Application-launching.html#gdk-app-launch-context-set-icon" title="gdk_app_launch_context_set_icon ()"><code class="function">gdk_app_launch_context_set_icon()</code></a>.
 320 </p>
 321 <p>
 322 If both <em class="parameter"><code>icon</code></em> and <em class="parameter"><code>icon_name</code></em> are set, the <em class="parameter"><code>icon_name</code></em> takes priority.
 323 If neither <em class="parameter"><code>icon</code></em> or <em class="parameter"><code>icon_name</code></em> is set, the icon is taken from either
 324 the file that is passed to launched application or from the <a href="http://library.gnome.org/devel/gio/unstable/GAppInfo.html"><span class="type">GAppInfo</span></a>
 325 for the launched application itself.
 326 </p>
 327 <div class="variablelist"><table border="0">
 328 <col align="left" valign="top">
 329 <tbody>
 330 <tr>
 331 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 332 <td>a <a class="link" href="gdk3-Application-launching.html#GdkAppLaunchContext"><span class="type">GdkAppLaunchContext</span></a>
 333 </td>
 334 </tr>
 335 <tr>
 336 <td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td>
 337 <td>an icon name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 338 </td>
 339 </tr>
 340 </tbody>
 341 </table></div>
 342 <p class="since">Since 2.14</p>
 343 </div>
 344 </div>
 345 <div class="refsect1">
 346 <a name="gdk3-Application-launching.property-details"></a><h2>Property Details</h2>
 347 <div class="refsect2">
 348 <a name="GdkAppLaunchContext--display"></a><h3>The <code class="literal">"display"</code> property</h3>
 349 <pre class="programlisting">  "display"                  <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>*           : Read / Write / Construct Only</pre>
 350 <p>Display.</p>
 351 </div>
 352 </div>
 353 </div>
 354 <div class="footer">
 355 <hr>
 356           Generated by GTK-Doc V1.18</div>
 357 </body>
 358 </html>