QApplication Class

メンバ関数のドキュメント

QApplication::QApplication(int &argc, char **argv)

ウィンドウシステムを初期化し、argv 内の `argc ` コマンドライン引数を使用してアプリケーションオブジェクトを構築します。

グローバルポインタqApp は、このアプリケーションオブジェクトを指します。アプリケーションオブジェクトは1つだけ作成する必要があります。

このアプリケーションオブジェクトは、paint devices （ウィジェット、ピクマップ、ビットマップなどを含む）のいかなるものよりも先に構築されなければなりません。

すべての Qt プログラムは、以下のコマンドラインオプションを自動的にサポートしています:

• -style=style: アプリケーションのGUIスタイルを設定します。使用可能な値はシステム構成によって異なります。追加のスタイルを含めてQtをコンパイルした場合、または追加のスタイルをプラグインとして使用している場合は、-style のコマンドラインオプションでそれらを利用できます。また、QT_STYLE_OVERRIDE 環境変数を設定することで、すべてのQtアプリケーションのスタイルを設定することもできます。
• -stylestyle：上記と同じ機能です。
• -stylesheet=stylesheet: アプリケーションのスタイルシートを設定します。値は、スタイルシートを含むファイルへのパスでなければなりません。

  注：スタイルシートファイル内の相対URLは 、そのスタイルシートファイルのパスを基準としています。

• -stylesheetstylesheet は、上記と同じです。
• -widgetcount: 終了時に、破棄されずに残っているウィジェットの数と、同時に存在した最大ウィジェット数に関するデバッグメッセージを出力します。
• -reverse: アプリケーションのレイアウト方向をQt::RightToLeft
• -qmljsdebugger=：指定したポートで QML/JS デバッガーを起動します。値は port:1234[,block] の形式で指定する必要があります。block はオプションであり、指定すると、デバッガーが接続するまでアプリケーションが待機します。

QCoreApplication::arguments()も参照してください 。

[virtual noexcept] QApplication::~QApplication()

このアプリケーションによって割り当てられたウィンドウシステムリソースをすべて解放します。グローバル変数qApp の値をnullptr に設定します。

[static slot] void QApplication::aboutQt()

Qt に関する簡単なメッセージボックスを表示します。メッセージには、アプリケーションで使用されている Qt のバージョン番号が含まれます。

これは、「Menus」の例に示されているように、アプリケーションの「Help 」メニューに組み込むのに役立ちます。

この関数は、QMessageBox::aboutQt() の便宜上のスロットです。

[static] QWidget *QApplication::activeModalWidget()

アクティブなモーダルウィジェットを返します。

モーダルウィジェットとは、QDialog のサブクラスであり、コンストラクタの modal パラメータを true として指定した特別なトップレベルウィジェットです。ユーザーがプログラムの他の部分に進むには、モーダルウィジェットを閉じる必要があります。

モーダルウィジェットはスタックとして管理されます。この関数は、スタックの最上部に位置するアクティブなモーダルウィジェットを返します。

activePopupWidget() およびtopLevelWidgets()も参照してください 。

[static] QWidget *QApplication::activePopupWidget()

アクティブなポップアップウィジェットを返します。

ポップアップウィジェットとは、Qt::WType_Popup ウィジェットフラグが設定された特別なトップレベルウィジェットです（例：QMenu ウィジェット）。アプリケーションがポップアップウィジェットを開くと、すべてのイベントがポップアップに送信されます。ポップアップウィジェットが閉じられるまでは、通常のウィジェットやモーダルウィジェットにアクセスすることはできません。

ポップアップウィジェットが表示されている間は、他のポップアップウィジェットのみを開くことができます。ポップアップウィジェットはスタックとして整理されます。この関数は、スタックの最上層にあるアクティブなポップアップウィジェットを返します。

activeModalWidget() およびtopLevelWidgets()も参照してください 。

[static] QWidget *QApplication::activeWindow()

