QWidget Class

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

[explicit] QWidget::QWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

parent の子となるウィジェットを構築し、ウィジェットのフラグをf に設定します。

parent がnullptr の場合、新しいウィジェットはウィンドウとなります。parent が別のウィジェットである場合、このウィジェットはparent 内の子ウィンドウとなります。新しいウィジェットは、そのparent が削除されると削除されます。

ウィジェットフラグ引数f は通常0ですが、ウィンドウのフレームをカスタマイズするために設定することもできます（つまり、parent はnullptr でなければなりません）。フレームをカスタマイズするには、window flags のいずれかのビット単位のOR演算で構成された値を使用します。

すでに表示されているウィジェットに子ウィジェットを追加する場合、その子ウィジェットを表示させるには、明示的に表示する必要があります。

X11版のQtでは、すべてのシステムでスタイルフラグのすべての組み合わせを反映できない場合があることに注意してください。これは、X11上ではQtがウィンドウマネージャに要求することしかできず、ウィンドウマネージャがアプリケーションの設定を上書きできるためです。Windows上では、Qtは任意のフラグを設定できます。

windowFlagsも参照してください 。

[virtual noexcept] QWidget::~QWidget()

ウィジェットを破棄します。

まず、このウィジェットのすべての子ウィジェットが削除されます。このウィジェットがメインウィジェットである場合、アプリケーションは終了します。

[virtual protected] void QWidget::actionEvent(QActionEvent *event)

このイベントハンドラは、ウィジェットのアクションが変更されるたびに、指定されたevent を引数として呼び出されます。

addAction()、insertAction()、removeAction()、actions()、およびQActionEventも参照してください 。

QList<QAction *> QWidget::actions() const

このウィジェットのアクションのリスト（空の場合もある）を返します。

contextMenuPolicy 、insertAction()、およびremoveAction()も参照してください 。

void QWidget::activateWindow()

このウィジェットを含む最上位のウィジェットをアクティブなウィンドウに設定します。

アクティブなウィンドウとは、表示されており、キーボードの入力フォーカスを持ち、最上位にあるウィンドウのことです。

この関数は、トップレベルウィンドウのタイトルバーをマウスでクリックした場合と同じ操作を実行します。X11 では、結果はウィンドウマネージャに依存します。ウィンドウを最前面に配置したい場合は、raise() も呼び出す必要があります。なお、ウィンドウが表示されている必要があります。そうでない場合、activateWindow() は効果を発揮しません。

Windows では、アプリケーションが現在アクティブでない状態でこの関数を呼び出しても、そのウィンドウをアクティブにはしません。代わりに、タスクバー上のエントリの色を変更して、ウィンドウに何らかの変更があったことを示します。これは、Microsoft が、アプリケーションがユーザーが別のアプリケーションで行っている操作を中断することを許可していないためです。

isActiveWindow()、window()、およびshow()も参照してください 。

void QWidget::addAction(QAction *action)

アクション「action 」を、このウィジェットのアクション一覧に追加します。

すべての QWidget にはQActionのリストがあります。ただし、それらはグラフィカルにさまざまな方法で表現されることがあります。QAction リスト（actions() によって返される）のデフォルトの用途は、コンテキストQMenu を作成することです。

QWidget には、各アクションが 1 つずつしか存在してはならず、すでに存在するアクションを追加しても、そのアクションがウィジェット内に 2 回存在することにはなりません。

action の所有権は、このQWidget には引き継がれません。

removeAction()、insertAction()、actions()、およびQMenuも参照してください 。

これらの便利関数は、テキスト「text 」、アイコン「icon 」、およびショートカット「shortcut 」（存在する場合）を持つ新しいアクションを作成します。

これらの関数は、新しく作成されたアクションをウィジェットのアクションリストに追加し、それを返します。

QWidget は、返されたQAction の所有権を取得します。

これらの関数は Qt 6.3 で導入されました。

これらの便利関数は、テキストtext 、アイコンicon 、およびショートカットshortcut （存在する場合）を持つ新しいアクションを作成します。

このアクションの `triggered()` シグナルは、あたかも `QObject::connect(action, &QAction::triggered, args...)` が呼び出されたかのように接続され、`Qt::ConnectionType` を含む `args` を完全に転送します。

この関数は、新しく作成されたアクションをウィジェットのアクション一覧に追加し、それを返します。

QWidget は、返されたQAction の所有権を取得します。

これらの関数は Qt 6.3 で導入されました。

この便利関数は、テキスト「text 」、アイコン「icon 」、およびショートカット「shortcut 」（存在する場合）を持つ新しいアクションを作成します。

このアクションの `triggered()` シグナルは、`receiver` の `member ` スロットに接続されます。この関数は、新しく作成されたアクションをウィジェットのアクション一覧に追加し、それを返します。

QWidget は、返された `QAction` の所有権を取得します。

これらの関数は Qt 6.3 で導入されました。

void QWidget::addActions(const QList<QAction *> &actions)

このウィジェットのアクション一覧に、actions を追加します。

removeAction()、QMenu 、およびaddAction()も参照してください 。

void QWidget::adjustSize()

ウィジェットのサイズを、その内容に合わせて調整します。

この関数は、sizeHint() が有効な場合（つまり、サイズヒントの幅と高さが 0 以上である場合）にそれを使用します。そうでない場合は、すべての子ウィジェットを覆う子矩形（すべての子ウィジェットの矩形の和集合）をサイズとして設定します。

ウィンドウの場合、画面サイズも考慮されます。sizeHint() が (200, 100) 未満で、サイズポリシーがexpanding の場合、ウィンドウのサイズは少なくとも (200, 100) になります。ウィンドウの最大サイズは、画面の幅と高さの 2/3 です。

sizeHint() およびchildrenRect()も参照してください 。

QPalette::ColorRole QWidget::backgroundRole() const

ウィジェットの背景ロールを返します。

背景ロールは、ウィジェットのpalette から、背景の描画に使用されるブラシを定義します。

明示的な背景ロールが設定されていない場合、ウィジェットは親ウィジェットの背景ロールを継承します。

setBackgroundRole() およびforegroundRole()も参照してください 。

QBackingStore *QWidget::backingStore() const

このウィジェットが描画されるQBackingStore を返します。

[virtual protected] void QWidget::changeEvent(QEvent *event)

このイベントハンドラは、状態の変化を処理するように再実装することができます。

このイベントで変更される状態は、提供されるevent を通じて取得できます。

変更イベントには、QEvent::ToolBarChange 、QEvent::ActivationChange 、QEvent::EnabledChange 、QEvent::FontChange 、QEvent::StyleChange 、QEvent::PaletteChange 、QEvent::WindowTitleChange 、QEvent::IconTextChange 、QEvent::ModifiedChange 、QEvent::MouseTrackingChange 、QEvent::ParentChange 、QEvent::WindowStateChange 、QEvent::LanguageChange 、QEvent::LocaleChange 、QEvent::LayoutDirectionChange 、QEvent::ReadOnlyChange などがあります。

QWidget *QWidget::childAt(int x, int y) const

ウィジェットの座標系において、位置 (x,y) にある表示中の子ウィジェットを返します。指定された位置に表示中の子ウィジェットが存在しない場合、この関数はnullptr を返します。

QWidget *QWidget::childAt(const QPoint &p) const

ウィジェット自身の座標系において、ポイントp にある表示されている子ウィジェットを返します。

[since 6.8] QWidget *QWidget::childAt(const QPointF &p) const

ウィジェット自身の座標系において、座標 (p ) にある表示されている子ウィジェットを返します。

この関数は Qt 6.8 で導入されました。

void QWidget::clearFocus()

ウィジェットからキーボード入力のフォーカスを解除します。

ウィジェットがアクティブなフォーカスを持っている場合、このウィジェットに対してfocus out event が送信され、フォーカスを失ったことが通知されます。

このウィジェットがキーボード入力フォーカスを取得するには、フォーカス設定を有効にする必要があります。つまり、setFocusPolicy() を呼び出す必要があります。

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

void QWidget::clearMask()

setMask() で設定されたマスクをすべて解除します。

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

[slot] bool QWidget::close()

このウィジェットを閉じます。ウィジェットが閉じられていた場合は `true ` を返し、そうでない場合は `false` を返します。

まず、ウィジェットに `QCloseEvent` を送信します。ウィジェットが `close` イベントを `accepts ` した場合、ウィジェットは `hidden ` になります。イベントを `ignores ` した場合は、何も起こりません。QWidget::closeEvent() のデフォルトの実装は、`close` イベントを受け入れます。

ウィジェットにQt::WA_DeleteOnClose フラグが設定されている場合、そのウィジェットも削除されます。ウィジェットが表示されているかどうかにかかわらず、close イベントがウィジェットに配信されます。

QGuiApplication::lastWindowClosed() シグナルは、Qt::WA_QuitOnClose 属性が設定されている、最後に表示されていたプライマリウィンドウ（つまり、親ウィンドウを持たないウィンドウ）が閉じられたときに発火します。デフォルトでは、スプラッシュスクリーン、ツールウィンドウ、ポップアップメニューなどの一時的なウィンドウを除くすべてのウィジェットに対して、この属性が設定されています。

[virtual protected] void QWidget::closeEvent(QCloseEvent *event)

