Vidalia 0.2.12
Public Member Functions

VidaliaSettings Class Reference

#include <VidaliaSettings.h>

Inheritance diagram for VidaliaSettings:
VSettings ServiceSettings

List of all members.

Public Member Functions

 VidaliaSettings ()
QString getLanguageCode ()
void setLanguageCode (QString languageCode)
QString getInterfaceStyle ()
void setInterfaceStyle (QString styleKey)
bool runTorAtStart ()
void setRunTorAtStart (bool run)
bool showMainWindowAtStart ()
void setShowMainWindowAtStart (bool show)
bool runVidaliaOnBoot ()
void setRunVidaliaOnBoot (bool run)
QString getBrowserExecutable () const
void setBrowserExecutable (const QString &browserExecutable)
QString getBrowserDirectory () const
void setBrowserDirectory (const QString &browserDirectory)
QString getIMExecutable () const
void setIMExecutable (const QString &IMExecutable)
bool runProxyAtStart ()
void setRunProxyAtStart (bool run)
QString getProxyExecutable () const
void setProxyExecutable (const QString &proxyExecutable)
QString getProxyExecutableArguments () const
void setProxyExecutableArguments (const QString &proxyExecutableArguments)
bool isAutoUpdateEnabled () const
void setAutoUpdateEnabled (bool enabled)
QDateTime lastCheckedForUpdates () const
void setLastCheckedForUpdates (const QDateTime &checkedAt)
bool useLocalGeoIpDatabase () const
void setUseLocalGeoIpDatabase (bool enabled)
QString localGeoIpDatabase () const
void setLocalGeoIpDatabase (const QString &databaseFile)

Detailed Description

Handles saving and restoring Vidalia's settings, such as the location of Tor, the control port, etc.

NOTE: Qt 4.1 documentation states that constructing a QSettings object is "very fast", so we shouldn't need to create a global instance of this class.

Definition at line 31 of file VidaliaSettings.h.


Constructor & Destructor Documentation

VidaliaSettings::VidaliaSettings ( )

Member Function Documentation

QString VidaliaSettings::getBrowserDirectory ( ) const

Returns a fully-qualified path to the web browser directory

Definition at line 200 of file VidaliaSettings.cpp.

References SETTING_BROWSER_DIRECTORY, and VSettings::value().

Referenced by MainWindow::aboutToQuit(), MainWindow::launchBrowserFromDirectory(), MainWindow::onSubprocessFinished(), and MainWindow::startSubprocesses().

QString VidaliaSettings::getBrowserExecutable ( ) const

If browserDirectory is empty, returns a fully-qualified path to the web browser, including the executable name. If browserDirectory is set, then returns the basename of the configured web browser

Definition at line 185 of file VidaliaSettings.cpp.

References SETTING_BROWSER_EXECUTABLE, and VSettings::value().

Referenced by MainWindow::aboutToQuit(), MainWindow::launchBrowserFromDirectory(), MainWindow::onCheckForBrowser(), MainWindow::onSubprocessFinished(), and MainWindow::startSubprocesses().

QString VidaliaSettings::getIMExecutable ( ) const

Returns a fully-qualified path to the IM client, including the executable name.

Definition at line 216 of file VidaliaSettings.cpp.

References SETTING_IM_EXECUTABLE, and VSettings::value().

Referenced by MainWindow::onSubprocessFinished(), and MainWindow::startSubprocesses().

QString VidaliaSettings::getInterfaceStyle ( )

Gets the interface style key (e.g., "windows", "motif", etc.)

Definition at line 103 of file VidaliaSettings.cpp.

References SETTING_STYLE, and VSettings::value().

Referenced by Vidalia::setStyle().

QString VidaliaSettings::getLanguageCode ( )

Gets the currently preferred language code for Vidalia.

Definition at line 89 of file VidaliaSettings.cpp.

References SETTING_LANGUAGE, and VSettings::value().

Referenced by AppearancePage::load(), AppearancePage::save(), and Vidalia::setLanguage().

QString VidaliaSettings::getProxyExecutable ( ) const

Returns a fully-qualified path to the proxy server, including the executable name.

Definition at line 247 of file VidaliaSettings.cpp.

References SETTING_PROXY_EXECUTABLE, and VSettings::value().

Referenced by GeneralPage::load(), and MainWindow::startProxy().

QString VidaliaSettings::getProxyExecutableArguments ( ) const

Returns a list containing additional command line arguments to be passed to ProxyExecutable

Returns a string containing additional command line arguments to be passed to ProxyExecutable

Definition at line 263 of file VidaliaSettings.cpp.

References SETTING_PROXY_EXECUTABLE_ARGUMENTS, and VSettings::value().

Referenced by GeneralPage::load(), and MainWindow::startProxy().

bool VidaliaSettings::isAutoUpdateEnabled ( ) const

Returns true if Vidalia should automatically check for software updates.

Definition at line 277 of file VidaliaSettings.cpp.

References SETTING_CHECK_FOR_UPDATES, and VSettings::value().

Referenced by MainWindow::circuitEstablished(), and MainWindow::running().

QDateTime VidaliaSettings::lastCheckedForUpdates ( ) const

Returns the time at which Vidalia last checked for software updates.

Definition at line 289 of file VidaliaSettings.cpp.

References SETTING_LAST_UPDATE_CHECK, and VSettings::value().

Referenced by MainWindow::circuitEstablished(), and MainWindow::running().

QString VidaliaSettings::localGeoIpDatabase ( ) const

Returns the file, if set, to be used as the local GeoIP database.

Definition at line 313 of file VidaliaSettings.cpp.

References SETTING_LOCAL_GEOIP_DATABASE, and VSettings::value().

Referenced by NetViewer::setupGeoIpResolver().

bool VidaliaSettings::runProxyAtStart ( )

Returns true if Vidalia should start a proxy application when it starts.

Definition at line 232 of file VidaliaSettings.cpp.

References SETTING_RUN_PROXY_AT_START, and VSettings::value().

Referenced by GeneralPage::load(), and MainWindow::running().

bool VidaliaSettings::runTorAtStart ( )

Returns true if Vidalia should start Tor when it starts.

Returns true if Tor is to be run when Vidalia starts.

Definition at line 117 of file VidaliaSettings.cpp.

References SETTING_RUN_TOR_AT_START, and VSettings::value().

Referenced by GeneralPage::load(), and MainWindow::running().

bool VidaliaSettings::runVidaliaOnBoot ( )

Returns true if Vidalia should start on system boot.

Returns true if Vidalia is set to run on system boot.

Definition at line 147 of file VidaliaSettings.cpp.

References win32_registry_get_key_value().

Referenced by GeneralPage::load().

void VidaliaSettings::setAutoUpdateEnabled ( bool  enabled)

Sets to enabled whether Vidalia should automatically check for software updates or not.

Definition at line 283 of file VidaliaSettings.cpp.

References SETTING_CHECK_FOR_UPDATES, and VSettings::setValue().

void VidaliaSettings::setBrowserDirectory ( const QString &  browserDirectory)

Sets the location and name of the web browser directory to the given string. If set to the empty string, the browser will not be started.

Definition at line 208 of file VidaliaSettings.cpp.

References SETTING_BROWSER_DIRECTORY, and VSettings::setValue().

void VidaliaSettings::setBrowserExecutable ( const QString &  browserExecutable)

Sets the location and name of the web browser executable to the given string. If set to the empty string, the browser will not be started.

Definition at line 193 of file VidaliaSettings.cpp.

References SETTING_BROWSER_EXECUTABLE, and VSettings::setValue().

void VidaliaSettings::setIMExecutable ( const QString &  IMExecutable)

Sets the location and name of the IM client executable to the given string. If set to the empty string, the client will not be started.

Definition at line 224 of file VidaliaSettings.cpp.

References SETTING_IM_EXECUTABLE, and VSettings::setValue().

void VidaliaSettings::setInterfaceStyle ( QString  styleKey)

Sets the interface style key.

Definition at line 110 of file VidaliaSettings.cpp.

