QML-exposed operator for track collection operations. More...

Inheritance diagram for zrythm::actions::TrackCollectionOperator:

Collaboration diagram for zrythm::actions::TrackCollectionOperator:

Public Member Functions
	TrackCollectionOperator (QObject *parent=nullptr)
structure::tracks::TrackCollection *	collection () const
void	setCollection (structure::tracks::TrackCollection *collection)
Q_SIGNAL void	collectionChanged ()
undo::UndoStack *	undoStack () const
void	setUndoStack (undo::UndoStack *undoStack)
Q_SIGNAL void	undoStackChanged ()
Q_INVOKABLE void	moveTracks (const QList< zrythm::structure::tracks::Track * > &tracks, int targetPosition, zrythm::structure::tracks::Track *targetFolder)
	Moves tracks to a new position in the collection.
Q_INVOKABLE void	moveTracks (const QList< zrythm::structure::tracks::Track * > &tracks, int targetPosition)
	Convenience overload for QML - moves without specifying a folder.
Q_INVOKABLE void	deleteTracks (const QList< zrythm::structure::tracks::Track * > &tracks)
	Deletes the given tracks (and their descendants if foldable).

Properties
zrythm::structure::tracks::TrackCollection *	collection
zrythm::undo::UndoStack *	undoStack

Detailed Description

QML-exposed operator for track collection operations.

This class provides QML bindings for operations that affect multiple tracks or the track collection as a whole, such as reordering tracks.

Constructor & Destructor Documentation

zrythm::actions::TrackCollectionOperator::TrackCollectionOperator ( QObject * parent = nullptr )

inlineexplicit

structure::tracks::TrackCollection * zrythm::actions::TrackCollectionOperator::collection ( ) const

inline

Q_INVOKABLE void zrythm::actions::TrackCollectionOperator::deleteTracks ( const QList< zrythm::structure::tracks::Track * > & tracks )

Deletes the given tracks (and their descendants if foldable).

Pushes a single DeleteTracksCommand onto the undo stack.

Exceptions

std::invalid_argument if any track is non-deletable.

Q_INVOKABLE void zrythm::actions::TrackCollectionOperator::moveTracks	(	const QList< zrythm::structure::tracks::Track * > &	tracks,
		int	targetPosition )

inline

Convenience overload for QML - moves without specifying a folder.

QML cannot resolve C++ default parameters on Q_INVOKABLE methods. Use this overload when no target folder is needed.

Q_INVOKABLE void zrythm::actions::TrackCollectionOperator::moveTracks	(	const QList< zrythm::structure::tracks::Track * > &	tracks,
		int	targetPosition,
		zrythm::structure::tracks::Track *	targetFolder )

Moves tracks to a new position in the collection.

Parameters

tracks	List of tracks to move (in their current order).
targetPosition	The position where the first track should end up.
targetFolder	If non-null, the foldable track to make the moved tracks children of. If null and the target position is inside an expanded folder, the enclosing folder is inferred automatically.