KGlobalSettings

#include <kglobalsettings.h>

Inheritance diagram for KGlobalSettings:

Classes

struct  KMouseSettings
 

Public Types

enum  ActivateOption { ApplySettings = 0x1, ListenForChanges = 0x2 }
 
typedef QFlags< ActivateOptionActivateOptions
 
enum  ChangeType {
  PaletteChanged = 0, FontChanged, StyleChanged, SettingsChanged,
  IconChanged, CursorChanged, ToolbarStyleChanged, BlockShortcuts,
  NaturalSortingChanged
}
 
enum  Completion {
  CompletionNone = 1, CompletionAuto, CompletionMan, CompletionShell,
  CompletionPopup, CompletionPopupAuto
}
 
enum  GraphicEffect { NoEffects = 0x0000, GradientEffects = 0x0001, SimpleAnimationEffects = 0x0002, ComplexAnimationEffects = 0x0006 }
 
typedef QFlags< GraphicEffectGraphicEffects
 
enum  SettingsCategory {
  SETTINGS_MOUSE, SETTINGS_COMPLETION, SETTINGS_PATHS, SETTINGS_POPUPMENU,
  SETTINGS_QT, SETTINGS_SHORTCUTS, SETTINGS_LOCALE, SETTINGS_STYLE
}
 

Signals

void appearanceChanged ()
 
void blockShortcuts (int data)
 
void cursorChanged ()
 
QT_MOC_COMPAT void iconChanged (int group)
 
void kdisplayFontChanged ()
 
void kdisplayPaletteChanged ()
 
void kdisplayStyleChanged ()
 
void naturalSortingChanged ()
 
void settingsChanged (int category)
 
void toolbarAppearanceChanged (int)
 

Public Member Functions

void activate ()
 
void activate (ActivateOptions options)
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
bool blockSignals (bool block)
 
const QObjectListchildren () const const
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
 
void deleteLater ()
 
void destroyed (QObject *obj)
 
bool disconnect (const char *signal, const QObject *receiver, const char *method) const const
 
bool disconnect (const QObject *receiver, const char *method) const const
 
void dumpObjectInfo ()
 
void dumpObjectInfo () const const
 
void dumpObjectTree ()
 
void dumpObjectTree () const const
 
QList< QByteArraydynamicPropertyNames () const const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
findChild (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
 
bool inherits (const char *className) const const
 
void installEventFilter (QObject *filterObj)
 
bool isWidgetType () const const
 
bool isWindowType () const const
 
void killTimer (int id)
 
virtual const QMetaObjectmetaObject () const const
 
void moveToThread (QThread *targetThread)
 
QString objectName () const const
 
void objectNameChanged (const QString &objectName)
 
QObjectparent () const const
 
QVariant property (const char *name) const const
 
 Q_CLASSINFO (Name, Value)
 
 Q_DISABLE_COPY (Class)
 
 Q_DISABLE_COPY_MOVE (Class)
 
 Q_DISABLE_MOVE (Class)
 
 Q_EMIT Q_EMIT
 
 Q_ENUM (...)
 
 Q_ENUM_NS (...)
 
 Q_ENUMS (...)
 
 Q_FLAG (...)
 
 Q_FLAG_NS (...)
 
 Q_FLAGS (...)
 
 Q_GADGET Q_GADGET
 
 Q_INTERFACES (...)
 
 Q_INVOKABLE Q_INVOKABLE
 
 Q_NAMESPACE Q_NAMESPACE
 
 Q_NAMESPACE_EXPORT (EXPORT_MACRO)
 
 Q_OBJECT Q_OBJECT
 
 Q_PROPERTY (...)
 
 Q_REVISION Q_REVISION
 
 Q_SET_OBJECT_NAME (Object)
 
 Q_SIGNAL Q_SIGNAL
 
 Q_SIGNALS Q_SIGNALS
 
 Q_SLOT Q_SLOT
 
 Q_SLOTS Q_SLOTS
 
qFindChild (const QObject *obj, const QString &name)
 
QList< T > qFindChildren (const QObject *obj, const QRegExp &regExp)
 
QList< T > qFindChildren (const QObject *obj, const QString &name)
 
qobject_cast (QObject *object)
 
qobject_cast (const QObject *object)
 
 QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
 
void removeEventFilter (QObject *obj)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const const
 
int startTimer (int interval, Qt::TimerType timerType)
 
int startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)
 
