kdecore Library API Documentation

KGlobalSettings Class Reference

Access the KDE global configuration. More...

#include <kglobalsettings.h>

List of all members.

Public Types

enum  TearOffHandle { Disable = 0, ApplicationLevel, Enable }
enum  Completion {
  CompletionNone = 1, CompletionAuto, CompletionMan, CompletionShell,
  CompletionPopup, CompletionPopupAuto
}

Static Public Member Functions

int dndEventDelay ()
bool singleClick ()
TearOffHandle insertTearOffHandle ()
bool changeCursorOverIcon ()
bool visualActivate ()
unsigned int visualActivateSpeed ()
int autoSelectDelay ()
int contextMenuKey ()
bool showContextMenusOnPress ()
Completion completionMode ()
KMouseSettingsmouseSettings ()
QString desktopPath ()
QString autostartPath ()
QString trashPath ()
QString documentPath ()
QColor toolBarHighlightColor ()
QColor inactiveTitleColor ()
QColor inactiveTextColor ()
QColor activeTitleColor ()
QColor activeTextColor ()
int contrast ()
QColor baseColor ()
QColor textColor ()
QColor linkColor ()
QColor visitedLinkColor ()
QColor highlightedTextColor ()
QColor highlightColor ()
QColor alternateBackgroundColor ()
QColor calculateAlternateBackgroundColor (const QColor &base)
QFont generalFont ()
QFont fixedFont ()
QFont toolBarFont ()
QFont menuFont ()
QFont windowTitleFont ()
QFont taskbarFont ()
QFont largeFont (const QString &text=QString::null)
bool isMultiHead ()
bool wheelMouseZooms ()
QRect splashScreenDesktopGeometry ()
QRect desktopGeometry (const QPoint &point)
QRect desktopGeometry (QWidget *w)
bool showIconsOnPushButtons ()
bool showFilePreview (const KURL &)
bool opaqueResize ()
int buttonLayout ()


Detailed Description

Access the KDE global configuration.

Author:
David Faure <faure@kde.org>
Version:
Id
kglobalsettings.h,v 1.51 2004/05/17 20:23:45 waba Exp

Definition at line 45 of file kglobalsettings.h.


Member Enumeration Documentation

enum KGlobalSettings::TearOffHandle
 

This enum describes the return type for insertTearOffHandle() wether to insert a handle or not.

Applications who independently want to use handles in their popup menus should test for Application level before calling the appropriate function in KPopupMenu.

Since:
3,1
Enumeration values:
Disable  disable tear-off handles
ApplicationLevel  enable on application level
Enable  enable tear-off handles
Definition at line 108 of file kglobalsettings.h.

Referenced by insertTearOffHandle().

enum KGlobalSettings::Completion
 

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

See the styleguide.

Enumeration values:
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 169 of file kglobalsettings.h.

Referenced by completionMode().


Member Function Documentation

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;

    int delay = KGlobalSettings::dndEventDelay();
    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
Definition at line 69 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readNumEntry().

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.
Definition at line 76 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readBoolEntry().

KGlobalSettings::TearOffHandle KGlobalSettings::insertTearOffHandle  )  [static]
 

Returns whether tear-off handles are inserted in KPopupMenus.

Returns:
whether tear-off handles are inserted in KPopupMenus.
Since:
3.1
Definition at line 83 of file kglobalsettings.cpp.

References KGlobal::config(), Disable, KConfigBase::readBoolEntry(), KConfigBase::readNumEntry(), and TearOffHandle.

bool KGlobalSettings::changeCursorOverIcon  )  [static]
 

Checks whether the cursor changes over icons.

Returns:
the KDE setting for "change cursor over icon"
Definition at line 94 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readBoolEntry().

bool KGlobalSettings::visualActivate  )  [static]
 

Checks whether to show feedback when in item (specifically an icon) is activated.

Returns:
whether to show some feedback when an item is activated.
Definition at line 101 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readBoolEntry().

Referenced by KIconEffect::visualActivate().

unsigned int KGlobalSettings::visualActivateSpeed  )  [static]
 

Returns the speed of the visual activation feedback.

Returns:
the speed of the visual activation feedback, between 0 for minimum and 100 for maximum speed
Definition at line 108 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readNumEntry().

Referenced by KIconEffect::visualActivate().

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 121 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readNumEntry().

int KGlobalSettings::contextMenuKey  )  [static]
 

Returns the KDE setting for the shortcut key to open context menus.

Returns:
the key that pops up context menus.
Definition at line 150 of file kglobalsettings.cpp.

References KConfigGroupSaver::config(), KGlobal::config(), and KConfigBase::readEntry().

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 142 of file kglobalsettings.cpp.

References KConfigGroupSaver::config(), KGlobal::config(), and KConfigBase::readBoolEntry().

KGlobalSettings::Completion KGlobalSettings::completionMode  )  [static]
 

Returns the preferred completion mode setting.

Returns:
Completion. Default is CompletionPopup.
Definition at line 128 of file kglobalsettings.cpp.

References Completion, CompletionNone, CompletionPopup, CompletionPopupAuto, KGlobal::config(), and KConfigBase::readNumEntry().

Referenced by KCompletion::KCompletion(), and KCompletionBase::KCompletionBase().

KGlobalSettings::KMouseSettings & KGlobalSettings::mouseSettings  )  [static]
 

This returns the current mouse settings.

Returns:
the current mouse settings
Definition at line 542 of file kglobalsettings.cpp.

References KGlobal::config(), KGlobalSettings::KMouseSettings::handed, and KConfigBase::readEntry().

QString KGlobalSettings::desktopPath  )  [inline, static]
 

The path to the desktop directory of the current user.

Returns:
the user's desktop directory
Definition at line 223 of file kglobalsettings.h.

QString KGlobalSettings::autostartPath  )  [inline, static]
 

The path to the autostart directory of the current user.

Returns:
the path of the autostart directory
Definition at line 229 of file kglobalsettings.h.

QString KGlobalSettings::trashPath  )  [inline, static]
 

The path to the trash directory of the current user.

Returns:
the path of the trash directory
Definition at line 235 of file kglobalsettings.h.

QString KGlobalSettings::documentPath  )  [inline, static]
 

The path where documents are stored of the current user.

Returns:
the path of the document directory
Definition at line 241 of file kglobalsettings.h.

QColor KGlobalSettings::toolBarHighlightColor  )  [static]
 

The default color to use when highlighting toolbar buttons.

Returns:
the toolbar highlight color
Definition at line 159 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::inactiveTitleColor  )  [static]
 

The default color to use for inactive titles.

Returns:
the inactive title color
Definition at line 167 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::inactiveTextColor  )  [static]
 

The default color to use for inactive texts.

Returns:
the inactive text color
Definition at line 176 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::activeTitleColor  )  [static]
 

The default color to use for active titles.

Returns:
the active title color
Definition at line 183 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::activeTextColor  )  [static]
 

The default color to use for active texts.

Returns:
the active text color
Definition at line 191 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

int KGlobalSettings::contrast  )  [static]
 

Returns the contrast for borders.

Returns:
the contrast (between 0 for minimum and 10 for maximum contrast)
Definition at line 198 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readNumEntry().

QColor KGlobalSettings::baseColor  )  [static]
 

Returns the default base (background) color.

Returns:
the default base (background) color
See also:
QColorGroup::base()
Definition at line 208 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

Referenced by alternateBackgroundColor().

QColor KGlobalSettings::textColor  )  [static]
 

Returns the default text color.

Returns:
the default text color
See also:
QColorGroup::text()
Definition at line 218 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::linkColor  )  [static]
 

Returns the default link color.

Returns:
the default link color
Definition at line 272 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::visitedLinkColor  )  [static]
 

Returns the default color for visited links.

Returns:
the default color for visited links
Definition at line 280 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::highlightedTextColor  )  [static]
 

