source: vbox/trunk/src/VBox/Frontends/VirtualBox/src/selector/UISnapshotPane.h@ 67119

/* $Id: UISnapshotPane.h 67119 2017-05-26 15:54:23Z vboxsync $ */
/** @file
 * VBox Qt GUI - UISnapshotPane class declaration.
 */

/*
 * Copyright (C) 2006-2017 Oracle Corporation
 *
 * This file is part of VirtualBox Open Source Edition (OSE), as
 * available from http://www.virtualbox.org. This file is free software;
 * you can redistribute it and/or modify it under the terms of the GNU
 * General Public License (GPL) as published by the Free Software
 * Foundation, in version 2 as it comes in the "COPYING" file of the
 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
 */

#ifndef ___UISnapshotPane_h___
#define ___UISnapshotPane_h___

/* GUI includes: */
#include "QIWithRetranslateUI.h"
#include "VBoxGlobal.h"

/* COM includes: */
#include "CMachine.h"

/* Forward declarations: */
class QIcon;
class QReadWriteLock;
class QTimer;
class QTreeWidgetItem;
class QITreeWidgetItem;
class UISnapshotTree;
class UISnapshotItem;


/** Snapshot age format. */
enum SnapshotAgeFormat
{
    SnapshotAgeFormat_InSeconds,
    SnapshotAgeFormat_InMinutes,
    SnapshotAgeFormat_InHours,
    SnapshotAgeFormat_InDays,
    SnapshotAgeFormat_Max
};


/** QWidget extension providing GUI with the pane to control snapshot related functionality. */
class UISnapshotPane : public QIWithRetranslateUI<QWidget>
{
    Q_OBJECT;

public:

    /** Constructs snapshot pane passing @a pParent to the base-class. */
    UISnapshotPane(QWidget *pParent = 0);
    /** Destructs snapshot pane. */
    virtual ~UISnapshotPane() /* override */;

    /** Defines the @a comMachine object to be parsed. */
    void setMachine(const CMachine &comMachine);

    /** Returns cached snapshot-item icon depending on @a fOnline flag. */
    const QIcon *snapshotItemIcon(bool fOnline) const;

protected:

    /** Handles translation event. */
    virtual void retranslateUi() /* override */;

private slots:

    /** @name Tree-widget handlers.
      * @{ */
        /** Handles cursor change to @a pItem. */
        void sltCurrentItemChanged(QTreeWidgetItem *pItem = 0);
        /** Handles context menu request for @a point. */
        void sltContextMenuRequested(const QPoint &point);
        /** Handles modification for @a pItem. */
        void sltItemChanged(QTreeWidgetItem *pItem);
        /** Handles double-click for @a pItem. */
        void sltItemDoubleClicked(QTreeWidgetItem *pItem);
    /** @} */

    /** @name Main event handlers.
      * @{ */
        /** Handles machine data change for machine with @a strMachineID. */
        void sltMachineDataChange(QString strMachineID);
        /** Handles machine @a enmState change for machine with @a strMachineID. */
        void sltMachineStateChange(QString strMachineID, KMachineState enmState);
        /** Handles session @a enmState change for machine with @a strMachineID. */
        void sltSessionStateChange(QString strMachineID, KSessionState enmState);
    /** @} */

    /** @name Timer event handlers.
      * @{ */
        /** Updates snapshots age. */
        void sltUpdateSnapshotsAge();
    /** @} */

    /** @name Toolbar handlers.
      * @{ */
        /** Proposes to take a snapshot. */
        void sltTakeSnapshot() { takeSnapshot(); }
        /** Proposes to restore the snapshot. */
        void sltRestoreSnapshot() { restoreSnapshot(); }
        /** Proposes to delete the snapshot. */
        void sltDeleteSnapshot() { deleteSnapshot(); }
        /** Displays the snapshot details dialog. */
        void sltShowSnapshotDetails() { showSnapshotDetails(); }
        /** Proposes to clone the snapshot. */
        void sltCloneSnapshot() { cloneSnapshot(); }
    /** @} */

private:

    /** @name Toolbar helpers.
      * @{ */
        /** Proposes to take a snapshot. */
        bool takeSnapshot();
        /** Proposes to restore the snapshot. */
        bool restoreSnapshot(bool fSuppressNonCriticalWarnings = false);
        /** Proposes to delete the snapshot. */
        bool deleteSnapshot();
        /** Displays the snapshot details dialog. */
        void showSnapshotDetails();
        /** Proposes to clone the snapshot. */
        void cloneSnapshot();
    /** @} */

    /** Refreshes everything. */
    void refreshAll();
    /** Populates snapshot items for corresponding @a comSnapshot using @a pItem as parent. */
    void populateSnapshots(const CSnapshot &comSnapshot, QITreeWidgetItem *pItem);

    /** @name Tree-widget helpers.
      * @{ */
        /** Searches for an item with corresponding @a strSnapshotID. */
        UISnapshotItem *findItem(const QString &strSnapshotID) const;
        /** Returns the "current state" item. */
        UISnapshotItem *currentStateItem() const;

        /** Searches for smallest snapshot age starting with @a pItem as parent. */
        SnapshotAgeFormat traverseSnapshotAge(QTreeWidgetItem *pItem) const;
    /** @} */

    /** @name General variables.
      * @{ */
        /** Holds the COM machine object. */
        CMachine       m_comMachine;
        /** Holds the machine object ID. */
        QString        m_strMachineID;
        /** Holds the cached session state. */
        KSessionState  m_enmSessionState;
        /** Holds the current snapshot item reference. */
        UISnapshotItem *m_pCurrentSnapshotItem;
        /** Holds the snapshot item editing protector. */
        QReadWriteLock *m_pLockReadWrite;
    /** @} */

    /** @name Widget variables.
      * @{ */
        /** Holds the Take Snapshot action instance. */
        QAction   *m_pActionTakeSnapshot;
        /** Holds the Restore Snapshot action instance. */
        QAction   *m_pActionRestoreSnapshot;
        /** Holds the Delete Snapshot action instance. */
        QAction   *m_pActionDeleteSnapshot;
        /** Holds the Show Snapshot Details action instance. */
        QAction   *m_pActionShowSnapshotDetails;
        /** Holds the Clone Snapshot action instance. */
        QAction   *m_pActionCloneSnapshot;

        /** Holds the snapshot age update timer. */
        QTimer *m_pTimerUpdateAge;

        /** Holds whether the snapshot operations are allowed. */
        bool  m_fShapshotOperationsAllowed;

        /** Holds the cached snapshot-item pixmap for 'offline' state. */
        QIcon *m_pIconSnapshotOffline;
        /** Holds the cached snapshot-item pixmap for 'online' state. */
        QIcon *m_pIconSnapshotOnline;

        /** Holds the snapshot tree instance. */
        UISnapshotTree *m_pSnapshotTree;
    /** @} */
};

#endif /* !___UISnapshotPane_h___ */