QThreadthread () const const
 

Static Public Member Functions

static QColor activeTextColor ()
 
static QColor activeTitleColor ()
 
static bool allowDefaultBackgroundImages ()
 
static int autoSelectDelay ()
 
static int buttonLayout ()
 
static bool changeCursorOverIcon ()
 
static Completion completionMode ()
 
static int contrast ()
 
static qreal contrastF (const KSharedConfigPtr &config=KSharedConfigPtr())
 
static QPalette createApplicationPalette (const KSharedConfigPtr &config=KSharedConfigPtr())
 
static QPalette createNewApplicationPalette (const KSharedConfigPtr &config=KSharedConfigPtr())
 
static QRect desktopGeometry (const QPoint &point)
 
static QRect desktopGeometry (const QWidget *w)
 
static QString desktopPath ()
 
static int dndEventDelay ()
 
static QString documentPath ()
 
static QString downloadPath ()
 
static void emitChange (ChangeType changeType, int arg=0)
 
static QFont fixedFont ()
 
static QFont generalFont ()
 
static GraphicEffects graphicEffectsLevel ()
 
static GraphicEffects graphicEffectsLevelDefault ()
 
static QColor inactiveTextColor ()
 
static QColor inactiveTitleColor ()
 
static bool isMultiHead ()
 
static QFont largeFont (const QString &text=QString())
 
static QFont menuFont ()
 
static KMouseSettingsmouseSettings ()
 
static QString musicPath ()
 
static bool naturalSorting ()
 
static bool opaqueResize ()
 
static QString picturesPath ()
 
static KGlobalSettingsself ()
 
static bool shadeSortColumn ()
 
static bool showContextMenusOnPress ()
 
static bool showFilePreview (const QUrl &)
 
static bool showIconsOnPushButtons ()
 
static bool singleClick ()
 
static QFont smallestReadableFont ()
 
static QRect splashScreenDesktopGeometry ()
 
static QFont taskbarFont ()
 
static QFont toolBarFont ()
 
static QString videosPath ()
 
static bool wheelMouseZooms ()
 
static QFont windowTitleFont ()
 
- Static Public Member Functions inherited from QObject
QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
 
bool disconnect (const QMetaObject::Connection &connection)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 

Additional Inherited Members

- Properties inherited from QObject
 objectName
 
- Public Attributes inherited from QObject
typedef QObjectList
 
- Protected Member Functions inherited from QObject
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const QMetaMethod &signal)
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const QMetaMethod &signal)
 
bool isSignalConnected (const QMetaMethod &signal) const const
 
int receivers (const char *signal) const const
 
QObjectsender () const const
 
int senderSignalIndex () const const
 
virtual void timerEvent (QTimerEvent *event)
 

Detailed Description

Access the KDE global configuration.

Author
David Faure <faure[email protected]@kde[email protected].org>

Definition at line 51 of file kglobalsettings.h.

Member Enumeration Documentation

Specifies options passed to activate().

Since
4.6
Enumerator
ApplySettings 

Make all globally applicable settings take effect.

ListenForChanges 

Listen for changes to the settings.

Definition at line 573 of file kglobalsettings.h.

An identifier for change signals.

See also
emitChange

Definition at line 543 of file kglobalsettings.h.

This enum describes the completion mode used for by the KCompletion class.

See the styleguide.

Deprecated:
Use KCompletion
Enumerator
CompletionNone 

No completion is used.

CompletionAuto 

