QWindow Class

メンバ関数ドキュメント

[explicit] QWindow::QWindow(QScreen *targetScreen = nullptr)

targetScreen のトップレベルとしてウィンドウを作成する。

このウィンドウは、setVisible(true) やshow() などが呼び出されるまで表示されない。

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

[explicit] QWindow::QWindow(QWindow *parent)

与えられたparent ウィンドウの子ウィンドウを作成します。

ウィンドウは親ウィンドウの内部に埋め込まれ、その座標は親ウィンドウからの相対座標となります。

スクリーンは親から継承されます。

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

[virtual noexcept] QWindow::~QWindow()

窓を破壊する。

[slot] void QWindow::alert(int msec)

アラートをmsec ミリ秒間表示する。msec が0 (デフォルト) の場合、 ウィンドウが再びアクティブになるまで、 アラートは無期限に表示される。この関数はアクティブなウィンドウには影響しない。

アラート状態では、ウィンドウは、タスクバーのエントリを点滅させたり、バウンスさせるなどして、注意を促していることを示す。

QSize QWindow::baseSize() const

ウィンドウの基本サイズを返します。

setBaseSize()も参照 。

[slot] bool QWindow::close()

ウィンドウを閉じる。

これはウィンドウを閉じ、事実上destroy() を呼び出し、アプリケーションを終了する可能性があります。成功した場合はtrue を返し、親ウィンドウがある場合は false を返します (この場合、トップレベルのウィンドウを閉じる必要があります)。

destroy()、QGuiApplication::quitOnLastWindowClosed()、closeEvent()も参照 。

[virtual protected] void QWindow::closeEvent(QCloseEvent *ev)

クローズ・イベント (ev) を処理するためにオーバーライドします。

この関数は、ウィンドウが閉じるように要求されたときに呼び出されます。ウィンドウが閉じないようにしたい場合は、このイベントでQEvent::ignore() を呼び出します。

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

void QWindow::create()

ウィンドウに関連するプラットフォームリソースを割り当てる。

この時点で、setFormat （）を使用して設定されたサーフェスフォーマットが、実際のネイティブサーフェスに解決される。ただし、setVisible （）が呼び出されるまで、ウィンドウは隠されたままである。

この関数は、show()、setVisible()、winId() など、プラットフォーム・リソースへのアクセスを必要とする関数から暗黙的に呼び出されるため、通常はこの関数を直接呼び出す必要はない。

必要に応じてdestroy() を呼び出して、プラットフォーム・リソースを解放する。

destroy()も参照 。

QCursor QWindow::cursor() const

このウィンドウのカーソル形状

setCursor() およびunsetCursor()も参照のこと 。

void QWindow::destroy()

このウィンドウに関連付けられたネイティブ・プラットフォーム・リソースを解放する。

create()も参照 。

qreal QWindow::devicePixelRatio() const

ウィンドウの物理ピクセルとデバイスに依存しないピクセルの比率を返します。この値はウィンドウが表示されている画面に依存し、ウィンドウを移動すると変化する可能性があります。

一般的な値は、通常のディスプレイでは1.0、Appleの "retina "ディスプレイでは2.0です。

QScreen::devicePixelRatio()も参照のこと 。

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

再インプリメント：QObject::event(QEvent *e)。

ウィンドウに送られたイベント (ev) を処理するためにオーバーライドします。イベントが認識され、処理された場合はtrue を返します。

マウス・イベント、キー・イベント、リサイズ・イベントなどを通常どおりにディスパッチしたい場合は、ベース・クラスのバージョンを呼び出すことを忘れないでください。

[virtual protected] void QWindow::exposeEvent(QExposeEvent *ev)

exposeイベント(ev)は、ウィンドウが非露出状態と露出状態の間を移動するときにウィンドウ・システムから送られます。

公開されたウィンドウはユーザーから見える可能性があります。ウィンドウが画面外に移動したり、他のウィンドウで完全に隠されたり、最小化されたりすると、この関数が呼び出され、isExposed() の値が false に変更される可能性があります。このイベントを使用して、ウィンドウが露出しているときにのみ実行されるアニメーションなどの高価な操作を制限することができます。

