QFormLayout

QFormLayout 정리

QFormLayout은 레이블(Label)과 입력 위젯을 한 줄씩 묶어서 배치할 때 사용하는 레이아웃이다.

회원가입 화면이나 로그인 화면처럼
"이름 : 입력창", "비밀번호 : 입력창" 형태의 UI를 만들 때 자주 사용된다.

QFormLayout은 2열 구조(레이블 / 입력 위젯)를 쉽게 만들 수 있다.

---

기본 예제

import sys
from PySide6.QtWidgets import (
    QApplication, QWidget,
    QPushButton, QLineEdit,
    QFormLayout
)

class FormExample(QWidget):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QFormLayout 예제")
        self.resize(360, 160)

        btn1, line1 = QPushButton("One"), QLineEdit()
        btn2, line2 = QPushButton("Two"), QLineEdit()
        btn3, line3 = QPushButton("Three"), QLineEdit()

        layout = QFormLayout(self)

        layout.addRow(btn1, line1)
        layout.addRow(btn2, line2)
        layout.addRow(btn3, line3)

if __name__ == "__main__":
    app = QApplication(sys.argv)

    w = FormExample()
    w.show()

    sys.exit(app.exec())

위 코드를 실행하면 아래와 같은 화면이 출력된다.

---

addRow()

QFormLayout에서 가장 중요한 메서드는 addRow() 이다.

기본 형태

layout.addRow(레이블, 위젯)

레이블과 입력 위젯을 한 줄로 배치한다.

문자열 사용 가능

layout.addRow("이름 :", lineEdit)

문자열을 넣으면 자동으로 QLabel처럼 처리된다.

---

코드 설명

layout.addRow(btn1, line1)
→ 첫 번째 줄에 버튼과 입력창 배치

layout.addRow(btn2, line2)
→ 두 번째 줄에 버튼과 입력창 배치

layout.addRow(btn3, line3)
→ 세 번째 줄에 버튼과 입력창 배치