QPushButton Class

詳しい説明

プッシュボタン（コマンドボタン）は、おそらくグラフィカル・ユーザー・インターフェースで最もよく使われるウィジェットです。ボタンを押す（クリックする）ことで、コンピュータに何らかのアクションを実行させたり、質問に答えたりすることができます。代表的なボタンは、OK、Apply、Cancel、Close、Yes、No、Helpです。

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

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

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

プッシュボタンにはテキストラベルと、オプションで小さなアイコンが表示されます。これらはコンストラクタで設定でき、setText() やsetIcon() を使って後で変更できる。ボタンが無効の場合、テキストとアイコンの外観はGUIスタイルに応じて操作され、ボタンが「無効」に見えるようになります。

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

ダイアログのコマンドボタンは、デフォルトでは自動デフォルトボタンになっています。デフォルトボタンは、ユーザーがダイアログでEnterキーやReturnキーを押したときに有効になるプッシュボタンです。これはsetAutoDefault() で変更できます。自動デフォルト・ボタンは、デフォルト・ボタン・インジケータを描画するために必要な余分なスペースを確保していることに注意してください。ボタンの周りにこのスペースが必要ない場合は、setAutoDefault(false)を呼び出してください。

このように中心的な存在であるボタンウィジェットは、過去10年間に非常に多くのバリエーションに対応できるように成長しました。マイクロソフトのスタイルガイドでは、Windowsのプッシュボタンの状態を10種類ほど示しており、すべての機能の組み合わせを考慮すると、さらに何十種類もあることを示唆している。

最も重要なモードや状態は以下の通りである：

• 利用可能かどうか（グレーアウト、無効）。
• 標準プッシュボタン、トグリングプッシュボタン、メニューボタン。
• オンかオフか（トグル・プッシュボタンの場合のみ）。
• デフォルトか通常か。ダイアログのデフォルトボタンは通常、EnterキーまたはReturnキーで「クリック」できます。
• オートリピートするかしないか。
• 押し下げられるかどうか。

一般的なルールとして、ユーザーがクリックするとアプリケーションやダイアログウィンドウがアクションを実行する場合（Apply、Cancel、Close、Helpなど）、およびウィジェットがテキストラベルを持つ幅の広い長方形の形状を持つことになっている場合は、プッシュボタンを使用します。アクションを実行するのではなく、ウィンドウの状態を変更する小さな、通常は正方形のボタン（QFileDialog の右上のボタンなど）は、コマンドボタンではなく、ツールボタンです。Qtはこれらのボタン用に特別なクラス(QToolButton)を用意しています。

トグル動作（setCheckable() を参照）や、スクロールバーの矢印のように押下されると起動信号を自動で繰り返すボタン（setAutoRepeat() を参照）が必要な場合、コマンドボタンはおそらく必要ありません。迷ったらツールボタンを使いましょう。

コマンドボタンのバリエーションとして、メニューボタンがあります。クリックするとオプションのメニューがポップアップするので、1つのコマンドだけでなく複数のコマンドを実行できます。ポップアップ・メニューをプッシュ・ボタンに関連付けるには、setMenu （）メソッドを使います。

ボタンの他のクラスには、オプション・ボタン（QRadioButton を参照）とチェック・ボックス（QCheckBox を参照）があります。

Qtでは、QAbstractButton 基本クラスがモードやその他のAPIのほとんどを提供し、QPushButtonがGUIロジックを提供します。APIについてはQAbstractButton を参照してください。