위젯 클래스

다음 섹션에서는 위젯 클래스를 나열합니다. 몇 가지 예제는 Qt Widgets 갤러리를 참조하십시오.

버튼, 콤보박스, 스크롤바와 같은 이러한 기본 위젯(컨트롤)은 바로 사용할 수 있도록 설계되었습니다.

QCheckBox	텍스트 레이블이 있는 체크박스
QComboBox	버튼과 드롭다운 목록을 결합한 것
QCommandLinkButton	Vista 스타일 명령 링크 버튼
QDateEdit	QDateTimeEdit 위젯을 기반으로 한 날짜 편집용 위젯
QDateTimeEdit	날짜 및 시간을 편집하기 위한 위젯
QDial	둥근 모양의 범위 컨트롤(속도계나 포텐셔미터와 같은)
QDoubleSpinBox	double 형식을 지원하는 스핀 박스 위젯
QFocusFrame	위젯의 일반적인 그리기 가능 영역 외부에 위치할 수 있는 포커스 프레임
QFontComboBox	사용자가 글꼴 패밀리를 선택할 수 있는 콤보박스
QLCDNumber	LCD와 유사한 숫자로 숫자를 표시하는 위젯
QLabel	텍스트 또는 이미지 표시
QLineEdit	한 줄 텍스트 편집기
QMenu	메뉴 바, 컨텍스트 메뉴 및 기타 팝업 메뉴에 사용할 수 있는 메뉴 위젯
QProgressBar	가로 또는 세로 진행률 표시줄
QPushButton	명령 버튼
QRadioButton	텍스트 레이블이 있는 라디오 버튼
QScrollArea	다른 위젯으로 스크롤되는 뷰
QScrollBar	수직 또는 수평 스크롤 바
QSizeGrip	최상위 창 크기 조정을 위한 크기 조정 핸들
QSlider	수직 또는 수평 슬라이더
QSpinBox	스핀 박스 위젯
QTabBar	탭 바(예: 탭이 있는 대화 상자에서 사용)
QTabWidget	탭이 있는 위젯 스택
QTimeEdit	QDateTimeEdit 위젯을 기반으로 한 시간 편집용 위젯
QToolBox	탭이 있는 위젯 항목의 열
QToolButton	명령이나 옵션에 대한 빠른 액세스 버튼으로, 주로 QToolBar 내에서 사용됨
QWidget	모든 사용자 인터페이스 객체의 기본 클래스

탭 위젯 및 진행률 표시줄과 같은 고급 GUI 위젯은 더 복잡한 사용자 인터페이스 컨트롤을 제공합니다.

트리 뷰를 사용하여 내용을 표시하는 디렉터리 위젯

월, 연도 및 선택된 날짜를 표시하는 캘린더 위젯

명령어 목록이 표시된 실행 취소 스택

QCalendarWidget	사용자가 날짜를 선택할 수 있는 월 단위 달력 위젯
QColumnView	컬럼 뷰의 모델/뷰 구현
QDataWidgetMapper	데이터 모델의 특정 섹션과 위젯 간의 매핑
QListView	모델에 대한 목록 또는 아이콘 뷰
QTableView	테이블 뷰의 기본 모델/뷰 구현
QTreeView	트리 뷰의 기본 모델/뷰 구현
QUndoView	QUndoStack의 내용 표시

추상 위젯 클래스는 기본 클래스입니다. 이 클래스들은 단독으로 사용할 수는 없지만, 서브클래스로 상속될 때 기능을 제공합니다.

QAbstractButton	버튼 위젯의 추상 기본 클래스로, 버튼에 공통적으로 필요한 기능을 제공합니다
QAbstractScrollArea	요청 시 스크롤바가 표시되는 스크롤 영역
QAbstractSlider	범위 내의 정수 값
QAbstractSpinBox	값을 표시하는 스핀박스 및 라인 에디트
QDialog	대화 상자의 기본 클래스
QFrame	프레임을 가질 수 있는 위젯의 기본 클래스

스플리터, 탭 바, 버튼 그룹 등과 같은 클래스는 GUI 기본 요소를 구성하고 그룹화하여 더 복잡한 애플리케이션 및 대화 상자를 만드는 데 사용됩니다.

QButtonGroup	버튼 위젯 그룹을 구성하는 컨테이너
QGroupBox	제목이 있는 그룹 박스 프레임
QSplitter	스플리터 위젯을 구현합니다
QSplitterHandle	스플리터의 핸들 기능
QStackedWidget	한 번에 하나의 위젯만 표시되는 위젯 스택
QTabWidget	탭이 있는 위젯 스택

