QWidget Class

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

これらの便利な関数は、テキストtext 、アイコンicon 、ショートカットshortcut があれば、それを持つ新しいアクションを作成します。

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

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

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

これはオーバーロードされた関数である。

この便利な関数は、テキストtext 、アイコンicon 、ショートカットshortcut があれば、それを持つ新しいアクションを作成します。

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

QWidget この関数は、返された の所有権を取ります。QAction

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

これはオーバーロードされた関数である。

これらの便利な関数は、テキストtext 、アイコンicon 、ショートカットshortcut があれば、それを持つ新しいアクションを作成します。

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

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

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

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

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

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

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の場合、アプリケーションが現在アクティブでないときにこれを呼んでも、アクティブ・ウィンドウにはなりません。ウィンドウが何らかの方法で変更されたことを示すために、タスクバーエントリーの色が変更されます。これは、マイクロソフトが、ユーザーが現在別のアプリケーションで行っていることを、アプリケーションが中断することを許可していないためです。

isActiveWindow （）、window （）、show （）も参照の こと。

void QWidget::addAction(QAction *action)

アクションaction をこのウィジェットのアクションリストに追加します。

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

QWidget は各アクションを1つだけ持つべきで、すでに持っているアクションを追加しても、同じアクションが2度ウィジェットに入ることはありません。

action の所有権は、このQWidget には移譲されません。

removeAction(),insertAction(),actions(),QMenuも参照のこと 。

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 を送ります。ウィジェットは、accepts close イベントがあれば、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)

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

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

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

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

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

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

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

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

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

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

• スタック順序; 組み込みウィンドウは、不透明なボックスとしてウィジェット階層の上にスタックします。複数のウィンドウ コンテナ インスタンスが重なった場合のスタック順序は未定義です。
• レンダリングの統合; ウィンドウ コンテナは、QGraphicsProxyWidget 、QWidget::render() または同様の機能とは相互運用しません。
• フォーカス処理; ウィンドウコンテナインスタンスに任意のフォーカスポリシーを持たせることが可能であり、QWindow::requestActivate() の呼び出しによってウィンドウにフォーカスを委譲する。ただし、QWindow インスタンスから通常のフォーカス チェーンに戻るかどうかは、QWindow インスタンスの実装次第です。例えば、Qt Quick をベースとしたウィンドウにタブフォーカスを持ったまま入ると、それ以上タブを押してもQMLアプリケーションの中でしか循環しない可能性が高いです。また、QWindow::requestActivate()が実際にウィンドウにフォーカスを与えるかどうかはプラットフォームに依存します。
• QWidget ベースのアプリケーションで多数のウィンドウコンテナを使用すると、 アプリケーション全体のパフォーマンスが大きく低下する可能性があります。
• 6.7以降では、window がウィジェットに属している場合（つまり、windowHandle （）を呼び出してwindow を受け取った場合）、コンテナは作成されません。parentコンテナは作成されないので、flags は無視される。言い換えると、window がウィジェットに属している場合、この関数を使用する代わりに、そのウィジェットをparent に再ペアレントすることを考えてください。

[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 が真の場合、ウィジェット・ウィンドウを破棄する。

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 パラメータで渡されるウィジェット入力イベントを受け取るために、サブクラスで再実装することができます。

マウスカーソルがウィジェットに入ると、イベントがウィジェットに送られます。

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 パラメータで渡されます。

ウィジェットは通常、フォーカス・イベントを受け取るために、Qt::NoFocus 以外にsetFocusPolicy() を指定する必要があります。(アプリケーション・プログラマは、通常はフォーカスを受け取らないウィジェットでも、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 が真なら、この関数は前方を検索し、next が偽なら、後方を検索する。

この関数を再実装したい場合もあるでしょう。たとえば、ウェブ・ブラウザはこの関数を再実装して、"現在のアクティブなリンク "を前方または後方に移動し、"ページ "上の最後のリンクまたは最初のリンクに到達したときだけfocusNextPrevChild()を呼び出すことができます。

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

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

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

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

ウィジェットは通常、Qt::NoFocus 以外にsetFocusPolicy() を指定して、フォーカス・イベントを受け取らなければなりません。(アプリケーション・プログラマは、通常はフォーカスを受け付けないウィジェットであっても、どのウィジェットでも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 で制限された pixmap にウィジェットをレンダリングします。ウィジェットに子ウィジェットがある場合、それらも適切な位置に描画されます。

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

render() およびQPixmapも参照して ください。

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

ウィジェットを特定のflags で指定されたgesture にサブスクライブする。

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)

この関数は grabMouse() をオーバーロードする。

マウス入力をつかみ、カーソルの形状を変更する。

カーソルは（マウスフォーカスがつかまれている間）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 関数は、ウィジェットのグラフィック効果へのポインタを返します。

ウィジェットにグラフィック効果がない場合は、nullptr が返されます。

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

QGraphicsProxyWidget *QWidget::graphicsProxyWidget() const

グラフィックスビューの対応する埋め込みウィジェットのプロキシウィジェットを返します。そうでない場合はnullptr を返します。

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

bool QWidget::hasEditFocus() const

このウィジェットが現在編集フォーカスを持っている場合はtrue を返し、そうでない場合は false を返します。

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

setEditFocus() およびQApplication::navigationMode()も参照してください 。

[virtual] bool QWidget::hasHeightForWidth() const

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

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

widthw を指定すると、このウィジェットの優先高さを返します。

このウィジェットにレイアウトがある場合、デフォルトの実装は、レイアウトの優先的な高さを返します。レイアウトがない場合、デフォルトの実装は、優先的な高さが幅に依存しないことを示す -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 window属性を明示的に（setAttribute （）関数を使用して）設定する必要があることに注意してください。

デフォルトの実装では、event->ignore()を呼び出し、Input Methodイベントを拒否します。詳細はQInputMethodEvent のドキュメントを参照してください。

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

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

このメソッドは入力ウィジェットにのみ関連する。囲みテキストと再変換のサポートとして複雑な入力メソッド操作をサポートできるように、ウィジェットのプロパティのセットを照会するために input メソッドによって使用されます。

query は、照会されるプロパティを指定します。

inputMethodEvent(),QInputMethodEvent,QInputMethodQueryEvent,inputMethodHintsも参照のこと 。

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

アクションbefore の前に、アクションaction をこのウィジェットのアクションリストに挿入する。before がnullptr であるか、before がこのウィジェットの有効なアクションでない場合、アクションを追加します。

QWidget は、各アクションを1つだけ持つべきです。

removeAction(),addAction(),QMenu,contextMenuPolicy,actions()も参照 。

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

アクションbefore の前に、アクションactions をこのウィジェットのアクションリストに挿入する。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 までの親も、明示的に非表示にされていない場合に発生する。

この関数は、ウィジェットが画面上の他のウィンドウによって隠されている場合でも真を返します。

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.

virtualQPaintDevice::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::pos() は、このウィジェットからの相対的なマウスカーソルの位置を報告します。押したり離したりするイベントの場合、位置は通常、最後のマウス移動イベントの位置と同じです。これは Qt ではなく、基本的なウィンドウ・システムの機能です。

マウスが動いている間、すぐにツールチップを表示したい場合（例えば、QMouseEvent::pos()でマウス座標を取得し、それをツールチップとして表示したい場合）、まず、上記のようにマウストラッキングを有効にする必要があります。それから、ツールチップが直ちに更新されるようにするために、mouseMoveEvent() の実装でsetToolTip() の代わりにQToolTip::showText() を呼び出す必要があります。

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

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

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

mousePressEvent()で新しいウィジェットを作成する場合、mouseReleaseEvent()は期待した場所に配置されないかもしれません。これは、基本的なウィンドウ・システム（またはX11ウィンドウ・マネージャ）、ウィジェットの位置、およびその他に依存します。

デフォルトの実装では、ウィンドウの外側をクリックするとポップアップ・ウィジェットが閉じます。他のタイプのウィジェットでは何もしません。

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

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

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

mousePressEvent(),mouseDoubleClickEvent(),mouseMoveEvent(),event(),QMouseEvent, およびScribble Exampleも参照してください 。

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() を使用することをお勧めします。

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

背景はsetBackgroundRole() とsetPalette() で設定できます。

Qt 4.0 以降、QWidget は自動的にペイントをダブルバッファリングするので、フリッカを避けるために paintEvent() でダブルバッファリングのコードを書く必要はありません。

event(),repaint(),update(),QPainter,QPixmap,QPaintEvent, およびAnalog Clockも参照してください 。

QWidget *QWidget::parentWidget() const

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

QWidget *QWidget::previousInFocusChain() const

previousInFocusChain 関数は、このウィジェットのフォーカスチェーン内の前のウィジェットを返します。

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

[slot] void QWidget::raise()

このウィジェットを親ウィジェットのスタックの先頭に上げます。

この呼び出しの後、ウィジェットは、重なっている兄弟ウィジェットの前に表示されます。

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

void QWidget::releaseKeyboard()

キーボードのグラブを解除する。

grabKeyboard(),grabMouse(),releaseMouse()も参照 。

void QWidget::releaseMouse()

マウス・グラブを解除する。

grabMouse(),grabKeyboard(),releaseKeyboard()も参照 。

void QWidget::releaseShortcut(int id)

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

grabShortcut() とsetShortcutEnabled()も参照して ください。

void QWidget::removeAction(QAction *action)

このウィジェットのアクションリストからアクションaction を削除します。

insertAction(),actions(),insertAction()も参照してください 。

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

このウィジェットのsourceRegion を、renderFlags を使ってtarget にレンダリングします。レンダリングは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 の処理速度を最適化し、ちらつきを抑えることができます。

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 Exampleも参照してください 。

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);
}

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

ジオメトリとツールバーおよびドックウィジェットの状態を保存するには、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 に設定します。

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

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

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

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

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

これはオーバーロードされた関数である。

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

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::setEditFocus(bool enable)

enable が true の場合、このウィジェットに編集フォーカスを持たせます。この場合、Qt::Key_Up とQt::Key_Down は通常通りウィジェットに配信されます。そうでない場合、Qt::Key_Up とQt::Key_Down がフォーカスの変更に使用されます。

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

hasEditFocus() とQApplication::navigationMode()も参照してください 。

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 引数は、この関数から送信されるフォーカスイベントに渡されます。これは、ウィジェットがフォーカスを得た原因の説明を与えるために使用されます。ウィンドウがアクティブでない場合、ウィンドウがアクティブになると、ウィジェットにフォーカスが与えられます。

まず、focus about to changeイベントがフォーカスウィジェット（もしあれば）に送られ、フォーカスが失われようとしていることを伝えます。そして、フォーカスが変更されると、前のフォーカス・アイテムに focus out イベントが送られ、新しいアイテムに focus in イベントが送られ、フォーカスを受け取ったことを伝えます。(フォーカス・インとフォーカス・アウトのウィジェットが同じ場合は、何も起こりません）。

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

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

hasFocus()、clearFocus()、focusInEvent()、focusOutEvent()、setFocusPolicy()、focusWidget()、QApplication::focusWidget()、grabKeyboard()、grabMouse()、ウィジェットのキーボード・フォーカス、QEvent::RequestSoftwareInputPanelも参照して ください。

[slot] void QWidget::setFocus()

これはオーバーロードされた関数です。

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

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)) に対応します。

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);
    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 に設定します。

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

これはオーバーロードされた関数である。

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

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 が真の場合、与えられたid を持つショートカットが有効になり、そうでない場合、そのショートカットは無効になります。

grabShortcut() とreleaseShortcut()も参照して ください。

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

これはオーバーロードされた関数である。

x（幅）サイズのインクリメントをw に、y（高さ）サイズのインクリメントをh に設定します。

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

これはオーバーロードされた関数です。

ウィジェットのサイズポリシーをhorizontal とvertical に設定します。

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)

first ウィジェットの後にsecond ウィジェットを置く。

これは事実上、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)

これはオーバーロードされた関数です。

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

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

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 に戻らず、それらのウィジェットの 1 つに移動します。

この関数は 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 の組み合わせである。

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

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

最小化されたウィンドウを（最大化および／またはフルスクリーンの状態を維持したまま）復元してアクティブにするには、次のようにします：

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

この関数を呼び出すと、ウィジェットが非表示になります。ウィジェットを再び表示するには、show()を呼び出す必要があります。

ウィンドウの状態が変化すると、ウィジェットはQEvent::WindowStateChange 型のchangeEvent() を受け取る。

Qt::WindowState とwindowState()も参照してください 。

void QWidget::setupUi(QWidget *widget)

指定されたwidget のユーザインタフェースを設定します。

アプリケーションでデザイナ UI ファイルを使用する」も参照してください 。

[slot] void QWidget::show()

