QWidget Class

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

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

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

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

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

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

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

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

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

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

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

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

Qt::ConnectionTypeアクションのtriggered() シグナルは、あたかもQObject::connect(action, &QAction::triggered, args...) の呼び出しによって接続され、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のリストを持っています。しかし、これらはさまざまな方法でグラフィカルに表現できます。actions() によって返されるQAction リストのデフォルトの使用方法は、コンテキスト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 を処理します。サブクラスでこの関数を再実装することもできますが、代わりに特殊なイベント・ハンドラの1つを使用することをお勧めします。

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

foreground roleを返します。

foreground ロールは、前景を描画するために使用されるウィジェットの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())

指定された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)

この関数は 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

nullptrgraphicsEffect関数は、グラフィックス・ビュー内の対応する埋め込みウィジェットのプロキシ・ウィジェットを返します。

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

幅が指定された場合、このウィジェットの好ましい高さを返します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 、Inputメソッド合成イベントを受け取るためにサブクラスで再実装することができます。このハンドラは、入力メソッドの状態が変化したときに呼び出されます。

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

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

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

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

このメソッドは入力ウィジェットにのみ関係します。このメソッドは、入力メソッドによって、ウィジェットのプロパティのセットを照会するために使用されます。

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 、およびScribbleExampleも参照してください 。

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

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

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

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

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

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

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

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

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

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

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

レンダリング方法を決定するためにrenderFlags を使用して、このウィジェットのsourceRegion を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(),ScribbleExampleも参照 。

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 が真の場合、このウィジェットに属性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)

このウィジェットまたはその親の1つが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()

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

このウィジェットまたはその親の 1 つが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 が true の場合、指定された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では、この関数は特定のウィンドウ・マネージャで正しく動作しない場合があります。詳しくはWindow Geometryドキュメントを参照してください。

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