그래픽 뷰 클래스

QAbstractGraphicsShapeItem	모든 경로 항목에 대한 공통 기반
QGraphicsAnchor	QGraphicsAnchorLayout 내 두 항목 간의 앵커를 나타냄
QGraphicsAnchorLayout	그래픽 뷰에서 위젯을 서로 고정할 수 있는 레이아웃
QGraphicsEffect	모든 Graphical Effects의 기본 클래스
QGraphicsEllipseItem	QGraphicsScene에 추가할 수 있는 타원(Ellipse) 항목
QGraphicsGridLayout	Graphics View에서 위젯을 관리하기 위한 그리드 레이아웃
QGraphicsItem	QGraphicsScene 내의 모든 그래픽 항목에 대한 기본 클래스
QGraphicsItemGroup	항목 그룹을 단일 항목으로 취급하는 컨테이너
QGraphicsLayout	Graphics View의 모든 레이아웃을 위한 기본 클래스
QGraphicsLayoutItem	상속받아 사용자 정의 항목을 레이아웃으로 관리할 수 있게 해줍니다
QGraphicsLineItem	QGraphicsScene에 추가할 수 있는 라인 항목
QGraphicsLinearLayout	Graphics View에서 위젯을 관리하기 위한 가로 또는 세로 레이아웃
QGraphicsObject	신호, 슬롯 및 속성이 필요한 모든 그래픽 항목의 기본 클래스
QGraphicsPathItem	QGraphicsScene에 추가할 수 있는 경로 항목
QGraphicsPixmapItem	QGraphicsScene에 추가할 수 있는 픽스맵(Pixmap) 항목
QGraphicsPolygonItem	QGraphicsScene에 추가할 수 있는 Polygon 항목
QGraphicsProxyWidget	QGraphicsScene에 QWidget을 삽입하기 위한 프록시 레이어
QGraphicsRectItem	QGraphicsScene에 추가할 수 있는 Rectangle 항목
QGraphicsScene	다량의 2D 그래픽 항목을 관리하기 위한 서피스
QGraphicsSceneContextMenuEvent	그래픽 뷰 프레임워크의 컨텍스트 메뉴 이벤트
QGraphicsSceneDragDropEvent	그래픽 뷰 프레임워크의 드래그 앤 드롭 이벤트
QGraphicsSceneEvent	모든 그래픽 뷰 관련 이벤트를 위한 기본 클래스
QGraphicsSceneHelpEvent	툴팁이 요청될 때 발생하는 이벤트
QGraphicsSceneHoverEvent	그래픽 뷰 프레임워크의 호버 이벤트
QGraphicsSceneMouseEvent	그래픽 뷰 프레임워크의 마우스 이벤트
QGraphicsSceneMoveEvent	그래픽 뷰 프레임워크에서 위젯 이동 시 발생하는 이벤트
QGraphicsSceneResizeEvent	그래픽 뷰 프레임워크에서 위젯 크기 조정 시 발생하는 이벤트
QGraphicsSceneWheelEvent	그래픽 뷰 프레임워크의 휠 이벤트
QGraphicsSimpleTextItem	QGraphicsScene에 추가할 수 있는 간단한 텍스트 항목
QGraphicsSvgItem	SVG 파일의 내용을 렌더링하는 데 사용할 수 있는 QGraphicsItem
QGraphicsTextItem	서식이 지정된 텍스트를 표시하기 위해 QGraphicsScene에 추가할 수 있는 텍스트 항목
QGraphicsTransform	QGraphicsItem에 대한 고급 변환을 구축하기 위한 추상 기본 클래스
QGraphicsView	QGraphicsScene의 내용을 표시하는 위젯
QGraphicsWidget	QGraphicsScene 내 모든 위젯 항목의 기본 클래스
QStyleOptionGraphicsItem	QGraphicsItem을 그리는 데 필요한 매개변수를 기술하는 데 사용됩니다

모델/뷰 클래스

QAbstractItemDelegate	모델의 데이터 항목을 표시하고 편집하는 데 사용됩니다
QAbstractItemModel	항목 모델 클래스를 위한 추상 인터페이스
QAbstractItemView	항목 뷰 클래스를 위한 기본 기능
QAbstractListModel	1차원 목록 모델을 생성하기 위해 서브클래스로 확장할 수 있는 추상 모델
QAbstractProxyModel	정렬, 필터링 또는 기타 데이터 처리 작업을 수행할 수 있는 프록시 항목 모델의 기본 클래스
QAbstractTableModel	테이블 모델을 생성하기 위해 하위 클래스를 정의할 수 있는 추상 모델
QColumnView	컬럼 뷰의 모델/뷰 구현
QConcatenateTablesProxyModel	여러 소스 모델을 프록시하고 해당 행들을 연결
QDataWidgetMapper	데이터 모델의 특정 섹션과 위젯 간의 매핑
QFileSystemModel	로컬 파일 시스템용 데이터 모델
QHeaderView	항목 뷰를 위한 헤더 행 또는 헤더 열
QIdentityProxyModel	소스 모델을 수정 없이 그대로 중계합니다
QItemDelegate	모델의 데이터 항목을 표시하고 편집할 수 있는 기능
QItemEditorCreator	QItemEditorCreatorBase를 서브클래스화하지 않고도 항목 편집기 생성기 기본 클래스를 만들 수 있게 함
QItemEditorCreatorBase	새로운 항목 편집기 생성기를 구현할 때 반드시 서브클래스로 상속해야 하는 추상 기본 클래스
QItemEditorFactory	뷰 및 델리게이트에서 항목 데이터를 편집하기 위한 위젯
QItemSelection	모델 내 선택된 항목에 대한 정보를 관리합니다
QItemSelectionModel	뷰에서 선택된 항목을 추적합니다
QItemSelectionRange	모델 내에서 선택된 항목 범위에 대한 정보를 관리합니다
QListView	모델을 표시하는 목록 또는 아이콘 뷰
QListWidget	항목 기반 목록 위젯
QListWidgetItem	QListWidget 항목 뷰 클래스와 함께 사용하는 항목
QModelIndex	데이터 모델 내의 데이터를 찾는 데 사용
QModelRoleData	역할과 해당 역할에 연관된 데이터를 보유합니다
QModelRoleDataSpan	QModelRoleData 객체들을 포괄합니다
QPersistentModelIndex	데이터 모델 내에서 데이터를 찾아내는 데 사용됩니다
QRangeModel	모든 C++ 범위에 대해 QAbstractItemModel을 구현합니다
QRangeModel::ItemAccess	템플릿은 QRangeModel이 개별 항목의 역할 데이터에 접근하는 방식을 제어할 수 있는 사용자 정의 지점을 제공합니다
QRangeModel::RowOptions	템플릿은 QRangeModel이 행으로 사용되는 유형을 표현하는 방식을 제어할 수 있는 사용자 정의 지점을 제공합니다
QRangeModelAdapter	모든 C++ 범위에 대해 QAbstractItemModel을 준수하는 액세스
QRangeModelAdapter::ColumnIterator	모델 행의 열에 대해 STL 스타일의 비const 이터레이터를 제공합니다
QRangeModelAdapter::ConstColumnIterator	모델 행의 열을 순회하는 STL 스타일의 비const 이터레이터를 제공합니다
QRangeModelAdapter::ConstRowIterator	모델의 행을 순회하는 STL 스타일의 const 이터레이터를 제공합니다
QRangeModelAdapter::ConstRowReference	QRangeModel 내의 const 행을 감싸는 참조 래퍼
QRangeModelAdapter::DataReference	QRangeModel 내의 항목을 감싸는 참조 래퍼
QRangeModelAdapter::RowIterator	모델의 행을 순회하는 STL 스타일의 비const 이터레이터를 제공합니다
QRangeModelAdapter::RowReference	QRangeModel 내의 행을 감싸는 참조 래퍼
QRangeModelAdapter::RowReferenceBase	RowReference 및 ConstRowReference에 대한 공통 API
QSortFilterProxyModel	다른 모델과 뷰 간에 전달되는 데이터의 정렬 및 필터링 지원
QStandardItem	QStandardItemModel 클래스와 함께 사용하는 항목
QStandardItemEditorCreator	QItemEditorCreatorBase를 서브클래스화하지 않고도 위젯을 등록할 수 있는 기능
QStandardItemModel	사용자 정의 데이터를 저장하기 위한 제네릭 모델
QStringListModel	뷰에 문자열을 제공하는 모델
QStyledItemDelegate	모델의 데이터 항목을 표시하고 편집할 수 있는 기능
QTableView	테이블 뷰의 기본 모델/뷰 구현
QTableWidget	기본 모델이 포함된 항목 기반 테이블 뷰
QTableWidgetItem	QTableWidget 클래스와 함께 사용하는 항목
QTableWidgetSelectionRange	모델 인덱스나 선택 모델을 사용하지 않고 모델 내 선택 항목과 상호작용하는 방법
QTreeView	트리 뷰의 기본 모델/뷰 구현
QTreeWidget	사전 정의된 트리 모델을 사용하는 트리 뷰
QTreeWidgetItem	QTreeWidget 편의 클래스와 함께 사용하는 항목
QTreeWidgetItemIterator	QTreeWidget 인스턴스의 항목을 순회하는 방법

QDockWidget	QMainWindow 내에 도킹하거나 데스크톱에서 최상위 창으로 띄울 수 있는 위젯
QMainWindow	메인 애플리케이션 창
QMdiArea	MDI 창이 표시되는 영역
QMdiSubWindow	QMdiArea의 서브윈도우 클래스
QMenu	메뉴 바, 컨텍스트 메뉴 및 기타 팝업 메뉴에 사용되는 메뉴 위젯
QMenuBar	가로형 메뉴 바
QSizeGrip	최상위 창의 크기를 조정하기 위한 크기 조정 핸들
QStatusBar	상태 정보를 표시하는 데 적합한 가로 막대
QToolBar	일련의 컨트롤을 포함하는 이동 가능한 패널
QWidgetAction	툴바와 같은 액션 기반 컨테이너에 사용자 정의 위젯을 삽입하기 위한 인터페이스를 통해 QAction을 확장합니다

UI 외관 및 스타일을 사용자 정의하는 데 사용되는 클래스.

QColor	RGB, HSV 또는 CMYK 값을 기반으로 하는 색상
QColorSpace	색상 공간 추상화
QColorTransform	색 공간 간의 변환
QCommonStyle	GUI의 공통적인 룩 앤 필을 캡슐화합니다
QCursor	임의의 모양을 가진 마우스 커서
QFont	텍스트 그리기에 사용되는 글꼴에 대한 쿼리 지정
QFontDatabase	기본 창 시스템에서 사용할 수 있는 글꼴에 대한 정보
QFontInfo	글꼴에 대한 일반 정보
QGraphicsAnchor	QGraphicsAnchorLayout 내 두 항목 간의 앵커를 나타냅니다
QGraphicsAnchorLayout	Graphics View에서 위젯을 서로 고정할 수 있는 레이아웃
QPalette	각 위젯 상태에 대한 색상 그룹을 포함합니다
QStyle	GUI의 모양과 느낌을 캡슐화하는 추상 기본 클래스
QStyleFactory	QStyle 객체를 생성합니다
QStyleHintReturn	기본 데이터 유형 이상의 정보를 반환하는 스타일 힌트
QStyleHintReturnMask	QRegion을 반환하는 스타일 힌트
QStyleHintReturnVariant	QVariant를 반환하는 스타일 힌트
QStyleKitStyle	Qt Labs StyleKit 스타일을 다음 대상에 적용합니다 Qt Widgets
QStyleOption	QStyle 함수에서 사용하는 매개변수를 저장합니다
QStylePainter	위젯 내부에서 QStyle 요소를 그리는 데 사용되는 편의 클래스

레이아웃 클래스

QBoxLayout	자식 위젯을 수평 또는 수직으로 정렬합니다
QButtonGroup	버튼 위젯 그룹을 구성하기 위한 컨테이너
QFormLayout	입력 위젯과 관련 레이블의 양식을 관리합니다
QGraphicsAnchor	QGraphicsAnchorLayout 내 두 항목 사이의 앵커를 나타냅니다
QGraphicsAnchorLayout	Graphics View에서 위젯을 서로 고정할 수 있는 레이아웃
QGridLayout	위젯을 격자 형태로 배치합니다
QGroupBox	제목이 있는 그룹 박스 프레임
QHBoxLayout	위젯을 수평으로 정렬합니다
QLayout	지오메트리 매니저의 기본 클래스
QLayoutItem	QLayout이 조작하는 추상 항목
QSizePolicy	가로 및 세로 크기 조정 정책을 설명하는 레이아웃 속성
QSpacerItem	레이아웃 내의 빈 공간
QStackedLayout	한 번에 하나의 위젯만 표시되는 위젯 스택
QStackedWidget	한 번에 하나의 위젯만 표시되는 위젯 스택
QVBoxLayout	위젯을 수직으로 정렬합니다
QWidgetItem	위젯을 나타내는 레이아웃 항목

위젯 갤러리

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.

위젯 클래스