【C++】Qtで使うQPushButton:基本操作とシグナル接続の実践的な使い方
QtでのQPushButtonはシンプルなボタンを実現できるウィジェットです。
ボタン生成時にテキストと親ウィジェットを指定でき、moveやresizeで位置や大きさの調整が可能です。
また、clickedシグナルとスロットの連携でユーザ操作に柔軟に応えられるため、直感的なインターフェース作りに適しているです。
QPushButtonの基本操作
QPushButtonの概要
ウィジェットとしての役割
QPushButtonは、グラフィカルなインターフェースで押しボタンを表現するために使われます。
ユーザーがクリック操作を行う対象として配置され、イベントが発生すると対応する処理が実行されます。
簡単な操作で動作をトリガーできるため、アプリケーションの中で重要な役割を果たします。
利用シーンの例
- フォームの送信ボタンとして
- メニューでのアクション選択時
- ダイアログのクローズ操作など
このようなシーンで使えば、ユーザーとのインタラクションがスムーズに行えます。
インスタンス生成とプロパティ設定
コンストラクタの利用方法
QPushButtonは、コンストラクタで直接インスタンスを生成することが可能です。
以下のサンプルコードでは、テキストを指定して親ウィジェットに追加しています。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
// QPushButtonのインスタンスを生成し、"Click Me"というテキストを表示
QPushButton *button = new QPushButton("Click Me", &window);
button->move(150, 130);
window.show();
return app.exec();
}
このプログラムを実行すると、400x300ピクセルのウィンドウが表示され、中央付近に「Click Me」というテキストが記載されたボタンが配置されます。

テキストとアイコンの設定
ボタンに表示するテキストは、コンストラクタの引数やsetText()
メソッドを使って設定できます。
また、setIcon()
でアイコンを追加すると、視覚的な強調が可能になります。
下記のコードは、テキストとアイコンを設定する例です。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QIcon>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton(&window);
// ボタンに表示するテキストを設定
button->setText("Submit");
// ボタンに設定するアイコンを用意(ファイルパスはサンプル用)
QIcon icon(":/images/submit.png");
button->setIcon(icon);
button->move(150, 130);
window.show();
return app.exec();
}
実行すると、「Submit」というテキストと共にアイコンが表示されたボタンが画面上に現れます。ファイルパスが正しければ、アイコン画像も確認できます。

親ウィジェットの指定
コンストラクタの第二引数に親ウィジェットを指定することで、ボタンをレイアウト内に自然に組み込むことが可能です。
親子関係により、ウィジェット同士の配置やメモリ管理が自動で行われます。
サイズと配置の調整
move()による位置決定
move()
メソッドを利用すると、ウィンドウ内でボタンの具体的な位置を指定できます。
位置はピクセル単位で指定するため、座標(100, 100)というふうにして配置の調整が可能です。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton("Move Example", &window);
// ウィンドウ上でのボタンの配置位置を(100, 100)に設定
button->move(100, 100);
window.show();
return app.exec();
}
指定された位置にボタンが配置され、ウィンドウ内で見やすい配置となります。

resize()でのサイズ設定
resize()
メソッドによって、ボタンの大きさを幅や高さで明確に指定できます。
これにより、ユーザーが操作しやすいサイズに調整可能です。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton("Resize Example", &window);
// ボタンのサイズを幅200ピクセル、高さ50ピクセルに設定
button->resize(200, 50);
button->move(100, 125);
window.show();
return app.exec();
}
ボタンのサイズが200x50ピクセルとなり、指定された位置に配置されます。

レイアウトとの連携
レイアウトマネージャを使用すると、複数のウィジェットを効率的に配置できます。
例えば、QVBoxLayout
を使った縦方向の配置では、ウィジェットの自動整列が行われ、ウィンドウサイズの変更にも柔軟に対応します。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QVBoxLayout>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
QVBoxLayout *layout = new QVBoxLayout(&window);
QPushButton *button1 = new QPushButton("Button 1", &window);
QPushButton *button2 = new QPushButton("Button 2", &window);
layout->addWidget(button1);
layout->addWidget(button2);
window.setLayout(layout);
window.resize(300, 200);
window.show();
return app.exec();
}
ウィンドウには、縦に並んだ2つのボタンが表示され、ウィンドウのサイズ変更に合わせて自動的に配置が調整されます。

シグナルとスロットの連携
シグナルとスロットの基本
Qtのイベントドリブンアーキテクチャ
Qtは、イベントドリブンプログラミングを採用しており、ユーザー操作や内部イベントに応答するための仕組みとしてシグナルとスロットが用いられます。
各ウィジェットが発生するシグナルに対して、事前に定義されたスロットで処理を行う仕組みが用意されています。
ボタン操作時に発生するシグナル
ボタンがクリックされると、clicked
シグナルが発生します。
その他にも、ボタンが押された際のpressed
や、離された際のreleased
などのシグナルがあり、用途に応じたイベント処理が可能です。
シグナル接続の実装方法
静的接続の手法
静的な接続は、QObject::connect()
関数を使ってシグナルとスロットを直接結び付ける方法です。
下記のサンプルコードでは、ボタンがクリックされたときにonButtonClicked()
関数が呼び出されます。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QDebug>
// ボタンがクリックされた際に実行される関数
void onButtonClicked() {
qDebug() << "Button clicked!";
}
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton("Static Connect", &window);
button->move(150, 130);
// シグナルとスロットの接続
QObject::connect(button, &QPushButton::clicked, onButtonClicked);
window.show();
return app.exec();
}
コンソールに「Button clicked!」というメッセージが表示され、クリックイベントが正常に処理されます。

ラムダ式を用いた接続
近年のC++では、ラムダ式を用いたシグナル接続が推奨される場合もあります。
コードがシンプルになり、宣言する関数が不要になるため、以下のように記述することができます。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QDebug>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton("Lambda Connect", &window);
button->move(150, 130);
// ラムダ式を使ってシグナルを処理
QObject::connect(button, &QPushButton::clicked, [](){
qDebug() << "Lambda: Button clicked!";
});
window.show();
return app.exec();
}
ボタンをクリックすると、コンソールに「Lambda: Button clicked!」というメッセージが出力されます。

スタイルカスタマイズ
スタイルシートによる外観変更
Qtでは、スタイルシート(CSSライクな記述)を使って、ウィジェットの外観を柔軟にカスタマイズできます。
ボタンの色やフォント、ボーダーなどを簡単なコードで調整できる仕組みです。
背景色・文字色の設定
setStyleSheet()
メソッドを活用することで、ボタンの背景色や文字色を変更できます。
下記のコードは、背景色が青で文字色が白のボタンを生成する例です。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton("Styled Button", &window);
// 背景色と文字色を設定
button->setStyleSheet("background-color: blue; color: white;");
button->move(150, 130);
window.show();
return app.exec();
}
実行後、青色の背景に白い文字で「Styled Button」と表示されたボタンが確認できます。

ボーダーとフォントの調整
ボタンのボーダーやフォントサイズを調整することで、より洗練されたデザインにすることが可能です。
以下の例では、ボーダーの太さやフォントサイズを設定しています。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton("Fancy Button", &window);
// ボーダーとフォントサイズのカスタマイズ
button->setStyleSheet("border: 2px solid black; font-size: 16px;");
button->move(150, 130);
window.show();
return app.exec();
}
このプログラムを起動すると、黒い2ピクセルのボーダーと大きめのフォントサイズが設定されたボタンが表示されます。

状態に応じたスタイル設定
ホバーやクリック時の視覚効果
ボタンには、ユーザーがカーソルを合わせたり、クリックしたときに視覚効果を付けるためのスタイルも設定できます。
CSSの疑似クラスを利用して、ボタンの状態ごとにデザインを変更可能な例です。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton("Hover Button", &window);
// 通常状態・ホバー時・クリック時の背景色を設定
button->setStyleSheet("QPushButton { background-color: gray; }"
"QPushButton:hover { background-color: lightgray; }"
"QPushButton:pressed { background-color: darkgray; }");
button->move(150, 130);
window.show();
return app.exec();
}
カーソルをボタン上に移すと背景色が明るくなり、クリック時には暗い色に変化する効果が確認できます。

無効状態のデザイン調整
ボタンが無効状態の場合にも、適切なスタイルを設定することで、ユーザーに視覚的なフィードバックを提供することが可能です。
下記のコードでは、ボタンを無効に設定し、無効時用の背景色を指定しています。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.resize(400, 300);
QPushButton *button = new QPushButton("Disabled Button", &window);
// ボタンを無効に設定
button->setEnabled(false);
button->setStyleSheet("QPushButton { background-color: red; color: white; }"
"QPushButton:disabled { background-color: lightcoral; }");
button->move(150, 130);
window.show();
return app.exec();
}
実行後、ボタンはクリックできない状態になり、通常時とは異なる色で表示され、無効状態が視覚的に伝わります。