ウィジェットとその子ウィジェットを表示する。

子ウィンドウの場合、これはsetVisible(true)を呼び出すのと同じである。そうでない場合は、showFullScreen(),showMaximized(),setVisible(true)を呼び出すのと同じである。これは、ウィンドウ・フラグに対するプラットフォームのデフォルト動作に依存する。

raise()、showEvent()、hide()、setVisible()、showMinimized()、showMaximized()、showNormal()、isVisible()、windowFlags()も参照 。

[virtual protected] void QWidget::showEvent(QShowEvent *event)

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

非自発的なショーイベントは、ウィジェットが表示される直前に送られます。ウィンドウの自発的な表示イベントは、その後に配信されます。

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

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

[slot] void QWidget::showFullScreen()

ウィジェットをフルスクリーンモードで表示する。

この関数を呼び出すと、windows にのみ影響する。

フルスクリーンモードから戻るには、showNormal() またはclose() を呼び出す。

別の方法として、ウィンドウマネージャを完全にバイパスして、Qt::X11BypassWindowManagerHint フラグでウィンドウを作成することもできます。しかし、これにはキーボードフォーカスが壊れたり、デスクトップが変更されたり、ユーザーが他のウィンドウを立ち上げたりしたときに非常に奇妙な影響が出るなど、深刻な問題があります。

最新のICCCM以降の仕様に従ったX11ウィンドウ・マネージャーは、フルスクリーン・モードを適切にサポートしています。

macOSでは、ウィンドウをフルスクリーン表示すると、アプリケーション全体がフルスクリーンモードになり、専用のデスクトップが提供されます。アプリケーションがフルスクリーンモードで動作している間に別のウィンドウを表示すると、そのウィンドウも自動的にフルスクリーンになる場合があります。これを防ぐには、別のウィンドウを表示する前に、showNormal() を呼び出すか、フルスクリーンウィンドウでclose() を呼び出して、フルスクリーンモードを終了する。

showNormal()、showMaximized()、show()、isVisible()、close()も参照のこと 。

[slot] void QWidget::showMaximized()

ウィジェットを最大化して表示する。

この関数を呼び出すと、windows にのみ影響します。

X11では、この関数は特定のウィンドウマネージャで正しく動作しない場合があります。説明についてはウィンドウのジオメトリのドキュメントを参照してください。

setWindowState(),showNormal(),showMinimized(),show(),hide(),isVisible()も参照 。

[slot] void QWidget::showMinimized()

最小化されたウィジェットをアイコンで表示する。

この関数の呼び出しは、windows にのみ影響する。

showNormal(),showMaximized(),show(),hide(),isVisible(),isMinimized()も参照 。

[slot] void QWidget::showNormal()

最大化または最小化されたウィジェットを復元する。

この関数の呼び出しは、windows にのみ影響する。

setWindowState(),showMinimized(),showMaximized(),show(),hide(),isVisible()も参照 。

void QWidget::stackUnder(QWidget *w)

親ウィジェットのスタック内のw の下にウィジェットを配置します。

これを動作させるには、ウィジェット自身とw が兄弟でなければなりません。

raise() とlower()も参照してください 。

QStyle *QWidget::style() const

QWidget::setStyle （）、QApplication::setStyle （）、QApplication::style （）も参照のこと 。

[virtual protected] void QWidget::tabletEvent(QTabletEvent *event)

このイベント・ハンドラは、イベントevent 、ウィジェットのタブレット・イベントを受け取るために、サブクラスで再実装することができます。

このハンドラを再実装する場合、ウィジェットの親がイベントを解釈できるように、イベントを処理しない場合はignore() することが非常に重要です。

デフォルトの実装では、イベントは無視されます。

タブレットトラッキングがオフの場合、タブレット移動イベントは、スタイラスがタブレットに接触しているか、スタイラスの移動中にスタイラスボタンが 1 つ以上押されている場合にのみ発生します。タブレットトラッキングがオンの場合、スタイラスがタブレットの近くにあり、ボタンが押されていなくても、タブレット移動イベントが発生します。

QEvent::ignore(),QEvent::accept(),event(),setTabletTracking(),QTabletEventも参照してください 。

bool QWidget::testAttribute(Qt::WidgetAttribute attribute) const

属性attribute がこのウィジェットに設定されている場合はtrue を返し、そうでない場合はfalse を返します。

setAttribute()も参照 。

bool QWidget::underMouse() const

ウィジェットがマウスカーソルの下にある場合はtrue を返し、そうでない場合はfalse を返します。

ドラッグ・アンド・ドロップ操作の間、この値は正しく更新されません。

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

void QWidget::ungrabGesture(Qt::GestureType gesture)

指定されたgesture タイプからウィジェットの購読を解除する。

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

[slot] void QWidget::update()

更新が無効になっているか、ウィジェットが非表示になっていない限り、ウィジェットを更新します。

この関数は即座に再描画を行うのではなく、Qt がメイン・イベント・ループに戻ったときに処理されるように、ペイント・イベントをスケジュールします。これにより Qt は、repaint() を呼び出すよりも高速でちらつきの少ない最適化を行うことができます。

通常、update() を数回呼び出すと、paintEvent() を 1 回呼び出すだけです。

Qt は通常、paintEvent() 呼び出しの前にウィジェットの領域を消去します。Qt::WA_OpaquePaintEvent ウィジェット属性が設定されている場合、ウィジェットはそのすべてのピクセルを不透明色で塗る責任があります。

repaint(),paintEvent(),setUpdatesEnabled(),アナログ時計も参照してください 。

void QWidget::update(const QRect &rect)

これはオーバーロードされた関数である。

このバージョンは、ウィジェット内の矩形rect を更新します。

void QWidget::update(const QRegion &rgn)

これはオーバーロードされた関数である。

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

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

これはオーバーロードされた関数である。

このバージョンは、ウィジェット内の矩形 (x,y,w,h) を更新します。

void QWidget::updateGeometry()

このウィジェットが変更され、ジオメトリを変更する必要があるかもしれないことをレイアウトシステムに通知する。

sizeHint() またはsizePolicy() が変更された場合、この関数を呼び出します。

明示的に非表示にされたウィジェットの場合、updateGeometry() は省略できません。ウィジェットが表示されると、レイアウトシステムに通知されます。

[protected slot] void QWidget::updateMicroFocus(Qt::InputMethodQuery query = Qt::ImQueryAll)

ウィジェットのマイクロフォーカスを更新し、query で指定された状態が変更されたことを入力メソッドに通知します。

QRegion QWidget::visibleRegion() const

ペイントイベントが発生する、遮蔽されていない領域を返します。

可視ウィジェットの場合、これは他のウィジェットに覆われていない領域の近似値であり、そうでない場合、これは空の領域です。

repaint() 関数は必要に応じてこの関数を呼び出すので、通常は呼び出す必要はありません。

[virtual protected] void QWidget::wheelEvent(QWheelEvent *event)

このイベント・ハンドラは、イベントevent 、ウィジェットのホイール・イベントを受け取るためにサブクラスで再実装することができます。

このハンドラを再実装する場合、ウィジェットの親がイベントを解釈できるように、イベントを処理しない場合はignore() することが非常に重要です。

デフォルトの実装では、イベントは無視されます。

QEvent::ignore(),QEvent::accept(),event(),QWheelEventも参照してください 。

WId QWidget::winId() const

ウィジェットのウィンドウシステム識別子を返します。

原理的にはポータブルですが、これを使うとポータブルでないことをしようとしている可能性があります。注意してください。

ウィジェットが非ネイティブ（エイリアン）であり、winId()が呼び出された場合、そのウィジェットにはネイティブハンドルが提供されます。

この値は実行時に変更される可能性があります。ウィンドウシステム識別子が変更されると、QEvent::WinIdChange タイプのイベントがウィジェットに送られます。

find()も参照 。

QWidget *QWidget::window() const

このウィジェットのウィンドウ、つまり、ウィンドウシステムフレームを持つ(または持つ可能性のある)次の祖先ウィジェットを返します。

ウィジェットがウィンドウの場合、ウィジェット自体が返されます。

典型的な使用法は、ウィンドウのタイトルを変更することです：

aWidget->window()->setWindowTitle("New Window Title");

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

QWindow *QWidget::windowHandle() const

これがネイティブ・ウィジェットの場合、関連するQWindow を返します。そうでない場合は null を返します。

ネイティブ・ウィジェットには、トップレベル・ウィジェット、QGLWidget、およびwinId() が呼び出された子ウィジェットが含まれます。

winId() およびscreen()も参照してください 。