Base class for feedback objects to be used for cancellation of something running in a worker thread. More...

#include <qgsfeedback.h>

Inheritance diagram for QgsFeedback:

[legend]

Public Slots
void	cancel ()
	Tells the internal routines that the current operation should be canceled. This should be run by the main thread.

Signals
void	canceled ()
	Internal routines can connect to this signal if they use event loop.

void	processedCountChanged (unsigned long long processedCount)
	Emitted when the feedback object reports a change in the number of processed objects.

void	progressChanged (double progress)
	Emitted when the feedback object reports a progress change.

Public Member Functions
	QgsFeedback (QObject *parent=nullptr)
	Construct a feedback object.

bool	isCanceled () const
	Tells whether the operation has been canceled already.

unsigned long long	processedCount () const
	Returns the current processed objects count reported by the feedback object.

double	progress () const
	Returns the current progress reported by the feedback object.

void	setProcessedCount (unsigned long long processedCount)
	Sets the current processed objects count for the feedback object.

void	setProgress (double progress)
	Sets the current progress for the feedback object.

Detailed Description

Base class for feedback objects to be used for cancellation of something running in a worker thread.

The class may be used as is or it may be subclassed for extended functionality for a particular operation (e.g. report progress or pass some data for preview).

When cancel() is called, the internal code has two options to check for cancellation state:

if the worker thread uses an event loop (e.g. for network communication), the code can make a queued connection to canceled() signal and handle the cancellation in its slot.
if the worker thread does not use an event loop, it can poll isCanceled() method regularly to see if the operation should be canceled.

The class is meant to be created and destroyed in the main thread.

For map rendering, the object may be created in constructor of a QgsMapLayerRenderer subclass and available with QgsMapLayerRenderer::feedback() method. When a map rendering job gets canceled, the cancel() method is called on the feedback object of all layers.

Definition at line 43 of file qgsfeedback.h.

Constructor & Destructor Documentation

◆ QgsFeedback()

QgsFeedback::QgsFeedback ( QObject * parent = nullptr )

inline

Construct a feedback object.

Definition at line 48 of file qgsfeedback.h.

Member Function Documentation

◆ cancel

void QgsFeedback::cancel ( )

inlineslot

Tells the internal routines that the current operation should be canceled. This should be run by the main thread.

Definition at line 105 of file qgsfeedback.h.

◆ canceled

void QgsFeedback::canceled ( )

signal

Internal routines can connect to this signal if they use event loop.

◆ isCanceled()

bool QgsFeedback::isCanceled ( ) const

inline

Tells whether the operation has been canceled already.

Definition at line 53 of file qgsfeedback.h.

◆ processedCount()

unsigned long long QgsFeedback::processedCount ( ) const

inline

Returns the current processed objects count reported by the feedback object.

Depending on how the feedback object is used processed count reporting may not be supported. The returned value is an unsigned long integer and starts from 0.

See also: setProcessedCount(); processedCountChanged()

Since: QGIS 3.24

Definition at line 87 of file qgsfeedback.h.

◆ processedCountChanged

void QgsFeedback::processedCountChanged ( unsigned long long processedCount )

signal

Emitted when the feedback object reports a change in the number of processed objects.

Depending on how the feedback object is used processed count reporting may not be supported. The processedCount argument is an unsigned long integer and starts from 0.

See also: setProgress(); progress()

Since: QGIS 3.24

◆ progress()

double QgsFeedback::progress ( ) const

inline

Returns the current progress reported by the feedback object.

Depending on how the feedback object is used progress reporting may not be supported. The returned value is in percentage and ranges from 0-100.

See also: setProgress(); progressChanged()

Definition at line 77 of file qgsfeedback.h.

◆ progressChanged

void QgsFeedback::progressChanged ( double progress )

signal

Emitted when the feedback object reports a progress change.

Depending on how the feedback object is used progress reporting may not be supported. The progress argument is in percentage and ranges from 0-100.

See also: setProgress(); progress()

◆ setProcessedCount()

void QgsFeedback::setProcessedCount ( unsigned long long processedCount )

inline

Sets the current processed objects count for the feedback object.

The processedCount argument is an unsigned long integer and starts from 0.

See also: processedCount(); processedCountChanged()

Since: QGIS 3.24

Definition at line 96 of file qgsfeedback.h.

◆ setProgress()

void QgsFeedback::setProgress ( double progress )

inline

Sets the current progress for the feedback object.

The progress argument is in percentage and valid values range from 0-100.

See also: progress(); progressChanged()

Definition at line 61 of file qgsfeedback.h.

The documentation for this class was generated from the following file:

/build/qgis-3.41.0+git20241214+cea29feecf2+99sid/src/core/qgsfeedback.h

Public Slots

Signals

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsFeedback()

Member Function Documentation

◆ cancel

◆ canceled

◆ isCanceled()

◆ processedCount()

◆ processedCountChanged

◆ progress()

◆ progressChanged

◆ setProcessedCount()

◆ setProgress()