GTK+图形化应用程序开发学习笔记（二十一）—文本框构建

                            GTK+图形化应用程序开发学习笔记（二十一）—文本框构建

文本框也叫多行文本输入框，是gtk+较常用的构件，也是较复杂的一个构件。它被分为以下几部分：

 

GtkTextView：代表了窗口中可见的文本框，用来显示GtkTextBuffer.

GtkTextBuffer：文本框正文的缓冲区，文本框文字的插入、删除都是对这一类变量进行操作。

GtkTextIter：保存文字在buffer中位置的结构。

GtkTextMark：A position in the buffer preserved across buffer modifications

GtkTextTag：用来给指定的文字添加一些标记，改变指定区域的文字的显示效果。如：字体的颜色、大小的改变。

GtkTextTagTable：是GtkTextTag标记的集合表。

      

一、创建文本框构件

       GtkTextView,它代表了窗口中可见的文本框，如果只是简单使用基本用不到除了创建以外的函数。有两种方法可以创建文本框。一种是用默认的缓冲区创建文本框，用函数gtk_text_view_new。另一种是指定缓冲区来创建文本框，用函数gtk_text_view_new_with_buffer。

 

1．

名称:：

gtk_text_view_new

功能：

创建文本框构件

头文件：

#include <gtk/gtk.h>

函数原形：

GtkWidget *gtk_text_view_new(void);

参数：

无

返回值：

新的文本框构件

      

 

 

 

 

 

 

 

 

 gtk_text_view_new创建一个新的缓冲区，如果你没有在创建之前调用函数gtk_text_view_set_buffer来设置这个缓冲区，那么系统将创建一个空的默认的缓冲区，我们可以用gtk_text_view_get_buffer来得到这个缓冲区。如果你用你自己的缓冲区来创建文本框可以用gtk_text_view_new_with_buffer.

 

2．

名称:：

gtk_text_view_new_with_buffer

功能：

创建树构件

头文件：

#include <gtk/gtk.h>

函数原形：

GtkWidget *gtk_text_view_new_with_buffer(GtkTextBuffer *buffer);

参数：

buffer    缓冲区

返回值：

新的文本框构件

     

 

 

 

 

 

 

 

gtk_text_view_new_with_buffer用指定的缓冲区创建一个新的文本框，我们用buffer来指定这个缓冲区，一个缓冲区能够被许多的构件共享。buffer可以为NULL，功能和gtk_text_view_new函数一样。

 

3．

名称:：

gtk_text_view_set_buffer

功能：

设置文本框的缓冲区

头文件：

#include <gtk/gtk.h>

函数原形：

void gtk_text_view_set_buffer(GtkTextView *text_view,GtkTextBuffer *buffer);

参数：

text_view     文本框

buffer        缓冲区

返回值：

无

 

 

 

 

 

 

 

 

 

 

 

 

4．

名称:：

gtk_text_view_get_buffer

功能：

获得文本框的缓冲区

头文件：

#include <gtk/gtk.h>

函数原形：

GtkTextBuffer* gtk_text_view_get_buffer (GtkTextView *text_view);

参数：

text_view     文本框

返回值：

文本框缓冲区

      

  

 

 

 

 

 

 

     

我们可以用gtk_text_view_new创建默认缓冲区的文本框，用gtk_text_view_get_buffer来得到这个缓冲区。下面就是程序例子。

 

#include <gtk/gtk.h>

 

int main(int argc,char *argv[ ])

{

GtkWidget *window;

GtkWidget *text_view;

GtkTextBuffer *buffer;

 

gtk_init(&argc,&argv);

window=gtk_window_new(GTK_WINDOW_TOPLEVEL);

gtk_widget_set_size_request(window,200,150);

g_signal_connect(GTK_OBJECT(window),”destroy”,G_CALLBACK(gtk_main_quit),NULL);

 

text_view=gtk_text_view_new();/*创建文本框构件*/

buffer=gtk_text_view_get_buffer(GTK_TEXT_VIEW(text_view));/*获得文本框缓冲区*/

gtk_container_add(GTK_CONTAINER(window),text_view);

gtk_widget_show(view);

 

gtk_widget_show(window);

gtk_main();

}

程序运行后得到如下界面：

 

二、创建文本框的缓冲区

5．

名称:：

gtk_text_buffer_new

功能：

创建文本框的缓冲区

头文件：

#include <gtk/gtk.h>

函数原形：

GtkTextBuffer* gtk_text_buffer_new(GtkTextTagTable *table);

参数：

table      文本构件的标签盒

返回值：

文本框缓冲区

      

 

 

 

 

 

 

gtk_text_buffer_new用来创建文本构件的缓冲区。它需要指定文本构件的标签盒。我们也可以让它为空，让系统创建默认的文件构件标签盒。然后用gtk_text_buffer_get_tag_table函数来获得标签盒。

 

6．

名称:：

gtk_text_buffer_get_tag_table

功能：

获得文本框的标签盒

头文件：

#include <gtk/gtk.h>

函数原形：

GtkTextTagTable* gtk_text_buffer_get_tag_table(GtkTextBuffer *buffer);

参数：

buffer      文本构件的缓冲区

返回值：

文本框构件的标签盒

 

 

 

 

 

 

 

 

 

 

 

下面是用指定缓冲区创建文本框的例子。

#include <gtk/gtk.h>

 

int main(int argc,char *argv[ ])

{

GtkWidget *window;

GtkWidget *text_view;

GtkTextBuffer *buffer;

 

gtk_init(&argc,&argv);

window=gtk_window_new(GTK_WINDOW_TOPLEVEL);

gtk_widget_set_size_request(window,200,150);

g_signal_connect(GTK_OBJECT(window),”destroy”,G_CALLBACK(gtk_main_quit),NULL);

buffer=gtk_text_buffer_new(NULL);/*创建文本框的缓冲区*/

text_view=gtk_text_view_new_with_buffer(buffer);/*创建文本框构件*/

gtk_container_add(GTK_CONTAINER(window),text_view);

gtk_widget_show(view);

 

gtk_widget_show(window);

gtk_main();

}

三、文本框文字的插入和删除

       对文本框文字的插入和删除之前都需要得到当前buffer中开始位置、结束位置的ITER，

我们可以用gtk_text_buffer_get_bounds来实现这一点。

      

7．

名称:：

gtk_text_buffer_get_bounds

功能：

获得文本框的标签盒

头文件：

#include <gtk/gtk.h>

函数原形：

void gtk_text_buffer_get_bounds(GtkTextBuffer *buffer,GtkTextIter *start, GtkTextIter *end);

参数：

buffer      文本构件的缓冲区

start       文本框文字开始位置的iter

end        文本框文字结束位置的iter

返回值：

无

      

 

 

 

 

 

 

 

 

 

缓冲区开始和结束位置的iter分别通过star和end参数得到。下面我们就可以对文本框构件的正文进行操作了。

 

8．

名称:：

gtk_text_buffer_insert

功能：

向缓冲区插入文字

头文件：

#include <gtk/gtk.h>

函数原形：

void gtk_text_buffer_insert(GtkTextBuffer *buffer,GtkTextIter *iter,const gchar *text,gint len);

参数：

buffer     文本构件的缓冲区

iter       插入的位置

text       插入的文本

len       插入的文本长度

返回值：

无

      

 

 

 

 

 

 

 

 

 

 

start、end分别为文本框文字开始位置和结束位置的iter。len为要插入文本的长度，它可以为-1，表示插入text的所有内容。

 

       下面是插入文字的程序例子：

#include <gtk/gtk.h>

 

GtkWidget *text_view;

GtkTextBuffer *buffer;

GtkTextIter *Iter;

 

void button_event(GtkWidget *widget,gpointer *data);

 

int main(int argc,char *argv[ ])

{

GtkWidget *window;

GtkWidget *button;

GtkWidget *box;

 

gtk_init(&argc,&argv);

window=gtk_window_new(GTK_WINDOW_TOPLEVEL);

gtk_widget_set_size_request(window,200,150);

g_signal_connect(GTK_OBJECT(window),”destroy”,G_CALLBACK(gtk_main_quit),NULL);

 

box=gtk_vbox_new(FALSE,0);

gtk_widget_show(box);

 

text_view=gtk_text_view_new();/*创建文本框构件*/

gtk_widget_set_request(text_view,200,120);

gtk_container_add(GTK_CONTAINER(window),box);

gtk_box_pack_start(GTK_BOX(box),text_view,FALSE,FALSE,0);

buffer=gtk_text_view_get_buffer(GTK_TEXT_VIEW(text_view));

gtk_widget_show(text_view);

 

button=gtk_button_new_with_label(“确定”);

gtk_box_pack_start(GTK_BOX(box),button,FALSE,FALSE,5);

gtk_signal_connect(GTK_OBJECT(button),”clicked”,GTK_SIGNAL_FUNC(button_event),NULL);

 

gtk_widget_show(window);

gtk_main();

}

 

void button_event(GtkWidget *widget,gpointer *data)

