| 리눅스 기타 자료 |
|---|
|
|
|
| 제목 | gtk 강좌 #7 1998/07/10 (17:33) |
| 이름 | 김효원 |
| 번호 | 91 |
| 조회 | 270 |
| 본문 |
『리눅스 학당-번역물 (go LINUX)』 203번 제 목:[번역] gtk Tutorial, Chap10~15입니다. 올린이:중앙자대(이훈 ) 98/03/11 15:32 읽음:167 관련자료 없음 ----------------------------------------------------------------------------- ***************** *** 10. 파일 선택 ***************** 파일선택 widget은 파일 대화상자를 보이는 빠르고 간편한 것이다. 이것은 Ok, Cancel, Help 버튼을 가지고 있으며, 프로그래밍 시간을 상당히 줄여준다. 새로운 파일선택 박스를 만들려면 이것을 이용한다. GtkWidget* gtk_file_selection_new (gchar *title); 파일이름을 세팅하기 위해서 이 함수를 이용한다. void gtk_file_selection_set_filename (GtkFileSelection *filesel, gchar *filename); 사용자가 키보드 혹은 마우스 클릭으로 입력한 텍스트를 포착하기 위해서는 이 함수를 쓴다. gchar* gtk_file_selection_get_filename (GtkFileSelection *filesel); 파일선택widget 내부에 포함된 widget들에 대한 포인터들도 있다. 그들은 다음과 같다. o dir_list o file_list o selection_entry o selection_text o main_vbox o ok_button o cancel_button o help_button 우리가 가장 많이 이용하게 될 것은 ok_button, cancel_button, 그리고 help_button 포인터가 될 것이다. 이것은 testgtk.c 에서 발췌한 것을 목적에 의해 변형한 것이다. 보면 알겠지만, 여기서는 파일선택widget을 하나 만들 뿐이다. Help 버튼이 스크린에 보이겠지만, 아무런 시그널이 연결되어 있지 않으므로 아무 기능이 없을 것이다. #include <gtk/gtk.h> /* 선택된 파일 이름을 취해서 그것을 콘솔로 프린트한다. */ void file_ok_sel (GtkWidget *w, GtkFileSelection *fs) { g_print ("%s\n", gtk_file_selection_get_filename (GTK_FILE_SELECTION (fs))); } void destroy (GtkWidget *widget, gpointer *data) { gtk_main_quit (); } int main (int argc, char *argv[]) { GtkWidget *filew; gtk_init (&argc, &argv); /* 파일선택 widget을 하나 만든다. */ filew = gtk_file_selection_new ("File selection"); gtk_signal_connect (GTK_OBJECT (filew), "destroy", (GtkSignalFunc) destroy, &filew); /* file_ok_sel 함수로 ok_button을 연결시킨다. */ gtk_signal_connect (GTK_OBJECT (GTK_FILE_SELECTION (filew)->ok_button), "clicked", (GtkSignalFunc) file_ok_sel, filew ); /* gtk_widget_destroy 함수로 cancel_button을 연결시킨다. */ gtk_signal_connect_object (GTK_OBJECT (GTK_FILE_SELECTION (filew)->cancel_button), "clicked", (GtkSignalFunc) gtk_widget_destroy, GTK_OBJECT (filew)); /* 파일이름을 세팅한다. */ gtk_file_selection_set_filename (GTK_FILE_SELECTION(filew), "penguin.png"); gtk_widget_show(filew); gtk_main (); return 0; } ******************* *** 11. 메뉴 widget ******************* 메뉴를 만들기 위해 쉬운 방법과 어려운 방법 두가지가 있다. 각각 쓰일 데가 있는 것들이지만, 우리는 보통 쉬운 방법으로 menu_factory를 쓰는 쪽을 택할 것이다. "어려운" 방법이란 함수를 이용해서 직접적으로 메뉴를 만드는 것이다. 그리고 쉬운 방법은 gtk_menu_factory 함수들을 쓰는 것이다. 이것은 훨씬 간단하지만, 나름대로 장점과 단점을 가지고 있다. 수동적인 방법으로 몇 가지 wrapper 함수들을 써 가며 메뉴를 만드는 것이 유용성에 있어서 훨씬 유리함에도 불구하고, menufactory를 이용하는 방법은 훨씬 사용하기 쉽고 또 새로운 메뉴를 추가하기도 쉽다. Menufactory를 이용하게 되면, 메뉴에 이미지라든가 '/'를 쓰는 것이 불가능해진다. *** *** 11-1. 수동적으로 메뉴 만들기 *** 교육의 바람직한 전통에 따라, 먼저 어려운 방법부터 보이겠다. :) 메뉴를 만들기 위해 쓰이는 함수들을 살펴보자. 이 첫번째 함수는 새로운 메뉴를 만들기 위해 쓰인다. GtkWidget *gtk_menu_bar_new() 이것은 이름 그대로 새로운 메뉴바를 만든다. 버튼과 마찬가지로, 우리는 이것을 윈도에 패킹하기 위해 gtk_container_add를 이용할수도 있고, 또는 박스에 패킹하기 위해 box_pack 함수들을 이용할 수 있다. GtkWidget *gtk_menu_new(); 이 함수는 새로운 메뉴를 향한 포인터를 리턴하는데, 이것은 실제로 보여지지는 않고(gtk_widget_show로써) 다만 메뉴 아이템들을 가지고만 있다. 이 아래에 나오는 예제를 보며 더 명확히 이해하기를 바란다. 이번의 두 함수는 메뉴 안으로 패킹되는 메뉴 아이템을 만들기 위해 쓰인다. GtkWidget *gtk_menu_item_new() GtkWidget *gtk_menu_item_new_with_label(const char *label) 이 함수들은 보여지기 위한 메뉴를 만들 때 쓰인다. gtk_menu_new로써 만들어지는 "메뉴"와 gtk_menu_item_new로써 만들어지는 "메뉴 아이템"을 꼭 구별해야 한다. 메뉴 아이템은 연결된 동작이 있는 실제의 버튼이 될 것이지만, 반면 메뉴는 이것들을 가지고 있는 컨테이너가 될 것이다. gtk_menu_item_append() gtk_menu_item_set_submenu() gtk_menu_new_with_label과 단순한 gtk_menu_new 함수는 여러분이 버튼에 대해 공부한 후에 짐작하는 그대로다. gtk_menu_new_with_label은 라벨이 이미 패킹되어 있는 메뉴 아이템을 만들고, gtk_menu_new는 비어있는 메뉴 아이템을 만든다. 이것은 메뉴들이 달려있는 메뉴바를 만드는 단계들이다. o gtk_menu_new()를 이용해서 새로운 메뉴를 만든다. o gtk_menu_item_new()를 이용해서 메뉴 아이템을 만든다. 이것은 root 메뉴가 되고, 여기의 텍스트는 메뉴바 자신의 이름이 될 것이다. o 각 아이템마다 gtk_menu_item_new()를 이용해 원하는 메뉴를 구성한다. 그리고 이것들 각각에 새로운 아이템을 붙이기 위해 gtk_menu_item_append() 를 쓴다. 이렇게 메뉴 아이템의 리스트를 만든다. o 새롭게 만들어지는 메뉴 아이템을 root 메뉴 아이템(두번째 단계에 있는) 에 붙여주기 위해 gtk_menu_item_set_submenu()를 이용한다. o gtk_menu_bar_new()를 이용해서 새로운 메뉴바를 만든다. 이 단계는 한 메뉴바 위로 일련의 메뉴를 만들 때만 필요하다. o gtk_menu_bar_append()를 이용해서 메뉴바 위에 root 메뉴를 놓는다. 팝업메뉴를 만드는 것도 거의 같다. 다른 점이 있다면 메뉴는 메뉴바에 의해 자동적으로 붙여지는 것이 아니라, button_press 이벤트로부터 gtk_menu_popup() 함수를 호출함으로써 붙여진다는 것이다. 이 과정을 따라보자. o 이벤트 핸들링 함수를 만든다. 이것은 이런 원형을 가져야 한다. static gint handler(GtkWidget *widget, GdkEvent *event); 그리고 이것은 메뉴를 팝업시킬 곳을 찾기 위해 이벤트를 이용할 것이다. o 이벤트 핸들러에서는, 만약 이벤트가 마우스 버튼을 누르는 것이라면, 이벤트를 버튼 이벤트로 다루고, gtk_menu_popup()에 정보를 넘겨주는 예제 코드에서 보인대로 이용하라. o 이 함수를 이용하여 이벤트 핸들러를 widget에 결합시킨다. gtk_signal_connect_object(GTK_OBJECT(widget), "event", GTK_SIGNAL_FUNC (handler), GTK_OBJECT(menu)); 여기서 widget 인자는 우리가 바인딩할 widget이고, handler 인자는 핸들링 함수다. 그리고 menu 인자는 gtk_menu_new()로써 만들어진 메뉴다. 예제 코드에서 보인대로, 이것은 메뉴바에 붙여져 있는 메뉴가 될 수도 있다. *** *** 11-2. 수동으로 메뉴를 만드는 예제 *** 이제 분명히 해두기 위해 예제를 보도록 하자. #include <gtk/gtk.h> static gint button_press (GtkWidget *, GdkEvent *); static void menuitem_response (GtkWidget *, gchar *); int main (int argc, char *argv[]) { GtkWidget *window; GtkWidget *menu; GtkWidget *menu_bar; GtkWidget *root_menu; GtkWidget *menu_items; GtkWidget *vbox; GtkWidget *button; char buf[128]; int i; gtk_init (&argc, &argv); /* 윈도를 만든다. */ window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_window_set_title(GTK_WINDOW (window), "GTK Menu Test"); gtk_signal_connect(GTK_OBJECT (window), "delete_event", (GtkSignalFunc) gtk_exit, NULL); /* menu-widget을 시작한다. 여기서 메뉴 widget들에 대해 * gtk_show_widget()을 쓰면 안된다! * 이것은 메뉴 아이템을 가지고 있는 메뉴고, 우리가 어플에서 * "Root Menu"를 클릭했을 때 팝업될 것이다. */ menu = gtk_menu_new(); /* 이것은 root 메뉴며, 메뉴바에 나타날 메뉴의 이름 즉 라벨이 * 될 것이다. 이것은 단지 눌러졌을 때 메뉴의 나머지 부분이 * 팝업되기만 할 것이므로 특별히 시그널 핸들러가 결합되어 * 있을 필요는 없다. */ root_menu = gtk_menu_item_new_with_label("Root Menu"); gtk_widget_show(root_menu); /* 다음으로 우리는 세 메뉴엔트리를 만들기 위해 작은 루프를 * 구현한다. 보통이라면, 우리는 각 메뉴 아이템들에 대해 * "clicked" 시그널을 잡아낼 것이고, 그것을 위해 callback을 * 세팅할 것이다. 그러나 공간을 절약하기 위해 그 과정은 * 생략한다. */ for(i = 0; i < 3; i++) { /* buf로 메뉴 이름을 복사한다. */ sprintf(buf, "Test-undermenu - %d", i); /* 이름을 가진 새 메뉴 아이템을 만든다. */ menu_items = gtk_menu_item_new_with_label(buf); /* 이것을 메뉴에 첨가한다. */ gtk_menu_append(GTK_MENU (menu), menu_items); /* 메뉴 아이템이 선택되면 뭔가 쓸만한 동작을 시킨다. */ gtk_signal_connect (GTK_OBJECT(menu_items), "activate", GTK_SIGNAL_FUNC(menuitem_response), (gpointer) g_strdup(buf)); /* widget을 보인다. */ gtk_widget_show(menu_items); } /* 이제 우리의 새롭게 만들어진 "menu"를, "root menu"가 되도록 * 설정해 보자. */ gtk_menu_item_set_submenu(GTK_MENU_ITEM (root_menu), menu); /* 메뉴와 버튼을 들여놓을 vbox */ vbox = gtk_vbox_new(FALSE, 0); gtk_container_add(GTK_CONTAINER(window), vbox); gtk_widget_show(vbox); /* 메뉴를 담고 있을 menu-bar를 만들고 그것을 우리의 main 윈도에 * 추가한다. */ menu_bar = gtk_menu_bar_new(); gtk_box_pack_start(GTK_BOX(vbox), menu_bar, FALSE, FALSE, 2); gtk_widget_show(menu_bar); /* 메뉴를 팝업시키도록 연결될 한 버튼을 만든다. */ button = gtk_button_new_with_label("press me"); gtk_signal_connect_object(GTK_OBJECT(button), "event", GTK_SIGNAL_FUNC (button_press), GTK_OBJECT(menu)); gtk_box_pack_end(GTK_BOX(vbox), button, TRUE, TRUE, 2); gtk_widget_show(button); /* 끝으로 menu-item을 menu-bar에 이어준다. 이것이 바로 * 내가 지금껏 지껄여 온 "root" 메뉴 아이템이다. =) */ gtk_menu_bar_append(GTK_MENU_BAR (menu_bar), root_menu); /* 언제나 전체 윈도를 마지막에 보여준다. */ gtk_widget_show(window); gtk_main (); return 0; } /* "widget"으로 넘겨받은 메뉴를 보임으로써 button-press에 응답한다. * * 인자 "widget"은 눌려진 버튼이 아니라 보여질 메뉴라는 걸 기억하자. */ static gint button_press (GtkWidget *widget, GdkEvent *event) { if (event->type == GDK_BUTTON_PRESS) { GdkEventButton *bevent = (GdkEventButton *) event; gtk_menu_popup (GTK_MENU(widget), NULL, NULL, NULL, NULL, bevent->button, bevent->time); /* 우리가 이 이벤트를 다루었음을 말한다. 여기서 멈춘다. */ return TRUE; } /* 우리가 이 이벤트를 다루지 않았음을 말한다. 계속 지나친다. */ return FALSE; } /* 메뉴 아이템이 선택되었을 때 문자열을 프린트한다. */ static void menuitem_response (GtkWidget *widget, gchar *string) { printf("%s\n", string); } 우리는 또한 메뉴 아이템을 반응을 보이지 않게도 만들 수 있고, 표를 참조 해서 메뉴 함수들에 키보드 바인딩을 해줄 수도 있다. *** *** 11-3. GtkMenuFactory를 이용하기 *** 이제 어려운 방법을 보였고, gtk_menu_factory 함수들을 이용하는 방법이 여기 있다. *** *** 11-4. Menu factory의 예제 *** 이것은 GTK menu factory를 이용하는 예제이다. 이것은 첫번째 파일 menus.h 다. 우리는 menus.c에서 쓰인 global변수들을 고려해서 menus.c 와 main.c를 분리할 것이다. #ifndef __MENUS_H__ #define __MENUS_H__ #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ void get_main_menu (GtkWidget **menubar, GtkAcceleratorTable **table); void menus_create(GtkMenuEntry *entries, int nmenu_entries); #ifdef __cplusplus } #endif /* __cplusplus */ #endif /* __MENUS_H__ */ 그리고 이것은 menus.c 파일이다. #include <gtk/gtk.h> #include <strings.h> #include "main.h" static void menus_remove_accel(GtkWidget * widget, gchar * signal_name, gchar * path); static gint menus_install_accel(GtkWidget * widget, gchar * signal_name, gchar key, gchar modifiers, gchar * path); void menus_init(void); void menus_create(GtkMenuEntry * entries, int nmenu_entries); /* 이것은 새로운 메뉴를 만들기 위해 쓴 GtkMenuEntry 구조체다. * 첫번째 멤버는 메뉴를 정의하는 문자열이다. 두번째는 이 메뉴함수를 * 키보드로 불러낼 때 쓰이는 디폴트 단축키다. 세번째 멤버는 이 메뉴 * 아이템이 선택되었을(마우스 혹은 단축키로써) 때 호출될 callback 함수다. * 그리고 마지막 멤버는 이 callback함수에 넘겨질 데이터다. */ static GtkMenuEntry menu_items[] = { {"<Main>/File/New", "<control>N", NULL, NULL}, {"<Main>/File/Open", "<control>O", NULL, NULL}, {"<Main>/File/Save", "<control>S", NULL, NULL}, {"<Main>/File/Save as", NULL, NULL, NULL}, {"<Main>/File/<separator>", NULL, NULL, NULL}, {"<Main>/File/Quit", "<control>Q", file_quit_cmd_callback, "OK, I'll quit"}, {"<Main>/Options/Test", NULL, NULL, NULL} }; /* 메뉴 아이템의 갯수를 계산한다. */ static int nmenu_items = sizeof(menu_items) / sizeof(menu_items[0]); static int initialize = TRUE; static GtkMenuFactory *factory = NULL; static GtkMenuFactory *subfactory[1]; static GHashTable *entry_ht = NULL; void get_main_menu(GtkWidget ** menubar, GtkAcceleratorTable ** table) { if (initialize) menus_init(); if (menubar) *menubar = subfactory[0]->widget; if (table) *table = subfactory[0]->table; } void menus_init(void) { if (initialize) { initialize = FALSE; factory = gtk_menu_factory_new(GTK_MENU_FACTORY_MENU_BAR); subfactory[0] = gtk_menu_factory_new(GTK_MENU_FACTORY_MENU_BAR); gtk_menu_factory_add_subfactory(factory, subfactory[0], "<Main>"); menus_create(menu_items, nmenu_items); } } void menus_create(GtkMenuEntry * entries, int nmenu_entries) { char *accelerator; int i; if (initialize) menus_init(); if (entry_ht) for (i = 0; i < nmenu_entries; i++) { accelerator = g_hash_table_lookup(entry_ht, entries[i].path); if (accelerator) { if (accelerator[0] == '\0') entries[i].accelerator = NULL; else entries[i].accelerator = accelerator; } } gtk_menu_factory_add_entries(factory, entries, nmenu_entries); for (i = 0; i < nmenu_entries; i++) if (entries[i].widget) { gtk_signal_connect(GTK_OBJECT(entries[i].widget), "install_accelerator", (GtkSignalFunc) menus_install_accel, entries[i].path); gtk_signal_connect(GTK_OBJECT(entries[i].widget), "remove_accelerator", (GtkSignalFunc) menus_remove_accel, entries[i].path); } } static gint menus_install_accel(GtkWidget * widget, gchar * signal_name, gchar key, gchar modifiers, gchar * path) { char accel[64]; char *t1, t2[2]; accel[0] = '\0'; if (modifiers & GDK_CONTROL_MASK) strcat(accel, "<control>"); if (modifiers & GDK_SHIFT_MASK) strcat(accel, "<shift>"); if (modifiers & GDK_MOD1_MASK) strcat(accel, "<alt>"); t2[0] = key; t2[1] = '\0'; strcat(accel, t2); if (entry_ht) { t1 = g_hash_table_lookup(entry_ht, path); g_free(t1); } else entry_ht = g_hash_table_new(g_string_hash, g_string_equal); g_hash_table_insert(entry_ht, path, g_strdup(accel)); return TRUE; } static void menus_remove_accel(GtkWidget * widget, gchar * signal_name, gchar * path) { char *t; if (entry_ht) { t = g_hash_table_lookup(entry_ht, path); g_free(t); g_hash_table_insert(entry_ht, path, g_strdup("")); } } void menus_set_sensitive(char *path, int sensitive) { GtkMenuPath *menu_path; if (initialize) menus_init(); menu_path = gtk_menu_factory_find(factory, path); if (menu_path) gtk_widget_set_sensitive(menu_path->widget, sensitive); else g_warning("Unable to set sensitivity for menu which doesn't exist: %s", path); } 이것은 main.h다. #ifndef __MAIN_H__ #define __MAIN_H__ #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ void file_quit_cmd_callback(GtkWidget *widget, gpointer data); #ifdef __cplusplus } #endif /* __cplusplus */ #endif /* __MAIN_H__ */ 그리고 이것이 main.c다. #include <gtk/gtk.h> #include "main.h" #include "menus.h" int main(int argc, char *argv[]) { GtkWidget *window; GtkWidget *main_vbox; GtkWidget *menubar; GtkAcceleratorTable *accel; gtk_init(&argc, &argv); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_signal_connect(GTK_OBJECT(window), "destroy", GTK_SIGNAL_FUNC(file_quit_cmd_callback), "WM destroy"); gtk_window_set_title(GTK_WINDOW(window), "Menu Factory"); gtk_widget_set_usize(GTK_WIDGET(window), 300, 200); main_vbox = gtk_vbox_new(FALSE, 1); gtk_container_border_width(GTK_CONTAINER(main_vbox), 1); gtk_container_add(GTK_CONTAINER(window), main_vbox); gtk_widget_show(main_vbox); get_main_menu(&menubar, &accel); gtk_window_add_accelerator_table(GTK_WINDOW(window), accel); gtk_box_pack_start(GTK_BOX(main_vbox), menubar, FALSE, TRUE, 0); gtk_widget_show(menubar); gtk_widget_show(window); gtk_main(); return(0); } /* 여기서는 menufactory를 이용할 때 callback들이 어떻게 작동하는지를 * 보여준다. 종종, 사람들은 메뉴들로부터의 모든 callback을 별도의 파일에 * 모아두고, 거기서 적절한 함수를 호출해 쓰는 방법을 택하기도 한다. */ void file_quit_cmd_callback (GtkWidget *widget, gpointer data) { g_print ("%s\n", (char *) data); gtk_exit(0); } 그리고 컴파일을 쉽게 해주는 makefile이다. CC = gcc PROF = -g C_FLAGS = -Wall $(PROF) -L/usr/local/include -DDEBUG L_FLAGS = $(PROF) -L/usr/X11R6/lib -L/usr/local/lib L_POSTFLAGS = -lgtk -lgdk -lglib -lXext -lX11 -lm PROGNAME = at O_FILES = menus.o main.o $(PROGNAME): $(O_FILES) rm -f $(PROGNAME) $(CC) $(L_FLAGS) -o $(PROGNAME) $(O_FILES) $(L_POSTFLAGS) $(CC) -c $(C_FLAGS) $< clean: rm -f core *.o $(PROGNAME) nohup.out distclean: clean rm -f *~ ******************************** *** 12. 문서화되지 않은 widget들 ******************************** 이들은 모두 저자를 기다리고 있다! :) 우리의 이 문서에 당신이 공헌해 보는 것도 고려해 보기를. 만약 당신이 문서화되지 않은 이 widget을 쓰게 된다면, GTK 배포판에 있는 그들 각각의 헤더파일을 살펴보기를 적극 권장한다. GTK의 함수이름들은 매우 서술적이다. 일단 무엇이 어떻게 작동하는지 이해한다면, 어떤 widget과 관련된 함수의 선언만 보더라도 그 widget을 어떻게 이용하는지 쉽게 알 수 있을 것이다. 만약 여러분이 문서화되지 않은 widget의 모든 함수들을 이해하게 되면, 당신이 tutorial을 써서 다른 사람들에게 도움을 주는 것을 고려해 줬으면 한다. *** *** 12-1. Text Entries *** 12-2. Color Selections *** 12-3. Range Controls *** 12-4. Rulers *** 12-5. Text Boxes *** 12-6. Previews *** |
|
|
|