Linux中国 Linux中国门户站!
设为主页 设为主页
收藏本站 收藏本站
 
当前位置 :首页 ->Linux技术 ->系统管理 ->正文

GTK入门导引

来源:Linux-cn.com 作者:Webmaster 时间:2007-05-05 点击: [收藏] [投稿]

void gtk_list_select_child (GtkList *LIST, GtkWidget *CHILD)

  触发GtkList::select_child信号给指定的CHILD.


void gtk_list_unselect_child (GtkList *LIST, GtkWidget *CHILD)

  触发GtkList::unselect_child信号给指定的CHILD.


gint gtk_list_child_position (GtkList *LIST, GtkWidget *CHILD)

  返回CHILD在LIST中的位置. `-1'为失败.


void gtk_list_set_selection_mode (GtkList *LIST, GtkSelectionMode MODE)

  设定LIST到选择模式MODE, 可以是GTK_SELECTION_SINGLE, GTK_SELECTION_BROWSE, GTK_SELECTION_MULTIPLE 或 GTK_SELECTION_EXTENDED.


GtkList* GTK_LIST (gpointer OBJ)

  传一个generic pointer到`GtkList*'. *Note Standard Macros::, for more info.


GtkListClass* GTK_LIST_CLASS (gpointer CLASS)

  传一个generic pointer到`GtkListClass*'. *Note Standard Macros::, for more info.


gint GTK_IS_LIST (gpointer OBJ)

  决定是否一个generic pointer对应到`GtkList' object. *Note Standard Macros::, for more info.

  12.3 范例

  以下是个范例程式, 将会列出GtkList的选择改变, 并让您用滑鼠右键"逮捕"list items.


/* compile this program with:
 * $ gcc -I/usr/local/include/ -lgtk -lgdk -lglib -lX11 -lm -Wall main.c
 */
/* include the gtk+ header files
 * include stdio.h, we need that for the printf() function
 */
#include<gtk/gtk.h>
#include<stdio.h>
/* this is our data identification string to store
 * data in list items
 */
constgchar*list_item_data_key="list_item_data";
/* prototypes for signal handler that we are going to connect
 * to the GtkList widget
 */
staticvoidsigh_print_selection(GtkWidget*gtklist,
 gpointerfunc_data);
staticvoidsigh_button_event(GtkWidget*gtklist,
 GdkEventButton *event,
 GtkWidget*frame);
/* main function to set up the user interface */
gint main (int argc, gchar *argv[])
{
GtkWidget*separator;
GtkWidget*window;
GtkWidget*vbox;
GtkWidget*scrolled_window;
GtkWidget*frame;
GtkWidget*gtklist;
GtkWidget*button;
GtkWidget*list_item;
GList*dlist;
guinti;
gcharbuffer[64];
/* initialize gtk+ (and subsequently gdk) */
gtk_init(&argc, &argv);
/* create a window to put all the widgets in
 * connect gtk_main_quit() to the "destroy" event of
 * the window to handle window manager close-window-events
 */
window=gtk_window_new(GTK_WINDOW_TOPLEVEL);
gtk_window_set_title(GTK_WINDOW(window), "GtkList Example");
gtk_signal_connect(GTK_OBJECT(window),
"destroy",
GTK_SIGNAL_FUNC(gtk_main_quit),
NULL);
/* inside the window we need a box to arrange the widgets
 * vertically */
vbox=gtk_vbox_new(FALSE, 5);
gtk_container_border_width(GTK_CONTAINER(vbox), 5);
gtk_container_add(GTK_CONTAINER(window), vbox);
gtk_widget_show(vbox);
/* this is the scolled window to put the GtkList widget inside */
scrolled_window=gtk_scrolled_window_new(NULL, NULL);
gtk_widget_set_usize(scrolled_window, 250, 150);
gtk_container_add(GTK_CONTAINER(vbox), scrolled_window);
gtk_widget_show(scrolled_window);
/* create the GtkList widget
 * connect the sigh_print_selection() signal handler
 * function to the "selection_changed" signal of the GtkList
 * to print out the selected items each time the selection
 * has changed */
gtklist=gtk_list_new();
gtk_container_add(GTK_CONTAINER(scrolled_window), gtklist);
gtk_widget_show(gtklist);
gtk_signal_connect(GTK_OBJECT(gtklist),
"selection_changed",
GTK_SIGNAL_FUNC(sigh_print_selection),
NULL);
/* we create a "Prison" to put a list item in ;)
 */
frame=gtk_frame_new("Prison");
gtk_widget_set_usize(frame, 200, 50);
gtk_container_border_width(GTK_CONTAINER(frame), 5);
gtk_frame_set_shadow_type(GTK_FRAME(frame), GTK_SHADOW_OUT);
gtk_container_add(GTK_CONTAINER(vbox), frame);
gtk_widget_show(frame);
/* connect the sigh_button_event() signal handler to the GtkList
 * wich will handle the "arresting" of list items
 */
gtk_signal_connect(GTK_OBJECT(gtklist),
"button_release_event",
GTK_SIGNAL_FUNC(sigh_button_event),
frame);
/* create a separator
 */
separator=gtk_hseparator_new();
gtk_container_add(GTK_CONTAINER(vbox), separator);
gtk_widget_show(separator);
/* finaly create a button and connect it愀 "clicked" signal
 * to the destroyment of the window
 */
button=gtk_button_new_with_label("Close");
gtk_container_add(GTK_CONTAINER(vbox), button);
gtk_widget_show(button);
gtk_signal_connect_object(GTK_OBJECT(button),
"clicked",
GTK_SIGNAL_FUNC(gtk_widget_destroy),
GTK_OBJECT(window));
/* now we create 5 list items, each having it愀 own
 * label and add them to the GtkList using gtk_container_add()
 * also we query the text string from the label and
 * associate it with the list_item_data_key for each list item
 */
for (i=0; i<5; i++) {
GtkWidget*label;
gchar*string;
sprintf(buffer, "ListItemContainer with Label #%d", i);
label=gtk_label_new(buffer);
list_item=gtk_list_item_new();
gtk_container_add(GTK_CONTAINER(list_item), label);
gtk_widget_show(label);
gtk_container_add(GTK_CONTAINER(gtklist), list_item);
gtk_widget_show(list_item);
gtk_label_get(GTK_LABEL(label), &string);
gtk_object_set_data(GTK_OBJECT(list_item),
list_item_data_key,
string);
}
/* here, we are creating another 5 labels, this time
 * we use gtk_list_item_new_with_label() for the creation
 * we can憩 query the text string from the label because
 * we don憩 have the labels pointer and therefore
 * we just associate the list_item_data_key of each
 * list item with the same text string
 * for adding of the list items we put them all into a doubly
 * linked list (GList), and then add them by a single call to
 * gtk_list_append_items()
 * because we use g_list_prepend() to put the items into the
 * doubly linked list, their order will be descending (instead
 * of ascending when using g_list_append())
 */
dlist=NULL;
for (; i<10; i++) {
sprintf(buffer, "List Item with Label %d", i);
list_item=gtk_list_item_new_with_label(buffer);
dlist=g_list_prepend(dlist, list_item);
gtk_widget_show(list_item);
gtk_object_set_data(GTK_OBJECT(list_item),
list_item_data_key,
"ListItem with integrated Label");
}
gtk_list_append_items(GTK_LIST(gtklist), dlist);
/* finaly we want to see the window, don憩 we? ;)
 */
gtk_widget_show(window);
/* fire up the main event loop of gtk
 */
gtk_main();
/* we get here after gtk_main_quit() has been called which
 * happens if the main window gets destroyed
 */
return 0;
}
/* this is the signal handler that got connected to button
 * press/release events of the GtkList
 */
