GTK+图形化应用程序开发学习笔记（八）—录入构件（1）

一、录入构件
录入构件(GtkEntry)是单行录入字段，用它来录入和显示正文信息。录入构件由可编辑构件派生而来，它是更复杂的正文构件的简化形式。录入构件比按钮构件或标号构件复杂。与按钮构件或标号构件相比，它具有更多的功能。
可以用gtk_entry_new函数或者gtk_entry_new_with_max_length函数建立录入构件.其中函数gtk_entry_new_with_max_length能够设置录入到构件中的最长的字符数。

1．

名称:：	gtk_entry_new gtk_entry_new_with_max_length
功能：	创建录入构件
头文件：	#include <gtk/gtk.h>
函数原形：	GtkWidget *gtk_entry_new(void); GtkWidget *gtk_entry_new_with_max_length(gint max);
参数：	max 够设置录入到构件中的最长的字符数
返回值：	新的录入构件

2．

名称:：	gtk_entry_get_text
功能：	获得录入构件正文
头文件：	#include <gtk/gtk.h>
函数原形：	const gchar *gtk_entry_get_text(GtkEntry *entry);
参数：	entry 录入构件名
返回值：	指向录入构件正文的指针

构件中的正文可以用gtk_entry_get_text函数提取。它的返回值是指向字符串数据的指针，但是不能通过该指针修改数据。
下面是录入构件的例子：用户输入姓名，按”Enter”按钮后屏幕上打印用户输入。

/*entry1.c*/ #include <gtk/gtk.h> void button_event(GtkWidget *,gpointer *); GtkWidget *name; int main(int argc,char *argv[ ]) { GtkWidget *window; GtkWidget *button; GtkWidget *box; GtkWidget *label; gtk_init_chrck(&argc,&argv); /*初始化GTK+工具库*/ window=gtk_window_new(GTK_WINDOW_TOPLEVEL); /*创建窗体*/ gtk_signal_connect(GTK_OBJECT(window),”delete_event”,G_CALLBACK(gtk_main_quit),NULL); /*登记窗体delete_event信号*/ box=gtk_vbox_new(FALSE,0);/*创建组合框*/ label=get_label_new(“name:”);/*创建标号*/ gtk_box_pack_start(GTK_BOX(box),label,FALSE,FALSE,5);/*把标号加入组合框*/ gtk_widget_show(label);/*显示标号*/ name=gtk_entry_new();/*创建录入构件*/ gtk_box_pack_start(GTK_BOX(box),labe,FALSE,FALSE,5);/*把录入构件加入组合框*/ gtk_widget_show(name);/*显示录入构件*/ button=gtk_button_new_with_label(“enter”);/*创建按钮*/ gtk_box_pack_start(GTK_BOX(box),button,FALSE,FALSE,5);/*把按钮加入组合框*/ gtk_signal_connect(GTK_OBJECT(button),”pressed”,GTK_SIGNAL_FUNC(button_event),”enter”); gtk_widget_show(button);/*显示按钮*/ gtk_container_add(GTK_CONTAINER(window),box);/*把组合框加入窗体*/ gtk_widget_show(box);/*显示组合框*/ gtk_widget_show(window);/*显示窗体*/ gtk_main(); return 0; } void button_event(GtkWidget *widget,gpointer *data) { const gchar *uname; uname=(gchar *)malloc(sizeof(gchar)); uname=gtk_entry_get_text(GTK_ENTRY(name));/*获得录入构件正文*/ g_print(“Name:%s/n”,uname); }

$gcc –o entry1 entry1.c `pkg-config –cflags –libs gtk+-2.0
$./entry1
当用户在录入构件里输入root,然后点击按钮后屏幕上显示Name：root

构件中的正文可以用下列3种方式来修改：
1、使用gtk_entry_prepend_text函数在字段的开始插入正文。
2、使用gtk_entry_append_text函数在字段的最后插入正文。
3、使用gtk_entry_set_text函数设置字段的正文，但它清除字段的原有值。

3．

名称:：	gtk_entry_prepend_text
功能：	修改录入构件正文
头文件：	#include <gtk/gtk.h>
函数原形：	void gtk_entry_prepend_text(GtkEntry *entry,const gchar *text); void gtk_entry_append_text(GtkEntry *entry,const gchar *text); void gtk_entry_set_text(GtkEntry *entry,const gchar *text);
参数：	entry 录入构件名 text 指向录入构件正文的指针
返回值：	无

我们程序entry1中加入下面的代码，就可以得到如图所示的程序。
gtk_entry_prepend_text(GTK_ENTRY(name),”Please input your name!”);