QApplication Class

メンバ関数ドキュメント

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

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

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

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

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

• -アプリケーションの GUI スタイルを設定します。style=style "はアプリケーションの GUI スタイルを設定します。Qt をコンパイルする際にスタイルを追加したり、プラグインとしてスタイルを追加した場合は、-style のコマンドラインオプションを使用できます。QT_STYLE_OVERRIDE 環境変数を設定することで、すべての Qt アプリケーションのスタイルを設定することもできます。
• -stylestyleは、上記と同じです。
• -stylesheet=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 のサブクラスで、コンストラクタのモーダル パラメータを 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 がゼロ（デフォルト）の場合、アラートはウィンドウが再びアクティブになるまで無期限に表示されます。

現在のところ、この関数は Qt for Embedded Linux では何もしません。

macOS では、この機能はアプリケーションレベルで動作し、アプリケーションアイコンがドックで跳ね返ります。

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

X11では、ウィンドウを "requires attention "と表示します。この機能を使うには、ウィンドウを非表示（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つのウィンドウがcloseイベントを受け付けなくなるまで、ランダムな順序で閉じられる。quitOnLastWindowClosed が false に設定されていない限り、最後のウィンドウが正常に閉じられるとアプリケーションは終了します。メニューなどからアプリケーションの終了をトリガーするには、この関数の代わりにQCoreApplication::quit() を使用してください。

quitOnLastWindowClosed 、lastWindowClosed()、QWidget::close()、QWidget::closeEvent()、lastWindowClosed()、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 に変わったとき、つまり、ユーザーがタブキーを押したか、ウィジェットをクリックしたか、アクティブ・ウィンドウを変更したときに発せられる。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も参照して ください。

[static] Qt::NavigationMode QApplication::navigationMode()

Qt が使用しているフォーカスナビゲーションの種類を返します。

この機能は Qt for Embedded Linux でのみ利用可能です。

setNavigationMode()も参照してください 。

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

再実装：QGuiApplication::notify(QObject *object, QEvent *event)。

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

widget が渡された場合、ウィジェットのクラスのデフォルトパレットが返されます。これはアプリケーションパレットである場合もあれば、そうでない場合もあります。ほとんどの場合、特定のタイプのウィジェットには特別なパレットはありませんが、1つの顕著な例外は、ユーザがディスプレイ設定でメニューの特別な背景色を定義している場合、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::setNavigationMode(Qt::NavigationMode mode)

Qt がmode で使用するフォーカスナビゲーションの種類を設定します。

この機能は Qt for Embedded Linux でのみ利用可能です。

navigationMode()も参照してください 。

[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 を返します。