libyui-qt  2.44.0
 All Classes Functions Variables
YQApplication Class Reference
Inheritance diagram for YQApplication:
Collaboration diagram for YQApplication:

Public Member Functions

virtual void setLanguage (const std::string &language, const std::string &encoding=std::string())
 
void loadPredefinedQtTranslations ()
 
void setLayoutDirection (const std::string &language)
 
void setLangFonts (const std::string &language, const std::string &encoding=std::string())
 
const QFont & currentFont ()
 
const QFont & boldFont ()
 
const QFont & headingFont ()
 
void deleteFonts ()
 
void pickAutoFonts ()
 
bool autoFonts () const
 
void setAutoFonts (bool useAutoFonts)
 
virtual std::string glyph (const std::string &glyphSymbolName)
 
virtual std::string askForExistingDirectory (const std::string &startDir, const std::string &headline)
 
virtual std::string askForExistingFile (const std::string &startWith, const std::string &filter, const std::string &headline)
 
virtual std::string askForSaveFileName (const std::string &startWith, const std::string &filter, const std::string &headline)
 
virtual bool openContextMenu (const YItemCollection &itemCollection)
 
void maybeLeftHandedUser ()
 
virtual int deviceUnits (YUIDimension dim, float layoutUnits)
 
virtual float layoutUnits (YUIDimension dim, int deviceUnits)
 
virtual void busyCursor ()
 
virtual void normalCursor ()
 
virtual void makeScreenShot (const std::string &fileName)
 
virtual void beep ()
 
virtual QPoint contextMenuPos ()
 
virtual void setContextMenuPos (QPoint contextMenuPos)
 
virtual int displayWidth ()
 
virtual int displayHeight ()
 
virtual int displayDepth ()
 
virtual long displayColors ()
 
virtual int defaultWidth ()
 
virtual int defaultHeight ()
 
virtual bool isTextMode ()
 
virtual bool hasImageSupport ()
 
virtual bool hasIconSupport ()
 
virtual bool hasAnimationSupport ()
 
virtual bool hasFullUtf8Support ()
 
virtual bool richTextSupportsTable ()
 
virtual bool hasWizardDialogSupport ()
 
virtual bool leftHandedMouse ()
 
virtual void setApplicationTitle (const std::string &title)
 
virtual void setApplicationIcon (const std::string &icon)
 

Static Public Member Functions

static QString askForSaveFileName (const QString &startWith, const QString &filter, const QString &headline)
 
static
YQPackageSelectorPluginStub
packageSelectorPlugin ()
 
static YQGraphPluginStubgraphPlugin ()
 

Protected Member Functions

 YQApplication ()
 
virtual ~YQApplication ()
 
QString fontKey (const QString &lang)
 

Protected Attributes

QFont * _currentFont
 
QFont * _headingFont
 
QFont * _boldFont
 
QString _fontFamily
 
QSettings * _langFonts
 
QTranslator * _qtTranslations
 
bool _autoFonts
 
int _autoNormalFontSize
 
int _autoHeadingFontSize
 
bool _leftHandedMouse
 
bool _askedForLeftHandedMouse
 
QPoint _contextMenuPos
 
QMenu * _contextMenu
 

Friends

class YQUI
 

Detailed Description

Definition at line 43 of file YQApplication.h.

Constructor & Destructor Documentation

YQApplication::YQApplication ( )
protected

Constructor.

Use YUI::app() to get the singleton for this class.

Definition at line 56 of file YQApplication.cc.

Here is the call graph for this function:

YQApplication::~YQApplication ( )
protectedvirtual

Destructor.

Definition at line 82 of file YQApplication.cc.

Here is the call graph for this function:

Member Function Documentation

string YQApplication::askForExistingDirectory ( const std::string &  startDir,
const std::string &  headline 
)
virtual

Open a directory selection box and prompt the user for an existing directory.

'startDir' is the initial directory that is displayed.

'headline' is an explanatory text for the directory selection box. Graphical UIs may omit that if no window manager is running.

Returns the selected directory name or an empty std::string if the user canceled the operation.

Implemented from YApplication.

Definition at line 483 of file YQApplication.cc.

Here is the call graph for this function:

string YQApplication::askForExistingFile ( const std::string &  startWith,
const std::string &  filter,
const std::string &  headline 
)
virtual

