Vidalia Class Reference

#include <Vidalia.h>

List of all members.

Signals

void running ()

Public Member Functions

 Vidalia (QStringList args, int &argc, char **argv)
 ~Vidalia ()

Static Public Member Functions

static bool validateArguments (QString &errmsg)
static void showUsageMessageBox ()
static bool showUsage ()
static bool setLanguage (QString languageCode=QString())
static bool setStyle (QString styleKey=QString())
static QString language ()
static QString style ()
static QString version ()
static TorControltorControl ()
static QString dataDirectory ()
static QString defaultDataDirectory ()
static QString pidFile ()
static bool readPasswordFromStdin ()
static Log::LogMessage log (Log::LogLevel level, QString msg)
static int run ()
static void createShortcut (const QKeySequence &key, QWidget *sender, QObject *receiver, const char *slot)
static void createShortcut (const QString &key, QWidget *sender, QObject *receiver, const char *slot)
static bool retranslateUi (const QString &languageCode)

Static Protected Member Functions

static void removeAllTranslators ()

Private Slots

void onEventLoopStarted ()

Private Member Functions

void parseArguments (QStringList args)
bool argNeedsValue (QString argName)
void copyDefaultSettingsFile () const
void loadDefaultCaCertificates () const

Static Private Member Functions

static void qt_msg_handler (QtMsgType type, const char *msg)

Static Private Attributes

static QMap< QString, QString > _args
static QString _style
static QString _language
static TorControl_torControl = 0
static Log _log
static QList< QTranslator * > _translators

Detailed Description

Definition at line 46 of file Vidalia.h.


Constructor & Destructor Documentation

Vidalia::Vidalia ( QStringList  args,
int &  argc,
char **  argv 
)

Constructor.

Constructor. Parses the command-line arguments, resets Vidalia's configuration (if requested), and sets up the GUI style and language translation.

Definition at line 94 of file Vidalia.cpp.

References _args, _log, _torControl, ARG_GUISTYLE, ARG_LANGUAGE, ARG_LOGFILE, ARG_LOGLEVEL, ARG_RESET, copyDefaultSettingsFile(), dataDirectory(), loadDefaultCaCertificates(), Log::Off, Log::open(), parseArguments(), qt_msg_handler(), VSettings::reset(), setLanguage(), Log::setLogLevel(), setStyle(), VSettings::settingsFileExists(), Log::stringToLogLevel(), and vApp.

Vidalia::~Vidalia (  ) 

Destructor.

Destructor

Definition at line 150 of file Vidalia.cpp.

References _torControl.


Member Function Documentation

bool Vidalia::argNeedsValue ( QString  argName  )  [private]

Returns true if the specified arguments wants a value.

Returns true if the specified argument expects a value.

Definition at line 229 of file Vidalia.cpp.

References ARG_DATADIR, ARG_GUISTYLE, ARG_LANGUAGE, ARG_LOGFILE, ARG_LOGLEVEL, and ARG_PIDFILE.

Referenced by parseArguments().

void Vidalia::copyDefaultSettingsFile (  )  const [private]

Copies a default settings file (if one exists) to Vidalia's data directory.

Definition at line 475 of file Vidalia.cpp.

References VSettings::settingsFile().

Referenced by Vidalia().

void Vidalia::createShortcut ( const QString &  key,
QWidget *  sender,
QObject *  receiver,
const char *  slot 
) [static]

Creates and binds a shortcut such that when key is pressed in sender's context, receiver's slot will be called.

Definition at line 397 of file Vidalia.cpp.

References createShortcut().

void Vidalia::createShortcut ( const QKeySequence &  key,
QWidget *  sender,
QObject *  receiver,
const char *  slot 
) [static]

Creates and binds a shortcut such that when key is pressed in sender's context, receiver's slot will be called.

Definition at line 387 of file Vidalia.cpp.

Referenced by ConfigDialog::ConfigDialog(), MessageLog::createActions(), createShortcut(), HelpBrowser::HelpBrowser(), MainWindow::MainWindow(), and NetViewer::NetViewer().

