Vidalia 0.2.15
Public Types | Public Member Functions
VidaliaSettings Class Reference

#include <VidaliaSettings.h>

Inheritance diagram for VidaliaSettings:
VSettings ServiceSettings

List of all members.

Public Types

enum  IconPosition { Tray, Dock, Both }

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)
IconPosition getIconPref ()
void setIconPref (const IconPosition iconPref)
QString toString (const IconPosition iconPref)
IconPosition fromString (QString iconPref)

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.


Member Enumeration Documentation

Enumerator:
Tray 
Dock 
Both 

Definition at line 36 of file VidaliaSettings.h.


Constructor & Destructor Documentation

VidaliaSettings::VidaliaSettings ( )

Member Function Documentation

VidaliaSettings::IconPosition VidaliaSettings::fromString ( QString  iconPref)

Definition at line 351 of file VidaliaSettings.cpp.

References Both, Dock, and Tray.

Referenced by getIconPref().

QString VidaliaSettings::getBrowserDirectory ( ) const

Returns a fully-qualified path to the web browser directory

Definition at line 202 of file VidaliaSettings.cpp.

References SETTING_BROWSER_DIRECTORY, toString(), 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 187 of file VidaliaSettings.cpp.

References SETTING_BROWSER_EXECUTABLE, toString(), and VSettings::value().

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

VidaliaSettings::IconPosition VidaliaSettings::getIconPref ( )

Get the icon preference

Definition at line 328 of file VidaliaSettings.cpp.

References fromString(), SETTING_ICON_PREF, toString(), and VSettings::value().

Referenced by AppearancePage::load(), MainWindow::MainWindow(), and MainWindow::setTrayIcon().

QString VidaliaSettings::getIMExecutable ( ) const

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

Definition at line 218 of file VidaliaSettings.cpp.

References SETTING_IM_EXECUTABLE, toString(), 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 105 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 91 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 249 of file VidaliaSettings.cpp.

References SETTING_PROXY_EXECUTABLE, toString(), 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 265 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 279 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 291 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 315 of file VidaliaSettings.cpp.

References SETTING_LOCAL_GEOIP_DATABASE, toString(), 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 234 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 119 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 149 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 285 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 210 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 195 of file VidaliaSettings.cpp.

References SETTING_BROWSER_EXECUTABLE, and VSettings::setValue().

void VidaliaSettings::setIconPref ( const IconPosition  iconPref)

Set the icon preference

Definition at line 335 of file VidaliaSettings.cpp.

References SETTING_ICON_PREF, VSettings::setValue(), and toString().

Referenced by AppearancePage::save().

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 226 of file VidaliaSettings.cpp.

References SETTING_IM_EXECUTABLE, and VSettings::setValue().

void VidaliaSettings::setInterfaceStyle ( QString  styleKey)

Sets the interface style key.

Definition at line 112 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 98 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 297 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 321 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 257 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 272 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 241 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 126 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 165 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 141 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 309 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 134 of file VidaliaSettings.cpp.

References SETTING_SHOW_MAINWINDOW_AT_START, and VSettings::value().

Referenced by MainWindow::MainWindow().

QString VidaliaSettings::toString ( const IconPosition  iconPref)
bool VidaliaSettings::useLocalGeoIpDatabase ( ) const

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

Definition at line 303 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: