QPushButton Class

詳細な説明

プッシュボタン、あるいはコマンドボタンは、おそらくどのグラフィカルユーザーインターフェースにおいても最も一般的に使用されるウィジェットです。ボタンを押す（クリックする）ことで、コンピュータに何らかのアクションを実行させたり、質問に答えさせたりします。代表的なボタンには、「OK」、「適用」、「キャンセル」、「閉じる」、「はい」、「いいえ」、「ヘルプ」などがあります。

コマンドボタンは長方形で、通常はその動作を説明するテキストラベルが表示されます。テキスト内の指定したい文字の前にアンパサンドを付けることで、ショートカットキーを指定できます。例：

QPushButton *button = new QPushButton("&Download", this);

この例では、ショートカットはAlt+Dとなります。詳細については、QShortcut のドキュメントを参照してください（実際のアンパサンドを表示するには、「&&」を使用してください）。

プッシュボタンにはテキストラベルが表示され、必要に応じて小さなアイコンも表示されます。これらはコンストラクタを使用して設定でき、後で `setText()` および `setIcon()` を使用して変更できます。ボタンが無効化されている場合、テキストとアイコンの外観は GUI スタイルに基づいて調整され、ボタンが「無効」に見えるようになります。

プッシュボタンは、マウス、スペースキー、またはキーボードショートカットによってアクティブ化されると、clicked() シグナルを発行します。このシグナルに接続して、ボタンのアクションを実行してください。プッシュボタンは、pressed() やreleased() など、あまり一般的に使用されないシグナルも提供します。

connect(dispenseButton, &QPushButton::clicked, this, &IceCreamMaker::dispense);

ダイアログ内のコマンドボタンは、デフォルトで「自動デフォルトボタン」となっています。つまり、キーボード入力のフォーカスを受けると、自動的にデフォルトのプッシュボタンになります。 デフォルトボタンとは、ユーザーがダイアログ内でEnterキーまたはReturnキーを押したときにアクティブになるプッシュボタンのことです。これはsetAutoDefault()で変更できます。自動デフォルトボタンは、デフォルトボタンインジケータを描画するために必要なわずかな余分なスペースを確保している点に注意してください。ボタンの周囲にこのスペースを必要としない場合は、setAutoDefault(false)を呼び出してください。

ボタンウィジェットは極めて重要な役割を担っているため、過去10年間で非常に多くのバリエーションに対応するよう発展してきました。Microsoftのスタイルガイドには現在、Windowsのプッシュボタンの約10種類の状態が掲載されていますが、機能のすべての組み合わせを考慮すると、実際にはさらに数十種類存在すると示唆されています。

最も重要なモードまたは状態は以下の通りです：

• 利用可能か否か（グレー表示、無効）。
• 標準のプッシュボタン、トグル式プッシュボタン、またはメニューボタン。
• オンまたはオフ（トグル式プッシュボタンのみ）。
• デフォルトまたは通常。ダイアログ内のデフォルトボタンは、通常、Enter キーまたは Return キーを使用して「クリック」できます。
• 自動リピートか否か。
• 押されているか、押されていないか。

原則として、アプリケーションやダイアログウィンドウが、ユーザーがボタンをクリックしたときにアクションを実行する場合（[適用]、[キャンセル]、[閉じる]、[ヘルプ] など）、およびウィジェットがテキストラベル付きの幅広の長方形の形状であるべき場合には、プッシュボタンを使用します。 アクションを実行するのではなく、ウィンドウの状態を変更する、通常は正方形の小さなボタン（QFileDialog の右上隅にあるボタンなど）は、コマンドボタンではなくツールボタンです。Qt では、これらのボタン用に特別なクラス（QToolButton ）が用意されています。

トグル動作（setCheckable() を参照）が必要な場合や、スクロールバーの矢印のように押下時にアクティベーション信号を自動的に繰り返し送信するボタン（setAutoRepeat() を参照）が必要な場合は、コマンドボタンはおそらく適していません。迷った場合は、ツールボタンを使用してください。

コマンドボタンのバリエーションとして、メニューボタンがあります。これらは、クリックするとオプションのメニューがポップアップ表示されるため、1つのコマンドだけでなく複数のコマンドを提供します。ポップアップメニューをプッシュボタンに関連付けるには、setMenu() メソッドを使用してください。

その他のボタンの種類としては、オプションボタン（QRadioButton を参照）やチェックボックス（QCheckBox を参照）があります。

Qt では、基底クラス `QAbstractButton ` がモードやその他の API の大部分を提供し、`QPushButton` が GUI ロジックを提供します。API に関する詳細については、QAbstractButton を参照してください。