← Back to branch summary

~ubuntu-branches/ubuntu/precise/glib2.0/precise-updates

« back to all changes in this revision

Viewing changes to docs/reference/gio/html/GApplication.html

  • Committer: Package Import Robot
  • Author(s): Sebastien Bacher, Martin Pitt
  • Date: 2012-01-03 18:16:47 UTC
  • mfrom: (1.59.34)
  • Revision ID: package-import@ubuntu.com-20120103181647-7jsgxz37px0igbna
Tags: 2.31.6-0ubuntu1
* New upstream version
* debian/patches/disable-test-gdbus-hanging.patch:
  - dropped the tests have been fixed in the new version
* debian/libglib2.0-0.postrm.in:
  - restore change dropped by error, don't clean the gsettings mmap on 
    upgrades to avoid having a time where no schemas seems installed which
    leads to applications erroring out
* debian/libglib2.0-0.symbols: 
  - new version update

[ Martin Pitt ]
* debian/control.in: Re-add our Vcs-Bzr:.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gio/html/GApplication.html
69
69
 
70
70
<span class="returnvalue">void</span>                <a class="link" href="GApplication.html#g-application-set-action-group" title="g_application_set_action_group ()">g_application_set_action_group</a>      (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>,
71
71
                                                         <em class="parameter"><code><a class="link" href="GActionGroup.html" title="GActionGroup"><span class="type">GActionGroup</span></a> *action_group</code></em>);
72
 
<span class="returnvalue">void</span>                <a class="link" href="GApplication.html#g-application-set-app-menu" title="g_application_set_app_menu ()">g_application_set_app_menu</a>          (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>,
73
 
                                                         <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *app_menu</code></em>);
74
 
<a class="link" href="GMenuModel.html" title="GMenuModel"><span class="returnvalue">GMenuModel</span></a> *        <a class="link" href="GApplication.html#g-application-get-app-menu" title="g_application_get_app_menu ()">g_application_get_app_menu</a>          (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>);
75
 
<span class="returnvalue">void</span>                <a class="link" href="GApplication.html#g-application-set-menubar" title="g_application_set_menubar ()">g_application_set_menubar</a>           (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>,
76
 
                                                         <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *menubar</code></em>);
77
 
<a class="link" href="GMenuModel.html" title="GMenuModel"><span class="returnvalue">GMenuModel</span></a> *        <a class="link" href="GApplication.html#g-application-get-menubar" title="g_application_get_menubar ()">g_application_get_menubar</a>           (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>);
78
72
 
79
73
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GApplication.html#g-application-get-is-registered" title="g_application_get_is_registered ()">g_application_get_is_registered</a>     (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>);
80
74
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GApplication.html#g-application-get-is-remote" title="g_application_get_is_remote ()">g_application_get_is_remote</a>         (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>);
191
185
<a class="link" href="GActionGroup.html#g-action-group-activate-action" title="g_action_group_activate_action ()"><code class="function">g_action_group_activate_action()</code></a> on the application, it is always
192
186
invoked in the primary instance. The actions are also exported on
193
187
the session bus, and GIO provides the <a class="link" href="GDBusActionGroup.html" title="GDBusActionGroup"><span class="type">GDBusActionGroup</span></a> wrapper to
194
 
conveniently access them remotely. Additionally, <a class="link" href="GApplication.html#g-application-set-app-menu" title="g_application_set_app_menu ()"><code class="function">g_application_set_app_menu()</code></a>
195
 
and <a class="link" href="GApplication.html#g-application-set-menubar" title="g_application_set_menubar ()"><code class="function">g_application_set_menubar()</code></a> can be used to export representation
 
188
conveniently access them remotely. Additionally, <code class="function">g_application_set_app_menu()</code>
 
189
and <code class="function">g_application_set_menubar()</code> can be used to export representation
196
190
data for the actions, in the form of <a href="GMenuModel.html"><span class="type">GMenuModels</span></a>. GIO provides
197
191
a <a class="link" href="GDBusMenuModel.html" title="GDBusMenuModel"><span class="type">GDBusMenuModel</span></a> wrapper for remote access to exported <a href="GMenuModel.html"><span class="type">GMenuModels</span></a>.
198
192
</p>
634
628
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
635
629
    <tbody>