Text is automatically filled in whenever possible.

CompletionMan 

Same as automatic except shortest match is used for completion.

CompletionShell 

Complete text much in the same way as a typical *nix shell would.

CompletionPopup 

Lists all possible matches in a popup list-box to choose from.

CompletionPopupAuto 

Lists all possible matches in a popup list-box to choose from, and automatically fill the result whenever possible.

Definition at line 144 of file kglobalsettings.h.

Enumerator
NoEffects 

GUI with no effects at all.

GradientEffects 

GUI with only gradients enabled.

SimpleAnimationEffects 

GUI with simple animations enabled.

ComplexAnimationEffects 

GUI with complex animations enabled.

Note that ComplexAnimationsEffects implies SimpleAnimationEffects.

Definition at line 457 of file kglobalsettings.h.

Valid values for the settingsChanged signal.

Definition at line 599 of file kglobalsettings.h.

Member Function Documentation

void KGlobalSettings::activate ( )

Makes all globally applicable settings take effect and starts listening for changes to these settings.

This is usually called only by the KApplication constructor.

Since
4.3.3

Definition at line 154 of file kglobalsettings.cpp.

void KGlobalSettings::activate ( ActivateOptions  options)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Since
4.6

Definition at line 159 of file kglobalsettings.cpp.

QColor KGlobalSettings::activeTextColor ( )
static

The default color to use for active texts.

Returns
the active text color
Deprecated:
since 5.0, This used to export the color of the titlebar. If you wanted to query the color of the active window foreground, use KColorScheme(QPalette::Active, KColorScheme::Window).foreground(KColorScheme::ActiveText).color(), otherwise please read the setting from kdeglobals/WM/activeForeground directly

Definition at line 258 of file kglobalsettings.cpp.

QColor KGlobalSettings::activeTitleColor ( )
static

The default color to use for active titles.

Returns
the active title color
Deprecated:
since 5.0, This used to export the color of the titlebar. If you wanted to query the color of the active window background, use KColorScheme(QPalette::Active, KColorScheme::Window).background(KColorScheme::ActiveBackground).color(), otherwise please read the setting from kdeglobals/WM/activeBackground directly

Definition at line 247 of file kglobalsettings.cpp.

bool KGlobalSettings::allowDefaultBackgroundImages ( )
static

Returns if default background images are allowed by the color scheme.

A "default" background image is just that, i.e. the user has not actively selected a background image to use.

Returns
true if default background images may be used

Definition at line 284 of file kglobalsettings.cpp.

void KGlobalSettings::appearanceChanged ( )
signal

Emitted when the application has changed either its GUI style, its font or its palette in response to a kdisplay request.

Normally, widgets will update their styles automatically, but you should connect to this to program special behavior.

int KGlobalSettings::autoSelectDelay ( )
static

Returns the KDE setting for the auto-select option.

Returns
the auto-select delay or -1 if auto-select is disabled.

Definition at line 200 of file kglobalsettings.cpp.

void KGlobalSettings::blockShortcuts ( int  data)
signal

Emitted by BlockShortcuts.

int KGlobalSettings::buttonLayout ( )
static

The layout scheme to use for dialog buttons.

Returns
Returns the number of the scheme to use.

Definition at line 597 of file kglobalsettings.cpp.

bool KGlobalSettings::changeCursorOverIcon ( )
static

Checks whether the cursor changes over icons.

Returns
the KDE setting for "change cursor over icon"

Definition at line 194 of file kglobalsettings.cpp.

KGlobalSettings::Completion KGlobalSettings::completionMode ( )
static

Returns the preferred completion mode setting.

Returns
Completion. Default is CompletionPopup.

Definition at line 206 of file kglobalsettings.cpp.

int KGlobalSettings::contrast ( )
static

Returns the contrast for borders.

Returns
the contrast (between 0 for minimum and 10 for maximum contrast)
Deprecated:
since 5.0, use KColorScheme::contrast()

Definition at line 268 of file kglobalsettings.cpp.

qreal KGlobalSettings::contrastF ( const KSharedConfigPtr config = KSharedConfigPtr())
static

Returns the contrast for borders as a floating point value.

Parameters
configpointer to the config from which to read the contrast setting (the default is to use KSharedConfig::openConfig())
Returns
the contrast (between 0.0 for minimum and 1.0 for maximum contrast)
Deprecated:
since 5.0, use KColorScheme::contrastF(config)

Definition at line 273 of file kglobalsettings.cpp.

QPalette KGlobalSettings::createApplicationPalette ( const KSharedConfigPtr config = KSharedConfigPtr())
static

Used to obtain the QPalette that will be used to set the application palette.

This is only useful for configuration modules such as krdb and should not be used in normal circumstances.

Parameters
configKConfig from which to load the colors (passed as-is to KColorScheme).
Returns
the QPalette
Deprecated:
since 5.0, use KColorScheme::createApplicationPalette()

Definition at line 794 of file kglobalsettings.cpp.

QPalette KGlobalSettings::createNewApplicationPalette ( const KSharedConfigPtr config = KSharedConfigPtr())
static

Used to obtain the QPalette that will be used to set the application palette.

This is only useful for configuration modules such as krdb and should not be used in normal circumstances.

Parameters
configKConfig from which to load the colors (passed as-is to KColorScheme).
Note
The difference between this and the previous is that this never caches.
Since
4.6.3
Returns
the QPalette
Deprecated:
since 5.0, use KColorScheme::createApplicationPalette()

Definition at line 799 of file kglobalsettings.cpp.

void KGlobalSettings::cursorChanged ( )
signal

Emitted when the cursor theme has been changed.

QRect KGlobalSettings::desktopGeometry ( const QPoint point)
static

This function returns the desktop geometry for an application that needs to set the geometry of a widget on the screen manually.

It takes into account the user's display settings (number of screens, Xinerama, etc), and the user's preferences (if KDE should be Xinerama aware).

Note that this can break in multi-head (not Xinerama) mode because this point could be on multiple screens. Use with care.

Parameters
pointa reference point for the widget, for instance one that the widget should be adjacent or on top of.
Returns
the geometry to use for the desktop. Note that it might not start at (0,0).
Deprecated:
use QApplication::desktop()->screenGeometry(point)

Definition at line 535 of file kglobalsettings.cpp.

QRect KGlobalSettings::desktopGeometry ( const QWidget w)
static

This function returns the desktop geometry for an application that needs to set the geometry of a widget on the screen manually.

It takes into account the user's display settings (number of screens, Xinerama, etc), and the user's preferences (if KDE should be Xinerama aware).

Parameters
wthe widget in question. This is used to determine which screen to use in Xinerama or multi-head mode.
Returns
the geometry to use for the desktop. Note that it might not start at (0,0).
Deprecated:
use QApplication::desktop()->screenGeometry(w)

Definition at line 540 of file kglobalsettings.cpp.

QString KGlobalSettings::desktopPath ( )
static

The path to the desktop directory of the current user.

Returns
the user's desktop directory
Deprecated:
since 5.0, use QStandardPaths::writableLocation(QStandardPaths::DesktopLocation).

Definition at line 457 of file kglobalsettings.cpp.

int KGlobalSettings::dndEventDelay ( )
static

Returns a threshold in pixels for drag & drop operations.

As long as the mouse movement has not exceeded this number of pixels in either X or Y direction no drag operation may be started. This prevents spurious drags when the user intended to click on something but moved the mouse a bit while doing so.

For this to work you must save the position of the mouse (oldPos) in the QWidget::mousePressEvent(). When the position of the mouse (newPos) in a QWidget::mouseMoveEvent() exceeds this threshold you may start a drag which should originate from oldPos.

Example code:

void KColorCells::mousePressEvent( QMouseEvent *e )
{
mOldPos = e->pos();
}
void KColorCells::mouseMoveEvent( QMouseEvent *e )
{
if( !(e->state() && LeftButton)) return;
QPoint newPos = e->pos();
if(newPos.x() > mOldPos.x()+delay || newPos.x() < mOldPos.x()-delay ||
newPos.y() > mOldPos.y()+delay || newPos.y() < mOldPos.y()-delay)
{
// Drag color object
int cell = posToCell(mOldPos); // Find color at mOldPos
if ((cell != -1) && colors[cell].isValid())
{
KColorDrag *d = KColorDrag::makeDrag( colors[cell], this);
d->dragCopy();
}
}
}
Returns
the threshold for drag & drop in pixels
Deprecated:
since 5.0, use QApplication::startDragDistance() instead.

Definition at line 182 of file kglobalsettings.cpp.

QString KGlobalSettings::documentPath ( )
static

The path to the autostart directory of the current user.

Returns
the path of the autostart directory The path where documents are stored of the current user.
the path of the document directory
Deprecated:
since 5.0, use QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation).

Definition at line 481 of file kglobalsettings.cpp.

QString KGlobalSettings::downloadPath ( )
static

The path where download are stored of the current user.

Returns
the path of the download directory
Deprecated:
since 5.0, use QStandardPaths::writableLocation(QStandardPaths::DownloadLocation).

Definition at line 487 of file kglobalsettings.cpp.

void KGlobalSettings::emitChange ( ChangeType  changeType,
int  arg = 0 
)
static

Notifies all KDE applications on the current display of a change.

This is typically called by kcontrol modules after changing the corresponding config file. Do not call this from a normal KDE application.

Deprecated:
since 5.0 :

Definition at line 632 of file kglobalsettings.cpp.

QFont KGlobalSettings::fixedFont ( )
static

Returns the default fixed font.

Returns
the default fixed font.
Deprecated:
since 5.0, use QFontDatabase::systemFont(QFontDatabase::FixedFont)

Definition at line 304 of file kglobalsettings.cpp.

QFont KGlobalSettings::generalFont ( )
static

Returns the default general font.

Returns
the default general font.

Definition at line 300 of file kglobalsettings.cpp.

KGlobalSettings::GraphicEffects KGlobalSettings::graphicEffectsLevel ( )
static

This function determines the desired level of effects on the GUI.

Since
4.1

Definition at line 559 of file kglobalsettings.cpp.

KGlobalSettings::GraphicEffects KGlobalSettings::graphicEffectsLevelDefault ( )
static

This function determines the default level of effects on the GUI depending on the system capabilities.

Since
4.1

Definition at line 574 of file kglobalsettings.cpp.

QT_MOC_COMPAT void KGlobalSettings::iconChanged ( int  group)
signal

Emitted when the global icon settings have been changed.

Parameters
groupthe new group
Deprecated:
since 5.0, use KIconLoader::iconChanged(int)
QColor KGlobalSettings::inactiveTextColor ( )
static

The default color to use for inactive texts.

Returns
the inactive text color
Deprecated:
since 5.0, This used to export the color of the titlebar. If you wanted to query the color of the inactive window foreground, use KColorScheme(QPalette::Inactive, KColorScheme::Window).foreground().color() otherwise please read the setting from kdeglobals/WM/inactiveForeground directly

Definition at line 236 of file kglobalsettings.cpp.

QColor KGlobalSettings::inactiveTitleColor ( )
static

The default color to use for inactive titles.

Returns
the inactive title color
Deprecated:
since 5.0, This used to export the color of the titlebar. If you wanted to query the color of the inactive window background, use KColorScheme(QPalette::Inactive, KColorScheme::Window).background().color(), otherwise please read the setting from kdeglobals/WM/inactiveBackground directly

Definition at line 225 of file kglobalsettings.cpp.

bool KGlobalSettings::isMultiHead ( )
static