このイベントはペイントに使用しないでください。ペイントを処理するには、代わりにpaintEvent() を実装してください。

ウィンドウが最初に表示されるとき、resizeイベントは常にexposeイベントの前に送信されます。

paintEvent() およびisExposed()も参照してください 。

QString QWindow::filePath() const

このウィンドウが表すファイル名。

setFilePath()も参照 。

[virtual protected] void QWindow::focusInEvent(QFocusEvent *ev)

これをオーバーライドして、フォーカス・イン・イベント (ev) を処理します。

Focus in イベントは、ウィンドウがキーボード フォーカスを受け取ったときに送られます。

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

[virtual] QObject *QWindow::focusObject() const

キーイベントなど、フォーカスに結びついたイベントの最終受信者となるQObject を返します。

[signal] void QWindow::focusObjectChanged(QObject *object)

このシグナルは、フォーカスに結びついたイベントの最終レシーバーがobject に変更されたときに発せられる。

focusObject()も参照のこと 。

[virtual protected] void QWindow::focusOutEvent(QFocusEvent *ev)

これをオーバーライドして、フォーカス・アウト・イベント (ev) を処理します。

フォーカスアウトイベントは、ウィンドウがキーボードフォーカスを失ったときに送られます。

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

[override virtual] QSurfaceFormat QWindow::format() const

再実装：QSurface::format() const.

このウィンドウの実際のフォーマットを返します。

ウィンドウが作成された後、この関数はウィンドウの実際の表面フォーマットを返します。要求されたフォーマットがプラットフォームによって満たされなかった場合、要求されたフォーマットとは異なるかもしれません。また、スーパーセットになる可能性もあります。例えば、特定のバッファサイズが要求されたサイズより大きくなる可能性があります。

setFormat()、create()、requestedFormat()、QOpenGLContext::format()も参照 。

QRect QWindow::frameGeometry() const

ウィンドウ・フレームを含むウィンドウのジオメトリを返す。

ジオメトリは、スクリーンの virtualGeometry() に関連している。

geometry() およびframeMargins()も参照 。

QMargins QWindow::frameMargins() const

ウィンドウを囲む枠の余白を返します。

geometry() およびframeGeometry()も参照 ください。

QPoint QWindow::framePosition() const

ウィンドウ・フレームを含むウィンドウの左上の位置を返します。

これはframeGeometry().topLeft() と同じ値を返します。

setFramePosition()、geometry()、frameGeometry()も参照 。

[static] QWindow *QWindow::fromWinId(WId id)

他のプロセスや Qt 以下のネイティブ・ライブラリによって作成されたウィンドウのローカル表現を作成します。

ネイティブウィンドウへのハンドルid が与えられると、このメソッドはQWindow オブジェクトを作成します。このオブジェクトは、setParent() やsetTransientParent() のようなメソッドを呼び出すときに、ウィンドウを表現するために使用できます。

これをサポートするプラットフォームでは、QWindow をネイティブウィンドウの中に埋め込んだり、QWindow の中にネイティブウィンドウを埋め込んだりするために使用できる。

外部ウィンドウがサポートされていない場合や、プラットフォーム・プラグインでネイティブ・ウィンドウの埋め込みに失敗した場合、この関数はnullptr を返します。

setParent()も参照のこと 。

QRect QWindow::geometry() const

ウィンドウフレームを除いたウィンドウのジオメトリを返す。

ジオメトリはスクリーンの virtualGeometry() に関連している。

setGeometry()、frameMargins()、frameGeometry()も参照 。

[slot] void QWindow::hide()

ウィンドウを隠す。

setVisible(false)を呼び出すのと同じ。

show() およびsetVisible()も参照 。

[virtual protected] void QWindow::hideEvent(QHideEvent *ev)

非表示イベント (ev) を処理するためにオーバーライドします。

この関数は、ウィンドウがウィンドウシステムで非表示を要求されたときに呼び出されます。

QIcon QWindow::icon() const

