原文： http://zetcode.com/gui/gtk2/gtktextview/

在 GTK+ 编程教程的这一部分中，我们使用GtkTextView小部件。

GtkTextView小部件用于显示和编辑多行文本。 GtkTextView小部件也具有 MVC 设计。 GtkTextView代表视图组件，GtkTextBuffer代表模型组件。 GtkTextBuffer用于处理文本数据。 GtkTextTag是可以应用于文本的属性。 GtkTextIter表示文本中两个字符之间的位置。 所有使用文本的操作都是使用文本迭代器完成的。

简单的例子

在第一个示例中，我们显示一些GtkTextView's函数。 我们展示了如何将各种文本标签应用于文本数据。

simpletextview.c

  1. #include <gtk/gtk.h>
  3. int main(int argc, char *argv[]) {
  5.   GtkWidget *window;
  6.   GtkWidget *view;
  7.   GtkWidget *vbox;
  9.   GtkTextBuffer *buffer;
  10.   GtkTextIter start, end;
  11.   GtkTextIter iter;
  13.   gtk_init(&argc, &argv);
  15.   window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
  16.   gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER);
  17.   gtk_window_set_default_size(GTK_WINDOW(window), 300, 200);
  18.   gtk_window_set_title(GTK_WINDOW(window), "GtkTextView");
  20.   vbox = gtk_vbox_new(FALSE, 0);
  21.   view = gtk_text_view_new();
  22.   gtk_box_pack_start(GTK_BOX(vbox), view, TRUE, TRUE, 0);
  24.   buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(view));
  26.   gtk_text_buffer_create_tag(buffer, "gap",
  27.         "pixels_above_lines", 30, NULL);
  29.   gtk_text_buffer_create_tag(buffer, "lmarg", 
  30.       "left_margin", 5, NULL);
  31.   gtk_text_buffer_create_tag(buffer, "blue_fg", 
  32.       "foreground", "blue", NULL); 
  33.   gtk_text_buffer_create_tag(buffer, "gray_bg", 
  34.       "background", "gray", NULL); 
  35.   gtk_text_buffer_create_tag(buffer, "italic", 
  36.       "style", PANGO_STYLE_ITALIC, NULL);
  37.   gtk_text_buffer_create_tag(buffer, "bold", 
  38.       "weight", PANGO_WEIGHT_BOLD, NULL);
  40.   gtk_text_buffer_get_iter_at_offset(buffer, &iter, 0);
  42.   gtk_text_buffer_insert(buffer, &iter, "Plain text\n", -1);
  43.   gtk_text_buffer_insert_with_tags_by_name(buffer, &iter, 
  44.         "Colored Text\n", -1, "blue_fg", "lmarg",  NULL);
  45.   gtk_text_buffer_insert_with_tags_by_name (buffer, &iter, 
  46.         "Text with colored background\n", -1, "lmarg", "gray_bg", NULL);
  48.   gtk_text_buffer_insert_with_tags_by_name (buffer, &iter, 
  49.         "Text in italics\n", -1, "italic", "lmarg",  NULL);
  51.   gtk_text_buffer_insert_with_tags_by_name (buffer, &iter, 
  52.         "Bold text\n", -1, "bold", "lmarg",  NULL);
  54.   gtk_container_add(GTK_CONTAINER(window), vbox);
  56.   g_signal_connect(G_OBJECT(window), "destroy",
  57.         G_CALLBACK(gtk_main_quit), NULL);
  59.   gtk_widget_show_all(window);
  61.   gtk_main();
  63.   return 0;
  64. }

该示例显示了一些应用了不同GtkTextTags的文本。

  1. view = gtk_text_view_new();

gtk_text_view_new()函数创建一个新的GtkTextView小部件。

  1. gtk_text_buffer_create_tag(buffer, "blue_fg", 
  2.     "foreground", "blue", NULL);

gtk_text_buffer_create_tag()函数创建一个标签，并将其添加到缓冲区的标签表中。 第二个参数是标签名称。 标签将文本的颜色更改为蓝色。

  1. gtk_text_buffer_insert_with_tags_by_name(buffer, &iter, 
  2.       "Colored Text\n", -1, "blue_fg", "lmarg",  NULL);

gtk_text_buffer_insert_with_tags_by_name()函数插入带有blue_fg和lmarg文本标签的文本。 标签通过其名称识别。

`GtkTextView`小部件 - 图1

图：GtkTextView

行和列

下面的示例显示文本光标的当前行和列。

