QScreenCapture Class

This class is used for capturing a screen. 更多...

头：	#include <QScreenCapture>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake:	QT += multimedia
Since:	Qt 6.5
实例化：	ScreenCapture
继承：	QObject

• 所有成员列表，包括继承成员

公共类型

enum	Error { NoError, InternalError, CapturingNotSupported, CaptureFailed, NotFound }

特性

• active : bool
• error : const Error
• errorString : const QString
• screen : QScreen*

公共函数

QMediaCaptureSession *	captureSession () const
QScreenCapture::Error	error () const
QString	errorString () const
bool	isActive () const
QScreen *	screen () const
void	setScreen (QScreen * screen )

公共槽

void	setActive (bool active )
void	start ()
void	stop ()

信号

void	activeChanged (bool)
void	errorChanged ()
void	errorOccurred (QScreenCapture::Error error , const QString & errorString )
void	screenChanged (QScreen *)

详细描述

The class captures a screen. It is managed by the QMediaCaptureSession class where the captured screen can be displayed in a video preview object or recorded to a file.

QMediaCaptureSession session;
QAudioInput audioInput;
session.setAudioInput(&input);
QMediaRecorder recorder;
session.setRecorder(&recorder);
recorder.setQuality(QMediaRecorder::HighQuality);
recorder.setOutputLocation(QUrl::fromLocalFile("test.mp3"));
recorder.record();
					

成员类型文档编制

enum QScreenCapture:: Error

Enumerates error codes that can be signaled by the QScreenCapture 类。 errorString () provides detailed information about the error cause.

常量	值	描述
QScreenCapture::NoError	0	No error
QScreenCapture::InternalError	1	Internal screen capturing driver error
QScreenCapture::CapturingNotSupported	2	Capturing is not supported
QScreenCapture::CaptureFailed	4	Capturing screen failed
QScreenCapture::NotFound	5	Selected screen not found

特性文档编制

active : bool

This property holds whether the capturing is currently active.

访问函数：

bool	isActive () const
void	setActive (bool active )

通知程序信号：

void	activeChanged (bool)

[read-only] error : const Error

This property holds the code of the last error.

访问函数：

QScreenCapture::Error

error () const

通知程序信号：

void	errorChanged ()

[read-only] errorString : const QString

This property holds a human readable string describing the cause of error.

访问函数：

QString

errorString () const

通知程序信号：

void	errorChanged ()

screen : QScreen *

This property holds the screen for capturing.

访问函数：

QScreen *	screen () const
void	setScreen (QScreen * screen )

通知程序信号：

void	screenChanged (QScreen *)

成员函数文档编制

QMediaCaptureSession *QScreenCapture:: captureSession () const

Returns the capture session this QScreenCapture is connected to.

使用 QMediaCaptureSession::setScreenCapture () to connect the camera to a session.

[signal] void QScreenCapture:: errorOccurred ( QScreenCapture::Error error , const QString & errorString )

Signals when an error occurs, along with the errorString .

[slot] void QScreenCapture:: start ()

Starts screen capture.

[slot] void QScreenCapture:: stop ()

Stops screen capture.

内容

• 公共类型

• 特性

• 公共函数

• 公共槽

• 信号

• 详细描述