New upstream version 3.23.0

This commit is contained in:
Iain Lane
2018-07-18 14:06:19 +01:00
731 changed files with 556100 additions and 542972 deletions

View File

@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkApplicationWindow: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="Application.html" title="Application support">
<link rel="prev" href="GtkApplication.html" title="GtkApplication">
<link rel="next" href="GtkActionable.html" title="GtkActionable">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -146,7 +146,7 @@ GtkApplicationWindow implements
</div>
<div class="refsect1">
<a name="GtkApplicationWindow.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtkunixprint.h&gt;
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
@ -184,71 +184,43 @@ menu, then it will automatically be included in the menubar or in the
windows client-side decorations.</p>
<div class="refsect3">
<a name="id-1.3.4.3.9.8"></a><h4>A GtkApplicationWindow with a menubar</h4>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GtkApplication</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkApplication.html#gtk-application-new">gtk_application_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"org.gtk.test"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
<div class="informalexample"><pre class="programlisting">
GtkApplication *app = gtk_application_new ("org.gtk.test", 0);
<span class="usertype">GtkBuilder</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">builder </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkBuilder.html#gtk-builder-new-from-string">gtk_builder_new_from_string</a></span><span class="normal"> </span><span class="symbol">(</span>
<span class="normal"> </span><span class="string">"&lt;interface&gt;"</span>
<span class="normal"> </span><span class="string">" &lt;menu id='menubar'&gt;"</span>
<span class="normal"> </span><span class="string">" &lt;submenu label='_Edit'&gt;"</span>
<span class="normal"> </span><span class="string">" &lt;item label='_Copy' action='win.copy'/&gt;"</span>
<span class="normal"> </span><span class="string">" &lt;item label='_Paste' action='win.paste'/&gt;"</span>
<span class="normal"> </span><span class="string">" &lt;/submenu&gt;"</span>
<span class="normal"> </span><span class="string">" &lt;/menu&gt;"</span>
<span class="normal"> </span><span class="string">"&lt;/interface&gt;"</span><span class="symbol">,</span>
<span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">);</span>
GtkBuilder *builder = gtk_builder_new_from_string (
"&lt;interface&gt;"
" &lt;menu id='menubar'&gt;"
" &lt;submenu label='_Edit'&gt;"
" &lt;item label='_Copy' action='win.copy'/&gt;"
" &lt;item label='_Paste' action='win.paste'/&gt;"
" &lt;/submenu&gt;"
" &lt;/menu&gt;"
"&lt;/interface&gt;",
-1);
<span class="usertype">GMenuModel</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">menubar </span><span class="symbol">=</span><span class="normal"> </span><span class="function">G_MENU_MODEL</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkBuilder.html#gtk-builder-get-object">gtk_builder_get_object</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span>
<span class="normal"> </span><span class="string">"menubar"</span><span class="symbol">));</span>
<span class="function"><a href="GtkApplication.html#gtk-application-set-menubar">gtk_application_set_menubar</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_APPLICATION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">),</span><span class="normal"> menubar</span><span class="symbol">);</span>
<span class="function">g_object_unref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">);</span>
GMenuModel *menubar = G_MENU_MODEL (gtk_builder_get_object (builder,
"menubar"));
gtk_application_set_menubar (GTK_APPLICATION (app), menubar);
g_object_unref (builder);
<span class="comment">// ...</span>
<span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">window </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkApplicationWindow.html#gtk-application-window-new">gtk_application_window_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
// ...
GtkWidget *window = gtk_application_window_new (app);
</pre></div>
<p></p>
</div>
<div class="refsect3">
<a name="id-1.3.4.3.9.9"></a><h4>Handling fallback yourself</h4>
<p><a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/sunny.c" target="_top">A simple example</a></p>
<p>The XML format understood by <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> for <span class="type">GMenuModel</span> consists
of a toplevel <code class="literal">&amp;lt;menu&gt;</code> element, which contains one or more <code class="literal">&amp;lt;item&gt;</code>
elements. Each <code class="literal">&amp;lt;item&gt;</code> element contains <code class="literal">&amp;lt;attribute&gt;</code> and <code class="literal">&amp;lt;link&gt;</code>
elements with a mandatory name attribute. <code class="literal">&amp;lt;link&gt;</code> elements have the
same content model as <code class="literal">&amp;lt;menu&gt;</code>. Instead of <code class="literal">&amp;lt;link name="submenu&gt;</code> or
<code class="literal">&amp;lt;link name="section"&gt;</code>, you can use <code class="literal">&amp;lt;submenu&gt;</code> or <code class="literal">&amp;lt;section&gt;</code>
of a toplevel <code class="literal">&lt;menu&gt;</code> element, which contains one or more <code class="literal">&lt;item&gt;</code>
elements. Each <code class="literal">&lt;item&gt;</code> element contains <code class="literal">&lt;attribute&gt;</code> and <code class="literal">&lt;link&gt;</code>
elements with a mandatory name attribute. <code class="literal">&lt;link&gt;</code> elements have the
same content model as <code class="literal">&lt;menu&gt;</code>. Instead of <code class="literal">&lt;link name="submenu&gt;</code> or
<code class="literal">&lt;link name="section"&gt;</code>, you can use <code class="literal">&lt;submenu&gt;</code> or <code class="literal">&lt;section&gt;</code>
elements.</p>
<p>Attribute values can be translated using gettext, like other <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a>
content. <code class="literal">&amp;lt;attribute&gt;</code> elements can be marked for translation with a
content. <code class="literal">&lt;attribute&gt;</code> elements can be marked for translation with a
<code class="literal">translatable="yes"</code> attribute. It is also possible to specify message
context and translator comments, using the context and comments attributes.
To make use of this, the <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> must have been given the gettext
@ -430,7 +402,7 @@ it.</p>
</tr>
<tr>
<td class="parameter_name"><p>help_overlay</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkShortcutsWindow.html" title="GtkShortcutsWindow"><span class="type">GtkShortcutsWindow</span></a>. </p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkShortcutsWindow.html" title="GtkShortcutsWindow"><span class="type">GtkShortcutsWindow</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
@ -463,7 +435,7 @@ a prior call to <a class="link" href="GtkApplicationWindow.html#gtk-application-
</div>
<div class="refsect3">
<a name="gtk-application-window-get-help-overlay.returns"></a><h4>Returns</h4>
<p>the help overlay associated with <em class="parameter"><code>window</code></em>
<p> the help overlay associated with <em class="parameter"><code>window</code></em>
, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
@ -513,6 +485,6 @@ of whether the desktop shell is showing the menus or not.</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.27</div>
<hr>Generated by GTK-Doc V1.25</div>
</body>
</html>