QString Vidalia::dataDirectory (  )  [static]

Returns the location Vidalia uses for its data files.

Returns the directory Vidalia uses for its data files.

Definition at line 340 of file Vidalia.cpp.

References _args, ARG_DATADIR, and defaultDataDirectory().

Referenced by GeoIpCache::cacheFileName(), GeoIpCache::saveToDisk(), UpdateProcess::updateRepositoryDir(), and Vidalia().

QString Vidalia::defaultDataDirectory (  )  [static]

Returns the default location of Vidalia's data directory.

Definition at line 350 of file Vidalia.cpp.

References win32_app_data_folder().

Referenced by dataDirectory().

static QString Vidalia::language (  )  [inline, static]

Returns the current language.

Definition at line 69 of file Vidalia.h.

References _language.

Referenced by UpdatesAvailableDialog::loadPackagesTable(), and HelpTextBrowser::loadResource().

void Vidalia::loadDefaultCaCertificates (  )  const [private]

Clears the list of default CA certificates and adds only the ones Vidalia is interested in.

Definition at line 506 of file Vidalia.cpp.

References vWarn.

Referenced by Vidalia().

Log::LogMessage Vidalia::log ( Log::LogLevel  level,
QString  msg 
) [static]

Writes msg with severity level to Vidalia's log.

Definition at line 379 of file Vidalia.cpp.

References _log, and Log::log().

void Vidalia::onEventLoopStarted (  )  [private, slot]

Called when the application's main event loop has started. This method will emit the running() signal to indicate that the application's event loop is running.

Definition at line 168 of file Vidalia.cpp.

References running().

Referenced by run().

void Vidalia::parseArguments ( QStringList  args  )  [private]

Parse the list of command-line arguments.

Parses the list of command-line arguments for their argument names and values.

Definition at line 242 of file Vidalia.cpp.

References _args, argNeedsValue(), and i().

Referenced by Vidalia().

QString Vidalia::pidFile (  )  [static]

Returns the location of Vidalia's pid file.

Definition at line 363 of file Vidalia.cpp.

References _args, and ARG_PIDFILE.

Referenced by main().

void Vidalia::qt_msg_handler ( QtMsgType  type,
const char *  s 
) [static, private]

Catches debugging messages from Qt and sends them to Vidalia's logs.

Catches debugging messages from Qt and sends them to Vidalia's logs. If Qt emits a QtFatalMsg, we will write the message to the log and then abort().

Definition at line 68 of file Vidalia.cpp.

References vDebug, vError, vNotice, and vWarn.

Referenced by Vidalia().

bool Vidalia::readPasswordFromStdin (  )  [static]

Returns true if Vidalia should read the control password from stdin.

Definition at line 372 of file Vidalia.cpp.

References _args, and ARG_READ_PASSWORD_FROM_STDIN.

void Vidalia::removeAllTranslators (  )  [static, protected]

Removes all currently installed QTranslators.

Definition at line 404 of file Vidalia.cpp.

References _translators, and vInfo.

Referenced by retranslateUi().

bool Vidalia::retranslateUi ( const QString &  languageCode  )  [static]

Loads and installs all available translators for the specified languageCode. All currently installed QTranslator objects will be removed. Returns true if at least Vidalia's language file can be loaded for the given language. Otherwise, returns false and no change is made to the current translators.

Definition at line 415 of file Vidalia.cpp.

References _language, _translators, err(), LanguageSupport::isValidLanguageCode(), removeAllTranslators(), vApp, vNotice, and vWarn.

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

int Vidalia::run (  )  [static]

Enters the main event loop and waits until exit() is called. The signal running() will be emitted when the event loop has started.

Definition at line 158 of file Vidalia.cpp.

References onEventLoopStarted(), and vApp.

Referenced by main().

void Vidalia::running (  )  [signal]

Emitted when the application is running and the main event loop has started.

