bitWalk's: レイアウトの左上寄せ～ PySide6

PySide (Qt for Python) は、Qt（キュート）の Python バインディングで、GUI などを構築するためのクロスプラットフォームなライブラリです。配布ライセンスは LGPL で公開されています（商用ライセンスも有り）。最新のバージョンは Qt6 に対応した PySide6（記事執筆時点で 6.6.0）です。

ウィジェットのレイアウトの左上に寄せること、これは簡単なことなのにいつまで経っても覚えらず、期待していた配置にならずにあたふたとしてしまうことのひとつです。そういうおバカな自分のための備忘録です。

他のウィジェットなどの都合でウィンドウのサイズが決まっている時に、なにも考えずに例えば QGridLayout でウィジェットを配置します。すると以下のようになってしまって、どうしたら左上にウィジェットを寄せられるのか考え込んでしまうときがあります。

qt_gridlayout_none.py の実行例

qt_gridlayout_none.py

	#!/usr/bin/env python
	# coding: utf-8
	#
	# Reference:
	# https://stackoverflow.com/questions/75727004/how-do-i-add-widgets-to-the-top-left-of-pyside-qt-layout-instead-of-having-the-i

	import sys

	from PySide6.QtWidgets import (
	QApplication,
	QGridLayout,
	QLabel,
	QWidget,
	)


	class Example(QWidget):
	def __init__(self):
	super().__init__()
	self.init_ui()
	self.setWindowTitle('QGridLayoout test')
	self.setFixedSize(200, 200)

	def init_ui(self):
	layout = QGridLayout()
	self.setLayout(layout)

	label1 = QLabel('Hello World!')
	layout.addWidget(label1, 0, 0)

	label2 = QLabel('Thanks a lot.')
	layout.addWidget(label2, 1, 0)

	def main():
	app = QApplication(sys.argv)
	ex = Example()
	ex.show()
	sys.exit(app.exec())


	if __name__ == '__main__':
	main()

view raw qt_gridlayout_none.py hosted with ❤ by GitHub

結局、インターネットで調べて、レイアウトのインスタンスを左上に寄せればよいことを見つけて、ああそうだったと思うことになるのです。

layout.setAlignment(Qt.AlignmentFlag.AlignTop | Qt.AlignmentFlag.AlignLeft)

この一行をレイアウトのインスタンスを定義した後に加えるだけで、全体が左上に寄ります。

qt_gridlayout_top_left.py の実行例

qt_gridlayout_top_left.py

	#!/usr/bin/env python
	# coding: utf-8
	#
	# Reference:
	# https://stackoverflow.com/questions/75727004/how-do-i-add-widgets-to-the-top-left-of-pyside-qt-layout-instead-of-having-the-i

	import sys

	from PySide6.QtCore import Qt
	from PySide6.QtWidgets import (
	QApplication,
	QGridLayout,
	QLabel,
	QWidget,
	)


	class Example(QWidget):
	def __init__(self):
	super().__init__()
	self.init_ui()
	self.setWindowTitle('QGridLayoout test')
	self.setFixedSize(200, 200)

	def init_ui(self):
	layout = QGridLayout()
	layout.setAlignment(
	Qt.AlignmentFlag.AlignTop \| Qt.AlignmentFlag.AlignLeft
	)
	self.setLayout(layout)

	label1 = QLabel('Hello World!')
	layout.addWidget(label1, 0, 0)

	label2 = QLabel('Thanks a lot.')
	layout.addWidget(label2, 1, 0)


	def main():
	app = QApplication(sys.argv)
	ex = Example()
	ex.show()
	sys.exit(app.exec())


	if __name__ == '__main__':
	main()

view raw qt_gridlayout_top_left.py hosted with ❤ by GitHub

念のため、QVBoxLayout でも確認しました。まずは何も考慮しなかった場合です。

qt_vboxlayout_none.py の実行例

qt_vboxlayout_none.py

	#!/usr/bin/env python
	# coding: utf-8
	#
	# Reference:
	# https://stackoverflow.com/questions/75727004/how-do-i-add-widgets-to-the-top-left-of-pyside-qt-layout-instead-of-having-the-i

	import sys

	from PySide6.QtWidgets import (
	QApplication,
	QLabel,
	QVBoxLayout,
	QWidget,
	)


	class Example(QWidget):
	def __init__(self):
	super().__init__()
	self.init_ui()
	self.setWindowTitle('QVBoxLayoout test')
	self.setFixedSize(200, 200)

	def init_ui(self):
	layout = QVBoxLayout()
	self.setLayout(layout)

	label1 = QLabel('Hello World!')
	layout.addWidget(label1)

	label2 = QLabel('Thanks a lot.')
	layout.addWidget(label2)


	def main():
	app = QApplication(sys.argv)
	ex = Example()
	ex.show()
	sys.exit(app.exec())


	if __name__ == '__main__':
	main()

view raw qt_vboxlayout_none.py hosted with ❤ by GitHub

QGridLayout の時と同様にレイアウトのインスタンスを定義した後に一行加えます。

qt_vboxlayout_top_left.py の実行例

qt_vboxlayout_top_left.py

	#!/usr/bin/env python
	# coding: utf-8
	#
	# Reference:
	# https://stackoverflow.com/questions/75727004/how-do-i-add-widgets-to-the-top-left-of-pyside-qt-layout-instead-of-having-the-i

	import sys

	from PySide6.QtCore import Qt
	from PySide6.QtWidgets import (
	QApplication,
	QLabel,
	QVBoxLayout,
	QWidget,
	)


	class Example(QWidget):
	def __init__(self):
	super().__init__()
	self.init_ui()
	self.setWindowTitle('QVBoxLayoout test')
	self.setFixedSize(200, 200)

	def init_ui(self):
	layout = QVBoxLayout()
	layout.setAlignment(
	Qt.AlignmentFlag.AlignTop \| Qt.AlignmentFlag.AlignLeft
	)
	self.setLayout(layout)

	label1 = QLabel('Hello World!')
	layout.addWidget(label1)

	label2 = QLabel('Thanks a lot.')
	layout.addWidget(label2)


	def main():
	app = QApplication(sys.argv)
	ex = Example()
	ex.show()
	sys.exit(app.exec())


	if __name__ == '__main__':
	main()