리눅스 기타 자료

제목	gtk 강좌 #11 1998/07/10 (17:34)
이름	김효원
번호	95
조회	336
본문	『리눅스 학당-번역물 (go LINUX)』 207번 제  목:[번역] gtk Tutorial, Chap19입니다.                           올린이:중앙자대(이훈    )    98/03/12 19:53    읽음:206 관련자료 없음 ----------------------------------------------------------------------------- ****************************** *** 19. 자신만의 widget 만들기 ****************************** *** *** 19-1. 개요 ***  비록 GTK 배포판에 포함되어 있는 수많은 widget들이 대부분의 기본적인 요구사항을 충족시켜 주지만, 언젠가 스스로 새로운 widget을 만들어야 할 때가 올 것이다.  GTK가 widget의 상속을 광범위하게 이용하고 또 이 만들어져 있는 widget들이 여러분의 요구에 근접한 것들이기 때문에, 유용하고 새로운 widget을 만드는 것도 단지 몇 줄의 코드로써 가능할 수도 있다.  그러나 새로운 widget을 만드는 작업을 시작하기 전에, 먼저 누군가 그것을 이미 만들어 놓지 않았는지 체크하자.  이렇게 해서 노력의 중복을 막고 또 GTK widget의 갯수를 최소한으로 유지할 수 있다.  이것은 서로 다른 어플들 사이에서 코드와 인터페이스 모두의 통일성을 유지하는 것이다.  이렇게 하는 한가지 방법으로, 만약 여러분이 자신만의 widget을 완성하게 되면, 그것을 다른 사람들 모두 이용할 수 있게 세계에 널리 알리자.  이렇게 할 수 있는 가장 좋은 장소는 아마 gtk-list일 것이다. *** *** 19-2. Widget의 구조 ***  새로운 widget을 만드는 데 있어서, GTK object들이 어떻게 동작하는지 이해 하는 것이 중요할 것이다.  이번 섹션은 단지 짧막한 개요만을 소개하고자 한다. 자세한 것은 참고 문서를 보라.  GTK widget들은 객체지향적 방법을 지향한다.  그러나, 그들은 표준 C로 쓰여진다.  이것은 현재 수준의 C++ 컴파일러를 쓰는 것보다 이식성과 안정성을 크게 향상시킨다.  하지만 이것은 widget 작성자가 몇몇 세부적인 곳에 주의를 기울여야만 하는 것을 의미한다.  한 클래스의 widget들(예를들자면 모든 Button widget들)의 instance들 모두에 공통적인 정보는 class structure에 저장되어 있다.  이 class의 시그널들은 함수에 대한 포인터, 즉 callback 함수로 처리 되고, C++에서의 virtual 함수처럼 하나의 복사본만이 존재해 준다.  상속을 지원하기 위해서, class structure의 첫번째 필드는 parent class structure의 copy가 되어야 한다.  GtkButton이라는 class structure의 선언은 이렇게 된다.         struct _GtkButtonClass       {         GtkContainerClass parent_class;         void (* pressed)  (GtkButton *button);         void (* released) (GtkButton *button);         void (* clicked)  (GtkButton *button);         void (* enter)    (GtkButton *button);         void (* leave)    (GtkButton *button);       };  버튼이 하나의 컨테이너로 다루어진다면(예를들어, resize되었을 때), 그것의 class structure는 GtkContainerClass로 캐스트될 수 있고, 또 시그널들을 다루기 위해 관련된 필드들이 쓰이게 된다.  하나의 instance basis를 기반으로 한 각각의 widget들을 위한 구조체도 있다. 이 구조체는 어떤 widget의 각각의 instance를 위한 서로 다른 정보를 가지고 있다.  우리는 이 구조체를 object structure라고 부를 것이다.  버튼 클래스를 예로 든다면 이렇게 된다.       struct _GtkButton       {         GtkContainer container;         GtkWidget *child;         guint in_button : 1;         guint button_down : 1;       };  Class structure에서와 마찬가지로 첫번째 필드는 parent class의 object structure임을 주의하라.  그래서 이 구조체는 필요할 경우 parent class의 object로 캐스트될 수도 있는 것이다. *** *** 19-3. Composite(합성,혼성) widget 만들기 *** *** *** 19-3.1. 소개 ***  우리가 만들고자 하는 어떤 widget은 단지 다른 GTK widget들의 집합체일 뿐일 수도 있다.  이런 widget은 꼭 새로운 것으로 만들어져야 할 것은 아니지만, 재사용성을 위해 사용자 인터페이스적인 요소들을 패키징하는 데 있어 편리한 방식을 제공한다.  표준 GTK 배포판에 있는 FileSelection과 ColorSelection widget이 예가 될 것이다.  우리가 여기서 만들려는 예제는 Tictactoe widget으로, 토글버튼의 3x3 배열 에서 어느 한 행 또는 열 또는 대각성분 모두가 눌러지게 되면 시그널을 내보낸 다. *** *** 19-3.2. Parent class를 고르기 ***  전형적으로 composite widget의 parent class는 그 composite widget의 모든 멤버들을 가지고 있는 컨테이너 클래스이다.  예를들어, FileSelection widget의 parent class는 Dialog 클래스이다.  우리 버튼들은 table 안에 늘어서 있을 것 이므로, parent class로 GtkTable 클래스가 되는 것이 자연스럽다.  불행히도, 이것은 동작하지 않는다.  한 widget을 만드는 것은 두 함수에 의한 것으로 나뉜다.  WIDGETNAME_new() 함수를 사용자가 부르고, 그리고 WIDGETNAME_init() 함수는 _new()함수의 인자로 주어진 widget들에 대한 기본적인 초기화 작업을 한다.  Descendent widget들은 단지 그들의 parent widget의 _init()함수만 부르게 된다.  그러나 이 작업 분할은 테이블에 대해서는 잘 동작하지 않는다. 테이블의 경우에는 만들어질 때 행과 열의 갯수를 알 필요성이 있기 때문이다. 그렇지 않으면 우리는 이 Tictactoe widget에 있는 gtk_table_new()의 대부분의 기능들을 중복해서 이용하게 될 것이다.  그러므로, 우리는 대신 그것을 GtkVBox 로부터 이끌어내어, 우리의 테이블을 VBox 내부로 붙여줄 것이다. *** *** 19-3.3. 헤더 파일 ***  각각의 widget class는 public 함수와 구조체 및 객체의 선언들이 있는 헤더 파일을 가지고 있다.  여기서 간단히 살펴보자.  중복 정의를 피하기 위해서, 우리는 헤더파일 전체를 이렇게 둘러싼다.  #ifndef __TICTACTOE_H__  #define __TICTACTOE_H__  #endif /* __TICTACTOE_H__ */  그리고 C++ 프로그램을 고려해서 이것도 추가한다.       #ifdef __cplusplus       extern "C" {       #endif /* __cplusplus */       #ifdef __cplusplus       }       #endif /* __cplusplus */  함수와 구조체들에 대해, 우리는 헤더파일 내에서 세가지 표준적인 매크로를 선언한다.  즉 TICTACTOE(obj), TICTACTOE_CLASS(klass), IS_TICTACTOE(obj)이다. 이들은 어떤 한 포인터를 object 혹은 class structure에 대한 포인터로 캐스트 하고, 어떤 object가 Tictactoe widget인지를 체크하는 역할을 한다.  이것이 최종적인 헤더파일이다.  #ifndef __TICTACTOE_H__  #define __TICTACTOE_H__  #include <gdk/gdk.h>  #include <gtk/gtkvbox.h>  #ifdef __cplusplus  extern "C" {  #endif /* __cplusplus */  #define TICTACTOE(obj)          GTK_CHECK_CAST (obj, tictactoe_get_type (), Tictactoe)  #define TICTACTOE_CLASS(klass)  GTK_CHECK_CLASS_CAST (klass, tictactoe_get_type (), TictactoeClass)  #define IS_TICTACTOE(obj)       GTK_CHECK_TYPE (obj, tictactoe_get_type ())  typedef struct _Tictactoe       Tictactoe;  typedef struct _TictactoeClass  TictactoeClass;  struct _Tictactoe  {    GtkVBox vbox;    GtkWidget *buttons[3][3];  };  struct _TictactoeClass  {    GtkVBoxClass parent_class;    void (* tictactoe) (Tictactoe *ttt);  };  guint          tictactoe_get_type        (void);  GtkWidget*     tictactoe_new             (void);  void           tictactoe_clear           (Tictactoe *ttt);  #ifdef __cplusplus  }  #endif /* __cplusplus */  #endif /* __TICTACTOE_H__ */ *** *** 19-3.4. _get_type() 함수 ***  이제 우리의 widget을 계속 다듬어 보자.  모든 widget들에 대한 핵심(core) 함수는 WIDGETNAME_get_type()이다.  이 함수는 처음 호출되었을 때, GTK에게 widget class에 대해 알려준다.  그리고 widget class를 명확히 식별하는 ID를 취한다.  계속 호출하면 바로 그 ID를 리턴한다.  guint  tictactoe_get_type ()  {    static guint ttt_type = 0;    if (!ttt_type)      {        GtkTypeInfo ttt_info =        {          "Tictactoe",          sizeof (Tictactoe),          sizeof (TictactoeClass),          (GtkClassInitFunc) tictactoe_class_init,          (GtkObjectInitFunc) tictactoe_init,          (GtkArgFunc) NULL,        };        ttt_type = gtk_type_unique (gtk_vbox_get_type (), &ttt_info);      }    return ttt_type;  }  구조체 GtkTypeInfo는 다음과 같이 정의되었다.       struct _GtkTypeInfo       {         gchar *type_name;         guint object_size;         guint class_size;         GtkClassInitFunc class_init_func;         GtkObjectInitFunc object_init_func;         GtkArgFunc arg_func;       };  이 구조체의 각 필드는 역시 보이는 그대로다.  우리는 여기서 arg_func 필드 를 무시할 것이다.  이것은 인터프리터 언어에서 비롯되어 widget 옵션들을 편리하게 세팅할 수 있도록 하는 중요한 역할을 할 수 있지만, 아직은 대개 갖추어지지 않았다.  일단 GTK가 이 구조체의 제대로 된 복사본을 가지게 되면, 그것은 특별한 widget type의 object를 만드는 방법을 알게 된다. *** *** 19-3.5. _class_init() 함수 ***  WIDGETNAME_class_init() 함수는 widget의 class structure에 있는 필드들을 초기화하고, 그 클래스에 대한 시그널들도 셋업해 준다.  우리의 Tictactoe widget에 대해서 이것은 이렇게 보여진다.  enum {    TICTACTOE_SIGNAL,    LAST_SIGNAL  };  static gint tictactoe_signals[LAST_SIGNAL] = { 0 };  static void  tictactoe_class_init (TictactoeClass *class)  {    GtkObjectClass *object_class;    object_class = (GtkObjectClass*) class;    tictactoe_signals[TICTACTOE_SIGNAL] = gtk_signal_new ("tictactoe",                                           GTK_RUN_FIRST,                                           object_class->type,                                           GTK_SIGNAL_OFFSET (TictactoeClass, tictactoe),                                           gtk_signal_default_marshaller, GTK_ARG_NONE, 0);    gtk_object_class_add_signals (object_class, tictactoe_signals, LAST_SIGNAL);    class->tictactoe = NULL;  }  우리 widget이 가진 유일한 시그널은 'tictactoe' 시그널로, 이것은 한 행, 열, 혹은 대각 성분이 완전히 채워지면 요구된다.  모든 합성 widget들이 시그널 을 필요로 하는 것은 아니며, 따라서 여러분이 이 부분을 처음 읽고 있는 상태 라면 다음 섹션(section)으로 넘어가도 좋다.  이 부분은 다소 복잡할 것이기 때문이다.  이 함수를 보자.       gint   gtk_signal_new (gchar               *name,                              GtkSignalRunType     run_type,                              gint                 object_type,                              gint                 function_offset,                              GtkSignalMarshaller  marshaller,                              GtkArgType           return_val,                              gint                 nparams,                              ...);  새로운 시그널을 만든다.  여기에 쓰인 인자들을 살펴보자.  o name: 시그널의 이름  o run_type: 디폴트 핸들러가 사용자 핸들러보다 앞서서 혹은    뒤따라 작동하는지 결정한다.  다른 가능성들도 있지만, 보통    이것은 GTK_RUN_FIRST 또는 GTK_RUN_LAST가 된다.  o object_type: 이 시그널이 적용될 object의 ID. (이 object의    descendents에도 적용됨)  o function_offset: 디폴트 핸들러를 가리키는 포인터의    class structure 내에서의 옵셋.  o marshaller: 시그널 핸들러를 불러내기 위해 쓰이는 함수.    시그널과 사용자 데이터를 발생한 object만을 인자로 가지는    시그널 핸들러일 경우, 우리는 이미 제공되는 marshaller 함수인    gtk_signal_default_marshaller를 이용할 수 있다.  o return_val: 리턴값의 타입.  o nparams: 시그널 핸들러의 인자 갯수. (위에서 언급된 두 디폴트    인자 이외의 다른 것들)  타입을 설정하기 위해, GtkArgType이라는 enumeration이 쓰인다.       typedef enum       {         GTK_ARG_INVALID,         GTK_ARG_NONE,         GTK_ARG_CHAR,         GTK_ARG_SHORT,         GTK_ARG_INT,         GTK_ARG_LONG,         GTK_ARG_POINTER,         GTK_ARG_OBJECT,         GTK_ARG_FUNCTION,         GTK_ARG_SIGNAL       } GtkArgType;  gtk_signal_new()는 시그널에 대해 고유한 정수 식별자를 리턴한다.  우리는 이들을 tictactoe_signals 배열에 저장하고, enumeration로 이용해서 인덱스를 준다. (관습적으로 enumeration의 원소들은 대문자로 시그널의 이름을 나타내 지만, 여기서 TICTACTOE() 매크로와 충돌할 수 있기 때문에, 우리는 이들을 TICTACTOE_SIGNAL이라고 부른다.)  시그널을 만들었다면, 이제 GTK가 이 시그널들을 Tictactoe 클래스에 연결시키 도록 해야 한다.  이 작업은 gtk_object_class_add_signals()로 해준다.  그리고 아무런 디폴트 동작이 없다는 걸 나타내기 위해, tictactoe 시그널을 위한 디폴트 핸들러를 가리키고 있는 포인터를 NULL로 세팅한다. *** *** 19-3.6. _init() 함수 ***  각 widget 클래스는 또한 object structure를 초기화해 줄 함수를 필요로 한다. 보통, 이 함수는 구조체의 필드들을 디폴트 값으로 세팅하는 나름대로 제한된 역할을 가지고 있다.  그러나 합성 widget들의 경우, 이 함수들이 적합한 또다른 widget들을 만들어 주기도 한다.  static void  tictactoe_init (Tictactoe *ttt)  {    GtkWidget *table;    gint i,j;    table = gtk_table_new (3, 3, TRUE);    gtk_container_add (GTK_CONTAINER(ttt), table);    gtk_widget_show (table);    for (i=0;i<3; i++)      for (j=0;j<3; j++)        {          ttt->buttons[i][j] = gtk_toggle_button_new ();          gtk_table_attach_defaults (GTK_TABLE(table), ttt->buttons[i][j],                                     i, i+1, j, j+1);          gtk_signal_connect (GTK_OBJECT (ttt->buttons[i][j]), "toggled",                              GTK_SIGNAL_FUNC (tictactoe_toggle), ttt);          gtk_widget_set_usize (ttt->buttons[i][j], 20, 20);          gtk_widget_show (ttt->buttons[i][j]);        }  } *** *** 19-3.7. 그리고 나머지들... ***  모든 widget들(GtkBin처럼 달리 설명될 수 없는 base widget들은 제외)이 가지고 있어야 할 함수가 하나 더 있다.  바로 그 해당하는 타입의 object를 만들기 위한 함수다.  이것은 관례상 WIDGETNAME_new()가 된다.  Tictactoe widget에는 해당하지 않지만, 일부 widget들은 이 함수들이 인자를 가지고, 그리고 그 인자를 참고해서 어떤 셋업을 행하기도 한다.  다른 두 함수는 우리의 Tictactoe widget에 대한 특별한 것들이다.  tictactoe_clear()는 widget에 있는 모든 버튼을 up 상태로 리셋해 준다.  버튼 토글을 위한 우리 시그널 핸들러가 불필요하게 조준되는 것을 막아주기 위해 gtk_signal_handler_block_by_data()를 이용하는 것을 명심하자.  tictactoe_toggle()은 사용자가 어떤 버튼을 클릭했을 때 요청되는 시그널 핸들러다.  이것은 토글된 버튼을 포함해 어떤 매력적인 콤비(combination)가 이루어지는지 체크하고, 만약 그렇다면 "tictactoe" 시그널을 발생시킨다.  GtkWidget*  tictactoe_new ()  {    return GTK_WIDGET ( gtk_type_new (tictactoe_get_type ()));  }  void  tictactoe_clear (Tictactoe *ttt)  {    int i,j;    for (i=0;i<3;i++)      for (j=0;j<3;j++)        {          gtk_signal_handler_block_by_data (GTK_OBJECT(ttt->buttons[i][j]), ttt);          gtk_toggle_button_set_state (GTK_TOGGLE_BUTTON (ttt->buttons[i][j]),                                       FALSE);          gtk_signal_handler_unblock_by_data (GTK_OBJECT(ttt->buttons[i][j]), ttt);        }  }  static void  tictactoe_toggle (GtkWidget *widget, Tictactoe *ttt)  {    int i,k;    static int rwins[8][3] = { { 0, 0, 0 }, { 1, 1, 1 }, { 2, 2, 2 },                               { 0, 1, 2 }, { 0, 1, 2 }, { 0, 1, 2 },                               { 0, 1, 2 }, { 0, 1, 2 } };    static int cwins[8][3] = { { 0, 1, 2 }, { 0, 1, 2 }, { 0, 1, 2 },                               { 0, 0, 0 }, { 1, 1, 1 }, { 2, 2, 2 },                               { 0, 1, 2 }, { 2, 1, 0 } };    int success, found;    for (k=0; k<8; k++)      {        success = TRUE;        found = FALSE;        for (i=0;i<3;i++)          {            success = success &&              GTK_TOGGLE_BUTTON(ttt->buttons[rwins[k][i]][cwins[k][i]])->active;            found = found ||              ttt->buttons[rwins[k][i]][cwins[k][i]] == widget;          }        if (success && found)          {            gtk_signal_emit (GTK_OBJECT (ttt),                             tictactoe_signals[TICTACTOE_SIGNAL]);            break;          }      }  }  그리고 우리의 Tictactoe widget을 이용한 예제 프로그램은 최종적으로 이것이다.  #include <gtk/gtk.h>  #include "tictactoe.h"  /* 어떤 행, 열, 혹은 대각성분이 다 차게 되면 요청된다. */  void  win (GtkWidget *widget, gpointer data)  {    g_print ("Yay!\n");    tictactoe_clear (TICTACTOE (widget));  }  int  main (int argc, char *argv[])  {    GtkWidget *window;    GtkWidget *ttt;    gtk_init (&argc, &argv);    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);    gtk_window_set_title (GTK_WINDOW (window), "Aspect Frame");    gtk_signal_connect (GTK_OBJECT (window), "destroy",                        GTK_SIGNAL_FUNC (gtk_exit), NULL);    gtk_container_border_width (GTK_CONTAINER (window), 10);    /* Tictactoe widget을 하나 만든다. */    ttt = tictactoe_new ();    gtk_container_add (GTK_CONTAINER (window), ttt);    gtk_widget_show (ttt);    /* 그리고 이것의 "tictactoe" 시그널에 결합시켜 둔다. */    gtk_signal_connect (GTK_OBJECT (ttt), "tictactoe",                        GTK_SIGNAL_FUNC (win), NULL);    gtk_widget_show (window);    gtk_main ();    return 0;  } *** *** 19-4. 무에서(from scratch) widget 만들기 *** *** *** 19-4.1. 소개 ***  이번 섹션에서는 widget들이 그 자신들을 어떻게 스크린에 보이게 하는지, 그리고 이벤트와 상호작용 하는지를 더 공부할 것이다.  이에 대한 예제로 우리는 포인터가 달려있는 아날로그 다이얼(analog dial) widget을 만들어서, 사용자가 그걸 끌어서 값을 세팅하도록 할 것이다. *** *** 19-4.2. 스크린에 widget을 보이기 ***  스크린에 보여주기 위해서 몇가지 단계가 있다.  Widget이 WIDGETNAME_new() 로써 만들어지고 나서, 몇개의 함수가 더 필요하다.  o 해당하는 widget에 대해 WIDGETNAEME_realize()가 X윈도를 만들어준다.  o WIDGETNAME_map()은 사용자가 gtk_widget_show()를 호출한 이후에 요청된다.    이는 widget이 실제로 스크린 위에 그려지는(mapped) 것을 확인한다.    컨테이너 클래스의 경우, 일체의 child widget들을 매핑하기 위한 호출 또한    필요하다.  o WIDGETNAME_draw()는 widget 혹은 그것의 ancestor에 대해 gtk_widget_draw()    가 호출되었을 때 요청되는 것이다.  이것은 widget을 스크린에 그리기 위해    실제 그리는 함수를 호출해 준다.  컨테이너 widget의 경우엔 그것의 child    widget들을 위해 gtk_widget_draw()도 호출해 줘야 한다.  o  WIDGETNAME_expose()는 expose 이벤트를 위한 핸들러다.  이것은 스크린에     expose된 영역을 그려주기 위해 필요한 함수를 호출한다.  컨테이너 widget     의 경우, 이 함수는 자신만의 윈도를 가지지 않는 child widget들에 대해     expose 이벤트를 발생시켜준다. (만약 그들이 윈도를 가진다면, 필요한     expose 이벤트를 X가 발생시킨다.)  상당히 유사한 마지막의 두 함수에 주의해야 할 것이다.  사실 많은 타입의 widget들은 두 경우의 차이점을 그다지 구별하지 않는다.  Widget 클래스의 디폴트 draw() 함수는 단지 다시 그려진 영역에 대해 종합적인 expose 이벤트를 발생시킬 뿐이다.  그러나 어떤 타입의 widget은 두 함수를 구별함으로써 작업을 최소화하기도 한다.  예를들어 여러 개의 X윈도를 가진 widget은 영향을 받은 (affected) 윈도만을 다시 그려줄 수 있는데, 이것은 단순히 draw()을 호출하는 것으로는 불가능한 일이다.  컨테이너 widget들은 서로의 차이점에 대해 자기 자신은 상관하지 않지만, 그들의 child widget들은 서로를 분명히 구별해야 하므로, 간단히 디폴트 draw() 함수를 가질 수 없다.  하지만, 두 함수 사이에서 그리는 코드를 중복하는 것은 낭비다.  이런 widget들은 관습상 WIDGETNAME_paint() 라고 불리는 함수를 가진다.  이 함수들은 widget을 실제로 그리는 역할을 하며, draw() 및 expose() 함수에 의해 불리어지게 된다.  우리의 예제에서는 dial widget이 컨테이너가 아니며 오직 하나의 윈도만 가지 기 때문에, 우리는 간단하게 문제를 해결할 수 있다.  즉 디폴트 draw()를 이용 하고 또 expose() 함수만을 갖춘다.

1998 by swindler