Pygtk-treeview-class
PyGTK-TreeViewクラス
Treeviewウィジェットは、gtk.TreeModelインターフェイスを実装するモデルのコンテンツを表示します。 PyGTKは次のタイプのモデルを提供します-
- gtk.ListStore
- gtk.TreeStore
- gtk.TreeModelSort
ListStoreはリストモデルです。 gtk.TreeViewウィジェットに関連付けられている場合、選択元のアイテムを含むリストボックスを生成します。 gtk.ListStoreオブジェクトは、次の構文で宣言されています-
リストには複数の列がある場合があり、事前定義された型定数は-
- gobject.TYPE_BOOLEAN
- gobject.TYPE_BOXED
- gobject.TYPE_CHAR
- gobject.TYPE_DOUBLE
- gobject.TYPE_ENUM
- gobject.TYPE_FLOAT
- gobject.TYPE_INT
- gobject.TYPE_LONG
- gobject.TYPE_NONE
- gobject.TYPE_OBJECT
- gobject.TYPE_STRING
- gobject.TYPE_UCHAR
- gobject.TYPE_UINT
- gobject.TYPE_ULONG
- gtk.gdk.pixbufなど
たとえば、文字列項目を格納するListStoreオブジェクトは次のように宣言されます-
ストアにアイテムを追加するには、append()メソッドを使用します-
TreeStoreは、複数列のTreeウィジェットのモデルです。 たとえば、次のステートメントは、文字列項目を持つ1つの列を持つストアを作成します。
TreeStoreにアイテムを追加するには、append()メソッドを使用します。 append()メソッドには、親と行の2つのパラメーターがあります。 トップレベルのアイテムを追加するには、親はNoneです。
複数の行を追加するには、このステートメントを繰り返す必要があります。
子行を追加するには、親パラメーターとしてトップレベル行をappend()メソッドに渡します-
複数の子行を追加するには、このステートメントを繰り返す必要があります。
次に、TreeViewウィジェットを作成し、上記のTreeStoreオブジェクトをモデルとして使用します。
次に、ストアデータを表示するためにTreeViewColumnを作成する必要があります。 gtk.TreeViewColumnのオブジェクトは、gtk.CelRendererを使用してヘッダーとセルを管理します。 TreeViewColumnオブジェクトは、次のコンストラクタを使用して作成されます-
タイトルとレンダラーに加えて、属性の値を取得するツリーモデル列を指定するために、0個以上のattribute = columnペアが必要です。 これらのパラメータは、以下に示すTreeViewColumnクラスのメソッドを使用して設定することもできます。
gtk.CellRendererは、さまざまなタイプのデータをレンダリングするための一連のオブジェクトの基本クラスです。 派生クラスは、CellRendererText、CellRendererPixBuf、およびCellRendererToggleです。
TreeViewColumnクラスの次のメソッドは、そのオブジェクトを構成するために使用されます-
- TreeViewColumn.pack_start(cell、expand = True)-このメソッドは、CellRendererオブジェクトを開始列にパックします。 expandパラメータがTrueに設定されている場合、割り当てられたスペース全体がセルに割り当てられます。 TreeViewColumn.add_attribute(cell、attribute、column)-このメソッドは、属性マッピングをツリー列のリストに追加します。 column *はツリーモデルの列です。
- TreeViewColumn.set_attributes()−このメソッドは、 attribute = column のペアを使用して*レンダラー*の属性の場所を設定します TreeViewColumn.set_visible()− Trueの場合、*ツリービュー列が表示されます
- TreeViewColumn.set_title()-このメソッドは、「title」プロパティを指定された値に設定します。
- TreeViewColumn.set_lickable()-Trueに設定されている場合、ヘッダーはキーボードフォーカスを取得してクリックできます。
- TreeViewColumn.set_alignment(xalign)-このメソッドは、「alignment」プロパティを xalign の値に設定します。
ユーザーが_treeviewcolumn_ヘッダーボタンをクリックすると、「クリックされた」シグナルが発行されます。
TreeViewColumnオブジェクトを構成すると、append_column()メソッドを使用してTreeViewウィジェットに追加されます。
以下は、TreeViewクラスの重要なメソッドです-
TreeViewウィジェットは、次の信号を発します-
cursor-changed | This is emitted when the cursor moves or is set. |
expand-collapse-cursor-row | This is emitted when the row at the cursor needs to be expanded or collapsed. |
row-activated | This is emitted when the user double clicks a treeview row |
row-collapsed | This is emitted when a row is collapsed by the user or programmatic action. |
row-expanded | This is emitted when a row is expanded via the user or programmatic action. |
TreeViewウィジェットの2つの例を以下に示します。 最初の例では、ListStoreを使用して単純なListViewを作成します。
ここで、ListStoreオブジェクトが作成され、文字列項目が追加されます。 このListStoreオブジェクトは、TreeViewオブジェクトのモデルとして使用されます-
次に、CellRendererTextがTreeViewColumnオブジェクトに追加され、同じものがTreeViewに追加されます。
TreeViewオブジェクトは、固定コンテナに追加することにより、トップレベルウィンドウに配置されます。
例1
次のコードを観察してください-
ユーザーが選択したアイテムは、* on_activatedコールバック*関数が呼び出されると、ウィンドウのラベルに表示されます。
例2
2番目の例は、TreeStoreから階層的なTreeViewを構築します。 このプログラムは、ストアを構築し、それをTreeViewのモデルとして設定し、TreeViewColumnを設計し、それをTreeViewに追加するという同じシーケンスに従います。
次のツリービューが出力として表示されます-