[Python,Gtk4] Gtk.Boxの使用について①　プロパティによる設定

Gtk.Boxの使用

　Gtk.Boxは、Gtk.LabelやGtk.ButtonなどのWidgetを垂直もしくは水平に並べて載せるのに使用するものであり、Gtk.ApplicationWidngowなどに複数のWidgetを載せるのに使用するWidgetです。

　今回は、①外観をプロパティで指定したGtk.Boxの作成方法と、②Gtk.Boxに子（Widget：サンプルではGtk.Label）を追加する方法について紹介します。

　※　外観の指定は、Propertiesの他にメソッドでも行えます。

今回紹介する内容
　・ 外観をプロパティで指定したGtk.Boxを作成する
　・ Gtk.Boxに子を追加する

[Python,Gtk4] Gtk.Boxの使用について②　メソッドによる設定

PythonとGtk4を使用して、GUIプログラムを作成するために、Gtk.Boxの外観の指定方法を確認します。今回は、Methodsを使用した外観の指定方法について見ていきます。

tannipat.blog

2023.04.25

Gtk.Boxの作成

外観をプロパティで設定したGtk.Boxを作成する

　Gtk.Boxは、Gtk.Box()と記入することで作成できます。Gtk.Boxのプロパティは、Gtk.Box()の中に以下のように「プロパティ名=値」という形で,(カンマ)区切りで記入することで、設定します。

        box = Gtk.Box(
            width_request=300, height_request=80,
            margin_top=20, margin_bottom=20,
            margin_start=20, margin_end=20,
            spacing=30,
            hexpand=True, vexpand=True,
            homogeneous=True)
        self.set_child(box)

　Gtk.Box用のプロパティは、以下のリンク（PyGObject API Reference）で確認できます。

PyGObject API Reference

lazka.github.io

　リンク先のページより、Gtk.Boxには、Gtk.Boxのプロパティ３つ(baseline_position, homogeneous, spacing)の他に、Gtk.Boxが継承しているクラス(Gtk.Widget, Gtk.Accessible, Gtk.Orientable)のプロパティ（Properties）を使用できることが確認できます。

※ リンク先のHPでは、baseline-positionと記述していますがpythonではbaselin_positionというように、(-)ハイフンを(_)アンダーバーに変更して使用します。他のプロパティも同じです。

Gtk.Box用の主なプロパティ

　Gtk.Boxに使用可能な主なプロパティをまとめると、以下のようになります。

Gtk.BoxにWidgetを載せる

　Gtk.Boxへの子（Widget）の追加や削除、子の位置の移動には、以下のメソッドを使用します。

append()を使用したGtk.BoxへのWidgetの追加

　以下は、box(Gtk.Box)にlabel1、label2、label3（Gtk.Label）を載せるプログラム部分を抜粋したものです。appendは、（Gtk.Box名）.append（childe名）の形で使用するものであり、label1、label2、label3の順に載せる指示を出すと、図のように左から載せた順番の並びに配置されます。（Gtk.Orientationを指定しない場合）

        label1 = Gtk.Label(label='Label1')
        label2 = Gtk.Label(label='Label2')
        label3 = Gtk.Label(label='Label3')

        box.append(label1)
        box.append(label2)
        box.append(label3)

サンプルプログラム

　以下のサンプルプログラムは、下図のように外観をプロパティで指定したGtk.Boxに、Gtk.Labelを３つ載せたものが表示されるものです。Gtk.Box及びGtk.Labelに関わる行の内容は、プログラムの下に記入しています。

import gi
gi.require_version('Gtk', '4.0')
from gi.repository import Gtk


APPID = 'com.github.taniyoshima.g4_fblog_box'


class Gtk4TestTest(Gtk.Window):

    def __init__(self, app):
        Gtk.Window.__init__(
            self, application=app, title='Gtk.Box Test')

        box = Gtk.Box(
            width_request=300, height_request=80,
            margin_top=20, margin_bottom=20,
            margin_start=20, margin_end=20,
            spacing=30,
            hexpand=True, vexpand=True,
            homogeneous=True)
        self.set_child(box)

        label1 = Gtk.Label(label='Label1')
        label2 = Gtk.Label(label='Label2')
        label3 = Gtk.Label(label='Label3')

        box.append(label1)
        box.append(label2)
        box.append(label3)


class Gtk4TestApp(Gtk.Application):

    def __init__(self):
        Gtk.Application.__init__(self, application_id=APPID)

    def do_activate(self):
        window = Gtk4TestTest(self)
        window.present()


def main():
    app = Gtk4TestApp()
    app.run()


if __name__ == '__main__':
    main()

　Gtk.Boxの設定は、15行目から21行目のGtk.Boxを定義するところで、プロパティにより以下の設定をしました。