程序啟動讀取和關閉時保存應用程序設置(QSettings)


保存應用程序設置(QSettings)

1.   QSettings 類

 

  • QSettings 提供保存應用程序當前設置的接口,可以方便地保存程序的狀態,例如窗口大小和位置,選項的選中狀態等等。

 

  • 在 Windows 系統中,程序程序的狀態信息記錄在注冊表中;在 Mac OS X 系統上,這些信息記錄在 XML 配置文件中;在 Unix 系統中,則使用 INI text 文件記錄。QSettings 則是對這些技術的一個抽象,使得保存和取得應用程序的設置狀態的只得獨立於操作系統。

 

  • QSettings 的 API 是基於 QVariant 類,當創建一個 QSettings 對象時,必須傳遞公司或組織的名稱(QString)和應用程序的名稱(QString)用於構造一個 QSettings 對象。

 

2.   使用 QSettings

 

(1)構造一個 QSettings 對象

 

  • QSettings settings("MySoft", "Star Runner") ;

 

(2)添加一個設置到 settings 中

 

  • 程序的設置是以“key-value”的形式,保存在 QSettings 對象中的。其中,key 由一個 QString 類型定義,value 是由 QVariant 類型定義:

 

  • settings.setValue( "editor/wrapMargin", 68 ) ;

         /*  wrapMargin 是一個子 key

         /*  如果存在相同的 key,那么已存在的 key 所對應的值將由新值代替

 

(3)從 setttings 中取出設置

 

  • 同時也可以通過 key 從 settings 中取出值:

 

  • int margin = settings.value( "editor/wrapMargin").toInt( ) ;

 

3.   QSettings 的組織方式

 

(1)用“/”表示子 key

 

  • QSettings 存儲狀態信息的形式是 key-value,其中 key 與文件路徑這個概念是類似的,subkey 可以用定義文件路徑的形式定義,例如 findDialog/ matchCase,其中 matchCase 就是一個 subkey;

 

(2)使用 beginGroup( ) 和 endGroup( ) 

 

  • void QSettings : : beginGroup( const QString &prefix ) 的作用是在當前的 group 后面加上 prefix。當前的 group 自動加到一個 QSettings 對象的尾部:

 

settings.beginGroup("mainwindow") ;

settings.setValue("size", win->size( ) ) ;

settings.setValue("fullScreen", win->isFullScreen( ) ) ;

settings.endGroup( ) ;

 

settings.beginGroup("outputpanel") ;

settings.setValue("visible", panel->isVisible( ) ) ;

settings.endGroup( ) ;

 

  • 這樣設置后,當前的 settings 對象看上去應該是這樣的層次結構:

 

mainwindow/ size

mainwindow/ fullScreen

outputpanel/ visible

 

(3)取得 key 與子 key

 

  • QStringList QSettings : : childKeys( ) const 函數返回所有頂層 keys,組成一個 QStringList 作為一個返回值。例如:

 

QSettings settings ;

settings.setValue("fridge/color", Qt::white) ;

settings.setValue("fridge/size", QSize(32, 96) ) ;

settings.setValue("sofa", true) ;

settings.setValue("tv", false) ;

QStringList keys = settings.childKeys( ) ;

 

  • 那么這個 keys 中看上去應該是這樣的:

 

  • keys: [ "sofa", "tv" ]

 

  • QStringList QSettings : : childGroups ( ) const 是返回所有包含有 key 的頂層 groups,組成一個 QStringList 作為返回值:

 

QSettings settings ;

settings.setValue("fridge/color",Qt::white); 

settings.setValue("fridge/size",QSize(32,96)); 

settings.setValue("sofa",true); 

settings.setValue("tv",false);

QStringList groups = settings.childGroups() ;

 

  • 則 groups 看上去是:

  • groups : [ "fridge" ]

 

4.   保存和取得程序的設置

 

(1)在主窗口的構造函數中,readSettings( )

 

void MainWindow::readSettings()
{
   QSettings settings("Software Inc.", "Spreadsheet");   // 寫入與讀取的 settings 要一致

   restoreGeometry(settings.value("geometry").toByteArray());

   recentFiles = settings.value("recentFiles").toStringList();
   updateRecentFileActions();

   bool showGrid = settings.value("showGrid", true).toBool();
   showGridAction->setChecked(showGrid);

   bool autoRecalc = settings.value("autoRecalc", true).toBool();
   autoRecalcAction->setChecked(autoRecalc);
}

 

(2)在關閉主窗口時,writeSettings( )

 

void MainWindow::writeSettings()
{
   QSettings settings("Software Inc.", "Spreadsheet");

   settings.setValue("geometry", saveGeometry());
   settings.setValue("recentFiles", recentFiles);
   settings.setValue("showGrid", showGridAction->isChecked());
   settings.setValue("autoRecalc", autoRecalcAction->isChecked());
}

/* 這里選擇 4 個狀態進行保存


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM