Home

QtCopyDialog Class Reference

The QtCopyDialog class provides visual feedback for large copy and move operations, and it provides the option of aborting an operation. More...

 #include <QtCopyDialog>

Inherits QDialog.

• List of all members, including inherited members

Properties

• autoClose : bool
• minimumDuration : int

• 2 properties inherited from QDialog
• 57 properties inherited from QWidget
• 1 property inherited from QObject

Public Functions

• QtCopyDialog ( QWidget * parent = 0, Qt::WFlags flags = 0 )
• QtCopyDialog ( QtFileCopier * copier, QWidget * parent = 0, Qt::WFlags flags = 0 )
• ~QtCopyDialog ()
• bool autoClose () const
• QtFileCopier * fileCopier () const
• int minimumDuration () const
• void setAutoClose ( bool on )
• void setFileCopier ( QtFileCopier * copier )
• void setMinimumDuration ( int ms )

• 5 public functions inherited from QDialog
• 207 public functions inherited from QWidget
• 12 public functions inherited from QPaintDevice
• 29 public functions inherited from QObject

Additional Inherited Members

• 5 public slots inherited from QDialog
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 3 signals inherited from QDialog
• 1 signal inherited from QWidget
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject
• 37 protected functions inherited from QWidget
• 1 protected function inherited from QPaintDevice
• 7 protected functions inherited from QObject
• 1 protected slot inherited from QWidget
• 1 protected type inherited from QPaintDevice
• 2 protected variables inherited from QObject

Detailed Description

The QtCopyDialog class provides visual feedback for large copy and move operations, and it provides the option of aborting an operation.

QtCopyDialog is used to give the user an indication of how much time a copy or move operation is going to take. It estimates and displays the time necessary to complete the operation. It also gives the user the option of aborting the operation at any time.

QtCopyDialog is normally used with the QtFileCopier class which perform copy and move operations on files in a background process. To connect the copy dialog to an QtFileCopier instance, you can use the setFileCopier() function.

The behavior of the copy dialog can be controlled using its autoClose and minimumDuration properties: The autoClose property holds whether the dialog should be automatically closed when the operation is completed. The minimumDuration property specifies the time that must pass before the dialog appears.

See also QtFileCopier.

Property Documentation

autoClose : bool

This property holds whether the dialog should be automatically closed when the operation is completed.

The default is true.

Access functions:

• bool autoClose () const
• void setAutoClose ( bool on )

minimumDuration : int

This property holds the time that must pass before the dialog appears.

When all pending operations are completed within the specified time frame, the dialog will not appear at all. If the minimum duration is set to 0, the dialog appears as soon as the program execution returns to the event processing loop.

The default duration is 2000 miliseconds.

Access functions:

• int minimumDuration () const
• void setMinimumDuration ( int ms )

Member Function Documentation

QtCopyDialog::QtCopyDialog ( QWidget * parent = 0, Qt::WFlags flags = 0 )

Creates a copy dialog with the given parent and the specified window flags.

QtCopyDialog::QtCopyDialog ( QtFileCopier * copier, QWidget * parent = 0, Qt::WFlags flags = 0 )

Creates a copy dialog with the given parent and the specified window flags.

The dialog is connected to the specified file copier. The file copier's current state must be QtFileCopier::Idle, i.e. it cannot be performing any operation and its pending list must be empty.

See also setFileCopier().

QtCopyDialog::~QtCopyDialog ()

Destroys the copy dialog.

QtFileCopier * QtCopyDialog::fileCopier () const

Returns the file copier currently connected to the copy dialog.

See also setFileCopier().

void QtCopyDialog::setFileCopier ( QtFileCopier * copier )

Connects the copy dialog to the given file copier. The file copier's current state must be QtFileCopier::Idle, i.e. it cannot be performing any operation and its pending list must be empty.

See also fileCopier().