ウィンドウシステムにおけるウィンドウのアイコンを返します。

setIcon()も参照 。

bool QWindow::isActive() const

ウィンドウがアクティブな場合はtrue を返す。

これは、入力フォーカスを持つウィンドウと、フォーカス ウィンドウと同じ親/一時的な親チェーンにあるウィンドウの場合です。

通常、アクティブなウィンドウはスタイルの観点からアクティブに見えるはずです。

現在フォーカスを持つウィンドウを取得するには、QGuiApplication::focusWindow() を使用します。

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

bool QWindow::isAncestorOf(const QWindow *child, QWindow::AncestorMode mode = IncludeTransients) const

ウィンドウが与えられたchild の祖先である場合、true を返します。mode がIncludeTransients の場合、一時的な親も祖先とみなされる。

bool QWindow::isExposed() const

このウィンドウがウィンドウシステムで公開されているかどうかを返します。

ウィンドウが公開されていない場合、アプリケーションによって表示されますが、ウィンドウシステムにはまだ表示されていないため、アプリケーションはアニメーションやその他のグラフィカルなアクティビティを最小化する必要があります。

この値が変更されるたびに、exposeEvent （）が送信される。

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

bool QWindow::isModal() const

ウィンドウがモーダルかどうかを返します。

モーダルウィンドウは、他のウィンドウからの入力を防ぎます。

QWindow::modalityも参照してください 。

bool QWindow::isTopLevel() const

ウィンドウがトップレベルであるかどうか、つまり親ウィンドウを持たないかどうかを返します。

[virtual protected] void QWindow::keyPressEvent(QKeyEvent *ev)

これをオーバーライドしてキー押下イベントを処理する (ev)。

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

[virtual protected] void QWindow::keyReleaseEvent(QKeyEvent *ev)

これをオーバーライドして、キー・リリース・イベント (ev) を処理する。

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

[slot] void QWindow::lower()

ウィンドウシステムのウィンドウを下げる。

ウィンドウを下げて他のウィンドウの下に表示するように要求する。

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

グローバルスクリーン座標pos をウィンドウ座標に変換します。

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

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

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

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

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

ウィンドウ座標pos をグローバルスクリーン座標に変換する。例えば、mapToGlobal(QPointF(0,0)) はウィンドウの左上ピクセルのグローバル座標を与えます。

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

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

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

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

QRegion QWindow::mask() const

ウィンドウに設定されているマスクを返す。

マスクは、アプリケーションが指定された領域外のマウスやタッチ入力を受け取りたくないことをウィンドウシステムに示すヒントです。

setMask()も参照 。

QSize QWindow::maximumSize() const

ウィンドウの最大サイズを返します。

setMaximumSize()も参照 。

QSize QWindow::minimumSize() const

ウィンドウの最小サイズを返します。

setMinimumSize()も参照 。

[signal] void QWindow::modalityChanged(Qt::WindowModality modality)

このシグナルは Qwindow::modality プロパティがmodality に変更されたときに発行されます。

[virtual protected] void QWindow::mouseDoubleClickEvent(QMouseEvent *ev)

これをオーバーライドして、マウスのダブルクリック・イベントを処理する (ev)。

mousePressEvent() およびQStyleHints::mouseDoubleClickInterval()も参照してください 。

[virtual protected] void QWindow::mouseMoveEvent(QMouseEvent *ev)

マウス移動イベント (ev) を処理するためにオーバーライドします。

[virtual protected] void QWindow::mousePressEvent(QMouseEvent *ev)

マウス押下イベント (ev) を処理するためにオーバーライドします。

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

[virtual protected] void QWindow::mouseReleaseEvent(QMouseEvent *ev)

マウス・リリース・イベント (ev) を処理するためにオーバーライドします。

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

[virtual protected] void QWindow::moveEvent(QMoveEvent *ev)

ウィンドウ移動イベント (ev) を処理するためにオーバーライドします。

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

これをオーバーライドして、プラットフォーム依存のイベントを処理する。eventType 、message 、result 。

これはアプリケーションを移植不可能にするかもしれません。