Returns if the user specified multihead.

In case the display has multiple screens, the return value of this function specifies if the user wants KDE to run on all of them or just on the primary On Windows, settings are retrieved from the system.

Returns
true if the user chose multi head

Definition at line 511 of file kglobalsettings.cpp.

void KGlobalSettings::kdisplayFontChanged ( )
signal

Emitted when the application has changed its font in response to a KControl request.

Normally widgets will update their fonts automatically, but you should connect to this to monitor global font changes, especially if you are using explicit fonts.

Note: If you derive from a QWidget-based class, a faster method is to reimplement QWidget::changeEvent() and catch QEvent::FontChange. This is the preferred way to get informed about font updates.

void KGlobalSettings::kdisplayPaletteChanged ( )
signal

Emitted when the application has changed its palette due to a KControl request.

Normally, widgets will update their palette automatically, but you should connect to this to program special behavior.

Note: If you derive from a QWidget-based class, a faster method is to reimplement QWidget::changeEvent() and catch QEvent::PaletteChange. This is the preferred way to get informed about palette updates.

void KGlobalSettings::kdisplayStyleChanged ( )
signal

Emitted when the application has changed its GUI style in response to a KControl request.

Normally, widgets will update their styles automatically (as they would respond to an explicit setGUIStyle() call), but you should connect to this to program special behavior.

Note: If you derive from a QWidget-based class, a faster method is to reimplement QWidget::changeEvent() and catch QEvent::StyleChange. This is the preferred way to get informed about style updates.

QFont KGlobalSettings::largeFont ( const QString text = QString())
static

Returns a font of approx.

48 pt. capable of showing text.

Parameters
textthe text to test
Returns
the font that is capable to show the text with 48 pt

Definition at line 391 of file kglobalsettings.cpp.

QFont KGlobalSettings::menuFont ( )
static

Returns the default menu font.

Returns
the default menu font.

Definition at line 320 of file kglobalsettings.cpp.

KGlobalSettings::KMouseSettings & KGlobalSettings::mouseSettings ( )
static

This returns the current mouse settings.

On Windows, settings are retrieved from the system.

Returns
the current mouse settings

Definition at line 452 of file kglobalsettings.cpp.

QString KGlobalSettings::musicPath ( )
static

The path where music are stored of the current user.

Returns
the path of the music directory
Deprecated:
since 5.0, use QStandardPaths::writableLocation(QStandardPaths::MusicLocation).

Definition at line 505 of file kglobalsettings.cpp.

bool KGlobalSettings::naturalSorting ( )
static

Returns true, if user visible strings should be sorted in a natural way: image 1.jpg image 2.jpg image 10.jpg image 11.jpg If false is returned, the strings are sorted by their unicode values: image 1.jpg image 10.jpg image 11.jpg image 2.jpg.

Since
4.4

Definition at line 552 of file kglobalsettings.cpp.

void KGlobalSettings::naturalSortingChanged ( )
signal

Emitted when the natural sorting has been changed.

Since
4.4
bool KGlobalSettings::opaqueResize ( )
static

Whether the user wishes to use opaque resizing.

Primarily intended for QSplitter::setOpaqueResize()

Returns
Returns true if user wants to use opaque resizing.

Definition at line 591 of file kglobalsettings.cpp.

QString KGlobalSettings::picturesPath ( )
static

The path where pictures are stored of the current user.

Returns
the path of the pictures directory
Deprecated:
since 5.0, use QStandardPaths::writableLocation(QStandardPaths::PicturesLocation).

Definition at line 499 of file kglobalsettings.cpp.

KGlobalSettings * KGlobalSettings::self ( )
static

Return the KGlobalSettings singleton.

This is used to connect to its signals, to be notified of changes.

Definition at line 138 of file kglobalsettings.cpp.

void KGlobalSettings::settingsChanged ( int  category)
signal

Emitted when the global settings have been changed.