このイベントハンドラは、Qtがウィンドウシステムからトップレベルウィジェットのウィンドウ閉じる要求を受け取った際に、指定されたevent を引数として呼び出されます。

デフォルトでは、このイベントは受け入れられ、ウィジェットは閉じられます。この関数を再実装することで、ウィジェットがウィンドウの閉じる要求に応答する方法を変更できます。たとえば、すべてのイベントで `ignore()` を呼び出すことで、ウィンドウが閉じられるのを防ぐことができます。

メインウィンドウを持つアプリケーションでは、通常、この関数を再実装して、ユーザーの作業が保存されているかどうかを確認し、閉じる前に確認を求めるようにしています。

event()、hide()、close()、およびQCloseEventも参照してください 。

QMargins QWidget::contentsMargins() const

contentsMargins 関数は、ウィジェットのコンテンツの余白を返します。

setContentsMargins() およびcontentsRect()も参照してください 。

QRect QWidget::contentsRect() const

ウィジェットのマージン内の領域を返します。

setContentsMargins() およびcontentsMargins()も参照してください 。

[virtual protected] void QWidget::contextMenuEvent(QContextMenuEvent *event)

イベントevent に対応するこのイベントハンドラは、サブクラスで再実装することで、ウィジェットのコンテキストメニューイベントを受け取ることができます。

このハンドラは、ウィジェットのcontextMenuPolicy がQt::DefaultContextMenu のときに呼び出されます。

デフォルトの実装では、コンテキストイベントは無視されます。詳細については、QContextMenuEvent のドキュメントを参照してください。

event()、QContextMenuEvent 、およびcustomContextMenuRequested()も参照してください 。

[protected] void QWidget::create(WId window = 0, bool initializeWindow = true, bool destroyOldWindow = true)

新しいウィジェットウィンドウを作成します。

Qt 5 では、window 、initializeWindow 、およびdestroyOldWindow のパラメータは無視されます。代わりに、外部ウィンドウをラップするQWindow を作成するにはQWindow::fromWinId() を使用し、それをQWidget::createWindowContainer() に渡してください。

createWindowContainer() およびQWindow::fromWinId()も参照してください 。