Returns the default color for highlighted text.

Returns:
the default color for highlighted text
See also:
QColorGroup::hightlightedText()
Definition at line 228 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::highlightColor  )  [static]
 

Returns the default color for text highlights.

Returns:
the default color for text highlights
See also:
QColorGroup::hightlight()
Definition at line 238 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::alternateBackgroundColor  )  [static]
 

Returns the alternate background color used by KListView with KListViewItem.

Any other list that uses alternating background colors should use this too, to obey to the user's preferences. Returns an invalid color if the user doesn't want alternating backgrounds.

Returns:
the alternate background color
See also:
calculateAlternateBackgroundColor
Definition at line 246 of file kglobalsettings.cpp.

References baseColor(), calculateAlternateBackgroundColor(), KGlobal::config(), and KConfigBase::readColorEntry().

QColor KGlobalSettings::calculateAlternateBackgroundColor const QColor base  )  [static]
 

Calculates a color based on base to be used as alternating color for e.g.

listviews.

Parameters:
base the base for the calculation
Returns:
the calculated color
See also:
alternateBackgroundColor
Definition at line 255 of file kglobalsettings.cpp.

Referenced by alternateBackgroundColor().

QFont KGlobalSettings::generalFont  )  [static]
 

Returns the default general font.

Returns:
the default general font.
Definition at line 287 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readFontEntry().

Referenced by largeFont().

QFont KGlobalSettings::fixedFont  )  [static]
 

Returns the default fixed font.

Returns:
the default fixed font.
Definition at line 304 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readFontEntry().

QFont KGlobalSettings::toolBarFont  )  [static]
 

Returns the default toolbar font.

Returns:
the default toolbar font.
Definition at line 321 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readFontEntry().

QFont KGlobalSettings::menuFont  )  [static]
 

Returns the default menu font.

Returns:
the default menu font.
Definition at line 338 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readFontEntry().

QFont KGlobalSettings::windowTitleFont  )  [static]
 

Returns the default window title font.

Returns:
the default window title font.
Definition at line 355 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readFontEntry().

QFont KGlobalSettings::taskbarFont  )  [static]
 

Returns the default taskbar font.

Returns:
the default taskbar font.
Definition at line 372 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readFontEntry().

QFont KGlobalSettings::largeFont const QString text = QString::null  )  [static]
 

Returns a font of approx.

48 pt. capable of showing text.

Parameters:
text the text to test
Returns:
the font that is capable to show the text with 48 pt
Since:
3.1
Definition at line 390 of file kglobalsettings.cpp.

References generalFont().

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

Returns:
true if the user chose multi head
Definition at line 595 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
Since:
3.1
Definition at line 604 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readBoolEntry().

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).
Since:
3.2
Definition at line 611 of file kglobalsettings.cpp.

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:
point a 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).
Since:
3.2
Definition at line 630 of file kglobalsettings.cpp.

QRect KGlobalSettings::desktopGeometry 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:
w the 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).
Since:
3.2
Definition at line 647 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.
Since:
3.2
Definition at line 666 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readBoolEntry().

bool KGlobalSettings::showFilePreview const KURL  )  [static]
 

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

Returns:
Returns true if user wants to show previews.
Since:
3.2
Definition at line 674 of file kglobalsettings.cpp.

References KURL::protocol(), KConfigBase::readBoolEntry(), and KProtocolInfo::showFilePreview().

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.
Since:
3.2
Definition at line 682 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readBoolEntry().

int KGlobalSettings::buttonLayout  )  [static]
 

The layout scheme to use for dialog buttons.

Returns:
Returns the number of the scheme to use.
See also:
KDialogBase::setButtonStyle
Since:
3.3
Definition at line 690 of file kglobalsettings.cpp.

References KGlobal::config(), and KConfigBase::readNumEntry().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdecore Library Version 3.3.0.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed Sep 29 09:43:14 2004 by doxygen 1.3.8 written by Dimitri van Heesch, © 1997-2003