イベントが処理された場合のみ、true を返すようにします。

[virtual protected, since 6.0] void QWindow::paintEvent(QPaintEvent *ev)

ペイント・イベント (ev) は、ウィンドウの再描画が必要なときにウィンドウ・システムから送信されます。例えば、ウィンドウを最初に表示するときや、他のウィンドウの移動によってウィンドウの一部が隠された場合などです。

アプリケーションは、ウィンドウの露出状態に関係なく、ペイントイベントに応答してウィンドウにレンダリングすることが期待されます。例えば、paint イベントはウィンドウが公開される前に送信され、ユーザーに表示する準備をします。

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

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

QWindow *QWindow::parent(QWindow::AncestorMode mode = ExcludeTransients) const

親ウィンドウがあればそれを返す。

mode がIncludeTransients の場合、親がなければ一時的な親が返されます。

親を持たないウィンドウはトップレベルウィンドウと呼ばれます。

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

QPoint QWindow::position() const

ウィンドウフレームを除いたデスクトップ上のウィンドウの位置を返します。

setPosition()も参照の こと。

[slot] void QWindow::raise()

ウィンドウシステムのウィンドウを上げる。

ウィンドウを他のウィンドウより上に表示するよう要求する。

[slot] void QWindow::requestActivate()

ウィンドウをアクティブにする、つまりキーボード・フォーカスを受けるように要求する。

isActive() およびQGuiApplication::focusWindow()も参照 。

[slot] void QWindow::requestUpdate()

このウィンドウに配信されるQEvent::UpdateRequest イベントをスケジュールする。

イベントは、それが可能なプラットフォームでは、ディスプレイのvsyncに同期して配信される。そうでない場合、イベントは最大5ミリ秒の遅延の後に配信される。ウィンドウの関連スクリーンが60Hzより高いrefresh rate を報告する場合、間隔は5より小さい値に縮小されます。追加の時間は、イベントループにシステムイベントを収集するためのアイドル時間を与えるためにあり、QT_QPA_UPDATE_IDLE_TIME環境変数を使用してオーバーライドすることができます。

アニメーションを駆動する場合、この関数は描画が完了した後に一度だけ呼び出す必要があります。この関数を複数回呼び出すと、1つのイベントがウィンドウに配信されます。

QWindow のサブクラスは、event() を再実装し、イベントをインターセプトしてアプリケーションのレンダリング コードを呼び出した後、ベース クラスの実装を呼び出す必要があります。

QSurfaceFormat QWindow::requestedFormat() const

このウィンドウの要求されたサーフェスフォーマットを返す。

要求されたフォーマットがプラットフォームの実装でサポートされていない場合、requestedFormatは実際のウィンドウのフォーマットとは異なります。

これはsetFormat() で設定された値である。

setFormat() およびformat()も参照 。

void QWindow::resize(const QSize &newSize)

ウィンドウ・フレームを除いたウィンドウのサイズを設定します。newSize

size() およびgeometry()も参照のこと 。

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

ウィンドウ・フレームを除いたウィンドウのサイズを、幅w と高さから構成されるQSize に設定する。h

対話的にウィンドウのサイズを変更する方法については、startSystemResize() を参照すること。

size() およびgeometry()も参照 。

[virtual protected] void QWindow::resizeEvent(QResizeEvent *ev)

これをオーバーライドして、リサイズ・イベント (ev) を処理します。

ウィンドウ・システムでウィンドウのサイズが変更されるたびに、resize イベントが呼び出されます。このイベントは、ウィンドウ・システムがsetGeometry() またはresize() リクエストを確認することによって直接呼び出されるか、ユーザーが手動でウィンドウのサイズを変更することによって間接的に呼び出されます。

QScreen *QWindow::screen() const

ウィンドウが表示されている画面を返す。

子ウィンドウの場合は、対応するトップレベル・ウィンドウの画面を返します。

setScreen() およびQScreen::virtualSiblings()も参照 。

[signal] void QWindow::screenChanged(QScreen *screen)

