Gambas文档
编译和安装
错误消息
代码片段
翻译
废弃的组件
教程
开发环境文档
开发文档
名词解释
如何操作
说明
维基手册
维基搜索
维基许可协议
文档
应用程序仓库
语言概览
语言索引
主题
组件
gb
gb.args
gb.cairo
gb.chart
gb.clipper
gb.complex
gb.compress
gb.crypt
gb.data
gb.db
gb.db.form
gb.db.mysql
gb.db.odbc
gb.db.postgresql
gb.db.sqlite2
gb.db.sqlite3
gb.dbus
gb.dbus.trayicon
gb.debug
gb.desktop
gb.desktop.x11
gb.eval
gb.eval.highlight
gb.form
gb.form.dialog
gb.form.editor
gb.form.htmlview
gb.form.mdi
gb.form.print
gb.form.terminal
gb.gmp
gb.gsl
gb.gtk
gb.gtk3
gb.gtk3.opengl
gb.gtk3.webview
gb.gui
gb.gui.qt
gb.gui.qt.ext
gb.gui.trayicon
gb.gui.webview
gb.hash
gb.highlight
gb.image
gb.image.effect
gb.image.io
gb.inotify
gb.logging
gb.map
gb.media
gb.media.form
gb.mime
gb.mysql
gb.ncurses
gb.net
gb.net.curl
gb.net.pop3
gb.net.smtp
gb.opengl
gb.opengl.glsl
gb.opengl.glu
gb.opengl.sge
gb.openssl
gb.option
gb.pcre
gb.pdf
gb.poppler
gb.qt4
gb.qt4.ext
gb.qt4.opengl
gb.qt4.webkit
gb.qt4.webview
gb.qt5
gb.qt5.ext
gb.qt5.opengl
gb.qt5.webview
gb.qt6
gb.qt6.ext
gb.qt6.opengl
gb.qt6.webview
gb.report
gb.report2
gb.sdl
gb.sdl2
gb.sdl2.audio
gb.settings
Settings
Clear
Path
Read
Reload
Save
Write
gb.signal
gb.term
gb.test
gb.util
gb.util.web
gb.v4l
gb.vb
gb.web
gb.web.feed
gb.web.form
gb.web.gui
gb.xml
gb.xml.html
gb.xml.rpc
gb.xml.xslt
最近的修改

Settings (gb.settings)

该类管理公用配置文件。

在需要时,通过创建一个隐含的实例,该类可以像对象一样使用。

该类是可创建

该类的行为像一个可读/可写数组。

静态属性
DefaultDir  

静态方法
FromString   Return a value from its settings internal string representation
ToString   Convert a value into its settings internal string representation

属性
Count   Return the number of entries in the settings file
Keys  
Path   PUBLIC SUB ButtonSettings_Click() CATCH END

方法
Clear  
Exist   Return if the specified settings key has a value
Read  
Reload  
Save  
Write  

如果静态的使用该类,那么将使用缺省的工程配置文件。

缺省配置文件的路径是:

User.Home &/ ".config/gambas" &/ Application.Name & ".conf"

例如,开发环境的配置文件被存储于=~/.config/gambas/gambas2.conf=

该示例将在窗口被打开时从设置文件中加载一个窗口的位置。如果设置文件不存在,那么将使用窗体缺省位置。当窗口关闭时,示例也保存窗口位置于设置文件。使用应用程序的缺省设置文件。

Examples

PUBLIC SUB Form_Open()
  ' 从设置文件刷新窗口位置
  ' 如果设置文件没找到,使用缺省位置
  ME.Top = Settings["Window/Top", ME.Top]
  ME.Left = Settings["Window/Left", ME.Left]
  ME.Height = Settings["Window/Height", ME.Height]
  ME.Width = Settings["Window/Width", ME.Width]
END

PUBLIC SUB Form_Close()
  ' 关闭程序时保存窗口位置设置
  Settings["Window/Top"] = ME.Top
  Settings["Window/Left"] = ME.Left
  Settings["Window/Height"] = ME.Height
  Settings["Window/Width"] = ME.Width
END

被保存的设置文件看起来就像下面这样在Window组中有设置项。
[Window]
Top=13
Left=18
Height=154
Width=235

注意,可以直接使用Write方法来存储一个窗口的设置,并用Read方法来恢复它们。