PyQt개발강좌, Splitter를 이용한 윈도우 패널 분할

서론

현대의 GUI 애플리케이션은 사용자 친화적인 디자인을 제공하기 위해 여러 개의 패널을 포함하고 있습니다.
PyQt는 Python에서 Qt 프레임워크를 활용하여 강력한 GUI 애플리케이션을 개발할 수 있는 도구입니다.
이번 강좌에서는 PyQt에서 제공하는 QSplitter 위젯을 사용하여 윈도우를 여러 패널로 나누는 방법에 대해 알아보겠습니다.
QSplitter를 사용하면 사용자가 패널의 크기를 동적으로 조정할 수 있어 인터페이스의 유연성을 높이는 데 큰 도움이 됩니다.

QSplitter란?

QSplitter는 여러 위젯을 수평 혹은 수직으로 나누어 배치하는 데 사용되는 컨테이너 위젯입니다.
기본적으로 QSplitter는 자식 위젯들 간의 공간을 나누고, 범위 내부에서 사용자가 해당 위젯의 크기를 드래그하여 조정할 수 있게 해줍니다.
이를 통해 사용자에게 최적화된 인터페이스를 제공할 수 있습니다.
QSplitter는 QWidget의 하위 클래스이므로 다양한 위젯과 함께 사용할 수 있습니다.

기본적인 QSplitter 사용법

QSplitter를 사용하기 위해서는 PyQt 패키지에서 QSplitter 클래스를 임포트하고, 이를 활용하여 여러 위젯을 추가합니다.
아래의 예제를 통해 그 기본적인 사용법을 알아보겠습니다.

예제 코드

from PyQt5.QtWidgets import QApplication, QMainWindow, QSplitter, QTextEdit, QLabel, QVBoxLayout, QWidget
from PyQt5.QtCore import Qt

class MyApp(QMainWindow):

    def __init__(self):
        super().__init__()

        self.setWindowTitle('Splitter 예제')
        self.setGeometry(100, 100, 800, 600)

        # 메인 위젯 및 레이아웃 설정
        main_widget = QWidget(self)
        self.setCentralWidget(main_widget)
        layout = QVBoxLayout(main_widget)

        # QSplitter 생성
        splitter = QSplitter(Qt.Horizontal)

        # 왼쪽 패널 - QTextEdit
        text_edit = QTextEdit()
        text_edit.setPlaceholderText("여기에 텍스트를 입력하세요.")

        # 오른쪽 패널 - QLabel
        label = QLabel("여기에 레이블이 표시됩니다.")
        label.setAlignment(Qt.AlignCenter)

        # 패널 추가
        splitter.addWidget(text_edit)
        splitter.addWidget(label)

        # 레이아웃에 splitter 추가
        layout.addWidget(splitter)

if __name__ == "__main__":
    app = QApplication([])
    window = MyApp()
    window.show()
    app.exec_()

예제 코드 설명

위 예제는 QSplitter를 사용하여 간단한 GUI를 생성합니다.

QMainWindow 클래스를 상속받아 MyApp 클래스를 정의하고,
자식 위젯으로 QTextEdit (텍스트 편집기)와 QLabel (레이블)을 추가합니다.
QSplitter는 수평으로 나누어 두 위젯을 추가하는 데 사용됩니다.

이 프로그램을 실행하면 사용자가 패널의 경계를 드래그하여 텍스트 편집기와 레이블의 크기를 조정할 수 있습니다.

QSplitter의 속성 및 메서드

QSplitter에는 여러 가지 속성과 메서드가 있으며, 이를 통해 패널의 동작과 레이아웃을 세밀히 조정할 수 있습니다.
주요 속성 및 메서드는 다음과 같습니다.

setSizes(sizes): 위젯의 초기 크기를 설정합니다. sizes는 리스트로 입력합니다.
setOrientation(orientation): QSplitter의 방향을 설정합니다. 방향은 Qt.Horizontal 또는 Qt.Vertical로 지정할 수 있습니다.
handle(index): 주어진 인덱스의 설정 핸들을 반환합니다. 이 핸들은 사용자가 드래그하여 위젯 크기를 조정할 수 있는 슬라이더입니다.
addWidget(widget): QSplitter에 위젯을 추가합니다.

응용 예제

이제 복합적인 사용자 인터페이스를 구성하는 예제를 살펴보겠습니다.
아래의 코드는 QSplitter를 사용하여 텍스트 편집기와 이미지 보기 패널을 갖춘 애플리케이션을 구현합니다. 사용자가 텍스트를 입력하면 그에 따라 해당 내용이 레이블에 표시될 것입니다.

응용 예제 코드

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QSplitter, QTextEdit, QLabel, QVBoxLayout, QWidget
from PyQt5.QtCore import Qt

class MyApp(QMainWindow):

    def __init__(self):
        super().__init__()

        self.setWindowTitle('Splitter 응용 예제')
        self.setGeometry(100, 100, 800, 600)

        # 메인 위젯 및 레이아웃 설정
        main_widget = QWidget(self)
        self.setCentralWidget(main_widget)
        layout = QVBoxLayout(main_widget)

        # QSplitter 생성
        splitter = QSplitter(Qt.Horizontal)

        # 왼쪽 패널 - QTextEdit
        self.text_edit = QTextEdit()
        self.text_edit.setPlaceholderText("여기에 텍스트를 입력하세요.")
        self.text_edit.textChanged.connect(self.update_label)

        # 오른쪽 패널 - QLabel
        self.label = QLabel("여기에 레이블이 표시됩니다.")
        self.label.setAlignment(Qt.AlignCenter)

        # 패널 추가
        splitter.addWidget(self.text_edit)
        splitter.addWidget(self.label)

        # 레이아웃에 splitter 추가
        layout.addWidget(splitter)

    def update_label(self):
        self.label.setText(self.text_edit.toPlainText())

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MyApp()
    window.show()
    sys.exit(app.exec_())

응용 예제 설명

응용 예제는 텍스트 편집기가 있는 왼쪽 패널과 텍스트를 표시하는 레이블이 있는 오른쪽 패널로 구성됩니다.

사용자가 텍스트를 입력할 때마다 update_label 메서드가 호출되어 레이블의 내용을 업데이트합니다.
이 예제를 통해 QSplitter의 활용도를 높이고, 사용자와의 상호작용을 극대화할 수 있습니다.

정리

이번 강좌에서는 PyQt에서 QSplitter를 사용하여 윈도우의 패널을 분할하는 방법을 살펴보았습니다.
QSplitter를 활용하면 더욱 유동적이고 사용자 친화적인 인터페이스를 구축할 수 있습니다.
다양한 위젯과 결합하여 창의적인 GUI 애플리케이션을 개발하는 데 큰 도움이 될 것입니다.
앞으로도 PyQt를 활용한 다양한 GUI 개발 기법에 대해 더 알아보길 바랍니다.
궁금한 점이나 추가적인 정보가 필요하다면 언제든지 질문해 주세요.

감사합니다!

서론