Open a file selection box and prompt the user for an existing file.

'startWith' is the initial directory or file.

'filter' is one or more blank-separated file patterns, e.g. "*.png *.jpg"

'headline' is an explanatory text for the file selection box. Graphical UIs may omit that if no window manager is running.

Returns the selected file name or an empty std::string if the user canceled the operation.

Implemented from YApplication.

Definition at line 500 of file YQApplication.cc.

Here is the call graph for this function:

string YQApplication::askForSaveFileName ( const std::string &  startWith,
const std::string &  filter,
const std::string &  headline 
)
virtual

Open a file selection box and prompt the user for a file to save data to. Automatically asks for confirmation if the user selects an existing file.

'startWith' is the initial directory or file.

'filter' is one or more blank-separated file patterns, e.g. "*.png *.jpg"

'headline' is an explanatory text for the file selection box. Graphical UIs may omit that if no window manager is running.

Returns the selected file name or an empty std::string if the user canceled the operation.

Implemented from YApplication.

Definition at line 526 of file YQApplication.cc.

Here is the call graph for this function:

QString YQApplication::askForSaveFileName ( const QString &  startWith,
const QString &  filter,
const QString &  headline 
)
static

Lower-level version that works with QStrings and does not change the mouse cursor.

Definition at line 552 of file YQApplication.cc.

bool YQApplication::autoFonts ( ) const
inline

Returns 'true' if the UI automatically picks fonts, disregarding Qt standard settings.

This makes sense during system installation system where the display DPI cannot reliably be retrieved and thus Qt uses random font sizes based on that random DPI.

Definition at line 138 of file YQApplication.h.

void YQApplication::beep ( )
virtual

Beep.

Reimplemented from YApplication.

Definition at line 699 of file YQApplication.cc.

const QFont & YQApplication::boldFont ( )

Returns the application's default bold font.

Definition at line 341 of file YQApplication.cc.

Here is the call graph for this function:

void YQApplication::busyCursor ( )
virtual

Change the (mouse) cursor to indicate busy status.

Reimplemented from YApplication.

Definition at line 705 of file YQApplication.cc.

Here is the call graph for this function:

virtual QPoint YQApplication::contextMenuPos ( )
inlinevirtual

Return position of the context menu (in gloabl coordinates)

Definition at line 302 of file YQApplication.h.

const QFont & YQApplication::currentFont ( )

Returns the application's default font.

Brute force approach to make sure we'll really get a complete Unicode font: Explicitly load the one font that we made sure to contain all required characters, including Latin1, Latin2, Japanese, Korean, and the characters used for glyphs.

There are many fonts that claim to be Unicode, but most of them contain just a sorry excuse for a complete Unicode character set. Qt can't know how complete a font is, so it chooses one that might be better in otherf aspects, but lacks necessary characters.

Definition at line 299 of file YQApplication.cc.

Here is the call graph for this function:

void YQApplication::deleteFonts ( )

Delete the fonts so they will be reloaded upon their next usage.

Definition at line 385 of file YQApplication.cc.

int YQApplication::deviceUnits ( YUIDimension  dim,
float  layoutUnits 
)
virtual

Convert logical layout spacing units into device dependent units. A default size dialog is assumed to be 80x25 layout spacing units.

Reimplemented from YApplication.

Definition at line 679 of file YQApplication.cc.

QString YQApplication::fontKey ( const QString &  lang)
protected

Constructs a key for the language specific font file: "font[lang]" for font[de_DE] = "Sans Serif" font[zh] = "ChineseSpecial, something" font[ja_JP] = "JapaneseSpecial, something" font = "Sans Serif"

Definition at line 289 of file YQApplication.cc.

string YQApplication::glyph ( const std::string &  glyphSymbolName)
virtual

Return a std::string for a named glyph.

Using this is discouraged in new applications.

Reimplemented from YApplication.

Definition at line 462 of file YQApplication.cc.

YQGraphPluginStub * YQApplication::graphPlugin ( )
static

Return the package selector plugin singleton or creates it (including loading the plugin lib) if it does not exist yet.

Definition at line 743 of file YQApplication.cc.

const QFont & YQApplication::headingFont ( )

Returns the application's heading font.

Brute force load the heading font - see currentFont() above for more.

Definition at line 354 of file YQApplication.cc.

Here is the call graph for this function:

