<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="treeview_simple_liststore.py" xml:lang="ko">

  <info>

    <title type="text">간단한 TreeView와 ListStore(Python)</title>

    <link type="guide" xref="beginner.py#treeview"/>

    <link type="seealso" xref="model-view-controller.py"/>

    <link type="next" xref="treeview_treestore.py"/>

    <revision version="0.2" date="2012-06-30" status="draft"/>

    <credit type="author copyright">

      <name>Marta Maria Casetti</name>

      <email its:translate="no">mmcasetti@gmail.com</email>

      <years>2012</years>

    </credit>

    <desc>ListStore를 표시하는 TreeView(더 간단한 예제)</desc>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>조성호</mal:name>

      <mal:email>shcho@gnome.org</mal:email>

      <mal:years>2017</mal:years>

    </mal:credit>

  </info>

  <title>간단한 TreeView와 ListStore</title>

  <media type="image" mime="image/png" src="media/treeview_simple_liststore.png"/>

  
이 TreeView에서는 선택 "changed" 시그널을 연결한 간단한 ListStore를 보여줍니다.

  <links type="section"/>

  <section id="code">

    <title>예제 결과를 만드는 코드</title>

    from gi.repository import Gtk

from gi.repository import Pango

import sys

columns = ["First Name",

           "Last Name",

           "Phone Number"]

phonebook = [["Jurg", "Billeter", "555-0123"],

             ["Johannes", "Schmid", "555-1234"],

             ["Julita", "Inca", "555-2345"],

             ["Javier", "Jardon", "555-3456"],

             ["Jason", "Clinton", "555-4567"],

             ["Random J.", "Hacker", "555-5678"]]

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

        Gtk.Window.__init__(self, title="My Phone Book", application=app)

        self.set_default_size(250, 100)

        self.set_border_width(10)

        # the data in the model (three strings for each row, one for each

        # column)

        listmodel = Gtk.ListStore(str, str, str)

        # append the values in the model

        for i in range(len(phonebook)):

            listmodel.append(phonebook[i])

        # a treeview to see the data stored in the model

        view = Gtk.TreeView(model=listmodel)

        # for each column

        for i, column in enumerate(columns):

            # cellrenderer to render the text

            cell = Gtk.CellRendererText()

            # the text in the first column should be in boldface

            if i == 0:

                cell.props.weight_set = True

                cell.props.weight = Pango.Weight.BOLD

            # the column is created

            col = Gtk.TreeViewColumn(column, cell, text=i)

            # and it is appended to the treeview

            view.append_column(col)

        # when a row is selected, it emits a signal

        view.get_selection().connect("changed", self.on_changed)

        # the label we use to show the selection

        self.label = Gtk.Label()

        self.label.set_text("")

        # a grid to attach the widgets

        grid = Gtk.Grid()

        grid.attach(view, 0, 0, 1, 1)

        grid.attach(self.label, 0, 1, 1, 1)

        # attach the grid to the window

        self.add(grid)

    def on_changed(self, selection):

        # get the model and the iterator that points at the data in the model

        (model, iter) = selection.get_selected()

        # set the label to a new value depending on the selection

        self.label.set_text("\n %s %s %s" %

                            (model[iter][0],  model[iter][1], model[iter][2]))

        return True

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        win.show_all()

    def do_startup(self):

        Gtk.Application.do_startup(self)

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

  </section>

  <section id="methods">

    <title>TreeView 위젯에 쓸만한 메서드</title>

    
TreeView 위젯은 Model/View/Controller  방식으로 설계했습니다. Model은 데이터를, View는 바뀐 내용 알림을 받은 후의 모델의 내용을, 마지막으로 Controller는 모델의 상태를 바꾸고 뷰에게 바뀐 모델의 상태를 알리는 코드를 담습니다. 자세한 내용과 TreeModel에 대한 쓸만한 메서드 목록을 보시려면 <link xref="model-view-controller.py"/>를 참고하십시오.

    
44번째 줄에서 "changed" 시그널은 widget.connect(signal, callback function) 함수로 on_changed() 콜백 함수에 연결했습니다. 더 자세한 설명은 <link xref="signals-callbacks.py"/>를 참조하십시오.

  </section>

  <section id="references">

    <title>API 참고서</title>

    
이 예제는 다음 참고자료가 필요합니다:

    <list>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkTreeView.html">GtkTreeView</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkTreeModel.html">GtkTreeModel</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkListStore.html">GtkListStore</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkCellRendererText.html">GtkCellRendererText</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkTreeViewColumn.html">GtkTreeViewColumn</link>
</item>

      <item>
<link href="http://git.gnome.org/browse/pygobject/tree/gi/overrides/Gtk.py">pygobject - GObject 인트로스펙션 파이썬 바인딩</link>
</item>

      <item>
<link href="http://developer.gnome.org/pango/stable/pango-Fonts.html">Fonts</link>
</item>

    </list>

  </section>

</page>