636
630
      <tr>
637
 
        <td class="listing_lines" align="right"><pre>1
638
 
2
639
 
3
640
 
4
641
 
5
642
 
6
643
 
7
644
 
8
645
 
9
646
 
10
647
 
11
648
 
12
649
 
13
650
 
14
651
 
15
652
 
16
653
 
17
654
 
18
655
 
19
656
 
20
657
 
21
658
 
22
659
 
23
660
 
24
661
 
25
662
 
26
663
 
27
664
 
28
665
 
29
666
 
30
667
 
31
668
 
32
669
 
33
670
 
34
671
 
35
672
 
36
673
 
37
674
 
38
675
 
39
676
 
40
677
 
41
678
 
42
679
 
43
680
 
44
681
 
45
682
 
46
683
 
47
684
 
48
685
 
49
686
 
50
687
 
51
688
 
52
689
 
53
690
 
54
691
 
55
692
 
56
693
 
57
694
 
58
695
 
59
696
 
60
697
 
61
698
 
62
699
 
63
700
 
64
701
 
65
702
 
66
703
 
67
704
 
68
705
 
69
706
 
70
707
 
71
708
 
72
709
 
73
710
 
74
711
 
75
712
 
76
713
 
77
714
 
78
715
 
79
716
 
80
717
 
81
718
 
82
719
 
83
720
 
84
721
 
85
722
 
86
723
 
87</pre></td>
724
 
        <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;gio/gio.h&gt;</span>
725
 
<span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;stdlib.h&gt;</span>
726
 
<span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;string.h&gt;</span>
727
 
 
728
 
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
729
 
<span class="function">activate</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GApplication</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">application</span><span class="symbol">)</span>
730
 
<span class="cbracket">{</span>
731
 
<span class="normal">  </span><span class="function"><a href="GApplication.html#g-application-hold">g_application_hold</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">application</span><span class="symbol">);</span>
732
 
<span class="normal">  </span><span class="function"><a href="./../glib/glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"activated</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
733
 
<span class="normal">  </span><span class="function"><a href="GApplication.html#g-application-release">g_application_release</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">application</span><span class="symbol">);</span>
734
 
<span class="cbracket">}</span>
735
 
 
736
 
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
737
 
<span class="function">show_help</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GSimpleAction</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">action</span><span class="symbol">,</span>
738
 
<span class="normal">           </span><span class="usertype">GVariant</span><span class="normal">      </span><span class="symbol">*</span><span class="normal">parameter</span><span class="symbol">,</span>
739
 
<span class="normal">           </span><span class="usertype">gpointer</span><span class="normal">       data</span><span class="symbol">)</span>
740
 
<span class="cbracket">{</span>
741
 
<span class="normal">  </span><span class="function"><a href="./../glib/glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Want help, eh ?!</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
742
 
<span class="cbracket">}</span>
743
 
 
744
 
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
745
 
<span class="function">show_about</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GSimpleAction</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">action</span><span class="symbol">,</span>
746
 
<span class="normal">            </span><span class="usertype">GVariant</span><span class="normal">      </span><span class="symbol">*</span><span class="normal">parameter</span><span class="symbol">,</span>
747
 
<span class="normal">            </span><span class="usertype">gpointer</span><span class="normal">       user_data</span><span class="symbol">)</span>
748
 
<span class="cbracket">{</span>
749
 
<span class="normal">  </span><span class="function"><a href="./../glib/glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Not much to say, really.</span><span class="specialchar">\n</span><span class="string">Just a stupid example</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
750
 
<span class="cbracket">}</span>
751
 
 
752
 
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
753
 
<span class="function">quit_app</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GSimpleAction</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">action</span><span class="symbol">,</span>
754
 
<span class="normal">          </span><span class="usertype">GVariant</span><span class="normal">      </span><span class="symbol">*</span><span class="normal">parameter</span><span class="symbol">,</span>
755
 
