# `GtkTextView`小部件 > 原文： [http://zetcode.com/gui/gtk2/gtktextview/](http://zetcode.com/gui/gtk2/gtktextview/) 在 GTK+ 編程教程的這一部分中，我們使用`GtkTextView`小部件。 `GtkTextView`小部件用于顯示和編輯多行文本。 `GtkTextView`小部件也具有 MVC 設計。 `GtkTextView`代表視圖組件，`GtkTextBuffer`代表模型組件。 `GtkTextBuffer`用于處理文本數據。 `GtkTextTag`是可以應用于文本的屬性。 `GtkTextIter`表示文本中兩個字符之間的位置。 所有使用文本的操作都是使用文本迭代器完成的。 ## 簡單的例子 在第一個示例中，我們顯示一些`GtkTextView's`函數。 我們展示了如何將各種文本標簽應用于文本數據。 `simpletextview.c` ```c #include <gtk/gtk.h> int main(int argc, char *argv[]) { GtkWidget *window; GtkWidget *view; GtkWidget *vbox; GtkTextBuffer *buffer; GtkTextIter start, end; GtkTextIter iter; gtk_init(&argc, &argv); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER); gtk_window_set_default_size(GTK_WINDOW(window), 300, 200); gtk_window_set_title(GTK_WINDOW(window), "GtkTextView"); vbox = gtk_vbox_new(FALSE, 0); view = gtk_text_view_new(); gtk_box_pack_start(GTK_BOX(vbox), view, TRUE, TRUE, 0); buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(view)); gtk_text_buffer_create_tag(buffer, "gap", "pixels_above_lines", 30, NULL); gtk_text_buffer_create_tag(buffer, "lmarg", "left_margin", 5, NULL); gtk_text_buffer_create_tag(buffer, "blue_fg", "foreground", "blue", NULL); gtk_text_buffer_create_tag(buffer, "gray_bg", "background", "gray", NULL); gtk_text_buffer_create_tag(buffer, "italic", "style", PANGO_STYLE_ITALIC, NULL); gtk_text_buffer_create_tag(buffer, "bold", "weight", PANGO_WEIGHT_BOLD, NULL); gtk_text_buffer_get_iter_at_offset(buffer, &iter, 0); gtk_text_buffer_insert(buffer, &iter, "Plain text\n", -1); gtk_text_buffer_insert_with_tags_by_name(buffer, &iter, "Colored Text\n", -1, "blue_fg", "lmarg", NULL); gtk_text_buffer_insert_with_tags_by_name (buffer, &iter, "Text with colored background\n", -1, "lmarg", "gray_bg", NULL); gtk_text_buffer_insert_with_tags_by_name (buffer, &iter, "Text in italics\n", -1, "italic", "lmarg", NULL); gtk_text_buffer_insert_with_tags_by_name (buffer, &iter, "Bold text\n", -1, "bold", "lmarg", NULL); gtk_container_add(GTK_CONTAINER(window), vbox); g_signal_connect(G_OBJECT(window), "destroy", G_CALLBACK(gtk_main_quit), NULL); gtk_widget_show_all(window); gtk_main(); return 0; } ``` 該示例顯示了一些應用了不同`GtkTextTags`的文本。 ```c view = gtk_text_view_new(); ``` `gtk_text_view_new()`函數創建一個新的`GtkTextView`小部件。 ```c gtk_text_buffer_create_tag(buffer, "blue_fg", "foreground", "blue", NULL); ``` `gtk_text_buffer_create_tag()`函數創建一個標簽，并將其添加到緩沖區的標簽表中。 第二個參數是標簽名稱。 標簽將文本的顏色更改為藍色。 ```c gtk_text_buffer_insert_with_tags_by_name(buffer, &iter, "Colored Text\n", -1, "blue_fg", "lmarg", NULL); ``` `gtk_text_buffer_insert_with_tags_by_name()`函數插入帶有`blue_fg`和`lmarg`文本標簽的文本。 標簽通過其名稱識別。  圖：`GtkTextView` ## 行和列 下面的示例顯示文本光標的當前行和列。 `linescols.c` ```c #include <gtk/gtk.h> update_statusbar(GtkTextBuffer *buffer, GtkStatusbar *statusbar) { gchar *msg; gint row, col; GtkTextIter iter; gtk_statusbar_pop(statusbar, 0); gtk_text_buffer_get_iter_at_mark(buffer, &iter, gtk_text_buffer_get_insert(buffer)); row = gtk_text_iter_get_line(&iter); col = gtk_text_iter_get_line_offset(&iter); msg = g_strdup_printf("Col: %d Ln: %d", col+1, row+1); gtk_statusbar_push(statusbar, 0, msg); g_free(msg); } void mark_set_callback(GtkTextBuffer *buffer, const GtkTextIter *new_location, GtkTextMark *mark, gpointer data) { update_statusbar(buffer, GTK_STATUSBAR(data)); } int main(int argc, char *argv[]) { GtkWidget *window; GtkWidget *vbox; GtkWidget *toolbar; GtkWidget *view; GtkWidget *statusbar; GtkToolItem *exit; GtkTextBuffer *buffer; gtk_init(&argc, &argv); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER); gtk_window_set_default_size(GTK_WINDOW(window), 350, 300); gtk_window_set_title(GTK_WINDOW(window), "Lines & columns"); vbox = gtk_vbox_new(FALSE, 0); gtk_container_add(GTK_CONTAINER(window), vbox); toolbar = gtk_toolbar_new(); gtk_toolbar_set_style(GTK_TOOLBAR(toolbar), GTK_TOOLBAR_ICONS); exit = gtk_tool_button_new_from_stock(GTK_STOCK_QUIT); gtk_toolbar_insert(GTK_TOOLBAR(toolbar), exit, -1); gtk_box_pack_start(GTK_BOX(vbox), toolbar, FALSE, FALSE, 5); view = gtk_text_view_new(); gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(view), GTK_WRAP_WORD); gtk_box_pack_start(GTK_BOX(vbox), view, TRUE, TRUE, 0); gtk_widget_grab_focus(view); buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(view)); statusbar = gtk_statusbar_new(); gtk_box_pack_start(GTK_BOX(vbox), statusbar, FALSE, FALSE, 0); g_signal_connect(G_OBJECT(exit), "clicked", G_CALLBACK(gtk_main_quit), NULL); g_signal_connect(buffer, "changed", G_CALLBACK(update_statusbar), statusbar); g_signal_connect_object(buffer, "mark_set", G_CALLBACK(mark_set_callback), statusbar, 0); g_signal_connect_swapped(G_OBJECT(window), "destroy", G_CALLBACK(gtk_main_quit), NULL); gtk_widget_show_all(window); update_statusbar(buffer, GTK_STATUSBAR(statusbar)); gtk_main(); return 0; } ``` 在此代碼示例中，我們在狀態欄中顯示文本光標的當前位置。 ```c g_signal_connect(buffer, "changed", G_CALLBACK(update_statusbar), statusbar); ``` 更改文本時，我們將調用`update_statusbar()`處理器。 ```c g_signal_connect_object(buffer, "mark_set", G_CALLBACK(mark_set_callback), statusbar, 0); ``` 光標移動時會發出`mark_set`信號。 ```c gtk_statusbar_pop(statusbar, 0); ``` 此代碼行從狀態欄中清除上下文標識為 0 的消息。 ```c gtk_text_buffer_get_iter_at_mark(buffer, &iter, gtk_text_buffer_get_insert(buffer)); row = gtk_text_iter_get_line(&iter); col = gtk_text_iter_get_line_offset(&iter); ``` 這些行確定當前行和列。 ```c msg = g_strdup_printf("Col %d Ln %d", col+1, row+1); ``` `g_strdup_printf()`用于構建要在狀態欄上顯示的文本。 ```c gtk_statusbar_push(statusbar, 0, msg); ``` 我們使用`gtk_statusbar_push()`函數在狀態欄上顯示文本。  圖：直線 and columns ## 搜索和高亮 在下一個示例中，我們在`GtkTextBuffer`中進行了一些搜索； 我們在文本緩沖區中高亮一些文本模式。 `search.c` ```c #include <gtk/gtk.h> #include <gdk/gdkkeysyms.h> gboolean key_pressed(GtkWidget *window, GdkEventKey* event, GtkTextBuffer *buffer) { GtkTextIter start_sel, end_sel; GtkTextIter start_find, end_find; GtkTextIter start_match, end_match; gboolean selected; gchar *text; if ((event->type == GDK_KEY_PRESS) && (event->state & GDK_CONTROL_MASK)) { switch (event->keyval) { case GDK_m : selected = gtk_text_buffer_get_selection_bounds(buffer, &start_sel, &end_sel); if (selected) { gtk_text_buffer_get_start_iter(buffer, &start_find); gtk_text_buffer_get_end_iter(buffer, &end_find); gtk_text_buffer_remove_tag_by_name(buffer, "gray_bg", &start_find, &end_find); text = (gchar *) gtk_text_buffer_get_text(buffer, &start_sel, &end_sel, FALSE); while (gtk_text_iter_forward_search(&start_find, text, GTK_TEXT_SEARCH_TEXT_ONLY | GTK_TEXT_SEARCH_VISIBLE_ONLY, &start_match, &end_match, NULL)) { gtk_text_buffer_apply_tag_by_name(buffer, "gray_bg", &start_match, &end_match); gint offset = gtk_text_iter_get_offset(&end_match); gtk_text_buffer_get_iter_at_offset(buffer, &start_find, offset); } g_free(text); } break; case GDK_r: gtk_text_buffer_get_start_iter(buffer, &start_find); gtk_text_buffer_get_end_iter(buffer, &end_find); gtk_text_buffer_remove_tag_by_name(buffer, "gray_bg", &start_find, &end_find); break; } } return FALSE; } int main(int argc, gchar *argv[]) { GtkWidget *window; GtkWidget *view; GtkWidget *vbox; GtkTextBuffer *buffer; GtkTextIter start, end; GtkTextIter iter; gtk_init(&argc, &argv); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER); gtk_window_set_default_size(GTK_WINDOW(window), 350, 300); gtk_window_set_title(GTK_WINDOW(window), "Search & highlight"); GTK_WINDOW(window)->allow_shrink = TRUE; vbox = gtk_vbox_new(FALSE, 0); view = gtk_text_view_new(); gtk_widget_add_events(view, GDK_BUTTON_PRESS_MASK); gtk_box_pack_start(GTK_BOX(vbox), view, TRUE, TRUE, 0); buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(view)); gtk_text_buffer_create_tag(buffer, "gray_bg", "background", "lightgray", NULL); gtk_container_add(GTK_CONTAINER(window), vbox); g_signal_connect(G_OBJECT(window), "destroy", G_CALLBACK(gtk_main_quit), NULL); g_signal_connect(G_OBJECT(window), "key-press-event", G_CALLBACK(key_pressed), buffer); gtk_widget_show_all(window); gtk_main(); return 0; } ``` 在我們的代碼示例中，我們使用鍵盤快捷鍵。 `Ctrl + M` 快捷鍵高亮所有當前選中的文本。 `Ctrl + R` 從文本中刪除高亮的內容。 ```c gtk_text_buffer_create_tag(buffer, "gray_bg", "background", "lightgray", NULL); ``` 這是我們在示例中使用的`GtkTextTag`。 標簽將文本的背景設為灰色。 ```c selected = gtk_text_buffer_get_selection_bounds(buffer, &start_sel, &end_sel); ``` 使用`gtk_text_buffer_get_selection_bounds()`函數，我們可以獲得所選文本的開始和結束位置。 ```c gtk_text_buffer_get_start_iter(buffer, &start_find); gtk_text_buffer_get_end_iter(buffer, &end_find); ``` 我們獲得文本緩沖區中的第一個和最后一個位置。 ```c gtk_text_buffer_remove_tag_by_name(buffer, "gray_bg", &start_find, &end_find); ``` 使用`gtk_text_buffer_remove_tag_by_name()`函數，我們可以刪除所有以前的文本標簽。 ```c text = (gchar *) gtk_text_buffer_get_text(buffer, &start_sel, &end_sel, FALSE); ``` 我們獲得選定的文本。 這是我們要搜索的文本。 ```c while (gtk_text_iter_forward_search(&start_find, text, GTK_TEXT_SEARCH_TEXT_ONLY | GTK_TEXT_SEARCH_VISIBLE_ONLY, &start_match, &end_match, NULL)) { gtk_text_buffer_apply_tag_by_name(buffer, "gray_bg", &start_match, &end_match); gint offset = gtk_text_iter_get_offset(&end_match); gtk_text_buffer_get_iter_at_offset(buffer, &start_find, offset); } ``` 此代碼搜索所有出現的所選文本。 如果找到任何匹配項，則應用文本標簽。 匹配之后，單詞的終點成為下一次搜索的起點。  圖：搜索和突出顯示 在本章中，我們介紹了`GtkTextView`小部件。