VirtualBox

Ignore:
Timestamp:
May 7, 2018 5:26:23 PM (7 years ago)
Author:
vboxsync
Message:

FE/Qt bugref:6699 Some comment editing

Location:
trunk/src/VBox/Frontends/VirtualBox/src/runtime/guestctrl
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/VBox/Frontends/VirtualBox/src/runtime/guestctrl/UIGuestControlFileManager.h

    r71693 r72151  
    4949
    5050
    51 /** QWidget extension
    52  *  providing GUI with guest session information and control tab in session-information window. */
     51/** A QWidget extension. it includes a QWidget extension for initiating a guest session
     52 *  one host and one guest file table views, a log viewer
     53 *  and some other file manager related widgets. */
    5354class UIGuestControlFileManager : public QIWithRetranslateUI<QWidget>
    5455{
    … …  
    100101    QStringList       getFsObjInfoStringList(const T &fsObjectInfo) const;
    101102
    102     const int           m_iMaxRecursionDepth;
    103     CGuest              m_comGuest;
    104     CGuestSession       m_comGuestSession;
    105     QVBoxLayout        *m_pMainLayout;
    106     QSplitter          *m_pVerticalSplitter;
    107     QTextEdit          *m_pLogOutput;
    108     UIToolBar          *m_pToolBar;
    109     QAction            *m_pCopyGuestToHost;
    110     QAction            *m_pCopyHostToGuest;
    111     QWidget            *m_pFileTableContainerWidget;
    112     QHBoxLayout        *m_pFileTableContainerLayout;
    113     QITabWidget        *m_pTabWidget;
     103    const int                   m_iMaxRecursionDepth;
     104    CGuest                      m_comGuest;
     105    CGuestSession               m_comGuestSession;
     106    QVBoxLayout                *m_pMainLayout;
     107    QSplitter                  *m_pVerticalSplitter;
     108    QTextEdit                  *m_pLogOutput;
     109    UIToolBar                  *m_pToolBar;
     110    QAction                    *m_pCopyGuestToHost;
     111    QAction                    *m_pCopyHostToGuest;
     112    QWidget                    *m_pFileTableContainerWidget;
     113    QHBoxLayout                *m_pFileTableContainerLayout;
     114    QITabWidget                *m_pTabWidget;
    114115
    115116    UIFileOperationsList       *m_pFileOperationsList;
    … …  
    117118    UIGuestControlInterface    *m_pControlInterface;
    118119    /* m_pSessionCreateWidget is a QWidget extension enabling user to start/stop
    119      * a Guest Control session. */
     120     * a Guest Control session with password/username fields etc.. */
    120121    UIGuestSessionCreateWidget *m_pSessionCreateWidget;
    121122    UIGuestFileTable           *m_pGuestFileTable;
    … …  
    129130
    130131#endif /* !___UIGuestControlFileManager_h___ */
    131 

  • trunk/src/VBox/Frontends/VirtualBox/src/runtime/guestctrl/UIGuestControlFileTable.h

    r72086 r72151  
    140140
    141141    static QString sanitize(const QString &path);
    142     /** Merge prefix and suffix by making sure they have a single '/' in between */
     142    /** Merges prefix and suffix by making sure they have a single '/' in between */
    143143    static QString mergePaths(const QString &path, const QString &baseName);
    144144    /** Returns the last part of the @p path. That is the filename or directory name without the path */
    145145    static QString getObjectName(const QString &path);
    146     /** Remove the object name and return the path */
     146    /** Removes the object name and return the path */
    147147    static QString getPathExceptObjectName(const QString &path);
    148     /** Replace the last part of the @p previusPath with newBaseName */
     148    /** Replaces the last part of the @p previusPath with newBaseName */
    149149    static QString constructNewItemPath(const QString &previousPath, const QString &newBaseName);
    150     /** Split the path and return it as a QStringList, top most being the 0th element. No delimiters */
     150    /** Splits the path and return it as a QStringList, top most being the 0th element. No delimiters */
    151151    static QStringList pathTrail(const QString &path);
    152152    static const QChar delimiter;
    153153    static const QChar dosDelimiter;
    154154
    155     /** Try to guess if the path starts with DOS style drive letters */
     155    /** Tries to determine if the path starts with DOS style drive letters. */
    156156    static bool doesPathStartWithDriveLetter(const QString &path);
    157157
    … …  
    174174
    175175    UIFileTableItem *child(int row) const;
    176     /** Return a child (if possible) by path */
     176    /** Searches for the child by path and returns it if found. */
    177177    UIFileTableItem *child(const QString &path) const;
    178178    int childCount() const;
    … …  
    193193    void setPath(const QString &path);
    194194
    195     /** True if this is directory and name is ".." */
     195    /** Returns true if this is directory and name is ".." */
    196196    bool isUpDirectory() const;
    197197    void clearChildren();
    … …  
    250250    UIGuestControlFileTable(QWidget *pParent = 0);
    251251    virtual ~UIGuestControlFileTable();
    252     /** Delete all the tree nodes */
     252    /** Deletes all the tree nodes */
    253253    void reset();
    254254    void emitLogOutput(const QString& strOutput);
    … …  
    308308
    309309private slots:
     310
    310311    /* index is passed by the item view and represents the double clicked object's 'proxy' model index */
    311312    void sltItemDoubleClicked(const QModelIndex &index);
    … …  
    329330    void             prepareObjects();
    330331    void             prepareActions();
    331     /* @itemIndex is assumed to be 'model' index not 'proxy model' index */
     332    /** @p itemIndex is assumed to be 'model' index not 'proxy model' index */
    332333    void             deleteByIndex(const QModelIndex &itemIndex);
    333334    /** Returns the UIFileTableItem for path / which is a direct (and single) child of m_pRootItem */
    … …  
    339340    void            deSelectUpDirectoryItem();
    340341    void            setSelectionForAll(QItemSelectionModel::SelectionFlags flags);
    341     /** Start directory requires a special attention since on file systems with drive letters
     342    /** The start directory requires a special attention since on file systems with drive letters
    342343     *  drive letter are direct children of the start directory. On other systems start directory is '/' */
    343344    void            populateStartDirectory(UIFileTableItem *startItem);
    … …  
    359360    QAction         *m_pSelectAll;
    360361    QAction         *m_pInvertSelection;
    361     /** The vector of action which need some selection to work on like cut, copy etc. */
     362    /** The vector of actions which need some selection to work on. Like cut, copy etc. */
    362363    QVector<QAction*> m_selectionDependentActions;
    363364    /** The absolue path list of the file objects which user has chosen to cut/copy. this

  • trunk/src/VBox/Frontends/VirtualBox/src/runtime/guestctrl/UIHostFileTable.h

    r72086 r72151  
    2222#include "UIGuestControlFileTable.h"
    2323
    24 /** This class scans the host file system by using the Qt
    25     and populates the UIGuestControlFileModel*/
     24/** This class scans the host file system by using the Qt API
     25    and connects to the UIGuestControlFileModel*/
    2626class UIHostFileTable : public UIGuestControlFileTable
    2727{
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette