Qt 6ウィジェットGUI 部品の説明

Qt Widgets は，デスクトップアプリケーションの GUI を組み立てるための部品群です．ここでは Qt 6 でよく使うウィジェットを，役割ごとに分けて示します．

図は外観の目安です．実際の見た目は OS やテーマによって変わります．

基本的な操作部品 (ボタンと表示)

基本的な操作部品は，画面上で情報を示したり，ユーザのクリックを受け取ったりするウィジェットです．アプリケーションの操作の入口になる部品なので，最初に覚えると画面全体の構成を理解しやすくなります．

名称	大雑把な役割
QLabel	文字列や画像を表示します．
QPushButton	クリックして処理を実行するボタンです．
QToolButton	ツールバーに置く小さめのボタンです．
QProgressBar	処理の進み具合を棒で表示します．

基本的な操作部品

文字・数値・日付の入力 (入力欄)

入力用のウィジェットは，ユーザが文字，数値，日付などをアプリケーションへ渡すために使います．入力できる値の種類に合わせて専用の部品を選ぶと，入力ミスを減らし，画面も分かりやすくなります．

名称	大雑把な役割
QLineEdit	1 行の文字列を入力します．
QTextEdit / QPlainTextEdit	複数行の文章やテキストを入力・編集します．
QSpinBox / QDoubleSpinBox	上下ボタン付きで数値を入力します．
QSlider / QDial	範囲内の値を直感的に指定します．
QDateEdit / QTimeEdit	日付や時刻を入力します．

文字・数値・日付の入力

選択用のウィジェット (チェック，ラジオ，コンボボックス)

選択用のウィジェットは，あらかじめ用意した候補からユーザに選んでもらうための部品です．複数選択，単一選択，省スペースなプルダウンなど，選び方に応じて使い分けます．

名称	大雑把な役割
QCheckBox	オン・オフを切り替えます．
QRadioButton	複数候補から 1 つだけ選びます．
QComboBox	プルダウンリストから選びます．
QListWidget	項目を縦に並べて選択します．

選択用のウィジェット

表示・一覧・モデルビュー (リスト，表，ツリー)

一覧表示のウィジェットは，複数の項目やデータを，リスト，表，ツリーなどの形で見せるために使います．小さなデータなら Widget 系，大きなデータや本格的な編集では View と Model を組み合わせる方法が便利です．

名称	大雑把な役割
QTableWidget	表形式のデータを手軽に表示・編集します．
QTreeWidget	階層構造を表示します．
QListView / QTableView / QTreeView	モデルのデータを一覧，表，ツリーとして表示します．
QTextBrowser	読み取り中心の文書を表示します．

表示・一覧・モデルビュー

領域をまとめるウィジェット (グループ，タブ，分割)

領域をまとめるウィジェットは，複数の部品を見やすい単位に整理するために使います．設定項目をグループ化したり，タブでページを切り替えたり，広い画面を分割したりできます．

名称	大雑把な役割
QGroupBox	関連する項目を枠と見出しでまとめます．
QTabWidget	ページをタブで切り替えます．
QSplitter	境界をドラッグして領域の大きさを変えます．
QScrollArea	大きな内容をスクロールして表示します．

領域をまとめるウィジェット

ウィンドウとダイアログ (独立した画面)

ウィンドウとダイアログは，アプリケーション全体の枠や，一時的な確認・設定画面を作るための部品です．主画面には QMainWindow，設定，確認，ファイル選択などの一時的な操作には各種ダイアログを使います．

名称	大雑把な役割
QMainWindow	メニューバーやツールバーを持つ主ウィンドウです．
QDialog	設定や確認などの一時的な画面です．
QFileDialog	ファイルやディレクトリを選ぶダイアログです．
QColorDialog / QFontDialog	色やフォントを選ぶダイアログです．
QMessageBox	情報，警告，確認などを表示します．

ウィンドウとダイアログ

参考資料

更新履歴