<span class="normal">          </span><span class="usertype">gpointer</span><span class="normal">       user_data</span><span class="symbol">)</span>
756
 
<span class="cbracket">{</span>
757
 
<span class="normal">  </span><span class="function"><a href="./../glib/glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Quitting...</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
758
 
<span class="normal">  </span><span class="function"><a href="GApplication.html#g-application-release">g_application_release</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GApplication.html#g-application-get-default">g_application_get_default</a></span><span class="normal"> </span><span class="symbol">());</span>
759
 
<span class="cbracket">}</span>
760
 
 
761
 
<span class="keyword">static</span><span class="normal"> </span><span class="usertype">GActionEntry</span><span class="normal"> entries</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span>
762
 
<span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"help"</span><span class="symbol">,</span><span class="normal">  show_help</span><span class="symbol">,</span><span class="normal">  <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
763
 
<span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"about"</span><span class="symbol">,</span><span class="normal"> show_about</span><span class="symbol">,</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
764
 
<span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"quit"</span><span class="symbol">,</span><span class="normal">  quit_app</span><span class="symbol">,</span><span class="normal">   <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span>
765
 
<span class="cbracket">}</span><span class="symbol">;</span>
766
 
 
767
 
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
768
 
<span class="function">add_actions</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GApplication</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app</span><span class="symbol">)</span>
769
 
<span class="cbracket">{</span>
770
 
<span class="normal">  </span><span class="function"><a href="GActionMap.html#g-action-map-add-action-entries">g_action_map_add_action_entries</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">G_ACTION_MAP</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">),</span>
771
 
<span class="normal">                                   entries</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="./../glib/glib/glib-Standard-Macros.html#G-N-ELEMENTS:CAPS">G_N_ELEMENTS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">entries</span><span class="symbol">),</span>
772
 
<span class="normal">                                   <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
773
 
<span class="cbracket">}</span>
774
 
 
775
 
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
776
 
<span class="function">add_menu</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GApplication</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app</span><span class="symbol">)</span>
777
 
<span class="cbracket">{</span>
778
 
<span class="normal">  </span><span class="usertype">GMenu</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">menu</span><span class="symbol">;</span>
779
 
 
780
 
<span class="normal">  menu </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GMenu.html#g-menu-new">g_menu_new</a></span><span class="normal"> </span><span class="symbol">();</span>
781
 
 
782
 
<span class="normal">  </span><span class="function"><a href="GMenu.html#g-menu-append">g_menu_append</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Help"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"help"</span><span class="symbol">);</span>
783
 
<span class="normal">  </span><span class="function"><a href="GMenu.html#g-menu-append">g_menu_append</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"About Example"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"about"</span><span class="symbol">);</span>
784
 
<span class="normal">  </span><span class="function"><a href="GMenu.html#g-menu-append">g_menu_append</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Quit"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"quit"</span><span class="symbol">);</span>
785
 
 
786
 
<span class="normal">  </span><span class="function"><a href="GApplication.html#g-application-set-app-menu">g_application_set_app_menu</a></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">G_MENU_MODEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">));</span>
787
 
 
788
 
<span class="normal">  </span><span class="function"><a href="./../gobject/gobject/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">menu</span><span class="symbol">);</span>
789
 
<span class="cbracket">}</span>
790
 
 
791
 
<span class="type">int</span>
792
 
<span class="function">main</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">argv</span><span class="symbol">)</span>
793
 
<span class="cbracket">{</span>
794
 
<span class="normal">  </span><span class="usertype">GApplication</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app</span><span class="symbol">;</span>
795
 
<span class="normal">  </span><span class="type">int</span><span class="normal"> status</span><span class="symbol">;</span>
796
 
 
797
 
<span class="normal">  app </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GApplication.html#g-application-new">g_application_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"org.gtk.TestApplication"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
798
 
<span class="normal">  </span><span class="function"><a href="./../gobject/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"activate"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="./../gobject/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">activate</span><span class="symbol">),</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
799
 
 
800
 
<span class="normal">  </span><span class="function">add_actions</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">);</span>
801
 
<span class="normal">  </span><span class="function">add_menu</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">);</span>
802
 
 
803
 
<span class="normal">  </span><span class="function"><a href="GApplication.html#g-application-hold">g_application_hold</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">);</span>
804
 
 
805
 
<span class="normal">  status </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GApplication.html#g-application-run">g_application_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">,</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> argv</span><span class="symbol">);</span>
806
 
 
807
 
<span class="normal">  </span><span class="function"><a href="./../gobject/gobject/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">app</span><span class="symbol">);</span>
808
 
 
809
 
