From 84244d56fc42a2cd6541819334b4ef7c7aa4fb1f Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 24 Jul 2013 00:44:34 -0400 Subject: [PATCH] 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 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/reference/gtk/getting_started.xml b/docs/reference/gtk/getting_started.xml index 9baa5b455f..89ef881c1d 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. + 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. + + To learn more about GApplication entry points, consult the + GIO documentation. + FIXME: MISSING XINCLUDE CONTENT @@ -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, 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. Our application is beginning to take shape: