VirtualBox

Changeset 66163 in vbox


Ignore:
Timestamp:
Mar 20, 2017 8:35:31 AM (8 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
114072
Message:

FE/Qt: Settings: A bit of doxygen refactoring at least which was possible by find+replace.

Location:
trunk/src/VBox/Frontends/VirtualBox/src/settings
Files:
31 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/UISettingsPage.h

    r62493 r66163  
    9595public:
    9696
    97     /* Load data to cache from corresponding external object(s),
    98      * this task COULD be performed in other than GUI thread: */
     97    /** Loads data into the cache from corresponding external object(s),
     98      * this task COULD be performed in other than the GUI thread. */
    9999    virtual void loadToCacheFrom(QVariant &data) = 0;
    100     /* Load data to corresponding widgets from cache,
    101      * this task SHOULD be performed in GUI thread only: */
     100    /** Loads data into corresponding widgets from the cache,
     101      * this task SHOULD be performed in the GUI thread only. */
    102102    virtual void getFromCache() = 0;
    103103
    104     /* Save data from corresponding widgets to cache,
    105      * this task SHOULD be performed in GUI thread only: */
     104    /** Saves data from corresponding widgets to the cache,
     105      * this task SHOULD be performed in the GUI thread only. */
    106106    virtual void putToCache() = 0;
    107     /* Save data from cache to corresponding external object(s),
    108      * this task COULD be performed in other than GUI thread: */
     107    /** Saves data from the cache to corresponding external object(s),
     108      * this task COULD be performed in other than the GUI thread. */
    109109    virtual void saveFromCacheTo(QVariant &data) = 0;
    110110
    … …  
    130130    bool isMachineInValidMode() const { return isMachineOffline() || isMachinePoweredOff() || isMachineSaved() || isMachineOnline(); }
    131131
    132     /* Page changed: */
     132    /** Returns whether the page content was changed. */
    133133    virtual bool changed() const = 0;
    134134
    … …  
    202202    void uploadData(QVariant &data) const;
    203203
    204     /* Page changed: */
     204    /** Returns whether the page content was changed. */
    205205    bool changed() const { return false; }
    206206

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsDisplay.h

    r65681 r66163  
    6767protected:
    6868
    69     /* Load data to cache from corresponding external object(s),
    70      * this task COULD be performed in other than GUI thread: */
     69    /** Loads data into the cache from corresponding external object(s),
     70      * this task COULD be performed in other than the GUI thread. */
    7171    void loadToCacheFrom(QVariant &data);
    72     /* Load data to corresponding widgets from cache,
    73      * this task SHOULD be performed in GUI thread only: */
     72    /** Loads data into corresponding widgets from the cache,
     73      * this task SHOULD be performed in the GUI thread only. */
    7474    void getFromCache();
    7575
    76     /* Save data from corresponding widgets to cache,
    77      * this task SHOULD be performed in GUI thread only: */
     76    /** Saves data from corresponding widgets to the cache,
     77      * this task SHOULD be performed in the GUI thread only. */
    7878    void putToCache();
    79     /* Save data from cache to corresponding external object(s),
    80      * this task COULD be performed in other than GUI thread: */
     79    /** Saves data from the cache to corresponding external object(s),
     80      * this task COULD be performed in other than the GUI thread. */
    8181    void saveFromCacheTo(QVariant &data);
    8282
    83     /* Helper: Navigation stuff: */
     83    /** Defines TAB order. */
    8484    void setOrderAfter(QWidget *pWidget);
    8585
    86     /* Helper: Translation stuff: */
     86    /** Handles translation event. */
    8787    void retranslateUi();
    8888

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsExtension.h

    r65690 r66163  
    111111protected:
    112112
    113     /* Load data to cache from corresponding external object(s),
    114      * this task COULD be performed in other than GUI thread: */
     113    /** Loads data into the cache from corresponding external object(s),
     114      * this task COULD be performed in other than the GUI thread. */
    115115    void loadToCacheFrom(QVariant &data);
    116     /* Load data to corresponding widgets from cache,
    117      * this task SHOULD be performed in GUI thread only: */
     116    /** Loads data into corresponding widgets from the cache,
     117      * this task SHOULD be performed in the GUI thread only. */
    118118    void getFromCache();
    119119
    120     /* Save data from corresponding widgets to cache,
    121      * this task SHOULD be performed in GUI thread only: */
     120    /** Saves data from corresponding widgets to the cache,
     121      * this task SHOULD be performed in the GUI thread only. */
    122122    void putToCache();
    123     /* Save data from cache to corresponding external object(s),
    124      * this task COULD be performed in other than GUI thread: */
     123    /** Saves data from the cache to corresponding external object(s),
     124      * this task COULD be performed in other than the GUI thread. */
    125125    void saveFromCacheTo(QVariant &data);
    126126
    127     /* Helper: Navigation stuff: */
     127    /** Defines TAB order. */
    128128    void setOrderAfter(QWidget *pWidget);
    129129
    130     /* Helper: Translation stuff: */
     130    /** Handles translation event. */
    131131    void retranslateUi();
    132132

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsGeneral.h

    r65684 r66163  
    7171protected:
    7272
    73     /* Load data to cache from corresponding external object(s),
    74      * this task COULD be performed in other than GUI thread: */
     73    /** Loads data into the cache from corresponding external object(s),
     74      * this task COULD be performed in other than the GUI thread. */
    7575    void loadToCacheFrom(QVariant &data);
    76     /* Load data to corresponding widgets from cache,
    77      * this task SHOULD be performed in GUI thread only: */
     76    /** Loads data into corresponding widgets from the cache,
     77      * this task SHOULD be performed in the GUI thread only. */
    7878    void getFromCache();
    7979
    80     /* Save data from corresponding widgets to cache,
    81      * this task SHOULD be performed in GUI thread only: */
     80    /** Saves data from corresponding widgets to the cache,
     81      * this task SHOULD be performed in the GUI thread only. */
    8282    void putToCache();
    83     /* Save data from cache to corresponding external object(s),
    84      * this task COULD be performed in other than GUI thread: */
     83    /** Saves data from the cache to corresponding external object(s),
     84      * this task COULD be performed in other than the GUI thread. */
    8585    void saveFromCacheTo(QVariant &data);
    8686
    87     /* Helper: Navigation stuff: */
     87    /** Defines TAB order. */
    8888    void setOrderAfter(QWidget *pWidget);
    8989
    90     /* Helper: Translation stuff: */
     90    /** Handles translation event. */
    9191    void retranslateUi();
    9292

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsInput.h

    r65685 r66163  
    5353protected:
    5454
    55     /* Load data to cache from corresponding external object(s),
    56      * this task COULD be performed in other than GUI thread: */
     55    /** Loads data into the cache from corresponding external object(s),
     56      * this task COULD be performed in other than the GUI thread. */
    5757    void loadToCacheFrom(QVariant &data);
    58     /* Load data to corresponding widgets from cache,
    59      * this task SHOULD be performed in GUI thread only: */
     58    /** Loads data into corresponding widgets from the cache,
     59      * this task SHOULD be performed in the GUI thread only. */
    6060    void getFromCache();
    6161
    62     /* Save data from corresponding widgets to cache,
    63      * this task SHOULD be performed in GUI thread only: */
     62    /** Saves data from corresponding widgets to the cache,
     63      * this task SHOULD be performed in the GUI thread only. */
    6464    void putToCache();
    65     /* Save data from cache to corresponding external object(s),
    66      * this task COULD be performed in other than GUI thread: */
     65    /** Saves data from the cache to corresponding external object(s),
     66      * this task COULD be performed in other than the GUI thread. */
    6767    void saveFromCacheTo(QVariant &data);
    6868
    69     /* API: Validation stuff: */
     69    /** Performs validation, updates @a messages list if something is wrong. */
    7070    bool validate(QList<UIValidationMessage> &messages);
    7171
    72     /* Helper: Navigation stuff: */
     72    /** Defines TAB order. */
    7373    void setOrderAfter(QWidget *pWidget);
    7474
    75     /* Helper: Translation stuff: */
     75    /** Handles translation event. */
    7676    void retranslateUi();
    7777

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsLanguage.cpp

    r65686 r66163  
    249249}
    250250
    251 /* Save data from cache to corresponding external object(s),
    252  * this task COULD be performed in other than GUI thread: */
    253251void UIGlobalSettingsLanguage::saveFromCacheTo(QVariant &data)
    254252{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsLanguage.h

    r65686 r66163  
    6363protected:
    6464
    65     /* Load data to cache from corresponding external object(s),
    66      * this task COULD be performed in other than GUI thread: */
     65    /** Loads data into the cache from corresponding external object(s),
     66      * this task COULD be performed in other than the GUI thread. */
    6767    void loadToCacheFrom(QVariant &data);
    68     /* Load data to corresponding widgets from cache,
    69      * this task SHOULD be performed in GUI thread only: */
     68    /** Loads data into corresponding widgets from the cache,
     69      * this task SHOULD be performed in the GUI thread only. */
    7070    void getFromCache();
    7171
    72     /* Save data from corresponding widgets to cache,
    73      * this task SHOULD be performed in GUI thread only: */
     72    /** Saves data from corresponding widgets to the cache,
     73      * this task SHOULD be performed in the GUI thread only. */
    7474    void putToCache();
    75     /* Save data from cache to corresponding external object(s),
    76      * this task COULD be performed in other than GUI thread: */
     75    /** Saves data from the cache to corresponding external object(s),
     76      * this task COULD be performed in other than the GUI thread. */
    7777    void saveFromCacheTo(QVariant &data);
    7878
    79     /* Helper: Navigation stuff: */
     79    /** Defines TAB order. */
    8080    void setOrderAfter(QWidget *pWidget);
    8181
    82     /* Helper: Translation stuff: */
     82    /** Handles translation event. */
    8383    void retranslateUi();
    8484
    85     /* Handlers: Event stuff: */
     85    /** Handles show @a pEvent. */
    8686    void showEvent(QShowEvent *pEvent);
     87    /** Performs final page polishing. */
    8788    void polishEvent(QShowEvent *pEvent);
    8889

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsNetwork.cpp

    r65760 r66163  
    5757    void uploadNetworkData(UIDataSettingsGlobalNetworkNAT &data);
    5858
    59     /* API: Validation stuff: */
    60     bool validate(UIValidationMessage &message);
     59    /** Performs validation, updates @a messages list if something is wrong. */
     60    bool validate(UIValidationMessage &messages);
    6161
    6262    /* API: Update stuff: */
    … …  
    9090    void uploadNetworkData(UIDataSettingsGlobalNetworkHost &data);
    9191
    92     /* API: Validation stuff: */
    93     bool validate(UIValidationMessage &message);
     92    /** Performs validation, updates @a messages list if something is wrong. */
     93    bool validate(UIValidationMessage &messages);
    9494
    9595    /* API: Update stuff: */

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsNetwork.h

    r65687 r66163  
    252252protected:
    253253
    254     /* API:
    255      * Load data to cache from corresponding external object(s),
    256      * this task COULD be performed in other than GUI thread: */
     254    /** Loads data into the cache from corresponding external object(s),
     255      * this task COULD be performed in other than the GUI thread. */
    257256    void loadToCacheFrom(QVariant &data);
    258     /* API:
    259      * Load data to corresponding widgets from cache,
    260      * this task SHOULD be performed in GUI thread only: */
     257    /** Loads data into corresponding widgets from the cache,
     258      * this task SHOULD be performed in the GUI thread only. */
    261259    void getFromCache();
    262260
    263     /* API:
    264      * Save data from corresponding widgets to cache,
    265      * this task SHOULD be performed in GUI thread only: */
     261    /** Saves data from corresponding widgets to the cache,
     262      * this task SHOULD be performed in the GUI thread only. */
    266263    void putToCache();
    267     /* API:
    268      * Save data from cache to corresponding external object(s),
    269      * this task COULD be performed in other than GUI thread: */
     264    /** Saves data from the cache to corresponding external object(s),
     265      * this task COULD be performed in other than the GUI thread. */
    270266    void saveFromCacheTo(QVariant &data);
    271267
    272     /* API: Validation stuff: */
     268    /** Performs validation, updates @a messages list if something is wrong. */
    273269    bool validate(QList<UIValidationMessage> &messages);
    274270
    275     /* API: Navigation stuff: */
     271    /** Defines TAB order. */
    276272    void setOrderAfter(QWidget *pWidget);
    277273
    278     /* API: Translation stuff: */
     274    /** Handles translation event. */
    279275    void retranslateUi();
    280276

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsProxy.h

    r65688 r66163  
    7272protected:
    7373
    74     /* Load data to cache from corresponding external object(s),
    75      * this task COULD be performed in other than GUI thread: */
     74    /** Loads data into the cache from corresponding external object(s),
     75      * this task COULD be performed in other than the GUI thread. */
    7676    void loadToCacheFrom(QVariant &data);
    77     /* Load data to corresponding widgets from cache,
    78      * this task SHOULD be performed in GUI thread only: */
     77    /** Loads data into corresponding widgets from the cache,
     78      * this task SHOULD be performed in the GUI thread only. */
    7979    void getFromCache();
    8080
    81     /* Save data from corresponding widgets to cache,
    82      * this task SHOULD be performed in GUI thread only: */
     81    /** Saves data from corresponding widgets to the cache,
     82      * this task SHOULD be performed in the GUI thread only. */
    8383    void putToCache();
    84     /* Save data from cache to corresponding external object(s),
    85      * this task COULD be performed in other than GUI thread: */
     84    /** Saves data from the cache to corresponding external object(s),
     85      * this task COULD be performed in other than the GUI thread. */
    8686    void saveFromCacheTo(QVariant &data);
    8787
    88     /* API: Validation stuff: */
     88    /** Performs validation, updates @a messages list if something is wrong. */
    8989    bool validate(QList<UIValidationMessage> &messages);
    9090
    91     /* Helper: Navigation stuff: */
     91    /** Defines TAB order. */
    9292    void setOrderAfter(QWidget *pWidget);
    9393
    94     /* Helper: Translation stuff: */
     94    /** Handles translation event. */
    9595    void retranslateUi();
    9696

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/global/UIGlobalSettingsUpdate.h

    r65689 r66163  
    7676protected:
    7777
    78     /* Load data to cache from corresponding external object(s),
    79      * this task COULD be performed in other than GUI thread: */
     78    /** Loads data into the cache from corresponding external object(s),
     79      * this task COULD be performed in other than the GUI thread. */
    8080    void loadToCacheFrom(QVariant &data);
    81     /* Load data to corresponding widgets from cache,
    82      * this task SHOULD be performed in GUI thread only: */
     81    /** Loads data into corresponding widgets from the cache,
     82      * this task SHOULD be performed in the GUI thread only. */
    8383    void getFromCache();
    8484
    85     /* Save data from corresponding widgets to cache,
    86      * this task SHOULD be performed in GUI thread only: */
     85    /** Saves data from corresponding widgets to the cache,
     86      * this task SHOULD be performed in the GUI thread only. */
    8787    void putToCache();
    88     /* Save data from cache to corresponding external object(s),
    89      * this task COULD be performed in other than GUI thread: */
     88    /** Saves data from the cache to corresponding external object(s),
     89      * this task COULD be performed in other than the GUI thread. */
    9090    void saveFromCacheTo(QVariant &data);
    9191
    92     /* Helper: Navigation stuff: */
     92    /** Defines TAB order. */
    9393    void setOrderAfter(QWidget *pWidget);
    9494
    95     /* Helper: Translation stuff: */
     95    /** Handles translation event. */
    9696    void retranslateUi();
    9797

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsAudio.cpp

    r62585 r66163  
    3636}
    3737
    38 /* Load data to cache from corresponding external object(s),
    39  * this task COULD be performed in other than GUI thread: */
    4038void UIMachineSettingsAudio::loadToCacheFrom(QVariant &data)
    4139{
    … …  
    6664}
    6765
    68 /* Load data to corresponding widgets from cache,
    69  * this task SHOULD be performed in GUI thread only: */
    7066void UIMachineSettingsAudio::getFromCache()
    7167{
    … …  
    8278}
    8379
    84 /* Save data from corresponding widgets to cache,
    85  * this task SHOULD be performed in GUI thread only: */
    8680void UIMachineSettingsAudio::putToCache()
    8781{
    … …  
    9892}
    9993
    100 /* Save data from cache to corresponding external object(s),
    101  * this task COULD be performed in other than GUI thread: */
    10294void UIMachineSettingsAudio::saveFromCacheTo(QVariant &data)
    10395{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsAudio.h

    r65629 r66163  
    6161protected:
    6262
    63     /* API: Cache stuff: */
     63    /** Returns whether the page content was changed. */
    6464    bool changed() const { return m_cache.wasChanged(); }
    6565
    66     /* Load data to cache from corresponding external object(s),
    67      * this task COULD be performed in other than GUI thread: */
     66    /** Loads data into the cache from corresponding external object(s),
     67      * this task COULD be performed in other than the GUI thread. */
    6868    void loadToCacheFrom(QVariant &data);
    69     /* Load data to corresponding widgets from cache,
    70      * this task SHOULD be performed in GUI thread only: */
     69    /** Loads data into corresponding widgets from the cache,
     70      * this task SHOULD be performed in the GUI thread only. */
    7171    void getFromCache();
    7272
    73     /* Save data from corresponding widgets to cache,
    74      * this task SHOULD be performed in GUI thread only: */
     73    /** Saves data from corresponding widgets to the cache,
     74      * this task SHOULD be performed in the GUI thread only. */
    7575    void putToCache();
    76     /* Save data from cache to corresponding external object(s),
    77      * this task COULD be performed in other than GUI thread: */
     76    /** Saves data from the cache to corresponding external object(s),
     77      * this task COULD be performed in other than the GUI thread. */
    7878    void saveFromCacheTo(QVariant &data);
    7979
    80     /* API: Focus-order stuff: */
     80    /** Defines TAB order. */
    8181    void setOrderAfter(QWidget *pWidget);
    8282
    83     /* Helper: Translate stuff: */
     83    /** Handles translation event. */
    8484    void retranslateUi();
    8585
    86     /* Helper: Polish stuff: */
     86    /** Performs final page polishing. */
    8787    void polishPage();
    8888

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsDisplay.cpp

    r63054 r66163  
    8585#endif /* VBOX_WITH_VIDEOHWACCEL */
    8686
    87 /* Load data to cache from corresponding external object(s),
    88  * this task COULD be performed in other than GUI thread: */
    8987void UIMachineSettingsDisplay::loadToCacheFrom(QVariant &data)
    9088{
    … …  
    143141}
    144142
    145 /* Load data to corresponding widgets from cache,
    146  * this task SHOULD be performed in GUI thread only: */
    147143void UIMachineSettingsDisplay::getFromCache()
    148144{
    … …  
    191187}
    192188
    193 /* Save data from corresponding widgets to cache,
    194  * this task SHOULD be performed in GUI thread only: */
    195189void UIMachineSettingsDisplay::putToCache()
    196190{
    … …  
    234228}
    235229
    236 /* Save data from cache to corresponding external object(s),
    237  * this task COULD be performed in other than GUI thread: */
    238230void UIMachineSettingsDisplay::saveFromCacheTo(QVariant &data)
    239231{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsDisplay.h

    r65629 r66163  
    142142protected:
    143143
    144     /* API: Cache stuff: */
     144    /** Returns whether the page content was changed. */
    145145    bool changed() const { return m_cache.wasChanged(); }
    146146
    147     /* API: Load data to cache from corresponding external object(s),
    148      * this task COULD be performed in other than GUI thread: */
     147    /** Loads data into the cache from corresponding external object(s),
     148      * this task COULD be performed in other than the GUI thread. */
    149149    void loadToCacheFrom(QVariant &data);
    150     /* API: Load data to corresponding widgets from cache,
    151      * this task SHOULD be performed in GUI thread only: */
     150    /** Loads data into corresponding widgets from the cache,
     151      * this task SHOULD be performed in the GUI thread only. */
    152152    void getFromCache();
    153153
    154     /* API: Save data from corresponding widgets to cache,
    155      * this task SHOULD be performed in GUI thread only: */
     154    /** Saves data from corresponding widgets to the cache,
     155      * this task SHOULD be performed in the GUI thread only. */
    156156    void putToCache();
    157     /* API: Save data from cache to corresponding external object(s),
    158      * this task COULD be performed in other than GUI thread: */
     157    /** Saves data from the cache to corresponding external object(s),
     158      * this task COULD be performed in other than the GUI thread. */
    159159    void saveFromCacheTo(QVariant &data);
    160160
    161     /* API: Validation stuff: */
     161    /** Performs validation, updates @a messages list if something is wrong. */
    162162    bool validate(QList<UIValidationMessage> &messages);
    163163
    164     /* Helper: Navigation stuff: */
     164    /** Defines TAB order. */
    165165    void setOrderAfter(QWidget *pWidget);
    166166
    167     /* Helper: Translation stuff: */
     167    /** Handles translation event. */
    168168    void retranslateUi();
    169169
    170     /* Helper: Polishing stuff: */
     170    /** Performs final page polishing. */
    171171    void polishPage();
    172172

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsInterface.cpp

    r62493 r66163  
    4141}
    4242
    43 /* Load data to cache from corresponding external object(s),
    44  * this task COULD be performed in other than GUI thread: */
    4543void UIMachineSettingsInterface::loadToCacheFrom(QVariant &data)
    4644{
    … …  
    8684}
    8785
    88 /* Load data to corresponding widgets from cache,
    89  * this task SHOULD be performed in GUI thread only: */
    9086void UIMachineSettingsInterface::getFromCache()
    9187{
    … …  
    125121}
    126122
    127 /* Save data from corresponding widgets to cache,
    128  * this task SHOULD be performed in GUI thread only: */
    129123void UIMachineSettingsInterface::putToCache()
    130124{
    … …  
    161155}
    162156
    163 /* Save data from cache to corresponding external object(s),
    164  * this task COULD be performed in other than GUI thread: */
    165157void UIMachineSettingsInterface::saveFromCacheTo(QVariant &data)
    166158{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsInterface.h

    r65629 r66163  
    129129protected:
    130130
    131     /* API: Cache stuff: */
     131    /** Returns whether the page content was changed. */
    132132    bool changed() const { return m_cache.wasChanged(); }
    133133
    134     /* API: Load data to cache from corresponding external object(s),
    135      * this task COULD be performed in other than GUI thread: */
     134    /** Loads data into the cache from corresponding external object(s),
     135      * this task COULD be performed in other than the GUI thread. */
    136136    void loadToCacheFrom(QVariant &data);
    137     /* API: Load data to corresponding widgets from cache,
    138      * this task SHOULD be performed in GUI thread only: */
     137    /** Loads data into corresponding widgets from the cache,
     138      * this task SHOULD be performed in the GUI thread only. */
    139139    void getFromCache();
    140140
    141     /* API: Save data from corresponding widgets to cache,
    142      * this task SHOULD be performed in GUI thread only: */
     141    /** Saves data from corresponding widgets to the cache,
     142      * this task SHOULD be performed in the GUI thread only. */
    143143    void putToCache();
    144     /* API: Save data from cache to corresponding external object(s),
    145      * this task COULD be performed in other than GUI thread: */
     144    /** Saves data from the cache to corresponding external object(s),
     145      * this task COULD be performed in other than the GUI thread. */
    146146    void saveFromCacheTo(QVariant &data);
    147147
    148     /* Helper: Navigation stuff: */
     148    /** Defines TAB order. */
    149149    void setOrderAfter(QWidget *pWidget);
    150150
    151     /* Helper: Translation stuff: */
     151    /** Handles translation event. */
    152152    void retranslateUi();
    153153
    154     /* Helper: Polishing stuff: */
     154    /** Performs final page polishing. */
    155155    void polishPage();
    156156

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsNetwork.cpp

    r65891 r66163  
    842842}
    843843
    844 /* Load data to cache from corresponding external object(s),
    845  * this task COULD be performed in other than GUI thread: */
    846844void UIMachineSettingsNetworkPage::loadToCacheFrom(QVariant &data)
    847845{
    … …  
    909907}
    910908
    911 /* Load data to corresponding widgets from cache,
    912  * this task SHOULD be performed in GUI thread only: */
    913909void UIMachineSettingsNetworkPage::getFromCache()
    914910{
    … …  
    941937}
    942938
    943 /* Save data from corresponding widgets to cache,
    944  * this task SHOULD be performed in GUI thread only: */
    945939void UIMachineSettingsNetworkPage::putToCache()
    946940{
    … …  
    956950}
    957951
    958 /* Save data from cache to corresponding external object(s),
    959  * this task COULD be performed in other than GUI thread: */
    960952void UIMachineSettingsNetworkPage::saveFromCacheTo(QVariant &data)
    961953{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsNetwork.h

    r65629 r66163  
    111111    void uploadAdapterCache(UISettingsCacheMachineNetworkAdapter &adapterCache);
    112112
    113     /* API: Validation stuff: */
     113    /** Performs validation, updates @a messages list if something is wrong. */
    114114    bool validate(QList<UIValidationMessage> &messages);
    115115
    … …  
    137137protected:
    138138
    139     /* Translation stuff: */
     139    /** Handles translation event. */
    140140    void retranslateUi();
    141141
    … …  
    203203protected:
    204204
    205     /* Load data to cache from corresponding external object(s),
    206      * this task COULD be performed in other than GUI thread: */
     205    /** Loads data into the cache from corresponding external object(s),
     206      * this task COULD be performed in other than the GUI thread. */
    207207    void loadToCacheFrom(QVariant &data);
    208     /* Load data to corresponding widgets from cache,
    209      * this task SHOULD be performed in GUI thread only: */
     208    /** Loads data into corresponding widgets from the cache,
     209      * this task SHOULD be performed in the GUI thread only. */
    210210    void getFromCache();
    211211
    212     /* Save data from corresponding widgets to cache,
    213      * this task SHOULD be performed in GUI thread only: */
     212    /** Saves data from corresponding widgets to the cache,
     213      * this task SHOULD be performed in the GUI thread only. */
    214214    void putToCache();
    215     /* Save data from cache to corresponding external object(s),
    216      * this task COULD be performed in other than GUI thread: */
     215    /** Saves data from the cache to corresponding external object(s),
     216      * this task COULD be performed in other than the GUI thread. */
    217217    void saveFromCacheTo(QVariant &data);
    218218
    219     /* Page changed: */
     219    /** Returns whether the page content was changed. */
    220220    bool changed() const { return m_cache.wasChanged(); }
    221221
    222     /* API: Validation stuff: */
     222    /** Performs validation, updates @a messages list if something is wrong. */
    223223    bool validate(QList<UIValidationMessage> &messages);
    224224
    225     /* Translation stuff: */
     225    /** Handles translation event. */
    226226    void retranslateUi();
    227227

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsParallel.cpp

    r65629 r66163  
    206206}
    207207
    208 /* Load data to cache from corresponding external object(s),
    209  * this task COULD be performed in other than GUI thread: */
    210208void UIMachineSettingsParallelPage::loadToCacheFrom(QVariant &data)
    211209{
    … …  
    242240}
    243241
    244 /* Load data to corresponding widgets from cache,
    245  * this task SHOULD be performed in GUI thread only: */
    246242void UIMachineSettingsParallelPage::getFromCache()
    247243{
    … …  
    274270}
    275271
    276 /* Save data from corresponding widgets to cache,
    277  * this task SHOULD be performed in GUI thread only: */
    278272void UIMachineSettingsParallelPage::putToCache()
    279273{
    … …  
    289283}
    290284
    291 /* Save data from cache to corresponding external object(s),
    292  * this task COULD be performed in other than GUI thread: */
    293285void UIMachineSettingsParallelPage::saveFromCacheTo(QVariant &data)
    294286{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsParallel.h

    r65629 r66163  
    117117protected:
    118118
    119     /* Load data to cache from corresponding external object(s),
    120      * this task COULD be performed in other than GUI thread: */
     119    /** Loads data into the cache from corresponding external object(s),
     120      * this task COULD be performed in other than the GUI thread. */
    121121    void loadToCacheFrom(QVariant &data);
    122     /* Load data to corresponding widgets from cache,
    123      * this task SHOULD be performed in GUI thread only: */
     122    /** Loads data into corresponding widgets from the cache,
     123      * this task SHOULD be performed in the GUI thread only. */
    124124    void getFromCache();
    125125
    126     /* Save data from corresponding widgets to cache,
    127      * this task SHOULD be performed in GUI thread only: */
     126    /** Saves data from corresponding widgets to the cache,
     127      * this task SHOULD be performed in the GUI thread only. */
    128128    void putToCache();
    129     /* Save data from cache to corresponding external object(s),
    130      * this task COULD be performed in other than GUI thread: */
     129    /** Saves data from the cache to corresponding external object(s),
     130      * this task COULD be performed in other than the GUI thread. */
    131131    void saveFromCacheTo(QVariant &data);
    132132
    133     /* Page changed: */
     133    /** Returns whether the page content was changed. */
    134134    bool changed() const { return m_cache.wasChanged(); }
    135135
    136     /* API: Validation stuff: */
     136    /** Performs validation, updates @a messages list if something is wrong. */
    137137    bool validate(QList<UIValidationMessage> &messages);
    138138
     139    /** Handles translation event. */
    139140    void retranslateUi();
    140141

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsSF.cpp

    r65629 r66163  
    239239}
    240240
    241 /* Load data to cache from corresponding external object(s),
    242  * this task COULD be performed in other than GUI thread: */
    243241void UIMachineSettingsSF::loadToCacheFrom(QVariant &data)
    244242{
    … …  
    291289}
    292290
    293 /* Load data to corresponding widgets from cache,
    294  * this task SHOULD be performed in GUI thread only: */
    295291void UIMachineSettingsSF::getFromCache()
    296292{
    … …  
    323319}
    324320
    325 /* Save data from corresponding widgets to cache,
    326  * this task SHOULD be performed in GUI thread only: */
    327321void UIMachineSettingsSF::putToCache()
    328322{
    … …  
    349343}
    350344
    351 /* Save data from cache to corresponding external object(s),
    352  * this task COULD be performed in other than GUI thread: */
    353345void UIMachineSettingsSF::saveFromCacheTo(QVariant &data)
    354346{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsSF.h

    r65629 r66163  
    8686protected:
    8787
    88     /* Load data to cache from corresponding external object(s),
    89      * this task COULD be performed in other than GUI thread: */
     88    /** Loads data into the cache from corresponding external object(s),
     89      * this task COULD be performed in other than the GUI thread. */
    9090    void loadToCacheFrom(QVariant &data);
    9191    void loadToCacheFrom(UISharedFolderType sharedFoldersType);
    92     /* Load data to corresponding widgets from cache,
    93      * this task SHOULD be performed in GUI thread only: */
     92    /** Loads data into corresponding widgets from the cache,
     93      * this task SHOULD be performed in the GUI thread only. */
    9494    void getFromCache();
    9595
    96     /* Save data from corresponding widgets to cache,
    97      * this task SHOULD be performed in GUI thread only: */
     96    /** Saves data from corresponding widgets to the cache,
     97      * this task SHOULD be performed in the GUI thread only. */
    9898    void putToCache();
    99     /* Save data from cache to corresponding external object(s),
    100      * this task COULD be performed in other than GUI thread: */
     99    /** Saves data from the cache to corresponding external object(s),
     100      * this task COULD be performed in other than the GUI thread. */
    101101    void saveFromCacheTo(QVariant &data);
     102    /** Saves data of @a sharedFoldersType from the cache to corresponding external object(s),
     103      * this task COULD be performed in other than the GUI thread. */
    102104    void saveFromCacheTo(UISharedFolderType sharedFoldersType);
    103105
    104     /* Page changed: */
     106    /** Returns whether the page content was changed. */
    105107    bool changed() const { return m_cache.wasChanged(); }
    106108
    107     void setOrderAfter (QWidget *aWidget);
     109    /** Defines TAB order. */
     110    void setOrderAfter(QWidget *pWidget);
    108111
     112    /** Handles translation event. */
    109113    void retranslateUi();
    110114

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsSerial.cpp

    r65629 r66163  
    245245}
    246246
    247 /* Load data to cache from corresponding external object(s),
    248  * this task COULD be performed in other than GUI thread: */
    249247void UIMachineSettingsSerialPage::loadToCacheFrom(QVariant &data)
    250248{
    … …  
    283281}
    284282
    285 /* Load data to corresponding widgets from cache,
    286  * this task SHOULD be performed in GUI thread only: */
    287283void UIMachineSettingsSerialPage::getFromCache()
    288284{
    … …  
    315311}
    316312
    317 /* Save data from corresponding widgets to cache,
    318  * this task SHOULD be performed in GUI thread only: */
    319313void UIMachineSettingsSerialPage::putToCache()
    320314{
    … …  
    330324}
    331325
    332 /* Save data from cache to corresponding external object(s),
    333  * this task COULD be performed in other than GUI thread: */
    334326void UIMachineSettingsSerialPage::saveFromCacheTo(QVariant &data)
    335327{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsSerial.h

    r65629 r66163  
    124124protected:
    125125
    126     /* Load data to cache from corresponding external object(s),
    127      * this task COULD be performed in other than GUI thread: */
     126    /** Loads data into the cache from corresponding external object(s),
     127      * this task COULD be performed in other than the GUI thread. */
    128128    void loadToCacheFrom(QVariant &data);
    129     /* Load data to corresponding widgets from cache,
    130      * this task SHOULD be performed in GUI thread only: */
     129    /** Loads data into corresponding widgets from the cache,
     130      * this task SHOULD be performed in the GUI thread only. */
    131131    void getFromCache();
    132132
    133     /* Save data from corresponding widgets to cache,
    134      * this task SHOULD be performed in GUI thread only: */
     133    /** Saves data from corresponding widgets to the cache,
     134      * this task SHOULD be performed in the GUI thread only. */
    135135    void putToCache();
    136     /* Save data from cache to corresponding external object(s),
    137      * this task COULD be performed in other than GUI thread: */
     136    /** Saves data from the cache to corresponding external object(s),
     137      * this task COULD be performed in other than the GUI thread. */
    138138    void saveFromCacheTo(QVariant &data);
    139139
    140     /* Page changed: */
     140    /** Returns whether the page content was changed. */
    141141    bool changed() const { return m_cache.wasChanged(); }
    142142
    143     /* API: Validation stuff: */
     143    /** Performs validation, updates @a messages list if something is wrong. */
    144144    bool validate(QList<UIValidationMessage> &messages);
    145145
     146    /** Handles translation event. */
    146147    void retranslateUi();
    147148

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsStorage.cpp

    r65629 r66163  
    21962196}
    21972197
    2198 /* Load data to cache from corresponding external object(s),
    2199  * this task COULD be performed in other than GUI thread: */
    22002198void UIMachineSettingsStorage::loadToCacheFrom(QVariant &data)
    22012199{
    … …  
    22762274}
    22772275
    2278 /* Load data to corresponding widgets from cache,
    2279  * this task SHOULD be performed in GUI thread only: */
    22802276void UIMachineSettingsStorage::getFromCache()
    22812277{
    … …  
    23362332}
    23372333
    2338 /* Save data from corresponding widgets to cache,
    2339  * this task SHOULD be performed in GUI thread only: */
    23402334void UIMachineSettingsStorage::putToCache()
    23412335{
    … …  
    23882382}
    23892383
    2390 /* Save data from cache to corresponding external object(s),
    2391  * this task COULD be performed in other than GUI thread: */
    23922384void UIMachineSettingsStorage::saveFromCacheTo(QVariant &data)
    23932385{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsStorage.h

    r65629 r66163  
    690690protected:
    691691
    692     /* Load data to cache from corresponding external object(s),
    693      * this task COULD be performed in other than GUI thread: */
     692    /** Loads data into the cache from corresponding external object(s),
     693      * this task COULD be performed in other than the GUI thread. */
    694694    void loadToCacheFrom(QVariant &data);
    695     /* Load data to corresponding widgets from cache,
    696      * this task SHOULD be performed in GUI thread only: */
     695    /** Loads data into corresponding widgets from the cache,
     696      * this task SHOULD be performed in the GUI thread only. */
    697697    void getFromCache();
    698698
    699     /* Save data from corresponding widgets to cache,
    700      * this task SHOULD be performed in GUI thread only: */
     699    /** Saves data from corresponding widgets to the cache,
     700      * this task SHOULD be performed in the GUI thread only. */
    701701    void putToCache();
    702     /* Save data from cache to corresponding external object(s),
    703      * this task COULD be performed in other than GUI thread: */
     702    /** Saves data from the cache to corresponding external object(s),
     703      * this task COULD be performed in other than the GUI thread. */
    704704    void saveFromCacheTo(QVariant &data);
    705705
    706     /* Page changed: */
     706    /** Returns whether the page content was changed. */
    707707    bool changed() const { return m_cache.wasChanged(); }
    708708
    709     /* API: Validation stuff: */
     709    /** Performs validation, updates @a messages list if something is wrong. */
    710710    bool validate(QList<UIValidationMessage> &messages);
    711711
     712    /** Handles translation event. */
    712713    void retranslateUi();
    713714
    714     void showEvent (QShowEvent *aEvent);
     715    /** Handles show @a pEvent. */
     716    void showEvent(QShowEvent *pEvent);
    715717
    716718private slots:

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsSystem.cpp

    r63567 r66163  
    7676}
    7777
    78 /* Load data to cache from corresponding external object(s),
    79  * this task COULD be performed in other than GUI thread: */
    8078void UIMachineSettingsSystem::loadToCacheFrom(QVariant &data)
    8179{
    … …  
    145143}
    146144
    147 /* Load data to corresponding widgets from cache,
    148  * this task SHOULD be performed in GUI thread only: */
    149145void UIMachineSettingsSystem::getFromCache()
    150146{
    … …  
    197193}
    198194
    199 /* Save data from corresponding widgets to cache,
    200  * this task SHOULD be performed in GUI thread only: */
    201195void UIMachineSettingsSystem::putToCache()
    202196{
    … …  
    238232}
    239233
    240 /* Save data from cache to corresponding external object(s),
    241  * this task COULD be performed in other than GUI thread: */
    242234void UIMachineSettingsSystem::saveFromCacheTo(QVariant &data)
    243235{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsSystem.h

    r65629 r66163  
    137137protected:
    138138
    139     /* API: Cache stuff: */
     139    /** Returns whether the page content was changed. */
    140140    bool changed() const { return m_cache.wasChanged(); }
    141141
    142     /* API: Load data to cache from corresponding external object(s),
    143      * this task COULD be performed in other than GUI thread: */
     142    /** Loads data into the cache from corresponding external object(s),
     143      * this task COULD be performed in other than the GUI thread. */
    144144    void loadToCacheFrom(QVariant &data);
    145     /* API: Load data to corresponding widgets from cache,
    146      * this task SHOULD be performed in GUI thread only: */
     145    /** Loads data into corresponding widgets from the cache,
     146      * this task SHOULD be performed in the GUI thread only. */
    147147    void getFromCache();
    148148
    149     /* API: Save data from corresponding widgets to cache,
    150      * this task SHOULD be performed in GUI thread only: */
     149    /** Saves data from corresponding widgets to the cache,
     150      * this task SHOULD be performed in the GUI thread only. */
    151151    void putToCache();
    152     /* API: Save data from cache to corresponding external object(s),
    153      * this task COULD be performed in other than GUI thread: */
     152    /** Saves data from the cache to corresponding external object(s),
     153      * this task COULD be performed in other than the GUI thread. */
    154154    void saveFromCacheTo(QVariant &data);
    155155
    156     /* API: Validation stuff: */
     156    /** Performs validation, updates @a messages list if something is wrong. */
    157157    bool validate(QList<UIValidationMessage> &messages);
    158158
    159     /* Helper: Navigation stuff: */
     159    /** Defines TAB order. */
    160160    void setOrderAfter(QWidget *pWidget);
    161161
    162     /* Helper: Translation stuff: */
     162    /** Handles translation event. */
    163163    void retranslateUi();
    164164
    165     /* Helper: Polishing stuff: */
     165    /** Performs final page polishing. */
    166166    void polishPage();
    167167

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsUSB.cpp

    r65919 r66163  
    274274}
    275275
    276 /* Load data to cache from corresponding external object(s),
    277  * this task COULD be performed in other than GUI thread: */
    278276void UIMachineSettingsUSB::loadToCacheFrom(QVariant &data)
    279277{
    … …  
    333331}
    334332
    335 /* Load data to corresponding widgets from cache,
    336  * this task SHOULD be performed in GUI thread only: */
    337333void UIMachineSettingsUSB::getFromCache()
    338334{
    … …  
    370366}
    371367
    372 /* Save data from corresponding widgets to cache,
    373  * this task SHOULD be performed in GUI thread only: */
    374368void UIMachineSettingsUSB::putToCache()
    375369{
    … …  
    400394}
    401395
    402 /* Save data from cache to corresponding external object(s),
    403  * this task COULD be performed in other than GUI thread: */
    404396void UIMachineSettingsUSB::saveFromCacheTo(QVariant &data)
    405397{

  • trunk/src/VBox/Frontends/VirtualBox/src/settings/machine/UIMachineSettingsUSB.h

    r65919 r66163  
    126126protected:
    127127
    128     /* Load data to cache from corresponding external object(s),
    129      * this task COULD be performed in other than GUI thread: */
     128    /** Loads data into the cache from corresponding external object(s),
     129      * this task COULD be performed in other than the GUI thread. */
    130130    void loadToCacheFrom(QVariant &data);
    131     /* Load data to corresponding widgets from cache,
    132      * this task SHOULD be performed in GUI thread only: */
     131    /** Loads data into corresponding widgets from the cache,
     132      * this task SHOULD be performed in the GUI thread only. */
    133133    void getFromCache();
    134134
    135     /* Save data from corresponding widgets to cache,
    136      * this task SHOULD be performed in GUI thread only: */
     135    /** Saves data from corresponding widgets to the cache,
     136      * this task SHOULD be performed in the GUI thread only. */
    137137    void putToCache();
    138     /* Save data from cache to corresponding external object(s),
    139      * this task COULD be performed in other than GUI thread: */
     138    /** Saves data from the cache to corresponding external object(s),
     139      * this task COULD be performed in other than the GUI thread. */
    140140    void saveFromCacheTo(QVariant &data);
    141141
    142     /* Page changed: */
     142    /** Returns whether the page content was changed. */
    143143    bool changed() const { return m_cache.wasChanged(); }
    144144
    145     /* API: Validation stuff: */
     145    /** Performs validation, updates @a messages list if something is wrong. */
    146146    bool validate(QList<UIValidationMessage> &messages);
    147147
    148     void setOrderAfter (QWidget *aWidget);
     148    /** Defines TAB order. */
     149    void setOrderAfter(QWidget *pWidget);
    149150
     151    /** Handles translation event. */
    150152    void retranslateUi();
    151153
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