<span class="normal">  </span><span class="keyword">return</span><span class="normal"> status</span><span class="symbol">;</span>
810
 
<span class="cbracket">}</span></pre></td>
 
631
        <td class="listing_lines" align="right"><pre>1</pre></td>
 
632
        <td class="listing_code"><pre class="programlisting"><span class="normal">FIXME</span><span class="symbol">:</span><span class="normal"> MISSING XINCLUDE CONTENT</span></pre></td>
811
633
      </tr>
812
634
    </tbody>
813
635
  </table>
1264
1086
<h3 class="title">Warning</h3>
1265
1087
<p><code class="literal">g_application_set_action_group</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use the <a class="link" href="GActionMap.html" title="GActionMap"><span class="type">GActionMap</span></a> interface instead.  Never ever
1266
1088
mix use of this API with use of <a class="link" href="GActionMap.html" title="GActionMap"><span class="type">GActionMap</span></a> on the same <em class="parameter"><code>application</code></em>
1267
 
or things will go very badly wrong.</p>
 
1089
or things will go very badly wrong.  This function is known to
 
1090
introduce buggy behaviour (ie: signals not emitted on changes to the
 
1091
action group), so you should really use <a class="link" href="GActionMap.html" title="GActionMap"><span class="type">GActionMap</span></a> instead.</p>
1268
1092
</div>
1269
1093
<p>
1270
1094
This used to be how actions were associated with a <a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a>.
1289
1113
</div>
1290
1114
<hr>
1291
1115
<div class="refsect2">
1292
 
<a name="g-application-set-app-menu"></a><h3>g_application_set_app_menu ()</h3>
1293
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_application_set_app_menu          (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>,
1294
 
                                                         <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *app_menu</code></em>);</pre>
1295
 
<p>
1296
 
Sets or unsets the application menu for <em class="parameter"><code>application</code></em>.
1297
 
</p>
1298
 
<p>
1299
 
The application menu is a single menu containing items that typically
1300
 
impact the application as a whole, rather than acting on a specific
1301
 
window or document.  For example, you would expect to see
1302
 
"Preferences" or "Quit" in an application menu, but not "Save" or
1303
 
"Print".
1304
 
</p>
1305
 
<p>
1306
 
If supported, the application menu will be rendered by the desktop
1307
 
environment.
1308
 
</p>
1309
 
<div class="variablelist"><table border="0">
1310
 
<col align="left" valign="top">
1311
 
<tbody>
1312
 
<tr>
1313
 
<td><p><span class="term"><em class="parameter"><code>application</code></em> :</span></p></td>
1314
 
<td>a <a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a>
1315
 
</td>
1316
 
</tr>
1317
 
<tr>
1318
 
<td><p><span class="term"><em class="parameter"><code>app_menu</code></em> :</span></p></td>
1319
 
<td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a>, or <a href="./../glib/glib/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>
1320
 
</td>
1321
 
</tr>
1322
 
</tbody>
1323
 
</table></div>
1324
 
<p class="since">Since 2.32</p>
1325
 
</div>
1326
 
<hr>
1327
 
<div class="refsect2">
1328
 
<a name="g-application-get-app-menu"></a><h3>g_application_get_app_menu ()</h3>
1329
 
<pre class="programlisting"><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="returnvalue">GMenuModel</span></a> *        g_application_get_app_menu          (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>);</pre>
1330
 
<p>
1331
 
Returns the menu model that has been set with
1332
 