このシグナルは、ウィンドウのscreen が変更されたときに発せられる。setScreen() で明示的に設定されるか、ウィンドウのスクリーンが取り除かれたときに自動的に設定される。

void QWindow::setBaseSize(const QSize &size)

ウィンドウのベースサイズsize を設定する。

ベースサイズは、ウィンドウがsizeIncrement() を定義している場合に、適切なウィンドウサイズを計算するために使用されます。

setMinimumSize()、setMaximumSize()、setSizeIncrement() およびbaseSize()も参照 。

void QWindow::setCursor(const QCursor &cursor)

このウィンドウのカーソル形状を設定する

オーバーライド・カーソルが設定されていない限り、マウスcursor がこのウィンドウの上にあるとき、この形状になります。便利な形状についてはlist of predefined cursor objects を参照のこと。

カーソルが設定されていない場合、またはunsetCursor() を呼び出した後は、親ウィンドウのカーソルが使用される。

デフォルトでは、カーソルの形状はQt::ArrowCursor です。

親ウィンドウの実装によっては、マウスがつかまれてもカーソルがウィンドウから離れるとリセットされます。ウィンドウの外でもすべてのウィンドウにカーソルを設定したい場合は、QGuiApplication::setOverrideCursor() を検討してください。

cursor() およびQGuiApplication::setOverrideCursor()も参照して ください。

void QWindow::setFilePath(const QString &filePath)

このウィンドウが表すファイル名を設定する。

ウィンドウシステムはfilePath を使って、このウィンドウが表すドキュメントのパスをタイルバーに表示することができる。

filePath()も参照 。

void QWindow::setFlag(Qt::WindowType flag, bool on = true)

on が true ならばこのウィンドウにウィンドウフラグflag を設定し、そうでなければフラグをクリアする。

setFlags()、flags()、type()も参照 。

void QWindow::setFormat(const QSurfaceFormat &format)

ウィンドウのサーフェスformat を設定します。

フォーマットは、色深度、アルファ、深度、ステンシル・バッファ・サイズなどのプロパティを決定します。例えば、ウィンドウに透明な背景を与えることができます（ウィンドウシステムが合成をサポートしており、ウィンドウ内の他のコンテンツがウィンドウを再び不透明にしないことが条件です）：

QSurfaceFormat format;
format.setAlphaBufferSize(8);
window.setFormat(format);

表面フォーマットはcreate() 関数で解決されます。create() が呼び出された後にこの関数を呼び出しても、ネイティブサーフェスのサーフェスフォーマットは再解決されません。

この関数でフォーマットを明示的に設定しない場合、QSurfaceFormat::defaultFormat() が返すフォーマットが使用されます。つまり、複数のウィンドウがある場合、この関数を個別に呼び出す代わりに、最初のウィンドウを作成する前にQSurfaceFormat::setDefaultFormat() を呼び出すことができます。

format()、create()、destroy()、QSurfaceFormat::setDefaultFormat()も参照 。

void QWindow::setFramePosition(const QPoint &point)

ウィンドウ (point) のウィンドウ・フレームを含む左上の位置を設定する。

この位置は、そのスクリーンの virtualGeometry() に関連している。

framePosition(),setGeometry(),frameGeometry()も参照 。

[slot] void QWindow::setGeometry(const QRect &rect)

ウィンドウフレームを除くウィンドウのジオメトリをrect に設定する。

ジオメトリはスクリーンの virtualGeometry() に関連している。

geometry()も参照 。

[slot] void QWindow::setGeometry(int posx, int posy, int w, int h)

ウィンドウフレームを除いたウィンドウのジオメトリを、posx,posy,w,h から構成される矩形に設定する。

このジオメトリはスクリーンの virtualGeometry() に関連している。

geometry()も参照 。

void QWindow::setIcon(const QIcon &icon)

ウィンドウシステムでウィンドウのicon を設定する。

ウィンドウアイコンは、ウィンドウの装飾やタスクスイッチャーなどでウィンドウシステムによって使用されます。

icon() およびsetFilePath()も参照の こと。

