WindowCapture QML Type
この型はウィンドウのキャプチャに使用する。詳細...
| Import Statement: | import QtMultimedia |
| Since: | Qt 6.6 |
| In C++: | QWindowCapture |
プロパティ
- active : bool
- error : enumeration
- errorString : string
- window : Window
方法
- list<CapturableWindow> capturableWindows()
- void start()
- void stop()
詳しい説明
WindowCaptureはウィンドウをキャプチャします。MediaCaptureSession によって管理され、キャプチャされたウィンドウはビデオプレビューオブジェクトに表示されるか、ファイルに記録されます。
ウィンドウ キャプチャの制限事項
WindowCaptureの使用には以下の制限があります:
- WindowCaptureはFFmpegバックエンドでのみサポートされています。
X11 システムでQWindowCapture を使用する場合、次の制限が適用されます:
- Linux X11 システムでは、ウィンドウが部分的に可視スクリーン領域の外に移動されると、可視領域のみがキャプチャされます。その結果、出力されるビデオ フレームのサイズがウィンドウのジオメトリよりも小さくなることがあります。
- 可視スクリーン領域の外側にあるウィンドウはキャプチャできず、その場合はエラー信号が出力される。
- 最小化されたウィンドウや不可視の仮想ワークスペースにあるウィンドウの動作は、ウィンドウマネージャに依存する。たとえば、GNOMEではこのようなウィンドウをキャプチャできますが、WindowMakerやXfwmではキャプチャできず、ウィンドウキャプチャインスタンスはエラーを出力します。
CaptureSession とCapturableWindowも参照して ください。
プロパティ・ドキュメント
active : bool
キャプチャが現在アクティブかどうかを示す。
error : enumeration [read-only]
最後のエラーのコードを返す。
errorString : string [read-only]
エラーの原因を説明する、人間が読める文字列を返します。
window : Window
キャプチャ用のウィンドウを記述する。
QtMultimedia::WindowCapture::capturableWindowsも参照 。
メソッドのドキュメント
list<CapturableWindow> capturableWindows()
キャプチャ可能なCapturableWindow オブジェクトのリストを返します。
void start()
window のキャプチャを開始する。
これは、active プロパティをtrue に設定することと同じです。
void stop()
キャプチャを停止する。
これはactive プロパティをfalse に設定することと同じです。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.