[gtk+] Getting started: Add information about activate and open
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+] Getting started: Add information about activate and open
- Date: Wed, 24 Jul 2013 11:31:48 +0000 (UTC)
commit 84244d56fc42a2cd6541819334b4ef7c7aa4fb1f
Author: Matthias Clasen <mclasen redhat com>
Date: Wed Jul 24 00:44:34 2013 -0400
Getting started: Add information about activate and open
The difference between the various GApplication entry points
is a little mysterious to many people, so talk a bit about
this here.
docs/reference/gtk/getting_started.xml | 12 +++++++++++-
1 files changed, 11 insertions(+), 1 deletions(-)
---
diff --git a/docs/reference/gtk/getting_started.xml b/docs/reference/gtk/getting_started.xml
index 9baa5b4..89ef881 100644
--- a/docs/reference/gtk/getting_started.xml
+++ b/docs/reference/gtk/getting_started.xml
@@ -321,6 +321,14 @@
activated without arguments, and open the files it is given, if it
is started with arguments.</para>
+ <para>To handle these two cases, we override the activate() vfunc,
+ which gets called when the application is launched without commandline
+ arguments, and the open() vfunc, which gets called when the application
+ is launched with commandline arguments.</para>
+
+ <para>To learn more about GApplication entry points, consult the
+ GIO <ulink
url="https://developer.gnome.org/gio/2.36/GApplication.html#GApplication.description">documentation</ulink>.
+
<informalexample>
<programlisting><xi:include href="../../../../examples/application1/exampleapp.c"
parse="text"><xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting>
</informalexample>
@@ -505,6 +513,8 @@ example_app_window_open (ExampleAppWindow *win,
gtk_widget_set_hexpand (scrolled, TRUE);
gtk_widget_set_vexpand (scrolled, TRUE);
view = gtk_text_view_new ();
+ gtk_text_view_set_editable (GTK_TEXT_VIEW (view), FALSE);
+ gtk_text_view_set_cursor_visible (GTK_TEXT_VIEW (view), FALSE);
gtk_widget_show (view);
gtk_container_add (GTK_CONTAINER (scrolled), view);
gtk_stack_add_titled (GTK_STACK (priv->stack), scrolled, basename, basename);
@@ -529,7 +539,7 @@ example_app_window_open (ExampleAppWindow *win,
<para>Note that we did not have to touch the stack switcher
at all. It gets all its information from the stack that it
belongs to. Here, we are passing the label to show for each
- file as the third argument to the gtk_stack_add_titled()
+ file as the last argument to the gtk_stack_add_titled()
function.</para>
<para>Our application is beginning to take shape:</para>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]