キーボードの入力フォーカスを有するアプリケーションの最上位ウィンドウを返します。アプリケーションウィンドウのいずれもフォーカスを有していない場合は、nullptr を返します。focusWidget()が存在しない場合でも、activeWindow()が存在する場合があります。例えば、そのウィンドウ内のウィジェットのいずれもキーイベントを受け付けない場合などです。

QWidget::setFocus()、QWidget::hasFocus()、およびfocusWidget()も参照してください 。

[static] void QApplication::alert(QWidget *widget, int msec = 0)

ウィンドウがアクティブなウィンドウでない場合、widget に対してアラートを表示します。アラートはmsec ミリ秒間表示されます。msec が 0（デフォルト）の場合、ウィンドウが再びアクティブになるまでアラートは無限に表示され続けます。

現在、この関数は Qt for Embedded Linux では動作しません。

macOSでは、これは主にアプリケーションレベルで動作し、ドック上のアプリケーションアイコンがバウンドするようになります。

Windowsでは、これによりウィンドウのタスクバー上のエントリが一時的に点滅します。msec が0の場合、点滅は停止し、タスクバー上のエントリは別の色（現在はオレンジ色）に変わります。

X11では、これによりウィンドウが「注意を要する」状態としてマークされます。この動作を有効にするには、ウィンドウが非表示になってはいけません（つまり、hide() が呼び出されておらず、何らかの形で表示されている必要があります）。

[static] QWidgetList QApplication::allWidgets()

アプリケーション内のすべてのウィジェットのリストを返します。

ウィジェットが存在しない場合、リストは空（QList::isEmpty()）になります。

例:

void updateAllWidgets()
{
    const QWidgetList allWidgets = QApplication::allWidgets();
    for (QWidget *widget : allWidgets)
        widget->update();
}

関連項目： topLevelWidgets() およびQWidget::isVisible()。

[static] void QApplication::beep()

デフォルトの音量とサウンドを使用してベルを鳴らします。この機能は、Qt for Embedded Linux では利用できません。

[static slot] void QApplication::closeAllWindows()

すべての最上位ウィンドウを閉じます。

この関数は、トップレベルウィンドウが多数あるアプリケーションで特に有用です。

ウィンドウは、1つのウィンドウが閉じるイベントを受け付けなくなるまで、ランダムな順序で閉じられます。quitOnLastWindowClosed がfalseに設定されていない限り、最後のウィンドウが正常に閉じられた時点でアプリケーションは終了します。例えばメニューなどからアプリケーションの終了をトリガーするには、この関数の代わりにQCoreApplication::quit()を使用してください。

関連項目： quitOnLastWindowClosed 、lastWindowClosed()、QWidget::close()、QWidget::closeEvent()、QCoreApplication::quit()、topLevelWidgets()、およびQWidget::isWindow()。

[override virtual protected] bool QApplication::event(QEvent *e)

QGuiApplication::event(QEvent *e) を再実装します。

[static] int QApplication::exec()

メインイベントループに入り、exit() が呼び出されるまで待機し、その後、exit() に設定された値を返します（quit() を通じてexit() が呼び出された場合、この値は 0 になります）。

イベント処理を開始するには、この関数を呼び出す必要があります。メインイベントループはウィンドウシステムからイベントを受け取り、それらをアプリケーションウィジェットにディスパッチします。

一般的に、exec() を呼び出すまではユーザーとの対話を行うことはできません。例外として、QMessageBox のようなモーダルウィジェットは、exec() を呼び出す前に使用できます。これは、モーダルウィジェットが exec() を呼び出してローカルイベントループを開始するためです。

アプリケーションにアイドル処理（つまり、保留中のイベントがないときに特別な関数を実行する処理）を行わせるには、タイムアウトを 0ns に設定したQChronoTimer を使用します。より高度なアイドル処理は、processEvents() を使用して実現できます。