linescols.c

  1. #include <gtk/gtk.h>
  3. update_statusbar(GtkTextBuffer *buffer,
  4.                   GtkStatusbar  *statusbar) {
  5.   gchar *msg;
  6.   gint row, col;
  7.   GtkTextIter iter;
  9.   gtk_statusbar_pop(statusbar, 0); 
  11.   gtk_text_buffer_get_iter_at_mark(buffer,
  12.       &iter, gtk_text_buffer_get_insert(buffer));
  14.   row = gtk_text_iter_get_line(&iter);
  15.   col = gtk_text_iter_get_line_offset(&iter);
  17.   msg = g_strdup_printf("Col: %d Ln: %d", col+1, row+1);
  19.   gtk_statusbar_push(statusbar, 0, msg);
  21.   g_free(msg);
  22. }
  24. void mark_set_callback(GtkTextBuffer *buffer, 
  25.     const GtkTextIter *new_location, GtkTextMark *mark, gpointer data) {
  27.   update_statusbar(buffer, GTK_STATUSBAR(data));
  28. }
  30. int main(int argc, char *argv[]) {
  32.   GtkWidget *window;
  33.   GtkWidget *vbox;
  35.   GtkWidget *toolbar;
  36.   GtkWidget *view;
  37.   GtkWidget *statusbar;
  38.   GtkToolItem *exit;
  39.   GtkTextBuffer *buffer;
  41.   gtk_init(&argc, &argv);
  43.   window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
  44.   gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER);
  45.   gtk_window_set_default_size(GTK_WINDOW(window), 350, 300);
  46.   gtk_window_set_title(GTK_WINDOW(window), "Lines & columns");
  48.   vbox = gtk_vbox_new(FALSE, 0);
  49.   gtk_container_add(GTK_CONTAINER(window), vbox);
  51.   toolbar = gtk_toolbar_new();
  52.   gtk_toolbar_set_style(GTK_TOOLBAR(toolbar), GTK_TOOLBAR_ICONS);
  54.   exit = gtk_tool_button_new_from_stock(GTK_STOCK_QUIT);
  55.   gtk_toolbar_insert(GTK_TOOLBAR(toolbar), exit, -1);
  57.   gtk_box_pack_start(GTK_BOX(vbox), toolbar, FALSE, FALSE, 5);
  59.   view = gtk_text_view_new();
  60.   gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(view), GTK_WRAP_WORD);
  61.   gtk_box_pack_start(GTK_BOX(vbox), view, TRUE, TRUE, 0);
  62.   gtk_widget_grab_focus(view);
  64.   buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(view));
  66.   statusbar = gtk_statusbar_new();
  67.   gtk_box_pack_start(GTK_BOX(vbox), statusbar, FALSE, FALSE, 0);
  69.   g_signal_connect(G_OBJECT(exit), "clicked", 
  70.         G_CALLBACK(gtk_main_quit), NULL);
  72.   g_signal_connect(buffer, "changed",
  73.         G_CALLBACK(update_statusbar), statusbar);
  75.   g_signal_connect_object(buffer, "mark_set", 
  76.         G_CALLBACK(mark_set_callback), statusbar, 0);
  78.   g_signal_connect_swapped(G_OBJECT(window), "destroy",
  79.         G_CALLBACK(gtk_main_quit), NULL);
  81.   gtk_widget_show_all(window);
  83.   update_statusbar(buffer, GTK_STATUSBAR(statusbar));
  85.   gtk_main();
  87.   return 0;
  88. }

在此代码示例中，我们在状态栏中显示文本光标的当前位置。

  1. g_signal_connect(buffer, "changed",
  2.       G_CALLBACK(update_statusbar), statusbar);

更改文本时，我们将调用update_statusbar()处理器。

  1. g_signal_connect_object(buffer, "mark_set", 
  2.       G_CALLBACK(mark_set_callback), statusbar, 0);

光标移动时会发出mark_set信号。

  1. gtk_statusbar_pop(statusbar, 0);

此代码行从状态栏中清除上下文标识为 0 的消息。

  1. gtk_text_buffer_get_iter_at_mark(buffer,
  2.     &iter, gtk_text_buffer_get_insert(buffer));
  4. row = gtk_text_iter_get_line(&iter);
  5. col = gtk_text_iter_get_line_offset(&iter);

这些行确定当前行和列。

  1. msg = g_strdup_printf("Col %d Ln %d", col+1, row+1);

g_strdup_printf()用于构建要在状态栏上显示的文本。

  1. gtk_statusbar_push(statusbar, 0, msg);

我们使用gtk_statusbar_push()函数在状态栏上显示文本。

`GtkTextView`小部件 - 图2

图：直线 and columns

搜索和高亮

在下一个示例中，我们在GtkTextBuffer中进行了一些搜索； 我们在文本缓冲区中高亮一些文本模式。

