<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="textview.c" xml:lang="fr">

  <info>

    <title type="text">TextView (C)</title>

    <link type="guide" xref="c#multiline"/>

    <revision version="0.1" date="2012-07-10" status="draft"/>

    <credit type="author copyright">

      <name>Monica Kochofar</name>

      <email its:translate="no">monicakochofar@gmail.com</email>

      <years>2012</years>

    </credit>

    <desc>L'élément graphique qui affiche un GtkTextBuffer</desc>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Luc Rebert,</mal:name>

      <mal:email>traduc@rebert.name</mal:email>

      <mal:years>2011</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Alain Lojewski,</mal:name>

      <mal:email>allomervan@gmail.com</mal:email>

      <mal:years>2011-2012</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Luc Pionchon</mal:name>

      <mal:email>pionchon.luc@gmail.com</mal:email>

      <mal:years>2011</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Bruno Brouard</mal:name>

      <mal:email>annoa.b@gmail.com</mal:email>

      <mal:years>2011-12</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Luis Menina</mal:name>

      <mal:email>liberforce@freeside.fr</mal:email>

      <mal:years>2014</mal:years>

    </mal:credit>

  </info>

  <title>Élément graphique TextView</title>

<note style="sidebar">
En appuyant sur « Entrée », nous créons une nouvelle ligne.

     
En appuyant encore de nombreuses fois sur « Entrée », d'autres lignes sont créées dans la fenêtre de taille par défaut, puis une barre de défilement verticale apparaît.

     
Si nous écrivons une longue phrase, la césure se fait entre deux mots.

     
Si nous avons un loooooooooooooooooooooooooooooooooooong mot, une barre de défilement horizontale apparaît.
</note>

  <media type="image" mime="image/png" src="media/textview.png"/>

    
Ceci est un exemple de Gtk.TextView

#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;

}

Dans cet exemple, les éléments suivants sont utilisés :

<list>

  <item>
<link href="http://developer.gnome.org/gtk3/3.4/GtkApplication.html">GtkApplication</link>
</item>

  <item>
<link href="http://developer.gnome.org/gtk3/3.4/GtkWindow.html">GtkWindow</link>
</item>

  <item>
<link href="http://developer.gnome.org/gtk3/stable/GtkTextBuffer.html">GtkTextBuffer</link>
</item>

  <item>
<link href="http://developer.gnome.org/gtk3/stable/GtkTextView.html">GtkTextView</link>
</item>

  <item>
<link href="http://developer.gnome.org/gtk3/stable/GtkScrolledWindow.html">GtkScrolledWindow</link>
</item>

  <item>
<link href="http://developer.gnome.org/gtk3/stable/GtkContainer.html">GtkContainer</link>
</item>

</list>

</page>