アプリケーションの `main() ` 関数内にクリーンアップコードを記述するのではなく、`aboutToQuit()` シグナルにクリーンアップコードを接続することをお勧めします。これは、一部のプラットフォームでは `QApplication::exec()` の呼び出しが戻らない場合があるためです。 たとえば、Windowsプラットフォームでは、ユーザーがログオフすると、Qtがすべてのトップレベルウィンドウを閉じた後にシステムがプロセスを終了します。したがって、QApplication::exec()の呼び出し後、main() 関数の末尾にあるコードが実行される前に、アプリケーションがイベントループを終了する時間があるとは保証されません。

quitOnLastWindowClosed 、QCoreApplication::quit()、QCoreApplication::exit()、QCoreApplication::processEvents()、およびQCoreApplication::exec()も参照してください 。

[signal] void QApplication::focusChanged(QWidget *old, QWidget *now)

このシグナルは、キーボードフォーカスを保持しているウィジェットが `old ` から `now` へ変更されたとき、つまり、ユーザーが Tab キーを押したり、ウィジェット内をクリックしたり、アクティブなウィンドウを変更したりした際に発生します。old とnow の両方が `nullptr` になる可能性があります。

このシグナルは、QFocusEvent を通じて両方のウィジェットに変更が通知された後に発火します。

QWidget::setFocus()、QWidget::clearFocus()、およびQt::FocusReasonも参照してください 。

[static] QWidget *QApplication::focusWidget()

キーボードの入力フォーカスが当てられているアプリケーションのウィジェットを返します。このアプリケーション内のどのウィジェットにもフォーカスが当てられていない場合は、nullptr を返します。

関連項目： QWidget::setFocus()、QWidget::hasFocus()、activeWindow()、およびfocusChanged()。

[static] QFont QApplication::font()

デフォルトのアプリケーションフォントを返します。

setFont()、fontMetrics()、およびQWidget::font()も参照してください 。

[static] QFont QApplication::font(const QWidget *widget)

widget のデフォルトフォントを返します。widget のクラスにデフォルトフォントが登録されていない場合、最も近い登録済みスーパークラスのデフォルトフォントを返します。

fontMetrics()、setFont()、およびQWidget::setFont()も参照してください 。

[static] QFont QApplication::font(const char *className)

指定されたclassName のウィジェットに使用されるフォントを返します。

setFont() およびQWidget::font()も参照してください 。

[static] bool QApplication::isEffectEnabled(Qt::UIEffect effect)

effect が有効な場合はtrue を返し、そうでない場合はfalse を返します。

デフォルトでは、Qt はデスクトップ設定を使用しようとします。これを防ぐには、setDesktopSettingsAware(false) を呼び出してください。

setEffectEnabled() およびQt::UIEffectも参照してください 。

[override virtual] bool QApplication::notify(QObject *receiver, QEvent *e)

QGuiApplication::notify （QObject *object, QEvent *event）を再実装します。

[static] QPalette QApplication::palette(const QWidget *widget)

widget が渡された場合、ウィジェットのクラスに対するデフォルトのパレットが返されます。これはアプリケーションのパレットと一致する場合もあれば、一致しない場合もあります。ほとんどの場合、特定の種類のウィジェットに特別なパレットは存在しませんが、顕著な例外として、Windows のポップアップメニューが挙げられます。これは、ユーザーがディスプレイ設定でメニュー用の特別な背景色を定義している場合です。

setPalette() およびQWidget::palette()も参照してください 。

[static] QPalette QApplication::palette(const char *className)

指定されたclassName のウィジェット用のパレットを返します。

setPalette() およびQWidget::palette()も参照してください 。

[static] void QApplication::setEffectEnabled(Qt::UIEffect effect, bool enable = true)

enable がtrueの場合、UIエフェクト「effect 」を有効にします。そうでない場合、このエフェクトは使用されません。

関連項目: ` isEffectEnabled()`、`Qt::UIEffect`、および `setDesktopSettingsAware()`。

[static] void QApplication::setFont(const QFont &font, const char *className = nullptr)

アプリケーションのデフォルトフォントをfont に変更します。className が渡された場合、この変更はclassName を継承するクラスにのみ適用されます（QObject::inherits()によって報告される通り）。

