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

フォーカス・イン・イベントは、ウィンドウがキーボード・フォーカスを受け取ると送られます。

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)

paint イベント (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 で指定し、OpenGL レンダリング用かどうかをQOpenGLContext で指定します。

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つの辺（コーナー）でなければなりません。それ以外の値は使用できません。

その操作がシステムでサポートされていれば真を返します。

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