{

const gchar *text=”How are you!”;

GtkTextIter start,end;

 

gtk_text_buffer_get_bounds(GTK_TEXT_BUFFER(buffer),&start,&end);/*获得缓冲区开始和结束位置的Iter*/

gtk_text_buffer_insert(GTK_TEXT_BUFFER(buffer),&start,text,strlen(text));/*插入文本到缓冲区*/

}

 

程序运行后得到如下界面：

当用户点击确定按扭后得到：

9．

名称:：

gtk_text_buffer_delete

功能：

缓冲区内容删除

头文件：

#include <gtk/gtk.h>

函数原形：

void gtk_text_buffer_delete(GtkTextBuffer *buffer,GtkTextIter *start,

GtkTextIter *end);

参数：

buffer      文本构件的缓冲区

start       文本框文字开始位置的iter

end        文本框文字结束位置的iter

返回值：

无

      

 

 

 

 

 

 

 

 

 

 

 

 gtk_text_buffer_delete函数可将缓冲区内容删除。start、end分别为文本框文字开始位置和结束位置的iter.

四、文本框缓冲区文本的获得和设置

       我们可以用函数gtk_text_buffer_get_text来获得文本框缓冲区的文本，用gtk_text_buffer_set_text来设置它。

 

10．

名称:：

gtk_text_buffer_get_text

功能：

文本框缓冲区文本的获得

头文件：

#include <gtk/gtk.h>

函数原形：

gchar* gtk_text_buffer_get_text(GtkTextBuffer *buffer,const GtkTextIter *start,const GtkTextIter *end,gboolean include_hidden_chars);

参数：

buffer      文本构件的缓冲区

start       文本框文字开始位置的iter

end        文本框文字结束位置的iter

include_hidden_chars  

返回值：

文本框缓冲区文本

      

 

 

 

 

 

 

 

 

 

 

gtk_text_buffer_get_text返回文本框缓冲区文本，include_hidden_chars设置是否包含看不见的文本。

      

下面是文本框缓冲区文本的获得的程序例子：

#include <gtk/gtk.h>

 

GtkWidget *text_view;

GtkTextBuffer *buffer;

GtkTextIter *Iter;

 

void button_event(GtkWidget *widget,gpointer *data);

 

int main(int argc,char *argv[ ])

{

GtkWidget *window;

GtkWidget *button;

GtkWidget *box;

 

gtk_init(&argc,&argv);

window=gtk_window_new(GTK_WINDOW_TOPLEVEL);

gtk_widget_set_size_request(window,200,150);

g_signal_connect(GTK_OBJECT(window),”destroy”,G_CALLBACK(gtk_main_quit),NULL);

 

box=gtk_vbox_new(FALSE,0);

gtk_widget_show(box);

 

text_view=gtk_text_view_new();/*创建文本框构件*/

gtk_widget_set_request(text_view,200,120);

gtk_container_add(GTK_CONTAINER(window),box);

gtk_box_pack_start(GTK_BOX(box),text_view,FALSE,FALSE,0);

buffer=gtk_text_view_get_buffer(GTK_TEXT_VIEW(text_view));

gtk_widget_show(text_view);

 

button=gtk_button_new_with_label(“确定”);

gtk_box_pack_start(GTK_BOX(box),button,FALSE,FALSE,5);

gtk_signal_connect(GTK_OBJECT(button),”clicked”,GTK_SIGNAL_FUNC(button_event),NULL);

 

gtk_widget_show(window);

gtk_main();

}

 

void button_event(GtkWidget *widget,gpointer *data)

{

gchar *text;

GtkTextIter start,end;

 

gtk_text_buffer_get_bounds(GTK_TEXT_BUFFER(buffer),&start,&end);/*获得缓冲区开始和结束位置的Iter*/

 

const GtkTextIter s=start,e=end;

text=gtk_text_buffer_get_text(GTK_TEXT_BUFFER(buffer),&s,&e,FALSE);/*获得文本框缓冲区文本*/

g_print(“%s/n”,text);

}

       当用户点击确定按钮，文本框的内容将会打印到屏幕上。

 

11．

名称:：

gtk_text_buffer_set_text

功能：

文本框缓冲区文本的设置

头文件：

#include <gtk/gtk.h>

函数原形：

void gtk_text_buffer_set_text(GtkTextBuffer *buffer,const gchar *text,

gint len);

参数：

buffer      文本构件的缓冲区

start       文本框文字开始位置的iter

end        文本框文字结束位置的iter

text        要设置的文本

返回值：

无

      

 

 

 

 

 

 

 

 

 

 

gtk_text_buffer_set_text会删除原有缓冲区内容，然后用text的内容代替。