[gnome-devel-docs] tutorials C: Textview sample/page

[Tiffany Antopolski <antopolski src gnome org>]

commit 26d531b003f952a6a5017cc6b59d93a355d047e2
Author: Monica Kochofar <monicakochofar gmail com>
Date:   Thu Jul 19 13:37:55 2012 -0400

    tutorials C: Textview sample/page

 platform-demos/C/samples/textview.c |   71 +++++++++++++++++++++++++++++++++++
 platform-demos/C/textview.c.page    |   41 ++++++++++++++++++++
 2 files changed, 112 insertions(+), 0 deletions(-)
---
diff --git a/platform-demos/C/samples/textview.c b/platform-demos/C/samples/textview.c
new file mode 100644
index 0000000..8ee3d0b
--- /dev/null
+++ b/platform-demos/C/samples/textview.c
@@ -0,0 +1,71 @@
+#include <gtk/gtk.h>
+
+
+
+static void
+activate (GtkApplication *app,
+          gpointer        user_data)
+{
+  /* Declare variables */
+  GtkWidget *window;
+  GtkWidget *text_view;
+  GtkWidget *scrolled_window;
+
+  GtkTextBuffer *buffer;
+
+
+  /* Create a window with a title, and a default size */
+  window = gtk_application_window_new (app);
+  gtk_window_set_title (GTK_WINDOW (window), "TextView Example");
+  gtk_window_set_default_size (GTK_WINDOW (window), 220, 200);
+
+
+  /* The text buffer represents the text being edited */
+  buffer = gtk_text_buffer_new (NULL);
+  
+
+  /* Text view is a widget in which can display the text buffer. 
+   * The line wrapping is set to break lines in between words.
+   */
+  text_view = gtk_text_view_new_with_buffer (buffer);
+  gtk_text_view_set_wrap_mode (GTK_TEXT_VIEW (text_view), GTK_WRAP_WORD); 
+
+
+  /* Create the scrolled window. Usually NULL is passed for both parameters so 
+   * that it creates the horizontal/vertical adjustments automatically. Setting 
+   * the scrollbar policy to automatic allows the scrollbars to only show up 
+   * when needed. 
+   */
+  scrolled_window = gtk_scrolled_window_new (NULL, NULL);
+  gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window), 
+                                  GTK_POLICY_AUTOMATIC, 
+                                  GTK_POLICY_AUTOMATIC); 
+  /* The function directly below is used to add children to the scrolled window 
+   * with scrolling capabilities (e.g text_view), otherwise, 
+   * gtk_scrolled_window_add_with_viewport() would have been used
+   */
+  gtk_container_add (GTK_CONTAINER (scrolled_window), 
+                                         text_view);
+  gtk_container_set_border_width (GTK_CONTAINER (scrolled_window), 5);
+ 
+  
+  gtk_container_add (GTK_CONTAINER (window), scrolled_window);
+
+  gtk_widget_show_all (window);
+}
+
+
+
+int
+main (int argc, char **argv)
+{
+  GtkApplication *app;
+  int status;
+
+  app = gtk_application_new ("org.gtk.example", G_APPLICATION_FLAGS_NONE);
+  g_signal_connect (app, "activate", G_CALLBACK (activate), NULL);
+  status = g_application_run (G_APPLICATION (app), argc, argv);
+  g_object_unref (app);
+
+  return status;
+}
diff --git a/platform-demos/C/textview.c.page b/platform-demos/C/textview.c.page
new file mode 100644
index 0000000..70eed50
--- /dev/null
+++ b/platform-demos/C/textview.c.page
@@ -0,0 +1,41 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:xi="http://www.w3.org/2001/XInclude";
+      type="guide" style="task"
+      id="textview.c">
+  <info>
+    <link type="guide" xref="beginner.c#multiline"/>
+    <revision version="0.1" date="2012-07-10" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Monica Kochofar</name>
+      <email>monicakochofar gmail com</email>
+      <years>2012</years>
+    </credit>
+
+    <desc>Widget which displays a GtkTextBuffer</desc>
+  </info>
+
+  <title>TextView widget</title>
+<note style="sidebar"><p>If we press "enter", we have a new line.</p>
+     <p>If we press "enter" more times then there are lines in the default sized window, then a vertical scrollbar appears.</p>
+     <p>If we write a long sentence, the text will wrap breaking lines between words.</p>
+     <p>If we have a loooooooooooooooooooooooooooooooooooong (that was long) word, a* horizontal scrollbar will appear.</p></note>
+
+  <media type="image" mime="image/png" src="media/textview.png"/>
+    <p>This is an example of Gtk.TextView</p>
+
+      <code mime="text/x-csrc" style="numbered">
+<xi:include href="samples/textview.c" parse="text"><xi:fallback/></xi:include></code>
+<p>
+  In this sample we used the following:
+</p>
+<list>
+  <item><p><link href="http://developer.gnome.org/gtk3/3.4/GtkApplication.html";>GtkApplication</link></p></item>
+  <item><p><link href="http://developer.gnome.org/gtk3/3.4/GtkWindow.html";>GtkWindow</link></p></item>
+  <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkTextBuffer.html";>GtkTextBuffer</link></p></item>
+  <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkTextView.html";>GtkTextView</link></p></item>
+  <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkScrolledWindow.html";>GtkScrolledWindow</link></p></item>
+  <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkContainer.html";>GtkContainer</link></p></item>
+</list>
+</page>