search.c

  1. #include <gtk/gtk.h>
  2. #include <gdk/gdkkeysyms.h>
  4. gboolean key_pressed(GtkWidget *window,
  5.     GdkEventKey* event, GtkTextBuffer *buffer) {
  7.   GtkTextIter start_sel, end_sel;
  8.   GtkTextIter start_find, end_find;
  9.   GtkTextIter start_match, end_match;
  10.   gboolean selected;    
  11.   gchar *text;            
  13.   if ((event->type == GDK_KEY_PRESS) && 
  14.      (event->state & GDK_CONTROL_MASK)) {
  16.     switch (event->keyval) {
  18.       case GDK_m :
  19.         selected = gtk_text_buffer_get_selection_bounds(buffer, 
  20.             &start_sel, &end_sel);
  21.       if (selected) {
  22.         gtk_text_buffer_get_start_iter(buffer, &start_find);
  23.         gtk_text_buffer_get_end_iter(buffer, &end_find);
  25.         gtk_text_buffer_remove_tag_by_name(buffer, "gray_bg", 
  26.             &start_find, &end_find);  
  27.         text = (gchar *) gtk_text_buffer_get_text(buffer, &start_sel,
  28.             &end_sel, FALSE);
  30.         while (gtk_text_iter_forward_search(&start_find, text, 
  31.                 GTK_TEXT_SEARCH_TEXT_ONLY | 
  32.                 GTK_TEXT_SEARCH_VISIBLE_ONLY, 
  33.                 &start_match, &end_match, NULL)) {
  35.           gtk_text_buffer_apply_tag_by_name(buffer, "gray_bg", 
  36.               &start_match, &end_match);
  37.           gint offset = gtk_text_iter_get_offset(&end_match);
  38.           gtk_text_buffer_get_iter_at_offset(buffer, 
  39.               &start_find, offset);
  40.         }
  42.         g_free(text);
  43.       }
  45.       break;
  47.       case GDK_r:
  48.         gtk_text_buffer_get_start_iter(buffer, &start_find);
  49.         gtk_text_buffer_get_end_iter(buffer, &end_find);
  51.         gtk_text_buffer_remove_tag_by_name(buffer, "gray_bg", 
  52.             &start_find, &end_find);  
  53.       break;
  54.     }
  55.   }
  57.   return FALSE;
  58. }
  60. int main(int argc, gchar *argv[]) {
  62.   GtkWidget *window;
  63.   GtkWidget *view;
  64.   GtkWidget *vbox;
  66.   GtkTextBuffer *buffer;
  67.   GtkTextIter start, end;
  68.   GtkTextIter iter;
  70.   gtk_init(&argc, &argv);
  72.   window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
  73.   gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER);
  74.   gtk_window_set_default_size(GTK_WINDOW(window), 350, 300);
  75.   gtk_window_set_title(GTK_WINDOW(window), "Search & highlight");
  76.   GTK_WINDOW(window)->allow_shrink = TRUE;
  78.   vbox = gtk_vbox_new(FALSE, 0);
  79.   view = gtk_text_view_new();
  80.   gtk_widget_add_events(view, GDK_BUTTON_PRESS_MASK);
  81.   gtk_box_pack_start(GTK_BOX(vbox), view, TRUE, TRUE, 0);
  83.   buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(view));
  84.   gtk_text_buffer_create_tag(buffer, "gray_bg", 
  85.       "background", "lightgray", NULL); 
  86.   gtk_container_add(GTK_CONTAINER(window), vbox);
  88.   g_signal_connect(G_OBJECT(window), "destroy",
  89.         G_CALLBACK(gtk_main_quit), NULL);
  91.   g_signal_connect(G_OBJECT(window), "key-press-event",
  92.         G_CALLBACK(key_pressed), buffer);
  94.   gtk_widget_show_all(window);
  96.   gtk_main();
  98.   return 0;
  99. }

在我们的代码示例中，我们使用键盘快捷键。 Ctrl + M 快捷键高亮所有当前选中的文本。 Ctrl + R 从文本中删除高亮的内容。

  1. gtk_text_buffer_create_tag(buffer, "gray_bg", 
  2.     "background", "lightgray", NULL);

这是我们在示例中使用的GtkTextTag。 标签将文本的背景设为灰色。

  1. selected = gtk_text_buffer_get_selection_bounds(buffer, 
  2.     &start_sel, &end_sel);

使用gtk_text_buffer_get_selection_bounds()函数，我们可以获得所选文本的开始和结束位置。

  1. gtk_text_buffer_get_start_iter(buffer, &start_find);
  2. gtk_text_buffer_get_end_iter(buffer, &end_find);

我们获得文本缓冲区中的第一个和最后一个位置。

  1. gtk_text_buffer_remove_tag_by_name(buffer, "gray_bg", 
  2.     &start_find, &end_find);

使用gtk_text_buffer_remove_tag_by_name()函数，我们可以删除所有以前的文本标签。

  1. text = (gchar *) gtk_text_buffer_get_text(buffer, &start_sel,
  2.     &end_sel, FALSE);

我们获得选定的文本。 这是我们要搜索的文本。

  1. while (gtk_text_iter_forward_search(&start_find, text, 
  2.         GTK_TEXT_SEARCH_TEXT_ONLY | 
  3.         GTK_TEXT_SEARCH_VISIBLE_ONLY, 
  4.         &start_match, &end_match, NULL)) {
  6.     gtk_text_buffer_apply_tag_by_name(buffer, "gray_bg", 
  7.         &start_match, &end_match);
  8.     gint offset = gtk_text_iter_get_offset(&end_match);
  9.     gtk_text_buffer_get_iter_at_offset(buffer, 
  10.         &start_find, offset);
  11. }

此代码搜索所有出现的所选文本。 如果找到任何匹配项，则应用文本标签。 匹配之后，单词的终点成为下一次搜索的起点。

`GtkTextView`小部件 - 图3

图：搜索和突出显示

在本章中，我们介绍了GtkTextView小部件。