KGlobalSettings takes care of calling reparseConfiguration on KSharedConfig::openConfig() so that applications/classes using this only have to re-read the configuration

Parameters
categorythe category among the SettingsCategory enum.
bool KGlobalSettings::shadeSortColumn ( )
static

Returns if the sorted column in a K3ListView shall be drawn with a shaded background color.

Returns
true if the sorted column shall be shaded

Definition at line 278 of file kglobalsettings.cpp.

bool KGlobalSettings::showContextMenusOnPress ( )
static

Returns the KDE setting for context menus.

Returns
whether context menus should be shown on button press or button release (click).

Definition at line 218 of file kglobalsettings.cpp.

bool KGlobalSettings::showFilePreview ( const QUrl url)
static

This function determines if the user wishes to see previews for the selected url.

Returns
Returns true if user wants to show previews.
Deprecated:
since 5.0, use KProtocolInfo::showFilePreview

Definition at line 583 of file kglobalsettings.cpp.

bool KGlobalSettings::showIconsOnPushButtons ( )
static

This function determines if the user wishes to see icons on the push buttons.

Returns
Returns true if user wants to show icons.
Deprecated:
since 5.0, use style->styleHint(QStyle::SH_DialogButtonBox_ButtonsHaveIcons, 0, widget);

Definition at line 545 of file kglobalsettings.cpp.

bool KGlobalSettings::singleClick ( )
static

Returns whether KDE runs in single (default) or double click mode.

see http://developer.kde.org/documentation/standards/kde/style/mouse/index.html

Returns
true if single click mode, or false if double click mode.
Deprecated:
since 5.0, use style->styleHint(QStyle::SH_ItemView_ActivateItemOnSingleClick, 0, widget)

Definition at line 188 of file kglobalsettings.cpp.

QFont KGlobalSettings::smallestReadableFont ( )
static

Returns the smallest readable font.

This can be used in dockers, rulers and other places where space is at a premium.

Definition at line 312 of file kglobalsettings.cpp.

QRect KGlobalSettings::splashScreenDesktopGeometry ( )
static

This function returns the desktop geometry for an application's splash screen.

It takes into account the user's display settings (number of screens, Xinerama, etc), and the user's preferences (if KDE should be Xinerama aware).

Returns
the geometry to use for the desktop. Note that it might not start at (0,0).
Deprecated:
use QApplication::desktop()->screenGeometry(QCursor::pos())

Definition at line 530 of file kglobalsettings.cpp.

QFont KGlobalSettings::taskbarFont ( )
static

Returns the default taskbar font.

Returns
the default taskbar font.

Definition at line 324 of file kglobalsettings.cpp.

void KGlobalSettings::toolbarAppearanceChanged ( int  )
signal

Emitted when the settings for toolbars have been changed.

KToolBar will know what to do.

QFont KGlobalSettings::toolBarFont ( )
static

Returns the default toolbar font.

Returns
the default toolbar font.

Definition at line 316 of file kglobalsettings.cpp.

QString KGlobalSettings::videosPath ( )
static

The path where videos are stored of the current user.

Returns
the path of the video directory
Deprecated:
since 5.0, use QStandardPaths::writableLocation(QStandardPaths::MoviesLocation).

Definition at line 493 of file kglobalsettings.cpp.

bool KGlobalSettings::wheelMouseZooms ( )
static

Typically, QScrollView derived classes can be scrolled fast by holding down the Ctrl-button during wheel-scrolling.

But QTextEdit and derived classes perform zooming instead of fast scrolling.

This value determines whether the user wants to zoom or scroll fast with Ctrl-wheelscroll.

Returns
true if the user wishes to zoom with the mouse wheel, false for scrolling

Definition at line 524 of file kglobalsettings.cpp.

QFont KGlobalSettings::windowTitleFont ( )
static

Returns the default window title font.

Returns
the default window title font.

Definition at line 308 of file kglobalsettings.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Mon Nov 30 2020 22:59:27 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.