[static] QWidget *QWidget::createWindowContainer(QWindow *window, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

「window 」を「QWidget 」ベースのアプリケーションに組み込むことを可能にする「QWidget 」を作成します。

ウィンドウコンテナは、parent の子として、ウィンドウフラグflags を指定して作成されます。

ウィンドウがコンテナに埋め込まれると、コンテナがウィンドウのジオメトリと可視性を制御します。埋め込まれたウィンドウに対して、QWindow::setGeometry()、QWindow::show()、またはQWindow::hide() を明示的に呼び出すことは推奨されません。

コンテナはwindow の所有権を引き継ぎます。QWindow::setParent()を呼び出すことで、ウィンドウをウィンドウコンテナから削除できます。

ウィンドウコンテナは、その親であるトップレベルウィンドウに対して、ネイティブの子ウィンドウとしてアタッチされます。ウィンドウコンテナが `QAbstractScrollArea ` または `QMdiArea` の子として使用される場合、このユースケースにおいて適切なスタック順とクリッピングが行われるよう、親チェーン内のすべてのウィジェットに対して `native window ` が作成されます。 ウィンドウコンテナ用にネイティブウィンドウを作成することも、適切な重ね合わせとクリッピングを可能にします。これは、ウィンドウコンテナを表示する前に実行する必要があります。ネイティブの子ウィンドウが多数あるアプリケーションでは、パフォーマンスの問題が発生する可能性があります。

ウィンドウコンテナには、いくつかの既知の制限事項があります：

• 重ね合わせ順序：埋め込まれたウィンドウは、不透明なボックスとしてウィジェット階層の上に重ねられます。複数のウィンドウコンテナインスタンスが重なった場合の重ね合わせ順序は未定義です。
• レンダリングの統合：ウィンドウコンテナは、QGraphicsProxyWidget 、QWidget::render()、または類似の機能とは相互運用しません。
• フォーカスの処理：ウィンドウコンテナのインスタンスには任意のフォーカスポリシーを設定することが可能であり、QWindow::requestActivate() の呼び出しを通じてウィンドウにフォーカスを委譲します。ただし、QWindow インスタンスから通常のフォーカスチェーンに戻るかどうかは、QWindow インスタンスの実装自体に依存します。また、QWindow::requestActivate() が実際にウィンドウにフォーカスを与えるかどうかは、プラットフォームに依存します。

  Qt Quick ベースのウィンドウを埋め込む場合、Qt はタブキーの押下によって埋め込まれた QML ウィンドウへのフォーカスの移行および切り替えを自動的に保証し、ウィンドウコンテナチェーン内の次の、または前のフォーカス可能なオブジェクトへフォーカスが移動できるようにします。

• QWidget ベースのアプリケーションで多数のウィンドウコンテナインスタンスを使用すると、アプリケーション全体のパフォーマンスに大きな悪影響を及ぼす可能性があります。

[signal] void QWidget::customContextMenuRequested(const QPoint &pos)

このシグナルは、ウィジェットのcontextMenuPolicy がQt::CustomContextMenu であり、ユーザーがウィジェット上でコンテキストメニューを要求した際に発火します。位置pos は、ウィジェットが受信するコンテキストメニューイベントの位置です。通常、これはウィジェット座標系での位置です。この規則の例外は、QAbstractScrollArea およびそのサブクラスであり、これらはコンテキストメニューイベントをviewport()の座標にマッピングします。

mapToGlobal()、QMenu 、およびcontextMenuPolicyも参照してください 。

[protected] void QWidget::destroy(bool destroyWindow = true, bool destroySubWindows = true)

ウィンドウシステムのリソースを解放します。destroyWindow がtrueの場合、ウィジェットのウィンドウを破棄します。

destroy() は、すべての子ウィジェットに対して再帰的に自身を呼び出し、destroyWindow パラメータとしてdestroySubWindows を渡します。子ウィジェットの破棄をより細かく制御するには、まず子ウィジェットを選択的に破棄してください。

この関数は通常、QWidget のデストラクタから呼び出されます。

[virtual protected] void QWidget::dragEnterEvent(QDragEnterEvent *event)

このイベントハンドラは、ドラッグ操作が行われている最中にマウスがこのウィジェットに入ってきたときに呼び出されます。イベントはevent パラメータとして渡されます。

このイベントを無視した場合、ウィジェットにはdrag move events が渡されません。

アプリケーションでドラッグ＆ドロップ機能を実装する方法の概要については、「ドラッグ＆ドロップ」のドキュメントを参照してください。

「 QDrag 」および「QDragEnterEvent 」も参照してください 。

[virtual protected] void QWidget::dragLeaveEvent(QDragLeaveEvent *event)

このイベントハンドラは、ドラッグ操作が行われている最中にマウスがこのウィジェットから離れたときに呼び出されます。このイベントは、event パラメータとして渡されます。

アプリケーションでドラッグ＆ドロップ機能を実装する方法の概要については、「ドラッグ＆ドロップ」のドキュメントを参照してください。

「 QDrag 」および「QDragLeaveEvent 」も参照してください 。

[virtual protected] void QWidget::dragMoveEvent(QDragMoveEvent *event)

このイベントハンドラは、ドラッグ操作が進行中で、かつ以下のいずれかの条件が発生した際に呼び出されます。カーソルがこのウィジェット内に入った場合、カーソルがこのウィジェット内で移動した場合、またはこのウィジェットがフォーカスを保持している間にキーボードの修飾キーが押された場合です。イベントはevent パラメータを通じて渡されます。

アプリケーションでドラッグ＆ドロップ機能を実装する方法の概要については、「ドラッグ＆ドロップ」のドキュメントを参照してください。

QDrag およびQDragMoveEventも参照してください 。

[virtual protected] void QWidget::dropEvent(QDropEvent *event)

このイベントハンドラは、このウィジェット上でドラッグされたオブジェクトがドロップされたときに呼び出されます。イベントはevent パラメータとして渡されます。

アプリケーションでドラッグ＆ドロップ機能を実装する方法の概要については、「ドラッグ＆ドロップ」のドキュメントを参照してください。

「 QDrag 」および「QDropEvent 」も参照してください 。

WId QWidget::effectiveWinId() const

ウィジェットの有効なウィンドウシステム識別子、すなわちネイティブの親ウィジェットのウィンドウシステム識別子を返します。

ウィジェットがネイティブである場合、この関数はネイティブウィジェットIDを返します。それ以外の場合は、最初のネイティブ親ウィジェット、すなわちこのウィジェットを含む最上位のウィジェットのウィンドウIDが返されます。

関連項目: ` nativeParentWidget()`。

void QWidget::ensurePolished() const

ウィジェットとその子要素が、QStyle によって適切に整えられていること（つまり、適切なフォントとパレットが設定されていること）を確認します。

QWidget この関数は、ウィジェットが完全に構築された後、初めて表示される前に呼び出されます。 何らかの処理を行う前にウィジェットがポリッシュ済みであることを確実にしたい場合は、この関数を呼び出すことができます。例えば、ウィジェットのsizeHint()の再実装において、正しいフォントサイズが必要になる場合があります。なお、この関数はsizeHint()のデフォルト実装から呼び出されることに注意してください。

ポリッシングは、すべてのコンストラクタ（基底クラスおよびサブクラスのもの）が呼び出された後に実行されなければならない最終的な初期化に役立ちます。

ウィジェットのポリッシング時に設定を変更する必要がある場合は、event() を再実装し、QEvent::Polish イベントタイプを処理してください。

注：この関数は、他の const 関数（例：sizeHint （））から呼び出せるように、const として宣言されています。

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

[virtual protected] void QWidget::enterEvent(QEnterEvent *event)

このイベントハンドラは、サブクラスで再実装することで、event パラメータを通じて渡されるウィジェットのenterイベントを受け取ることができます。

マウスカーソルがウィジェット内に入ったときに、ウィジェットにイベントが送信されます。

leaveEvent()、mouseMoveEvent()、およびevent()も参照してください 。

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

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

これはメインのイベントハンドラであり、event イベントを処理します。この関数をサブクラスで再実装することも可能ですが、代わりに専用のイベントハンドラのいずれかを使用することを推奨します。

キーの押下および離しイベントは、他のイベントとは異なる扱いとなります。event() は Tab キーおよび Shift+Tab キーの押下を検出し、フォーカスを適切に移動しようとします。フォーカスを移動させる対象となるウィジェットが存在しない場合（または押されたキーが Tab キーまたは Shift+Tab キーでない場合）、event() はkeyPressEvent() を呼び出します。

マウスおよびタブレットイベントの処理も若干特殊です。ウィジェットがenabled である場合にのみ、event()はmousePressEvent()などの専用ハンドラを呼び出します。そうでない場合は、イベントを破棄します。

この関数は、イベントが認識された場合は `true ` を返し、そうでない場合は `false` を返します。認識されたイベントが受け入れられた場合（QEvent::accepted を参照）、親ウィジェットへのイベント伝播などのそれ以降の処理は停止します。

関連項目： closeEvent(),focusInEvent(),focusOutEvent(),enterEvent(),keyPressEvent(),keyReleaseEvent(),leaveEvent(),mouseDoubleClickEvent(),mouseMoveEvent(),mousePressEvent(),mouseReleaseEvent(),moveEvent(),paintEvent(),resizeEvent(),QObject::event(),QObject::timerEvent().

[static] QWidget *QWidget::find(WId id)

ウィンドウ識別子/ハンドルid を持つウィジェットへのポインタを返します。

ウィンドウ識別子の型は、基盤となるウィンドウシステムによって異なります。具体的な定義については、qwindowdefs.h を参照してください。この識別子を持つウィジェットが存在しない場合、nullptr が返されます。

[virtual protected] void QWidget::focusInEvent(QFocusEvent *event)

このイベントハンドラは、サブクラスで再実装することで、ウィジェットのキーボードフォーカスイベント（フォーカス取得）を受け取ることができます。このイベントは、event パラメータを通じて渡されます

通常、ウィジェットがフォーカスイベントを受信するには、setFocusPolicy() をQt::NoFocus 以外の値に設定する必要があります。（なお、アプリケーションプログラマは、通常はフォーカスを受け付けないウィジェットであっても、任意のウィジェットに対してsetFocus() を呼び出すことができます。）

デフォルトの実装では、ウィジェットが更新されます（focusPolicy() を指定していないウィンドウを除く）。

focusOutEvent()、setFocusPolicy()、keyPressEvent()、keyReleaseEvent()、event()、およびQFocusEventも参照してください 。

[protected] bool QWidget::focusNextChild()

Tab に応じて、キーボードフォーカスを当てる新しいウィジェットを検索し、新しいウィジェットが見つかった場合は `true ` を返し、見つからなかった場合は `false` を返します。

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

[virtual protected] bool QWidget::focusNextPrevChild(bool next)

TabキーおよびShift+Tabキーの操作に応じて、キーボードフォーカスを移す新しいウィジェットを検索し、新しいウィジェットが見つかった場合はtrue を、見つからなかった場合はfalseを返します。

next がtrueの場合、この関数は前方へ検索し、next がfalseの場合は後方へ検索します。

場合によっては、この関数を再実装したくなることもあるでしょう。たとえば、Web ブラウザでは、「現在アクティブなリンク」を前または後ろに移動させるためにこの関数を再実装し、「ページ」上の最後のリンクまたは最初のリンクに到達した場合にのみ focusNextPrevChild() を呼び出すことがあります。

子ウィジェットは親ウィジェットに対して focusNextPrevChild() を呼び出しますが、フォーカスをどこへ移動させるかを決定するのは、その子ウィジェットを含むウィンドウのみです。したがって、あるオブジェクトに対してこの関数を再実装することで、すべての子ウィジェットのフォーカス移動を制御できるようになります。

focusNextChild() およびfocusPreviousChild()も参照してください 。

[virtual protected] void QWidget::focusOutEvent(QFocusEvent *event)

このイベントハンドラは、サブクラスで再実装することで、ウィジェットのキーボードフォーカスイベント（フォーカス喪失）を受け取ることができます。イベントはevent パラメータを通じて渡されます。

通常、ウィジェットがフォーカスイベントを受信するには、setFocusPolicy() をQt::NoFocus 以外の値に設定する必要があります。（なお、アプリケーションプログラマは、通常はフォーカスを受け付けないウィジェットであっても、任意のウィジェットに対してsetFocus() を呼び出すことができます。）

デフォルトの実装では、ウィジェットが更新されます（focusPolicy() を指定していないウィンドウを除く）。

focusInEvent()、setFocusPolicy()、keyPressEvent()、keyReleaseEvent()、event()、およびQFocusEventも参照してください 。

[protected] bool QWidget::focusPreviousChild()

Shift+Tab に適した、キーボードフォーカスを与える新しいウィジェットを検索し、新しいウィジェットが見つかった場合は `true ` を返し、見つからなかった場合は `false` を返します。

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

QWidget *QWidget::focusProxy() const

フォーカスプロキシを返します。フォーカスプロキシが存在しない場合は、nullptr を返します。

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

QWidget *QWidget::focusWidget() const

setFocus が呼び出された、このウィジェットの最後の子ウィジェットを返します。最上位のウィジェットの場合、これはこのウィンドウがアクティブになった際にフォーカスを得るウィジェットとなります

これは、現在アクティブなウィンドウ内のフォーカス対象ウィジェットを返す `QApplication::focusWidget()` とは異なります。

QFontInfo QWidget::fontInfo() const

ウィジェットの現在のフォントに関する情報を返します。QFontInfo(widget->font()) と同等です。

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

QFontMetrics QWidget::fontMetrics() const

ウィジェットの現在のフォントのフォントメトリクスを返します。QFontMetrics(widget->font()) と同等です。

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

QPalette::ColorRole QWidget::foregroundRole() const

前景ロールを返します。

フォアグラウンド・ロールは、ウィジェットのpalette から、フォアグラウンドの描画に使用される色を定義します。

明示的なフォアグラウンド・ロールが設定されていない場合、この関数はバックグラウンド・ロールと対照的なロールを返します。

setForegroundRole() およびbackgroundRole()も参照してください 。

[invokable] QPixmap QWidget::grab(const QRect &rectangle = QRect(QPoint(0, 0), QSize(-1, -1)))

指定されたrectangle によって制限されたピクマップにウィジェットを描画します。ウィジェットに子要素がある場合は、それらも適切な位置に描画されます。

無効なサイズの矩形が指定された場合（デフォルト）、ウィジェット全体が描画されます。

関連項目: render() およびQPixmap 。

void QWidget::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

指定されたgesture に対して、特定のflags を持つウィジェットを登録します。

ungrabGesture() およびQGestureEventも参照してください 。

void QWidget::grabKeyboard()

キーボード入力を取得します。

このウィジェットは、releaseKeyboard() が呼び出されるまで、すべてのキーボードイベントを受信します。他のウィジェットはキーボードイベントを一切受け取りません。マウスイベントには影響しません。マウスイベントもキャプチャしたい場合は、grabMouse() を使用してください。

フォーカスウィジェットは、キーボードイベントを受け取らない点を除き、影響を受けません。setFocus() は通常通りフォーカスを移動させますが、新しいフォーカスウィジェットがキーボードイベントを受け取るのは、releaseKeyboard() が呼び出された後になります。

現在、別のウィジェットがキーボード入力を取得している場合は、まずそのウィジェットの取得が解除されます。

releaseKeyboard()、grabMouse()、releaseMouse()、およびfocusWidget()も参照してください 。

void QWidget::grabMouse()

マウス入力を取得します。

このウィジェットは、releaseMouse()が呼び出されるまで、すべてのマウスイベントを受信します。他のウィジェットにはマウスイベントが一切届きません。キーボードイベントには影響しません。キーボードイベントをキャプチャしたい場合は、grabKeyboard()を使用してください。

Qt を使用する際、マウスをキャプチャする必要が生じることはほとんどありません。Qt は適切にマウスをキャプチャおよび解放するからです。特に、Qt はマウスボタンが押された際にマウスをキャプチャし、最後のボタンが解放されるまでその状態を維持します。

関連項目： releaseMouse()、grabKeyboard()、およびreleaseKeyboard()。

void QWidget::grabMouse(const QCursor &cursor)

マウス入力を取得し、カーソルの形状を変更します。

カーソルはcursor の形状になり（マウスのフォーカスが取得されている間）、releaseMouse()が呼び出されるまでは、このウィジェットのみがマウスイベントを受け取ります。

関連項目: releaseMouse()、grabKeyboard()、releaseKeyboard()、およびsetCursor()。

int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context = Qt::WindowShortcut)