アプリケーションの起動時、デフォルトのフォントはウィンドウシステムによって異なります。これは、ウィンドウシステムのバージョンやロケールによって異なる場合があります。この関数を使用すると、デフォルトのフォントを上書きできますが、例えば一部のロケールでは特殊文字をサポートするために特大のフォントが必要となる場合があるため、上書きは推奨されません。

関連項目： font()、fontMetrics()、およびQWidget::setFont()。

[static] void QApplication::setPalette(const QPalette &palette, const char *className = nullptr)

アプリケーションパレットを「palette 」に変更します。

className が渡された場合、この変更はclassName を継承するウィジェットにのみ適用されます（QObject::inherits() によって報告される通り）。className を 0 のままにすると、変更はすべてのウィジェットに影響し、以前に設定されたクラス固有のパレットはすべて上書きされます。

パレットは、QStyle::polish() に指定された現在の GUI スタイルに従って変更される場合があります。

関連項目： QWidget::setPalette()、palette()、およびQStyle::polish()。

[static] void QApplication::setStyle(QStyle *style)

アプリケーションのGUIスタイルをstyle に設定します。スタイルオブジェクトの所有権はQApplication に移管されるため、アプリケーションの終了時、または新しいスタイルが設定された際に、古いスタイルが依然としてアプリケーションオブジェクトの親である場合、QApplication によってスタイルオブジェクトが削除されます。

使用例：

QApplication::setStyle(QStyleFactory::create("Fusion"));

アプリケーションのスタイルを切り替える際、カラーパレットは初期の色またはシステムのデフォルト値に戻されます。特定のスタイルでは、スタイルガイドに完全に準拠するためにカラーパレットを調整する必要があるため、これは必須です。

パレットが設定される前、つまり `QApplication` を作成する前にスタイルを設定すると、アプリケーションはパレットとして `QStyle::standardPalette()` を使用することになります。

style()、QStyle 、setPalette()、およびdesktopSettingsAware()も参照してください 。

[static] QStyle *QApplication::setStyle(const QString &style)

QStyleFactory から、style に対応するQStyle オブジェクトを要求します。

文字列はQStyleFactory::keys()のいずれかでなければならず、通常は「windows」、「windowsvista」、「fusion」、または「macos」のいずれかです。スタイル名は大文字小文字を区別しません。

未知の `style ` が渡された場合は `nullptr ` を返します。それ以外の場合は、返された `QStyle ` オブジェクトがアプリケーションの GUI スタイルとして設定されます。

[static] QStyle *QApplication::style()

アプリケーションのスタイルオブジェクトを返します。

setStyle() およびQStyleも参照してください 。

[static] QWidget *QApplication::topLevelAt(const QPoint &point)

指定されたpoint にある最上位のウィジェットを返します。該当するウィジェットが存在しない場合は、nullptr を返します。

[static] QWidget *QApplication::topLevelAt(int x, int y)

点 (x,y) にある最上位のウィジェットを返します。該当するウィジェットが存在しない場合は 0 を返します。

[static] QWidgetList QApplication::topLevelWidgets()

アプリケーション内の最上位ウィジェット（ウィンドウ）のリストを返します。

例:

void showAllHiddenTopLevelWidgets()
{
    const QWidgetList topLevelWidgets = QApplication::topLevelWidgets();
    for (QWidget *widget : topLevelWidgets) {
        if (widget->isHidden())
            widget->show();
    }
}

関連項目: ` allWidgets()`、`QWidget::isWindow()`、および `QWidget::isHidden()`。

[static] QWidget *QApplication::widgetAt(const QPoint &point)

グローバル画面座標point にあるウィジェットを返します。その位置にQtウィジェットが存在しない場合は、nullptr を返します。

この関数の実行には時間がかかる場合があります。

QCursor::pos()、QWidget::grabMouse()、およびQWidget::grabKeyboard()も参照してください 。

[static] QWidget *QApplication::widgetAt(int x, int y)

グローバルな画面位置（x 、y ）にあるウィジェットを返します。その位置にQtウィジェットが存在しない場合は、nullptr を返します。