ユーザインターフェースとの連携
ボタン操作とイベント処理
ユーザ操作に対する動作のマッピング
ボタンを操作したときに、ウィジェット全体に動的な変化を与えることが可能です。
例えば、ラベルのテキストを変更するなど、ユーザーの入力に応じた動作を割り当てると、インタラクティブなアプリケーションを構築できます。
以下は、ボタンをクリックした際にラベルのテキストを変えるサンプルコードです。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QLabel>
#include <QVBoxLayout>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.setWindowTitle("UI Interaction Example");
QVBoxLayout *layout = new QVBoxLayout(&window);
QLabel *label = new QLabel("Initial Text", &window);
layout->addWidget(label);
QPushButton *button = new QPushButton("Change Text", &window);
layout->addWidget(button);
// ボタンをクリックするとラベルのテキストが変更される
QObject::connect(button, &QPushButton::clicked, [=](){
label->setText("Text Changed!");
});
window.setLayout(layout);
window.resize(300, 200);
window.show();
return app.exec();
}
ボタンを押すと、ラベルのテキストが「Text Changed!」に変更され、ユーザー操作が反映されます。

複数ウィジェット間の連携
複数のウィジェットを連携させることで、より複雑な挙動や情報の更新が可能となります。
下記の例では、2つのラベルと2つのボタンが連動し、それぞれのボタンで対応するラベルのメッセージが更新されます。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QLabel>
#include <QHBoxLayout>
#include <QVBoxLayout>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.setWindowTitle("Multiple Widgets Interaction");
QVBoxLayout *vLayout = new QVBoxLayout(&window);
QLabel *label1 = new QLabel("Label 1", &window);
QLabel *label2 = new QLabel("Label 2", &window);
vLayout->addWidget(label1);
vLayout->addWidget(label2);
QHBoxLayout *hLayout = new QHBoxLayout();
QPushButton *button1 = new QPushButton("Change Label 1", &window);
QPushButton *button2 = new QPushButton("Change Label 2", &window);
hLayout->addWidget(button1);
hLayout->addWidget(button2);
vLayout->addLayout(hLayout);
// それぞれのボタンが対応するラベルを更新する
QObject::connect(button1, &QPushButton::clicked, [=](){
label1->setText("Label 1 Updated!");
});
QObject::connect(button2, &QPushButton::clicked, [=](){
label2->setText("Label 2 Updated!");
});
window.setLayout(vLayout);
window.resize(300, 200);
window.show();
return app.exec();
}
各ボタンを押すと、対応するラベルのテキストが即座に更新され、ウィジェット間の連携が確認できます。

ボタンの状態管理
有効・無効の切替
ボタンの有効状態と無効状態を簡単に切り替えることができ、必要に応じてユーザー操作を一時的に制限できます。
下記のコードでは、あるボタンをクリックするたびに別のボタンの有効状態が切り替わります。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QVBoxLayout>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.setWindowTitle("Button State Management");
QVBoxLayout *layout = new QVBoxLayout(&window);
QPushButton *toggleButton = new QPushButton("Toggle Button", &window);
QPushButton *targetButton = new QPushButton("Target Button", &window);
layout->addWidget(toggleButton);
layout->addWidget(targetButton);
// トグルボタンをクリックするたびにターゲットボタンの有効状態が反転する
QObject::connect(toggleButton, &QPushButton::clicked, [=](){
bool currentState = targetButton->isEnabled();
targetButton->setEnabled(!currentState);
});
window.setLayout(layout);
window.resize(300, 200);
window.show();
return app.exec();
}
トグルボタンをクリックすると、ターゲットボタンが有効から無効、またはその逆に切り替わる様子が確認できます。

状態変化による視覚的フィードバック
状態の変化に合わせたスタイルを設定すれば、ユーザーに対して現在のボタン状態を明確に提示できます。
スタイルシートの:disabled
疑似クラスなどを併用することで、無効状態でも違和感のない見た目に調整できます。
まとめ
今回の記事では、QtのQPushButton
に関する基本操作からシグナルとスロットの連携、スタイルカスタマイズ、そしてユーザインターフェースとの連携まで幅広く紹介しました。
各コードサンプルを通して、実際に動作する例を交えながら詳しく説明しており、柔らかい表現で解説を行った。
ボタンの状態管理も含め、様々なシーンに対応可能な操作方法が理解できる仕組みになっています。
ぜひ、この知識を参考にして、実際のC++プロジェクトで快適なユーザー体験を実現していただければ幸いです。