Referenced by onEventLoopStarted().

bool Vidalia::setLanguage ( QString  languageCode = QString()  )  [static]

Sets the current language.

Sets the translation Vidalia will use. If one was specified on the command-line, we will use that. Otherwise, we'll check to see if one was saved previously. If not, we'll default to one appropriate for the system locale.

Definition at line 303 of file Vidalia.cpp.

References _language, VidaliaSettings::getLanguageCode(), and retranslateUi().

Referenced by Vidalia().

bool Vidalia::setStyle ( QString  styleKey = QString()  )  [static]

Sets the current GUI style.

Sets the GUI style Vidalia will use. If one was specified on the command-line, we will use that. Otherwise, we'll check to see if one was saved previously. If not, we'll default to one appropriate for the operating system.

Definition at line 323 of file Vidalia.cpp.

References _style, and VidaliaSettings::getInterfaceStyle().

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

bool Vidalia::showUsage (  )  [static]

Returns true if the user wants to see usage information.

Definition at line 188 of file Vidalia.cpp.

References _args, and ARG_HELP.

Referenced by main().

void Vidalia::showUsageMessageBox (  )  [static]

Displays usage information for command-line args.

Definition at line 195 of file Vidalia.cpp.

References ARG_DATADIR, ARG_GUISTYLE, ARG_HELP, ARG_LANGUAGE, ARG_LOGFILE, ARG_LOGLEVEL, ARG_PIDFILE, ARG_RESET, VMessageBox::information(), LanguageSupport::languageCodes(), Log::logLevels(), VMessageBox::Ok, tcol(), and trow().

Referenced by main().

static QString Vidalia::style (  )  [inline, static]

Returns the current GUI style.

Definition at line 71 of file Vidalia.h.

References _style.

Referenced by AppearancePage::load().

static TorControl* Vidalia::torControl (  )  [inline, static]
bool Vidalia::validateArguments ( QString &  errmsg  )  [static]

Validates that all arguments were well-formed.

Verifies that all specified arguments were valid.

Definition at line 267 of file Vidalia.cpp.

References _args, _log, ARG_GUISTYLE, ARG_LANGUAGE, ARG_LOGFILE, ARG_LOGLEVEL, Log::errorString(), Log::isOpen(), LanguageSupport::isValidLanguageCode(), and Log::logLevels().

Referenced by main().

static QString Vidalia::version (  )  [inline, static]

Returns Vidalia's application version.

Definition at line 73 of file Vidalia.h.

References VIDALIA_VERSION.

Referenced by AboutDialog::AboutDialog(), and main().


Member Data Documentation

QMap< QString, QString > Vidalia::_args [static, private]

List of command-line arguments.

Definition at line 155 of file Vidalia.h.

Referenced by dataDirectory(), parseArguments(), pidFile(), readPasswordFromStdin(), showUsage(), validateArguments(), and Vidalia().

QString Vidalia::_language [static, private]

The current language.

Definition at line 157 of file Vidalia.h.

Referenced by language(), retranslateUi(), and setLanguage().

Log Vidalia::_log [static, private]

Logs debugging messages to file or stdout.

Definition at line 159 of file Vidalia.h.

Referenced by log(), validateArguments(), and Vidalia().

QString Vidalia::_style [static, private]

The current GUI style.

Definition at line 156 of file Vidalia.h.

Referenced by setStyle(), and style().

TorControl * Vidalia::_torControl = 0 [static, private]

Vidalia's main TorControl object.

Main TorControl object.

Definition at line 158 of file Vidalia.h.

Referenced by torControl(), Vidalia(), and ~Vidalia().

QList< QTranslator * > Vidalia::_translators [static, private]

List of installed translators.

Definition at line 160 of file Vidalia.h.

Referenced by removeAllTranslators(), and retranslateUi().


The documentation for this class was generated from the following files:
Generated on Mon Aug 30 22:58:57 2010 for Vidalia by  doxygen 1.6.3