Qtのショートカットシステムに、指定された「context 」内で指定された「key 」シーケンスを監視するショートカットを追加します。context が「Qt::ApplicationShortcut 」の場合、ショートカットはアプリケーション全体に適用されます。それ以外の場合は、このウィジェットに限定される（Qt::WidgetShortcut ）か、ウィンドウ自体に限定される（Qt::WindowShortcut ）のいずれかとなります。

同じkey シーケンスが複数のウィジェットによって取得されている場合、key シーケンスが発生すると、QEvent::Shortcut イベントが、適用されるすべてのウィジェットに対して非決定論的な順序で送信されますが、その際「ambiguous」フラグはtrueに設定されます。

releaseShortcut() およびsetShortcutEnabled()も参照してください 。

QGraphicsEffect *QWidget::graphicsEffect() const

graphicsEffect 関数は、ウィジェットのグラフィックエフェクトへのポインタを返します。

ウィジェットにGraphical Effectsがない場合、nullptr が返されます。

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

QGraphicsProxyWidget *QWidget::graphicsProxyWidget() const

グラフィックスビュー内の対応する埋め込みウィジェットに対するプロキシウィジェットを返します。それ以外の場合は、nullptr を返します。

QGraphicsProxyWidget::createProxyForChildWidget() およびQGraphicsScene::addWidget()も参照してください 。

[virtual] bool QWidget::hasHeightForWidth() const

ウィジェットの推奨高さがその幅に依存する場合は `true ` を返し、そうでない場合は `false` を返します。

[virtual] int QWidget::heightForWidth(int w) const

幅w が指定された場合、このウィジェットの推奨高さを返します。

このウィジェットにレイアウトが設定されている場合、デフォルトの実装はレイアウトの推奨高さを返します。レイアウトが設定されていない場合、デフォルトの実装は、推奨高さが幅に依存しないことを示す -1 を返します。

[slot] void QWidget::hide()

ウィジェットを非表示にします。この関数は、setVisible(false) と同等です。

関連項目： hideEvent()、isHidden()、show()、setVisible()、isVisible()、およびclose()を参照してください 。

[virtual protected] void QWidget::hideEvent(QHideEvent *event)

このイベントハンドラは、ウィジェットの非表示イベントを受け取るために、サブクラスで再実装することができます。イベントはevent パラメータを通じて渡されます。

非表示イベントは、ウィジェットが非表示になった直後にウィジェットに送信されます。

注：ウィジェットは、ウィンドウシステムによってマッピング状態が変更された際に、自動的な表示および非表示イベントを受け取ります。例えば、ユーザーがウィンドウを最小化した際には自動的な非表示イベントが、ウィンドウが再び復元された際には自動的な表示イベントが発生します。自動的な非表示イベントを受け取った後も、isVisible() の意味において、そのウィジェットは依然として表示されているものとみなされます。

visible 、event()、およびQHideEventも参照してください 。

[override virtual protected] void QWidget::initPainter(QPainter *painter) const

painter のペン、背景、フォントを、指定されたウィジェットのものと一致するように初期化します。この関数は、QWidget 上でペインターが開かれた際に自動的に呼び出されます。

[virtual protected] void QWidget::inputMethodEvent(QInputMethodEvent *event)

イベント「event 」に対するこのイベントハンドラは、サブクラスで再実装することで、入力メソッドの構成イベントを受け取ることができます。このハンドラは、入力メソッドの状態が変更された際に呼び出されます。

カスタムテキスト編集ウィジェットを作成する際は、入力メソッドイベントを受信するために、ウィンドウ属性 `Qt::WA_InputMethodEnabled ` を（関数 `setAttribute()` を使用して）明示的に設定する必要があることに注意してください。

デフォルトの実装では event->ignore() が呼び出され、これにより入力メソッドイベントが拒否されます。詳細については、QInputMethodEvent のドキュメントを参照してください。

event() およびQInputMethodEventも参照してください 。

[virtual] QVariant QWidget::inputMethodQuery(Qt::InputMethodQuery query) const

このメソッドは入力ウィジェットにのみ適用されます。入力メソッドが、周囲のテキストへの対応や再変換といった複雑な操作をサポートするために、ウィジェットのプロパティセットを取得する際に使用されます。

query どのプロパティを照会するかを指定します。

関連項目： inputMethodEvent()、QInputMethodEvent 、QInputMethodQueryEvent 、およびinputMethodHintsも参照してください 。

void QWidget::insertAction(QAction *before, QAction *action)

このウィジェットのアクション一覧に、アクション「action 」を「before 」の直前に挿入します。before がnullptr である場合、またはbefore がこのウィジェットに対して有効なアクションでない場合は、そのアクションを末尾に追加します。

QWidget には、各アクションが1つずつしか含まれてはなりません。

removeAction()、addAction()、QMenu 、contextMenuPolicy 、およびactions()も参照してください 。

void QWidget::insertActions(QAction *before, const QList<QAction *> &actions)

このウィジェットのアクション一覧に、アクション「actions 」を「before 」の前の位置に挿入します。before がnullptr である場合、またはbefore がこのウィジェットに対して有効なアクションでない場合は、そのアクションを末尾に追加します。

QWidget には、各アクションにつき最大1つまで含めることができます。

removeAction()、QMenu 、insertAction()、およびcontextMenuPolicyも参照してください 。

bool QWidget::isAncestorOf(const QWidget *child) const

このウィジェットが、指定されたchild の親（または祖父母など、どのレベルであっても）であり、かつ両方のウィジェットが同じウィンドウ内にある場合は、true を返します。それ以外の場合は、false を返します。

bool QWidget::isEnabledTo(const QWidget *ancestor) const

ancestor が有効な場合に、このウィジェットが有効になるのであればtrue を返し、そうでない場合はfalse を返します。

これは、ウィジェット自体も、ancestor までのすべての親（ 自体は除く）も、明示的に無効化されていない場合に該当します。

isEnabledTo(0) は、このウィジェットまたはその祖先のいずれかが明示的に無効にされている場合、false を返します。

ここでいう「祖先」とは、同じウィンドウ内にある親ウィジェットを意味します。

したがって、isEnabledTo(0) は、親ウィンドウも考慮に入れるisEnabled() とは異なり、このウィジェットのウィンドウで処理を停止します。

setEnabled() およびenabledも参照してください 。

bool QWidget::isHidden() const

ウィジェットが非表示の場合は `true ` を返し、それ以外の場合は `false` を返します。

非表示のウィジェットは、show() が呼び出されたときにのみ表示されます。親ウィジェットが表示されても、自動的に表示されることはありません。

表示状態を確認するには、代わりに !isVisible() を使用してください（感嘆符に注意してください）。

isHidden() は !isVisible() を意味しますが、ウィジェットは「表示されていない」状態と「非表示」状態を同時に持つことがあります。これは、表示されていないウィジェットの子であるウィジェットの場合に当てはまります。

ウィジェットが非表示となるのは、以下の場合です：

• 独立したウィンドウとして作成された場合、
• 表示されているウィジェットの子として作成された場合、
• hide() またはsetVisible(false) が呼び出された場合。

bool QWidget::isVisibleTo(const QWidget *ancestor) const

ancestor が表示された場合に、このウィジェットが表示されるようになる場合は `true ` を返し、そうでない場合は `false` を返します。

この条件が真となるのは、ウィジェット自体も、ancestor までの親ウィジェット（ を除く）も、明示的に非表示にされていない場合です。

この関数は、ウィジェットが画面上の他のウィンドウによって隠されている場合でも、そのウィジェットや他のウィンドウを移動すれば物理的に表示される可能性がある場合は、依然として true を返します。

isVisibleTo(0) はisVisible() と同じです。

show()、hide()、およびisVisible()も参照してください 。

bool QWidget::isWindow() const

ウィジェットが独立したウィンドウである場合はtrue を返し、そうでない場合はfalse を返します。

ウィンドウとは、視覚的に他のウィジェットの子ではないウィジェットであり、通常はフレームとwindow title を持っています。

ウィンドウは `parent widget` を持つことができます。その場合、親ウィンドウとグループ化され、親が削除されると一緒に削除され、親が最小化されると一緒に最小化されます。また、ウィンドウマネージャがサポートしている場合は、親ウィンドウと共通のタスクバーエントリを持ちます。

QDialog また、QMainWindow ウィジェットは、コンストラクタで親ウィジェットが指定されている場合でも、デフォルトではウィンドウとして扱われます。この動作は、Qt::Window フラグによって指定されます。

window()、isModal()、およびparentWidget()も参照してください 。

[virtual protected] void QWidget::keyPressEvent(QKeyEvent *event)

このイベントハンドラ（event イベント用）は、サブクラスで再実装することで、ウィジェットに対するキー押下イベントを受け取ることができます。

ウィジェットは、キー押下イベントを受信するために、最初にsetFocusPolicy() を呼び出してフォーカスを受け入れ、フォーカスを保持している必要があります。

このハンドラを再実装する場合、キーに対して何らかの処理を行わないときは、基底クラスの実装を呼び出すことが非常に重要です。

デフォルトの実装では、ユーザーがQKeySequence::Cancel のキーシーケンス（通常は Escape キー）を押すと、ポップアップウィジェットが閉じられます。それ以外の場合は、イベントは無視され、ウィジェットの親がそれを解釈できるようになります。

QKeyEvent はisAccepted() == trueの状態で開始されるため、QKeyEvent::accept()を呼び出す必要はありません。ただし、キーに対して何らかの処理を行う場合は、基底クラスの実装を呼び出さないようにしてください。

keyReleaseEvent()、setFocusPolicy()、focusInEvent()、focusOutEvent()、event()、およびQKeyEventも参照してください 。

[virtual protected] void QWidget::keyReleaseEvent(QKeyEvent *event)

イベントevent に対応するこのイベントハンドラは、サブクラスで再実装することで、ウィジェットのキー離しイベントを受け取ることができます。

ウィジェットがキーの解放イベントを受信するには、最初に `accept focus ` を実行し、その後 `have focus ` を実行する必要があります。

このハンドラを再実装する場合、キーに対して何らかの処理を行わないときは、基底クラスの実装を呼び出すことが非常に重要です。

デフォルトの実装では、ウィジェットの親がイベントを解釈できるように、イベントは無視されます。

QKeyEvent は isAccepted() == true の状態で開始されるため、QKeyEvent::accept() を呼び出す必要はありません。ただし、キーに対して何らかの処理を行う場合は、基底クラスの実装を呼び出さないでください。

keyPressEvent()、QEvent::ignore()、setFocusPolicy()、focusInEvent()、focusOutEvent()、event()、およびQKeyEventも参照してください 。

[static] QWidget *QWidget::keyboardGrabber()

現在キーボード入力を取得しているウィジェットを返します。

このアプリケーション内で現在キーボード入力を取得しているウィジェットがない場合、nullptr が返されます。

grabMouse() およびmouseGrabber()も参照してください 。

QLayout *QWidget::layout() const

このウィジェットにインストールされているレイアウトマネージャーを返します。レイアウトマネージャーがインストールされていない場合は、nullptr を返します。

レイアウトマネージャは、レイアウトに追加されたウィジェットの子要素のジオメトリを設定します。

setLayout()、sizePolicy()、および「レイアウト管理」も参照してください 。

[virtual protected] void QWidget::leaveEvent(QEvent *event)

このイベントハンドラは、サブクラスで再実装することで、event パラメータを介して渡されるウィジェットの離脱イベントを受け取ることができます。

leaveイベントは、マウスカーソルがウィジェットから離れたときにウィジェットに送信されます。

enterEvent()、mouseMoveEvent()、およびevent()も参照してください 。

[slot] void QWidget::lower()

ウィジェットを親ウィジェットのスタックの最下層に移動します。

この呼び出し後、ウィジェットは視覚的に、重なり合う兄弟ウィジェットの後ろに位置することになります（したがって、それらのウィジェットによって隠れます）。

raise() およびstackUnder()も参照してください 。

[since 6.0] QPointF QWidget::mapFrom(const QWidget *parent, const QPointF &pos) const

ウィジェットの座標pos を、座標系parent からこのウィジェットの座標系に変換します。parent はnullptr であってはならず、呼び出し元のウィジェットの親ウィジェットでなければなりません。

この関数は Qt 6.0 で導入されました。

mapTo()、mapFromParent()、mapFromGlobal()、およびunderMouse()も参照してください 。

QPoint QWidget::mapFrom(const QWidget *parent, const QPoint &pos) const

[since 6.0] QPointF QWidget::mapFromGlobal(const QPointF &pos) const

グローバル画面座標pos をウィジェット座標に変換します。

この関数は Qt 6.0 で導入されました。

mapToGlobal()、mapFrom)、およびmapFromParent()も参照してください 。

QPoint QWidget::mapFromGlobal(const QPoint &pos) const

[since 6.0] QPointF QWidget::mapFromParent(const QPointF &pos) const

親ウィジェットの座標pos をウィジェットの座標に変換します。

ウィジェットに親がない場合は、mapFromGlobal() と同じ動作をします。

この関数は Qt 6.0 で導入されました。

mapToParent()、mapFrom()、mapFromGlobal()、およびunderMouse()も参照してください 。

QPoint QWidget::mapFromParent(const QPoint &pos) const

[since 6.0] QPointF QWidget::mapTo(const QWidget *parent, const QPointF &pos) const

ウィジェットの座標pos を、座標系parent に変換します。parent はnullptr であってはならず、呼び出し元のウィジェットの親でなければなりません。

この関数は Qt 6.0 で導入されました。

mapFrom()、mapToParent()、mapToGlobal()、およびunderMouse()も参照してください 。

QPoint QWidget::mapTo(const QWidget *parent, const QPoint &pos) const

[since 6.0] QPointF QWidget::mapToGlobal(const QPointF &pos) const

ウィジェットの座標 `pos ` を画面のグローバル座標に変換します。たとえば、mapToGlobal(QPointF(0,0)) とすると、ウィジェットの左上ピクセルのグローバル座標が得られます。

この関数は Qt 6.0 で導入されました。

mapFromGlobal()、mapTo()、およびmapToParent()も参照してください 。

QPoint QWidget::mapToGlobal(const QPoint &pos) const

[since 6.0] QPointF QWidget::mapToParent(const QPointF &pos) const

ウィジェットの座標 `pos ` を、親ウィジェット内の座標に変換します。

ウィジェットに親がない場合は、mapToGlobal() と同じ動作をします。

この関数は Qt 6.0 で導入されました。

mapFromParent()、mapTo()、mapToGlobal()、およびunderMouse()も参照してください 。

QPoint QWidget::mapToParent(const QPoint &pos) const

QRegion QWidget::mask() const

ウィジェットに現在設定されているマスクを返します。マスクが設定されていない場合、戻り値は空の領域になります。

setMask()、clearMask()、およびQRegion::isEmpty()も参照してください 。

[override virtual protected] int QWidget::metric(QPaintDevice::PaintDeviceMetric m) const

QPaintDevice::metric （QPaintDevice::PaintDeviceMetric metric）const を再実装します。

仮想関数QPaintDevice::metric() の内部実装。

m は、取得するメトリックです。

[virtual protected] void QWidget::mouseDoubleClickEvent(QMouseEvent *event)

イベントevent に対応するこのイベントハンドラは、サブクラスで再実装することで、ウィジェットに対するマウスのダブルクリックイベントを受け取ることができます。

デフォルトの実装では、mousePressEvent() が呼び出されます。

関連項目： mousePressEvent()、mouseReleaseEvent()、mouseMoveEvent()、event()、およびQMouseEvent 。

[static] QWidget *QWidget::mouseGrabber()

現在マウス入力を取得しているウィジェットを返します。

このアプリケーション内で現在マウス入力を取得しているウィジェットがない場合、nullptr が返されます。

grabMouse() およびkeyboardGrabber()も参照してください 。

[virtual protected] void QWidget::mouseMoveEvent(QMouseEvent *event)

このイベントハンドラ（event イベント用）は、サブクラスで再実装することで、ウィジェットのマウス移動イベントを受け取ることができます。

マウストラッキングがオフになっている場合、マウス移動イベントは、マウスを移動させている間にマウスボタンが押されたときにのみ発生します。マウストラッキングがオンになっている場合、マウスボタンが押されていなくてもマウス移動イベントが発生します。

QMouseEvent::position() は、このウィジェットを基準としたマウスカーソルの位置を報告します。押下および解放イベントの場合、位置は通常、最後のマウス移動イベントの位置と同じですが、ユーザーの手が震えている場合は異なる場合があります。これは Qt ではなく、基盤となるウィンドウシステムの特徴です。

マウスの移動中にツールチップを即座に表示したい場合（例：QMouseEvent::position() でマウスの座標を取得し、それをツールチップとして表示する場合）、前述のようにまずマウストラッキングを有効にする必要があります。 そして、ツールチップが即座に更新されるようにするには、mouseMoveEvent() の実装において、setToolTip() の代わりにQToolTip::showText() を呼び出す必要があります。

関連項目： setMouseTracking()、mousePressEvent()、mouseReleaseEvent()、mouseDoubleClickEvent()、event()、QMouseEvent 、およびScribble の例。

[virtual protected] void QWidget::mousePressEvent(QMouseEvent *event)

このイベントハンドラ（event ）は、サブクラスで再実装することで、ウィジェットのマウス押下イベントを受け取ることができます。

mousePressEvent() 内で新しいウィジェットを作成すると、基盤となるウィンドウシステム（または X11 ウィンドウマネージャ）やウィジェットの位置などによっては、mouseReleaseEvent() が期待した場所で終了しない場合があります。

デフォルトの実装では、ウィンドウの外側をクリックした際にポップアップウィジェットを閉じる処理が行われます。その他のウィジェットタイプに対しては、何もしません。

mouseReleaseEvent()、mouseDoubleClickEvent()、mouseMoveEvent()、event()、QMouseEvent 、および「Scribble Example」も参照してください 。

[virtual protected] void QWidget::mouseReleaseEvent(QMouseEvent *event)

イベント `event` に対するこのイベントハンドラは、サブクラスで再実装することで、ウィジェットのマウス離しイベントを受け取ることができます。

mousePressEvent()、mouseDoubleClickEvent()、mouseMoveEvent()、event()、QMouseEvent 、および「Scribble」の例も参照してください 。

void QWidget::move(int x, int y)

これは、move(QPoint(x,y)) に対応します。

[virtual protected] void QWidget::moveEvent(QMoveEvent *event)

このイベントハンドラは、サブクラスで再実装することで、event パラメータを通じて渡されるウィジェットの移動イベントを受け取ることができます。ウィジェットがこのイベントを受け取った時点で、ウィジェットはすでに新しい位置にあります。

元の位置は、QMoveEvent::oldPos() を通じて取得できます。

resizeEvent()、event()、move()、およびQMoveEventも参照してください 。

[virtual protected] bool QWidget::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)

この特別なイベントハンドラは、サブクラスで再実装することで、message パラメータを通じて渡される、eventType で識別されるネイティブプラットフォームのイベントを受け取ることができます。

この関数を再実装する際、Qtによるイベント処理を停止したい場合は、trueを返し、result を設定してください。result パラメータはWindowsでのみ意味を持ちます。falseを返した場合、このネイティブイベントはQtに引き渡され、QtはイベントをQtイベントに変換してウィジェットに送信します。

QAbstractNativeEventFilterも参照してください 。

QWidget *QWidget::nativeParentWidget() const

このウィジェットのネイティブ親、つまりシステム識別子を持つ直系の先祖ウィジェットを返します。ネイティブ親が存在しない場合は、nullptr を返します。

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

QWidget *QWidget::nextInFocusChain() const

このウィジェットのフォーカスチェーンにある次のウィジェットを返します。

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

void QWidget::overrideWindowFlags(Qt::WindowFlags flags)

ウィンドウシステムに通知することなく、ウィジェットのウィンドウフラグをflags に設定します。

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

[override virtual] QPaintEngine *QWidget::paintEngine() const

QPaintDevice::paintEngine() const を再実装します。

ウィジェットのペイントエンジンを返します。

この関数は再実装のみを目的としているため、ユーザーが明示的に呼び出してはならないことに注意してください。この関数はQt内部で呼び出され、デフォルトの実装では必ずしも有効なポインタが返されるとは限りません。

[virtual protected] void QWidget::paintEvent(QPaintEvent *event)

このイベントハンドラは、event で渡されるペイントイベントを受け取るために、サブクラスで再実装することができます。

ペイントイベントとは、ウィジェットの全部または一部を再描画する要求のことです。これは、以下のいずれかの理由で発生します：

• repaint() または `update()` が呼び出された場合、
• ウィジェットが隠れていた状態から再び表示された場合、または
• その他多くの理由。

多くのウィジェットは、要求があれば単に表面全体を再描画できますが、処理の遅い一部のウィジェットでは、要求された領域のみを描画することで最適化する必要があります：QPaintEvent::region()。この速度最適化は結果を変えることはありません。なぜなら、イベント処理中に描画はその領域にクリップされるからです。例えば、QListView やQTableView はこれを行っています。

また、Qt では複数のペイントイベントを 1 つに統合することで、描画の高速化を図っています。update() が複数回呼び出されたり、ウィンドウシステムから複数のペイントイベントが送信されたりした場合、Qt はこれらのイベントを、より広い領域を持つ 1 つのイベントに統合します（QRegion::united() を参照）。repaint() 関数ではこの最適化が行われないため、可能な限りupdate() を使用することをお勧めします。

ペイントイベントが発生した時点で、通常、更新領域はすでに消去されているため、ウィジェットの背景上に描画することになります。

背景は、setBackgroundRole() およびsetPalette() を使用して設定できます。

Qt 4.0 以降、QWidget は自動的にダブルバッファリングを行うため、ちらつきを防ぐために paintEvent() 内でダブルバッファリングのコードを記述する必要はありません。

関連項目： event()、repaint()、update()、QPainter 、QPixmap 、QPaintEvent 、およびAnalog Clock。

QWidget *QWidget::parentWidget() const

このウィジェットの親を返します。親ウィジェットが存在しない場合は、nullptr を返します。

QWidget *QWidget::previousInFocusChain() const

InFocusChain関数は、このウィジェットのフォーカスチェーンにある直前のウィジェットを返します。

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

[slot] void QWidget::raise()

このウィジェットを、親ウィジェットのスタックの最前面に配置します。

この呼び出し後、このウィジェットは、重なり合っている兄弟ウィジェットのすべてよりも視覚的に手前に表示されます。

関連項目： lower() およびstackUnder()。

void QWidget::releaseKeyboard()

キーボードのロックを解除します。

grabKeyboard()、grabMouse()、releaseMouse()も参照してください 。

void QWidget::releaseMouse()

マウスのグラブを解除します。

grabMouse()、grabKeyboard()、およびreleaseKeyboard()も参照してください 。

void QWidget::releaseShortcut(int id)

指定されたid を持つショートカットを、Qtのショートカットシステムから削除します。これにより、そのウィジェットは、そのショートカットのキーシーケンスに関するQEvent::Shortcut イベントを受け取らなくなります（同じキーシーケンスを持つ他のショートカットがない場合）。

grabShortcut() およびsetShortcutEnabled()も参照してください 。

void QWidget::removeAction(QAction *action)

このウィジェットのアクション一覧から、アクション「action 」を削除します。

insertAction() およびactions()も参照してください 。

void QWidget::render(QPaintDevice *target, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

このウィジェットのsourceRegion をtarget にレンダリングします。この際、renderFlags を使用してレンダリング方法を決定します。レンダリングは、target 内のtargetOffset から開始されます。例：

QPixmap pixmap(widget->size());
widget->render(&pixmap);

sourceRegion がnull領域の場合、この関数はQWidget::rect()を領域として使用します。つまり、ウィジェット全体が領域となります。

レンダリングを行う前に、target デバイスのアクティブなペインター（存在する場合）に対してQPainter::end()を呼び出すようにしてください。例：

QPainter painter(this);
...
painter.end();
myWidget->render(this);

void QWidget::render(QPainter *painter, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

ウィジェットをpainter のQPainter::device()にレンダリングします。

painter に適用されている変形や設定は、レンダリング時に使用されます。

QPainter::device()も参照してください 。

[slot] void QWidget::repaint()

更新が無効になっているか、ウィジェットが非表示でない限り、直ちにpaintEvent()を呼び出してウィジェットを直接再描画します。

repaint() の使用は、アニメーション中など、即時の再描画が必要な場合にのみ推奨します。ほとんどの場合、update() を使用する方が適切です。これにより、Qt が速度を最適化し、ちらつきを最小限に抑えることができるためです。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        widget, qOverload<>(&QWidget::repaint));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        widget, [receiver = widget]() { receiver->repaint(); });

関連項目: update()、paintEvent()、およびsetUpdatesEnabled()。

void QWidget::repaint(const QRect &rect)

このバージョンでは、ウィジェット内の矩形rect を再描画します。

void QWidget::repaint(const QRegion &rgn)

このバージョンは、ウィジェット内の領域rgn を再描画します。

void QWidget::repaint(int x, int y, int w, int h)

このバージョンでは、ウィジェット内の矩形（x 、y 、w 、h ）を再描画します。

w が負の値の場合、width() - x に置き換えられ、h が負の値の場合、height() - y に置き換えられます。

void QWidget::resize(int w, int h)

これは、resize(QSize(w,h)) に対応します。

[virtual protected] void QWidget::resizeEvent(QResizeEvent *event)

このイベントハンドラは、サブクラスで再実装して、event パラメータを通じて渡されるウィジェットのリサイズイベントを受け取ることができます。resizeEvent()が呼び出される時点で、ウィジェットはすでに新しいジオメトリを持っています。以前のサイズには、QResizeEvent::oldSize()を通じてアクセスできます。

ウィジェットは、サイズ変更イベントの処理が完了するとすぐに消去され、ペイントイベントを受信します。このハンドラ内では、描画を行う必要はありません（また、行うべきでもありません）。

関連項目： moveEvent()、event()、resize()、QResizeEvent 、paintEvent()、および「Scribble」の例。

bool QWidget::restoreGeometry(const QByteArray &geometry)

バイト配列 `geometry` に格納されている最上位ウィジェットのジオメトリと状態を復元します。成功した場合は `true ` を返し、失敗した場合は `false` を返します。

復元されたジオメトリが画面外にある場合、利用可能な画面ジオメトリ内に収まるように変更されます。

QSettings を使用して保存されたジオメトリを復元するには、次のようなコードを使用できます。

QSettings settings("MyCompany", "MyApp");
myWidget->restoreGeometry(settings.value("myWidget/geometry").toByteArray());

ウィンドウのジオメトリに関する問題の概要については、「ウィンドウのジオメトリ」のドキュメントを参照してください。

QMainWindow::restoreState() を使用して、ジオメトリおよびツールバーやドックウィジェットの状態を復元します。

saveGeometry()、QSettings 、QMainWindow::saveState()、およびQMainWindow::restoreState()も参照してください 。

QByteArray QWidget::saveGeometry() const

トップレベルのウィジェットの現在のジオメトリと状態を保存します。

ウィンドウが閉じられる際にジオメトリを保存するには、次のようにcloseイベントを実装します。

void MyWidget::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    QWidget::closeEvent(event);
}

ウィンドウのジオメトリに関する問題の概要については、「Window Geometry」のドキュメントを参照してください。

ツールバーやドックウィジェットのジオメトリと状態を保存するには、QMainWindow::saveState() を使用してください。

restoreGeometry()、QMainWindow::saveState()、およびQMainWindow::restoreState()も参照してください 。

QScreen *QWidget::screen() const

そのウィジェットが配置されている画面を返します。

setScreen() およびwindowHandle()も参照してください 。

void QWidget::scroll(int dx, int dy)

ウィジェットとその子要素を含めて、dx ピクセル右へ、dy ピクセル下へスクロールします。dx とdy の両方が負の値になる場合があります。

スクロール後、ウィジェットは再描画が必要な領域についてペイントイベントを受け取ります。Qt が不透明であると認識しているウィジェットの場合、これは新しく露出された部分のみです。たとえば、不透明なウィジェットが 8 ピクセル左にスクロールされた場合、右端の幅 8 ピクセルの帯のみが更新されます。

ウィジェットはデフォルトで親のコンテンツを伝播するため、ウィジェットを不透明にするには、autoFillBackground プロパティを設定するか、setAttribute() を使用してQt::WA_OpaquePaintEvent 属性を設定する必要があります。

コンテンツの伝播を使用するウィジェットの場合、スクロールが行われるとスクロール領域全体が更新されます。

「Transparency and Double Buffering」も参照してください 。

void QWidget::scroll(int dx, int dy, const QRect &r)

このバージョンでは、r のみをスクロールし、ウィジェットの子要素は移動しません。

r が空または無効な場合、結果は未定義となります。

QScrollAreaも参照してください 。

void QWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)

on がtrueの場合、このウィジェットのattribute 属性を設定します。そうでない場合は、この属性をクリアします。

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

void QWidget::setBackgroundRole(QPalette::ColorRole role)

ウィジェットの背景ロールを「role 」に設定します。

backgroundロールは、ウィジェットのpalette から、背景の描画に使用されるブラシを定義します。

role がQPalette::NoRole の場合、ウィジェットは親のbackground roleを継承します。

なお、スタイルではパレット内の任意の色を自由に選択できます。setBackgroundRole() を使用しても希望通りの結果が得られない場合は、パレットを変更するか、スタイルシートを設定してください。

backgroundRole() およびforegroundRole()も参照してください 。

void QWidget::setBaseSize(int basew, int baseh)

これは、setBaseSize(QSize(basew,baseh)) に対応します。ウィジェットの基本サイズを、幅basew 、高さbaseh に設定します。

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

void QWidget::setContentsMargins(int left, int top, int right, int bottom)

ウィジェットのコンテンツ周囲の余白を、left 、top 、right 、bottom のサイズに設定します。これらの余白はレイアウトシステムで使用され、サブクラスでは描画対象領域（例：フレームを除く）を指定するために使用される場合があります。

マージンを変更すると、resizeEvent() が発生します。

contentsRect() およびcontentsMargins()も参照してください 。

void QWidget::setContentsMargins(const QMargins &margins)

setContentsMargins 関数は、ウィジェットのコンテンツ周囲の余白を設定します。

ウィジェットのコンテンツ周囲のマージンを、margins で指定されたサイズに設定します。これらのマージンはレイアウトシステムによって使用され、サブクラスでは描画対象領域（例：フレームを除く）を指定するために使用される場合があります。

マージンを変更すると、resizeEvent() が呼び出されます。

contentsRect() およびcontentsMargins()も参照してください 。

[slot] void QWidget::setDisabled(bool disable)

disable が true の場合はウィジェットの入力イベントを無効にし、それ以外の場合は入力イベントを有効にします。

詳細については、enabled のドキュメントを参照してください。

isEnabledTo()、QKeyEvent 、QMouseEvent 、およびchangeEvent()も参照してください 。

void QWidget::setFixedHeight(int h)

ウィジェットの幅を変更せずに、最小高さと最大高さの両方をh に設定します。利便性のために用意されています。

sizeHint()、minimumSize()、maximumSize()、およびsetFixedSize()も参照してください 。

void QWidget::setFixedSize(const QSize &s)

ウィジェットの最小サイズと最大サイズの両方を `s` に設定し、それによってウィジェットが拡大・縮小することを一切防止します。

これにより、QLayout で設定されたデフォルトのサイズ制約が上書きされます。

制約を解除するには、サイズを `QWIDGETSIZE_MAX` に設定してください。

あるいは、ウィジェットをその内容に基づいて固定サイズにしたい場合は、QLayout::setSizeConstraint(QLayout::SetFixedSize) を呼び出すことができます。

maximumSize およびminimumSizeも参照してください 。

void QWidget::setFixedSize(int w, int h)

ウィジェットの幅をw 、高さをh に設定します。

void QWidget::setFixedWidth(int w)

ウィジェットの最小幅と最大幅の両方をw に設定し、高さは変更しません。利便性のために用意されています。

sizeHint()、minimumSize()、maximumSize()、およびsetFixedSize()も参照してください 。

void QWidget::setFocus(Qt::FocusReason reason)

このウィジェットまたはその親のいずれかが「active window 」である場合、キーボードの入力フォーカスをこのウィジェット（またはそのフォーカスプロキシ）に与えます。reason 引数は、この関数から送信されるすべてのフォーカスイベントに渡され、ウィジェットがフォーカスを取得した原因を説明するために使用されます。 ウィンドウがアクティブでない場合、ウィンドウがアクティブになった時点で、このウィジェットにフォーカスが与えられます。

まず、フォーカスが変更されようとしていることを伝えるために、フォーカスウィジェット（存在する場合）に「フォーカス変更直前」イベントが送信されます。 その後、フォーカスが変更されると、以前のフォーカス対象に「フォーカスアウト」イベントが送信され、新しい対象には「フォーカスイン」イベントが送信され、フォーカスが移ったことが通知されます。（フォーカスインとフォーカスアウトの対象が同じウィジェットの場合は、何も起こりません。）

setFocus() は、ウィジェットのフォーカスポリシーに関係なくそのウィジェットにフォーカスを与えますが、キーボードのロックは解除しません（grabKeyboard() を参照）。

ウィジェットが非表示の場合、表示されるまではフォーカスを受け付けないことに注意してください。

関連項目: hasFocus()、clearFocus()、focusInEvent()、focusOutEvent()、setFocusPolicy()、focusWidget()、QApplication::focusWidget()、grabKeyboard()、grabMouse()、ウィジェットでのキーボードフォーカス、およびQEvent::RequestSoftwareInputPanel 。

[slot] void QWidget::setFocus()

このウィジェットまたはその親のいずれかがactive window である場合、キーボードの入力フォーカスをこのウィジェット（またはそのフォーカスプロキシ）に設定します。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        widget, qOverload<>(&QWidget::setFocus));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        widget, [receiver = widget]() { receiver->setFocus(); });

void QWidget::setFocusProxy(QWidget *w)

ウィジェットのフォーカスプロキシをウィジェット `w` に設定します。w が `nullptr` の場合、この関数はこのウィジェットのフォーカスプロキシを解除します。

一部のウィジェットは「フォーカスを持つ」ことができますが、実際にフォーカスを処理するために、QLineEdit のような子ウィジェットを作成します。この場合、そのウィジェットは、ラインエディットを自身のフォーカスプロキシとして設定することができます。

setFocusProxy() は、「このウィジェット」がフォーカスを得た際に、実際にフォーカスを受けるウィジェットを設定します。フォーカスプロキシが存在する場合、setFocus() およびhasFocus() は、そのフォーカスプロキシに対して動作します。「このウィジェット」がフォーカスウィジェットである場合、setFocusProxy() はフォーカスを新しいフォーカスプロキシに移します。

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

void QWidget::setForegroundRole(QPalette::ColorRole role)

ウィジェットの前景色を「role 」に設定します。

フォアグラウンド・ロールは、ウィジェットのpalette から、フォアグラウンドの描画に使用される色を定義します。

role が `QPalette::NoRole` の場合、ウィジェットは背景ロールと対照的な前景色ロールを使用します。

スタイルでは、パレット内の任意の色を自由に選択できることに注意してください。setForegroundRole() を使用して希望の結果が得られない場合は、パレットを変更するか、スタイルシートを設定することができます。

foregroundRole() およびbackgroundRole()も参照してください 。

void QWidget::setGeometry(int x, int y, int w, int h)

これは、setGeometry(QRect(x,y,w,h)) に対応します。

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

void QWidget::setGraphicsEffect(QGraphicsEffect *effect)

setGraphicsEffect 関数は、ウィジェットのグラフィック効果を設定するためのものです。

effect をウィジェットのエフェクトとして設定します。このウィジェットにすでにエフェクトが適用されている場合、QWidget は新しいeffect を適用する前に、既存のエフェクトを削除します。

effect が別のウィジェットにインストールされているエフェクトである場合、setGraphicsEffect() はそのウィジェットからエフェクトを削除し、このウィジェットにインストールします。

QWidget effect の所有権を取得します。

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

[slot] void QWidget::setHidden(bool hidden)

setVisible （!hidden ）と同等の便利関数です。

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

void QWidget::setLayout(QLayout *layout)

このウィジェットのレイアウトマネージャーを「layout 」に設定します。

このウィジェットにすでにレイアウトマネージャーが設定されている場合、QWidget では別のレイアウトマネージャーを設定することはできません。新しいレイアウトで setLayout() を呼び出すには、まず既存のレイアウトマネージャー（layout() によって返されるもの）を削除する必要があります。

layout が別のウィジェットのレイアウトマネージャーである場合、setLayout() によってレイアウトの親が変更され、このウィジェットのレイアウトマネージャーとなります。

例：

QVBoxLayout *layout = new QVBoxLayout;
layout->addWidget(formWidget);
formWidget->setLayout(layout);

この関数を呼び出す代わりに、このウィジェットをレイアウトのコンストラクタに渡すこともできます。

QWidget はlayout の所有権を引き継ぎます。

「 layout()」および「レイアウト管理」も参照してください 。

void QWidget::setMask(const QBitmap &bitmap)

bitmap に対応する1ビットを持つウィジェットのピクセルのみが表示されるようにします。領域にウィジェットのrect()の範囲外のピクセルが含まれている場合、その領域内のウィンドウシステムコントロールは、プラットフォームによっては表示される場合と表示されない場合があります。

なお、領域が特に複雑な場合、この処理に時間がかかることがあります。

以下のコードは、アルファチャンネルを持つ画像を使用してウィジェットのマスクを生成する方法を示しています。

QLabel topLevelLabel;
QPixmap pixmap(":/images/tux.png");
topLevelLabel.setPixmap(pixmap);
topLevelLabel.setMask(pixmap.mask());

このコードで表示されるラベルは、その中に含まれる画像を使用してマスクされており、不規則な形状の画像が画面上に直接描画されているかのように見えます。

マスクされたウィジェットは、表示されている部分でのみマウスイベントを受け取ります。

mask()、clearMask()、およびwindowOpacity()も参照してください 。

void QWidget::setMask(const QRegion &region)

region と重なるウィジェットの部分のみを表示します。その領域にウィジェットのrect() の範囲外にあるピクセルが含まれている場合、その領域内のウィンドウシステムコントロールは、プラットフォームによっては表示される場合と表示されない場合があります。

QRegion を使用すると、任意に複雑な領域を作成できるため、ウィジェットマスクは最も型破りな形状のウィンドウに合わせて作成でき、ウィジェットに穴を開けた状態で表示することも可能です。ただし、領域が特に複雑な場合、この処理に時間がかかることがある点に注意してください。

ウィジェットマスクは、マスク外の領域に対するマウスイベントをアプリケーションが受け付けないことをウィンドウシステムに通知するために使用されます。ほとんどのシステムでは、マスクは粗い視覚的なクリッピングも引き起こします。滑らかなウィンドウの縁を得るには、「半透明の背景」の例に示されているように、代わりに半透明の背景とアンチエイリアス描画を使用してください。

windowOpacityも参照してください 。

void QWidget::setMaximumSize(int maxw, int maxh)

この関数は、setMaximumSize(QSize(maxw,maxh)) に対応します。最大幅をmaxw 、最大高さをmaxh に設定します。

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

void QWidget::setMinimumSize(int minw, int minh)

この関数は、setMinimumSize(QSize(minw, minh)) に対応します。最小幅をminw 、最小高さをminh に設定します。

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

void QWidget::setParent(QWidget *parent)

ウィジェットの親を `parent` に設定し、ウィンドウフラグをリセットします。ウィジェットは、新しい親ウィンドウ内の座標 (0, 0) に移動されます。

新しい親ウィジェットが別のウィンドウ内にある場合、親が変更されたウィジェットとその子ウィジェットは、以前と同じ内部順序で、新しい親ウィジェットのtab chain の末尾に追加されます。移動されたウィジェットのいずれかがキーボードフォーカスを有していた場合、setParent()はそのウィジェットに対してclearFocus()を呼び出します。

新しい親ウィジェットが以前の親ウィジェットと同じウィンドウ内にある場合、親の設定を変更してもタブ順やキーボードフォーカスは変更されません。

「新しい」親ウィジェットが以前の親ウィジェットである場合、この関数は何も行いません。

関連項目： setWindowFlags()。

void QWidget::setParent(QWidget *parent, Qt::WindowFlags f)

この関数は、ウィジェットフラグ（f ）も引数として受け取ります。

void QWidget::setScreen(QScreen *screen)

ウィジェットを表示する画面を `screen` に設定します。

画面の設定はウィンドウに対してのみ有効です。必要に応じて、ウィジェットのウィンドウは `screen` 上で再作成されます。

関連項目： screen() およびQWindow::setScreen()。

void QWidget::setShortcutAutoRepeat(int id, bool enable = true)

enable が true の場合、指定されたid を持つショートカットの自動繰り返し機能が有効になります。そうでない場合は無効になります。

grabShortcut() およびreleaseShortcut()も参照してください 。

void QWidget::setShortcutEnabled(int id, bool enable = true)

enable がtrueの場合、指定されたid を持つショートカットが有効になります。そうでない場合は、ショートカットは無効になります。

grabShortcut() およびreleaseShortcut()も参照してください 。

void QWidget::setSizeIncrement(int w, int h)

x（幅）方向のサイズ増加量をw に、y（高さ）方向のサイズ増加量をh に設定します。

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

void QWidget::setSizePolicy(QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)

ウィジェットのサイズポリシーを「horizontal 」および「vertical 」に設定します。これは、標準のストレッチが適用され、「height-for-width」は適用されません。

sizePolicy() およびQSizePolicy::QSizePolicy()も参照してください 。

void QWidget::setStyle(QStyle *style)

ウィジェットのGUIスタイルをstyle に設定します。スタイルオブジェクトの所有権は譲渡されません。

スタイルが設定されていない場合、ウィジェットは代わりにアプリケーションのスタイルである `QApplication::style()` を使用します。

ウィジェットのスタイルを設定しても、既存または将来の子ウィジェットには影響しません。

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

[static] void QWidget::setTabOrder(QWidget *first, QWidget *second)

フォーカス順序において、「second 」ウィジェットを「first 」ウィジェットの後に配置します。

これにより、second ウィジェットがフォーカスチェーンから事実上除外され、first ウィジェットの後に挿入されます。

なお、second ウィジェットのタブ順序が変更されるため、チェーンの順序は次のように指定する必要があります：

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

このようにしてはいけません：

// WRONG
setTabOrder(c, d); // c to d
setTabOrder(a, b); // a to b AND c to d
setTabOrder(b, c); // a to b to c, but not c to d

first またはsecond にフォーカスプロキシがある場合、setTabOrder() はプロキシを正しく代入します。

setFocusPolicy()、setFocusProxy()、および「ウィジェットにおけるキーボードフォーカス」も参照してください 。

[static, since 6.6] void QWidget::setTabOrder(std::initializer_list<QWidget *> widgets)

widgets リスト内のウィジェットのタブ順序を、連続するウィジェットのペアごとにQWidget::setTabOrder(QWidget *, QWidget *)を呼び出すことで設定します。

次のように各ペアを手動で設定する代わりに：

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

次のように呼び出すことができます：

setTabOrder({a, b, c, d}); // a to b to c to d

この呼び出しは、閉じたタブフォーカスループを作成しません。Qt::TabFocus フォーカスポリシーを持つウィジェットが他にもある場合、d でタブ操作を行うと、フォーカスはそれらのウィジェットのいずれかに移動し、a には戻りません。

この関数は Qt 6.6 で導入されました。

setFocusPolicy()、setFocusProxy()、および「ウィジェットにおけるキーボードフォーカス」も参照してください 。

void QWidget::setWindowFlag(Qt::WindowType flag, bool on = true)

on がtrueの場合、このウィジェットのウィンドウフラグflag を設定します。そうでない場合は、そのフラグをクリアします。

関連項目： setWindowFlags()、windowFlags()、およびwindowType()。

void QWidget::setWindowRole(const QString &role)

ウィンドウのロールを「role 」に設定します。これは、X11上のウィンドウにおいてのみ意味を持ちます。

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

void QWidget::setWindowState(Qt::WindowStates windowState)

ウィンドウの状態をwindowState に設定します。ウィンドウの状態は、Qt::WindowState ：Qt::WindowMinimized 、Qt::WindowMaximized 、Qt::WindowFullScreen 、およびQt::WindowActive の論理和（OR）で構成されます。

ウィンドウが表示されていない場合（つまり、isVisible()がfalse を返す場合）、ウィンドウの状態の変更はshow()が呼び出されたときに有効になります。表示されているウィンドウの場合、変更は即座に反映されます。たとえば、フルスクリーンモードと通常モードを切り替えるには、次のコードを使用します:

w->setWindowState(w->windowState() ^ Qt::WindowFullScreen);

最小化されたウィンドウを復元してアクティブにし（最大化および／または全画面表示の状態を維持したまま）、次のようにします：

w->setWindowState((w->windowState() & ~Qt::WindowMinimized) | Qt::WindowActive);