void
sigh_button_event(GtkWidget*gtklist,
 GdkEventButton *event,
 GtkWidget*frame)
{
/* we only do something if the third (rightmost mouse button
 * was released
 */
if (event->type==GDK_BUTTON_RELEASE &&
event->button==3) {
GList*dlist, *free_list;
GtkWidget*new_prisoner;
/* fetch the currently selected list item which
 * will be our next prisoner ;)
 */
dlist=GTK_LIST(gtklist)->selection;
if (dlist)
new_prisoner=GTK_WIDGET(dlist->data);
else
new_prisoner=NULL;
/* look for already prisoned list items, we
 * will put them back into the list
 * remember to free the doubly linked list that
 * gtk_container_children() returns
 */
dlist=gtk_container_children(GTK_CONTAINER(frame));
free_list=dlist;
while (dlist) {
GtkWidget*list_item;
list_item=dlist->data;
gtk_widget_reparent(list_item, gtklist);
dlist=dlist->next;
}
g_list_free(free_list);
/* if we have a new prisoner, remove him from the
 * GtkList and put him into the frame "Prison"
 * we need to unselect the item before
 */
if (new_prisoner) {
GListstatic_dlist;
static_dlist.data=new_prisoner;
static_dlist.next=NULL;
static_dlist.prev=NULL;
gtk_list_unselect_child(GTK_LIST(gtklist),
new_prisoner);
gtk_widget_reparent(new_prisoner, frame);
}
}
}
/* this is the signal handler that gets called if GtkList
 * emits the "selection_changed" signal
 */
void
sigh_print_selection(GtkWidget*gtklist,
 gpointerfunc_data)
{
GList*dlist;
/* fetch the doubly linked list of selected items
 * of the GtkList, remember to treat this as read-only!
 */
dlist=GTK_LIST(gtklist)->selection;
/* if there are no selected items there is nothing more
 * to do than just telling the user so
 */
if (!dlist) {
g_print("Selection cleared
");
return;
}
/* ok, we got a selection and so we print it
 */
g_print("The selection is a ");
/* get the list item from the doubly linked list
 * and then query the data associated with list_item_data_key
 * we then just print it
 */
while (dlist) {
GtkObject*list_item;
gchar*item_data_string;
list_item=GTK_OBJECT(dlist->data);
item_data_string=gtk_object_get_data(list_item,
 list_item_data_key);
g_print("%s ", item_data_string);
dlist=dlist->next;
}
g_print("
");
}


 如果您对本文有任何疑问或者建议,请到讨论区发表您的意见: >> 论坛入口 <<



上一篇:GTK+/Gnome应用开发   下一篇:GTK v1.2 Tutorial(英文)

文章评论】 【收藏本文】 【推荐好友】 【打印本文】 【我要投稿】 【论坛讨论
更多相关文章
Power by linux-cn.com 粤ICP备05006655号