bool QWindow::setKeyboardGrabEnabled(bool grab)

キーボード・グラブを有効にするかどうかを設定します (grab)。

戻り値が true の場合、ウィンドウは setKeyboardGrabEnabled(false) が呼ばれるまですべてのキーイベントを受け取ります。マウスイベントは影響を受けません。マウスイベントを取得したい場合は、setMouseGrabEnabled() を使用してください。

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

void QWindow::setMask(const QRegion &region)

ウィンドウのマスクを設定する。

マスクは、アプリケーションが指定されたregion の外側でマウスやタッチの入力を受け取りたくないというヒントをウィンドウシステムに与えるものである。

ウィンドウ・マネージャは、マスクに含まれないウィンドウの領域を表示することを選択することも、しないこともできます。したがって、マスクの一部でない領域を透明にすることは、アプリケーションの責任です。

mask()も参照のこと 。

void QWindow::setMaximumSize(const QSize &size)

ウィンドウの最大サイズを設定する。

これは、指定されたsize 以上のリサイズを防ぐためのウィンドウ・マネージャへのヒントである。

setMinimumSize() およびmaximumSize()も参照のこと 。

void QWindow::setMinimumSize(const QSize &size)

ウィンドウの最小サイズを設定する。

これは、指定されたsize 以下のリサイズを防ぐためのウィンドウ・マネージャへのヒントである。

setMaximumSize() およびminimumSize()も参照のこと 。

bool QWindow::setMouseGrabEnabled(bool grab)

マウス・グラブを有効にするかどうかを設定します (grab)。

戻り値が true の場合、ウィンドウは setMouseGrabEnabled(false) が呼ばれるまですべてのマウスイベントを受け取ります。キーボード・イベントは影響を受けません。キーボード・イベントを取得したい場合は、setKeyboardGrabEnabled() を使用してください。

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

void QWindow::setParent(QWindow *parent)

parent ウィンドウを設定します。これにより、ウィンドウのクリップはウィンドウ・システムによって管理され、parent ウィンドウにクリップされます。

parent をnullptr に設定すると、ウィンドウはトップレベルウィンドウになる。

parent がfromWinId() によって作成されたウィンドウの場合、 プラットフォームがサポートしていれば、現在のウィンドウはparent の中に埋め込まれる。

parent()も参照のこと 。

void QWindow::setPosition(const QPoint &pt)

デスクトップ上のウィンドウの位置を次のように設定します。pt

この位置は、スクリーンのvirtualGeometry()に関連している。

ウィンドウのインタラクティブな移動については、startSystemMove() を参照。インタラクティブなウィンドウのサイズ変更については、startSystemResize() を参照。

position() およびstartSystemMove()も参照の こと。

void QWindow::setPosition(int posx, int posy)

デスクトップ上のウィンドウの位置をposx に設定する、posy

この位置は、そのスクリーンの virtualGeometry() に関連している。

position()も参照 。

void QWindow::setScreen(QScreen *newScreen)

ウィンドウを表示するスクリーンを設定する。

ウィンドウが作成されている場合は、newScreen に再作成されます。

この関数はトップ・レベルのウィンドウに対してのみ動作します。

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

void QWindow::setSizeIncrement(const QSize &size)

ウィンドウのサイズの増分 (size) を設定します。

baseSizeユーザがウィンドウのサイズを変更すると、sizeIncrement().width() ピクセルを基準に水平方向に、sizeIncrement().height() ピクセルを基準に垂直方向に移動します。

デフォルトでは、このプロパティには幅と高さがゼロのサイズが含まれます。

ウィンドウ・システムは、サイズの増分をサポートしていないかもしれません。

sizeIncrement()、setBaseSize()、setMinimumSize()、setMaximumSize()も参照 。

void QWindow::setSurfaceType(QSurface::SurfaceType surfaceType)

ウィンドウのsurfaceType を設定する。

ウィンドウがQBackingStore でラスターレンダリングされるのか、QOpenGLContext で OpenGL レンダリングされるのかを指定します。

surfaceType は、create() 関数でネイティブ・サーフェスが作成されるときに使用されます。ネイティブサーフェスが作成された後にこの関数を呼び出すと、destroy() とcreate() を呼び出して古いネイティブサーフェスを解放し、新しいサーフェスを作成する必要があります。

surfaceType()、QBackingStore 、QOpenGLContext 、create()、destroy()も参照のこと 。

void QWindow::setVulkanInstance(QVulkanInstance *instance)

このウィンドウを指定されたVulkaninstance に関連付けます。

instance は、この インスタンスが存在する限り有効でなければなりません。QWindow

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

void QWindow::setWindowState(Qt::WindowState state)

ウィンドウの画面占有状態を設定する

ウィンドウstate は、ウィンドウがウィンドウシステムで最大化、最小化、フルスクリーン、通常のどれで表示されるかを表す。

列挙値Qt::WindowActive はパラメータとして受け付けられない。

windowState()、showNormal()、showFullScreen()、showMinimized()、showMaximized()、setWindowStates()も参照のこと 。

void QWindow::setWindowStates(Qt::WindowStates state)

ウィンドウの画面占有状態を設定する

ウィンドウstate は、ウィンドウが最大化、最小化、および/またはフルスクリーンとしてウィンドウシステムに表示されるかどうかを表します。

ウィンドウはいくつかの状態を組み合わせることができる。例えば、ウィンドウが最小化と最大化の両方である場合、ウィンドウは最小化された状態で表示されるが、タスクバーのエントリをクリックすると最大化された状態に戻る。

列挙値Qt::WindowActive は設定すべきではない。

windowStates()、showNormal()、showFullScreen()、showMinimized()、showMaximized()も参照のこと 。

[slot] void QWindow::show()

ウィンドウを表示する。

子ウィンドウの場合、これはshowNormal() を呼び出すのと同じである。それ以外の場合は、showFullScreen()、showMaximized()、showNormal() のいずれかを呼び出すのと同じである。

showFullScreen()、showMaximized()、showNormal()、hide()、QStyleHints::showIsFullScreen()、flags()も参照 。

[virtual protected] void QWindow::showEvent(QShowEvent *ev)

show イベント (ev) を処理するためにオーバーライドします。

この関数は、ウィンドウの表示要求があったときに呼び出されます。

ウィンドウがウィンドウシステムによって正常に表示されると、リサイズとexposeイベントが続きます。

[slot] void QWindow::showFullScreen()

ウィンドウをフルスクリーンで表示する。

setWindowStates(Qt::WindowFullScreen) を呼び出してからsetVisible(true) を呼び出すのと同じである。

プラットフォーム固有の考慮事項や制限事項については、QWidget::showFullScreen() のドキュメントを参照してください。

setWindowStates() およびsetVisible()も参照 。

[slot] void QWindow::showMaximized()

ウィンドウを最大化して表示する。

setWindowStates(Qt::WindowMaximized) を呼び出してからsetVisible(true) を呼び出すのと同じである。

setWindowStates() およびsetVisible()も参照のこと 。

[slot] void QWindow::showMinimized()

ウィンドウを最小化して表示する。

setWindowStates(Qt::WindowMinimized) を呼び出してからsetVisible(true) を呼び出すのと同じである。

setWindowStates() およびsetVisible()も参照 。

[slot] void QWindow::showNormal()

ウィンドウを通常通り、つまり最大化も最小化もフルスクリーンもせずに表示する。

setWindowStates(Qt::WindowNoState) を呼び出してからsetVisible(true) を呼び出すのと同じである。

setWindowStates() およびsetVisible()も参照 。

[override virtual] QSize QWindow::size() const

再実装：QSurface::size() const.

ウィンドウ枠を除いたウィンドウのサイズを返します。

resize()も参照ください 。

QSize QWindow::sizeIncrement() const

ウィンドウのサイズ増分を返します。

setSizeIncrement()も参照 。

[slot] bool QWindow::startSystemMove()

システム固有の移動操作を開始する

これを呼び出すと、それをサポートしているプラットフォームでは、ウィンドウに対する対話的な移動操作が開始されます。実際の動作はプラットフォームによって異なるかもしれない。通常、マウスボタンが離されるまでウィンドウをマウスカーソルに追従させる。

これをサポートしているプラットフォームでは、ウィンドウを移動させるこの方法はsetPosition よりも好まれます。なぜなら、ウィンドウを移動させることで、よりネイティブなルック＆フィールが可能になるからです。例えば、ウィンドウ・マネージャがこのウィンドウを他のウィンドウに対してスナップさせたり、画面の端にドラッグされたときにアニメーションを使った特別なタイリングやリサイズ動作が可能になったりします。さらに、Waylandのようないくつかのプラットフォームでは、setPosition がサポートされていないため、アプリケーションがその位置に影響を与えることができる唯一の方法です。

操作がシステムによってサポートされた場合はtrueを返します。

[slot] bool QWindow::startSystemResize(Qt::Edges edges)

システム固有のリサイズ操作を開始する

これを呼び出すと、それをサポートするプラットフォームによって、ウィンドウの対話的なリサイズ操作が開始されます。実際の動作はプラットフォームによって異なるかもしれない。通常、ウィンドウの端がマウスカーソルに追従するようにリサイズされる。

これをサポートするプラットフォームでは、ウィンドウをリサイズするこの方法はsetGeometry よりも好まれます。なぜなら、よりネイティブなルック＆フィールでウィンドウをリサイズすることができるからです。例えば、ウィンドウマネージャが他のウィンドウに対してこのウィンドウをスナップさせたり、スクリーンの端にドラッグされたときにアニメーションで特別なリサイズ動作をさせたりできます。

edges は1つの辺か、隣接する2つの辺（コーナー）でなければなりません。それ以外の値は使用できません。

操作がシステムによってサポートされた場合、true を返します。

[override virtual] QSurface::SurfaceType QWindow::surfaceType() const

再実装：QSurface::surfaceType() const.

ウィンドウの表面型を返します。

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

[virtual protected] void QWindow::tabletEvent(QTabletEvent *ev)

これをオーバーライドして、タブレットの押下、移動、離席イベント (ev) を処理します。

近接入力および離席イベントはウィンドウに送信されず、アプリケーションインスタンスに配信されます。

[virtual protected] void QWindow::touchEvent(QTouchEvent *ev)

これをオーバーライドして、タッチイベント (ev) を処理します。

Qt::WindowType QWindow::type() const

ウィンドウのタイプを返します。

これは、ウィンドウがダイアログなのか、ツールチップなのか、ポップアップなのか、通常のウィンドウなのか、などを表すウィンドウフラグの部分を返します。

flags() およびsetFlags()も参照ください 。

void QWindow::unsetCursor()

このウィンドウのデフォルトの矢印カーソルに戻す。

QVulkanInstance *QWindow::vulkanInstance() const

設定されていれば関連するVulkanインスタンスを、そうでなければnullptr を返します。

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

[virtual protected] void QWindow::wheelEvent(QWheelEvent *ev)

これをオーバーライドして、マウスホイールやその他のホイールイベントを処理します (ev)。

WId QWindow::winId() const

ウィンドウのプラットフォームIDを返す。

このidが有用なプラットフォームでは、返される値は対応するスクリーン内のウィンドウを一意に表します。

screen()も参照のこと 。

Qt::WindowState QWindow::windowState() const

ウィンドウの画面占有状態

setWindowState() およびwindowStates()も参照の こと。

[signal] void QWindow::windowStateChanged(Qt::WindowState windowState)

このシグナルは、setWindowStates()で明示的に設定されるか、ユーザーがタイトルバーのボタンをクリックした時などに自動的に設定され、windowState 。

Qt::WindowStates QWindow::windowStates() const

ウィンドウの画面占有状態

ウィンドウはいくつかの状態を組み合わせることができる。例えば、ウィンドウが最小化と最大化の両方の状態にある場合、ウィンドウは最小化された状態で表示されるが、タスクバーのエントリーをクリックすると最大化された状態に戻る。

setWindowStates()も参照 。