このページでは

QSurface Class

QSurface クラスは、Qt におけるレンダリング可能なサーフェスの抽象化です。詳細...

ヘッダー: #include <QSurface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
継承元:

QOffscreenSurface およびQWindow

パブリック型

enum SurfaceClass { Window, Offscreen }
enum SurfaceType { RasterSurface, OpenGLSurface, OpenVGSurface, VulkanSurface, MetalSurface, Direct3DSurface }

パブリック関数

virtual ~QSurface()
virtual QSurfaceFormat format() const = 0
virtual QSize size() const = 0
bool supportsOpenGL() const
QSurface::SurfaceClass surfaceClass() const
virtual QPlatformSurface *surfaceHandle() const = 0
virtual QSurface::SurfaceType surfaceType() const = 0

保護された関数

QSurface(QSurface::SurfaceClass type)

詳細な説明

サーフェスのサイズは、size() 関数を使用して取得できます。サーフェスのレンダリング固有の属性は、format() 関数を介して取得できます。

メンバ型のドキュメント

enum QSurface::SurfaceClass

SurfaceClass 列挙型は、サーフェスの実際のサブクラスを表します。

定数値説明
QSurface::Window0このサーフェスは、QWindow のインスタンスです。
QSurface::Offscreen1サーフェスは、QOffscreenSurface のインスタンスです。

enum QSurface::SurfaceType

SurfaceType 列挙型は、これがどのような種類の表面であるかを表します。

定数値説明
QSurface::RasterSurface0このサーフェスはピクセルで構成されており、Qt のラスタペイントエンジンなどのソフトウェアラスタライザを使用してレンダリングを行うことができます。
QSurface::OpenGLSurface1このサーフェスは OpenGL 互換のサーフェスであり、QOpenGLContext と組み合わせて使用できます。
QSurface::OpenVGSurface3このサーフェスは OpenVG 互換のサーフェスであり、OpenVG コンテキストと組み合わせて使用できます。
QSurface::VulkanSurface4このサーフェスは Vulkan 互換のサーフェスであり、Vulkan グラフィックス API と組み合わせて使用できます。
QSurface::MetalSurface5このサーフェスは Metal 互換のサーフェスであり、Apple の Metal グラフィックス API と組み合わせて使用できます。このサーフェスタイプは、macOS および iOS でのみサポートされています。
QSurface::Direct3DSurface6このサーフェスは Direct 3D 11 および 12 互換のサーフェスであり、DXGI および Direct3D API と組み合わせて使用できます。このサーフェスタイプは Windows でのみサポートされています。

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

[explicit protected] QSurface::QSurface(QSurface::SurfaceClass type)

指定されたtype を使用してサーフェスを作成します。

[virtual noexcept] QSurface::~QSurface()

表面を破壊する。

[pure virtual] QSurfaceFormat QSurface::format() const

サーフェスのフォーマットを返します。

[pure virtual] QSize QSurface::size() const

サーフェスのサイズをピクセル単位で返します。

bool QSurface::supportsOpenGL() const

サーフェスが OpenGL 互換であり、QOpenGLContext と組み合わせて使用できる場合は true を返し、そうでない場合は false を返します。

QSurface::SurfaceClass QSurface::surfaceClass() const

このサーフェスのサーフェスクラスを返します。

[pure virtual] QPlatformSurface *QSurface::surfaceHandle() const

サーフェスのプラットフォーム固有の実装へのハンドルを返します。

[pure virtual] QSurface::SurfaceType QSurface::surfaceType() const

サーフェスの型を返します。

© 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.