References SETTING_STYLE, and VSettings::setValue().

Referenced by AppearancePage::save().

void VidaliaSettings::setLanguageCode ( QString  languageCode)

Saves the preferred language code.

Sets the preferred language code.

Definition at line 96 of file VidaliaSettings.cpp.

References SETTING_LANGUAGE, and VSettings::setValue().

Referenced by AppearancePage::save().

void VidaliaSettings::setLastCheckedForUpdates ( const QDateTime &  checkedAt)

Sets to checkedAt the time at which Vidalia last checked for available software updates.

Definition at line 295 of file VidaliaSettings.cpp.

References SETTING_LAST_UPDATE_CHECK, and VSettings::setValue().

void VidaliaSettings::setLocalGeoIpDatabase ( const QString &  databaseFile)

Sets the file to use as a local GeoIP database.

Definition at line 319 of file VidaliaSettings.cpp.

References SETTING_LOCAL_GEOIP_DATABASE, and VSettings::setValue().

void VidaliaSettings::setProxyExecutable ( const QString &  proxyExecutable)

Sets the location and name of the proxy server executable to the given string. If set to the empty string, the proxy will not be started.

Definition at line 255 of file VidaliaSettings.cpp.

References SETTING_PROXY_EXECUTABLE, and VSettings::setValue().

Referenced by GeneralPage::save().

void VidaliaSettings::setProxyExecutableArguments ( const QString &  proxyExecutableArguments)

Sets the additional arguments to be passed to Proxy Executable

Definition at line 270 of file VidaliaSettings.cpp.

References SETTING_PROXY_EXECUTABLE_ARGUMENTS, and VSettings::setValue().

Referenced by GeneralPage::save().

void VidaliaSettings::setRunProxyAtStart ( bool  run)

Set whether to run a proxy application when Vidalia starts.

Definition at line 239 of file VidaliaSettings.cpp.

References SETTING_RUN_PROXY_AT_START, and VSettings::setValue().

Referenced by GeneralPage::save().

void VidaliaSettings::setRunTorAtStart ( bool  run)

Set whether to run Tor when Vidalia starts.

If run is set to true, then Tor will be run when Vidalia starts.

Definition at line 124 of file VidaliaSettings.cpp.

References SETTING_RUN_TOR_AT_START, and VSettings::setValue().

Referenced by GeneralPage::save().

void VidaliaSettings::setRunVidaliaOnBoot ( bool  run)

Set whether to run Vidalia on system boot.

If run is set to true, then Vidalia will run on system boot.

Definition at line 163 of file VidaliaSettings.cpp.

References win32_registry_remove_key(), and win32_registry_set_key_value().

Referenced by GeneralPage::save().

void VidaliaSettings::setShowMainWindowAtStart ( bool  show)

Sets whether to show Vidalia's main window when the application starts.

Definition at line 139 of file VidaliaSettings.cpp.

References SETTING_SHOW_MAINWINDOW_AT_START, and VSettings::setValue().

Referenced by MainWindow::toggleShowOnStartup().

void VidaliaSettings::setUseLocalGeoIpDatabase ( bool  enabled)

Enables or disables use of a local GeoIP database.

Definition at line 307 of file VidaliaSettings.cpp.

References SETTING_USE_LOCAL_GEOIP_DATABASE, and VSettings::setValue().

bool VidaliaSettings::showMainWindowAtStart ( )

Returns true if Vidalia's main window should be visible when the application starts.

Definition at line 132 of file VidaliaSettings.cpp.

References SETTING_SHOW_MAINWINDOW_AT_START, and VSettings::value().

Referenced by MainWindow::MainWindow().

bool VidaliaSettings::useLocalGeoIpDatabase ( ) const

Returns true if Vidalia is currently configured to use a local GeoIP database.

Definition at line 301 of file VidaliaSettings.cpp.

References SETTING_USE_LOCAL_GEOIP_DATABASE, and VSettings::value().

Referenced by NetViewer::setupGeoIpResolver().


The documentation for this class was generated from the following files: