Blog | Tag | Local | Guest | Login | Write |  RSS
GTK+ Window Widget Paned


안녕하세요. 오늘은 GTK+ widget Paned에 대해서 설명해 보겠습니다. Table을 이용해서 화면을 분할하듯이 paned을 이용해서 분할할 수 있습니다. Paned은 window widget의 한 영역으로 사용자가 크기를 상대적으로 조절하여 두영역으로 나누어서 쓸 수 있습니다.  두 영역 사이에는 handle이 달린 홈이 있고 이를 마우스로 드래그해서 사용자는 원하는 대로 두 영역의 비율을 바꿀 수 있습니다. 이러한 분할은 수평(HPaned)적이거나 수직(VPaned)적이 됩니다.

새 paned window를 만들려면 다음중 하나를 불러 사용합니다.

GtkWidget* gtk_hpaned_new (void)
GtkWidget* gtk_vpaned_new (void)

Paned window widget을 만든 다음에는 나누어진 양쪽에 자식 widget을 주어야 합니다. 이는 다음 함수들을 이용해서 이루어집니다.

void gtk_paned_add1 (GtkPaned *paned, GtkWidget *child)
void gtk_paned_add2 (GtkPaned *paned, GtkWidget *child)
gtk_paned_add1()는 paned 윈도 widget의 왼쪽 혹은 윗쪽에 자식 widget을 더합니다.
gtk_paned_add2()는 반대로 오른쪽 혹은 아랫쪽에 더합니다.

한 예로는 가상적인 E-mail 프로그램의 사용자 인터페이스 일부를 만들어 보려고합니다. 말이 거창할 뿐, 그리 어렵진 않습니다. 앞에 많은 예제를 다루어 봤듯이 GTK+는 반복적인 틀로 만들어지기 때문에 소스만 보아도 이해가 가능할 것입니다.
오늘 만들어 볼 E-mail 프로그램은 E-mail 메시지들의 리스트를 표시하는 윗 부분과 메시지 내용을 표시하는 아랫 부분으로 나누어 집니다. 간단한 프로그램이지만 오늘도 역시 중요한 부분이 있겠죠? 오늘의 중요한 사항은 두가지 입니다. 두가지의 중요한 부분을 집고 넘어 가겠습니다. 두가지 주의해야 할 점은 다음과 같습니다. 텍스트는 텍스트 widget에 이것이 realize되기 전에는 더해질 수 없습니다. 이는 gtk_widget_realize()를 호출해서 이루어지지만 또 다른 방법으로 text를 더하기 위해 "realize" 시그널을 연결할 수도 있습니다. 또한, GTK_SHRINK 옵션을 text 윈도와 스크롤바를 포함하고 있는 테이블 내용 일부에 더해주는 것이 필요합니다. 그래야만 아랫 부분을 작게 만들때 윈도의 바닥이 밀려나는 대신 원하던 부분이 줄어들게 됩니다.

/* paned.c */

#include <gtk/gtk.h>
  
/* "messages"의 리스트를 만듭니다 */
GtkWidget *
create_list (void)
{

    GtkWidget *scrolled_window;
    GtkWidget *list;
    GtkWidget *list_item;
  
    int i;
    char buffer[16];
  
    /* 스크롤바(필요할 때만)가 딸린 스크롤된 윈도를 만듭니다. */
    scrolled_window = gtk_scrolled_window_new (NULL, NULL);
    gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
                                    GTK_POLICY_AUTOMATIC,
                                    GTK_POLICY_AUTOMATIC);
  
    /* 새로운 리스트를 만들어 이를 스크롤된 윈도에 집어넣습니다. */
    list = gtk_list_new ();
    gtk_container_add (GTK_CONTAINER(scrolled_window), list);
    gtk_widget_show (list);
  
    /* 윈도에 메시지 몇개를 더합니다 */
    for (i=0; i<10; i++) {

        sprintf(buffer,"Message #%d",i);
        list_item = gtk_list_item_new_with_label (buffer);
        gtk_container_add (GTK_CONTAINER(list), list_item);
        gtk_widget_show (list_item);

    }
  
    return scrolled_window;
}
  
/* 텍스트 몇개를 텍스트 widget에 더합니다. - 아래 함수는 우리의 윈도가 realize 될
때 불리는 callback합수입니다. gtk_widget_realize로 realize되도록 강제할 수도 있지만
그건 먼저 계층구조의 한 부분이 되어야 할 것입니다.
*/
void
realize_text (GtkWidget *text, gpointer data)
{
    gtk_text_freeze (GTK_TEXT (text));
    gtk_text_insert (GTK_TEXT (text), NULL, &text->style->black, NULL,
    "From: pathfinder@nasa.gov\n"
    "To: mom@nasa.gov\n"
    "Subject: Made it!\n"
    "\n"
    "We just got in this morning. The weather has been\n"
    "great - clear but cold, and there are lots of fun sights.\n"
    "Sojourner says hi. See you soon.\n"
    " -Path\n", -1);
  
    gtk_text_thaw (GTK_TEXT (text));
}
  
/* "message"를 보여주는 스크롤된 텍스트 영역을 만듭니다. */
GtkWidget *
create_text (void)
{
    GtkWidget *table;
    GtkWidget *text;
    GtkWidget *hscrollbar;
    GtkWidget *vscrollbar;
  
    /* 텍스트 위젯과 스크롤바를 갖는 테이블을 만듭니다 */
    table = gtk_table_new (2, 2, FALSE);
  
    /* 텍스트 위젯을 왼쪽 위에 놓습니다. Y 축 방향으로 GTK_SHRINK가 쓰인 것을 주목해야 합니다. */
    text = gtk_text_new (NULL, NULL);
    gtk_table_attach (GTK_TABLE (table), text, 0, 1, 0, 1,
                      GTK_FILL | GTK_EXPAND,
                      GTK_FILL | GTK_EXPAND | GTK_SHRINK, 0, 0);
    gtk_widget_show (text);
  
    /* HScrollbar를 왼쪽 아래에 놓습니다. */
    hscrollbar = gtk_hscrollbar_new (GTK_TEXT (text)->hadj);
    gtk_table_attach (GTK_TABLE (table), hscrollbar, 0, 1, 1, 2,
                      GTK_EXPAND | GTK_FILL, GTK_FILL, 0, 0);
    gtk_widget_show (hscrollbar);
  
    /* VScrollbar를 오른쪽 위에 놓습니다. */
    vscrollbar = gtk_vscrollbar_new (GTK_TEXT (text)->vadj);
    gtk_table_attach (GTK_TABLE (table), vscrollbar, 1, 2, 0, 1,
                      GTK_FILL, GTK_EXPAND | GTK_FILL | GTK_SHRINK, 0, 0);
    gtk_widget_show (vscrollbar);
  
    /* 텍스트 widget이 realize되었을 때 그 widget이 갖고 있는 메시지를 출력해주는 시그널 핸들러를 더합니다. */
    gtk_signal_connect (GTK_OBJECT (text), "realize",
                        GTK_SIGNAL_FUNC (realize_text), NULL);
  
    return table;
}
  
int
main (int argc, char *argv[])
{
    GtkWidget *window;
    GtkWidget *vpaned;
    GtkWidget *list;
    GtkWidget *text;

    gtk_init (&argc, &argv);
  
    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    gtk_window_set_title (GTK_WINDOW (window), "Paned Windows");
    gtk_signal_connect (GTK_OBJECT (window), "destroy",
                        GTK_SIGNAL_FUNC (gtk_main_quit), NULL);
    gtk_container_border_width (GTK_CONTAINER (window), 10);
  
    /* vpaned widget을 만들어서 toplevel 윈도에 더합니다. */
  
    vpaned = gtk_vpaned_new ();
    gtk_container_add (GTK_CONTAINER(window), vpaned);
    gtk_widget_show (vpaned);
  
    /* 이제 윈도 두 부분의 내용을 만듭니다. */
  
    list = create_list ();
    gtk_paned_add1 (GTK_PANED(vpaned), list);
    gtk_widget_show (list);
  
    text = create_text ();
    gtk_paned_add2 (GTK_PANED(vpaned), text);
    gtk_widget_show (text);
    gtk_widget_show (window);
    gtk_main ();
    return 0;
}

오늘도 간단한 예제를 해보았습니다. 어떠하였는지요? 정말 길지도 않죠? 처음 배웠던 내용의 기본적인 내용을 뺀다면 정작 프로그램에서 사용하는 내용은 얼마 없죠? GTK+의 매력~~~