<a class="link" href="GApplication.html#g-application-set-app-menu" title="g_application_set_app_menu ()"><code class="function">g_application_set_app_menu()</code></a>.
1333
 
</p>
1334
 
<div class="variablelist"><table border="0">
1335
 
<col align="left" valign="top">
1336
 
<tbody>
1337
 
<tr>
1338
 
<td><p><span class="term"><em class="parameter"><code>application</code></em> :</span></p></td>
1339
 
<td>a <a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a>
1340
 
</td>
1341
 
</tr>
1342
 
<tr>
1343
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1344
 
<td>the application menu of <em class="parameter"><code>application</code></em>
1345
 
</td>
1346
 
</tr>
1347
 
</tbody>
1348
 
</table></div>
1349
 
<p class="since">Since 2.32</p>
1350
 
</div>
1351
 
<hr>
1352
 
<div class="refsect2">
1353
 
<a name="g-application-set-menubar"></a><h3>g_application_set_menubar ()</h3>
1354
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_application_set_menubar           (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>,
1355
 
                                                         <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *menubar</code></em>);</pre>
1356
 
<p>
1357
 
Sets or unsets the menubar for windows of <em class="parameter"><code>application</code></em>.
1358
 
</p>
1359
 
<p>
1360
 
This is a menubar in the traditional sense.
1361
 
</p>
1362
 
<p>
1363
 
Depending on the desktop environment, this may appear at the top of
1364
 
each window, or at the top of the screen.  In some environments, if
1365
 
both the application menu and the menubar are set, the application
1366
 
menu will be presented as if it were the first item of the menubar.
1367
 
Other environments treat the two as completely separate -- for
1368
 
example, the application menu may be rendered by the desktop shell
1369
 
while the menubar (if set) remains in each individual window.
1370
 
</p>
1371
 
<div class="variablelist"><table border="0">
1372
 
<col align="left" valign="top">
1373
 
<tbody>
1374
 
<tr>
1375
 
<td><p><span class="term"><em class="parameter"><code>application</code></em> :</span></p></td>
1376
 
<td>a <a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a>
1377
 
</td>
1378
 
</tr>
1379
 
<tr>
1380
 
<td><p><span class="term"><em class="parameter"><code>menubar</code></em> :</span></p></td>
1381
 
<td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a>, or <a href="./../glib/glib/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>
1382
 
</td>
1383
 
</tr>
1384
 
</tbody>
1385
 
</table></div>
1386
 
<p class="since">Since 2.32</p>
1387
 
</div>
1388
 
<hr>
1389
 
<div class="refsect2">
1390
 
<a name="g-application-get-menubar"></a><h3>g_application_get_menubar ()</h3>
1391
 
<pre class="programlisting"><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="returnvalue">GMenuModel</span></a> *        g_application_get_menubar           (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>);</pre>
1392
 
<p>
1393
 
Returns the menu model that has been set with
1394
 
<a class="link" href="GApplication.html#g-application-set-menubar" title="g_application_set_menubar ()"><code class="function">g_application_set_menubar()</code></a>.
1395
 
</p>
1396
 
<div class="variablelist"><table border="0">
1397
 
<col align="left" valign="top">
1398
 
<tbody>
1399
 
<tr>
1400
 
<td><p><span class="term"><em class="parameter"><code>application</code></em> :</span></p></td>
1401
 
<td>a <a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a>
1402
 
</td>
1403
 
</tr>
1404
 
<tr>
1405
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1406
 
<td>the menubar for windows of <em class="parameter"><code>application</code></em>
1407
 
</td>
1408
 
</tr>
1409
 
</tbody>
1410
 
</table></div>
1411
 
<p class="since">Since 2.32</p>
1412
 
</div>
1413
 
<hr>
1414
 
<div class="refsect2">
1415
1116
<a name="g-application-get-is-registered"></a><h3>g_application_get_is_registered ()</h3>
1416
1117
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_application_get_is_registered     (<em class="parameter"><code><a class="link" href="GApplication.html" title="GApplication"><span class="type">GApplication</span></a> *application</code></em>);</pre>
1417
1118
<p>