float YQApplication::layoutUnits ( YUIDimension  dim,
int  deviceUnits 
)
virtual

Convert device dependent units into logical layout spacing units. A default size dialog is assumed to be 80x25 layout spacing units.

Reimplemented from YApplication.

Definition at line 688 of file YQApplication.cc.

void YQApplication::loadPredefinedQtTranslations ( )

Load translations for Qt's predefined dialogs like file selection box etc.

Definition at line 115 of file YQApplication.cc.

void YQApplication::makeScreenShot ( const std::string &  fileName)
virtual

Make a screen shot and save it to the specified file.

Reimplemented from YApplication.

Definition at line 717 of file YQApplication.cc.

Here is the call graph for this function:

void YQApplication::maybeLeftHandedUser ( )

A mouse click with the wrong mouse button was detected - e.g., a right click on a push button. The user might be left-handed, but his mouse might not (yet) be configured for left-handed use - e.g., during installation. Ask him if he would like his mouse temporarily configured as a left-handed mouse.

This status can be queried with YQApplication::leftHandedMouse().

Definition at line 629 of file YQApplication.cc.

void YQApplication::normalCursor ( )
virtual

Change the (mouse) cursor back from busy status to normal.

Reimplemented from YApplication.

Definition at line 711 of file YQApplication.cc.

Here is the call graph for this function:

bool YQApplication::openContextMenu ( const YItemCollection &  itemCollection)
virtual

Open a context menu for a widget

'itemCollection' describes the menu structure

Returns true on success (otherwise false).

Implemented from YApplication.

Definition at line 542 of file YQApplication.cc.

YQPackageSelectorPluginStub * YQApplication::packageSelectorPlugin ( )
static

Return the package selector plugin singleton or creates it (including loading the plugin lib) if it does not exist yet.

Definition at line 724 of file YQApplication.cc.

void YQApplication::pickAutoFonts ( )

Determine good fonts based on defaultsize geometry and set _auto_normal_font_size and _auto_heading_font_size accordingly. Caches the values, so it's safe to call this repeatedly.

Definition at line 405 of file YQApplication.cc.

void YQApplication::setApplicationIcon ( const std::string &  icon)
virtual

Set the application Icon

Reimplemented from YApplication.

Definition at line 772 of file YQApplication.cc.

void YQApplication::setApplicationTitle ( const std::string &  title)
virtual

Set the application title

Reimplemented from YApplication.

Definition at line 764 of file YQApplication.cc.

Here is the call graph for this function:

void YQApplication::setAutoFonts ( bool  useAutoFonts)

Set whether or not fonts should automatically be picked.

Definition at line 398 of file YQApplication.cc.

void YQApplication::setContextMenuPos ( QPoint  contextMenuPos)
virtual

Sets the position of the context menu (in gloabl coordinates)

Definition at line 759 of file YQApplication.cc.

Here is the call graph for this function:

void YQApplication::setLangFonts ( const std::string &  language,
const std::string &  encoding = std::string() 
)

Set fonts according to the specified language and encoding.

This is most important for some Asian languages that have overlaps in the Unicode table, like Japanese vs. Chinese.

Definition at line 206 of file YQApplication.cc.

Here is the call graph for this function:

void YQApplication::setLanguage ( const std::string &  language,
const std::string &  encoding = std::string() 
)
virtual

Set language and encoding for the locale environment ($LANG).

Load UI-internal translations (e.g. for predefined dialogs like file selection) and fonts.

'language' is the ISO short code ("de_DE", "en_US", ...).

'encoding' an (optional) encoding ("utf8", ...) that will be appended if present.

Reimplemented from YApplication.

Definition at line 93 of file YQApplication.cc.

Here is the call graph for this function:

void YQApplication::setLayoutDirection ( const std::string &  language)

Set the layout direction (left-to-right or right-to-left) from 'language'.

Definition at line 168 of file YQApplication.cc.

Member Data Documentation

QString YQApplication::_fontFamily
protected

Font family or list of font families to use ("Sans Serif" etc.)

Definition at line 375 of file YQApplication.h.

QSettings* YQApplication::_langFonts
protected

Language-specific font settings

Definition at line 380 of file YQApplication.h.

QTranslator* YQApplication::_qtTranslations
protected

Translator for the predefined Qt dialogs

Definition at line 385 of file YQApplication.h.


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