Source: kglobalsettings.h


Annotated List
Files
Globals
Hierarchy
Index
/* This file is part of the KDE libraries
   Copyright (C) 2000 David Faure 

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.
*/
#ifndef _KGLOBALSETTINGS_H
#define _KGLOBALSETTINGS_H

#include 
#include 
#include 

#define KDE_DEFAULT_SINGLECLICK true
#define KDE_DEFAULT_INSERTTEAROFFHANDLES true
#define KDE_DEFAULT_AUTOSELECTDELAY -1
#define KDE_DEFAULT_CHANGECURSOR true
#define KDE_DEFAULT_LARGE_CURSOR false
#define KDE_DEFAULT_VISUAL_ACTIVATE true
#define KDE_DEFAULT_VISUAL_ACTIVATE_SPEED 50

/**
 * Access the KDE global configuration.
 *
 * @author David Faure 
 * @version $Id: kglobalsettings_h.html 132191 2002-01-17 21:32:13Z dfaure $
 */
class KGlobalSettings
{
  public:

    /**
     * Returns a treshold 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 (@p oldPos)
     * in the @ref QWidget::mousePressEvent().
     * When the position of the mouse (@p newPos)
     * in a  @ref QWidget::mouseMoveEvent() exceeds this treshold
     * you may start a drag
     * which should originate from @ref 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();
     *       }
     *    }
     * }
     * 
* */ static int dndEventDelay(); /** * Returns whether KDE runs in single (default) or double click * mode. * * @return @p true if single click mode, or @p false if double click mode. * * see @ref http://developer.kde.org/documentation/standards/kde/style/mouse/index.html **/ static bool singleClick(); /** * Returns whether tear-off handles are inserted in KPopupMenus. **/ static bool insertTearOffHandle(); /** * @return the KDE setting for "change cursor over icon" */ static bool changeCursorOverIcon(); /** * @return whether to show some feedback when an item (specifically an * icon) is activated. */ static bool visualActivate(); static unsigned int visualActivateSpeed(); /** * Returns the KDE setting for the auto-select option * * @return the auto-select delay or -1 if auto-select is disabled. */ static int autoSelectDelay(); /** * Returns the KDE setting for the shortcut key to open * context menus. * * @return the key that pops up context menus. */ static int contextMenuKey (); /** * Returns the KDE setting for context menus. * * @return whether context menus should be shown on button press * or button release (click). */ static bool showContextMenusOnPress (); /** * Retrieve the configured completion mode. * * see @ref http://developer.kde.org/documentation/standards/kde/style/keys/completion.html * * @details * 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. **/ enum Completion { CompletionNone=1, CompletionAuto, CompletionMan, CompletionShell, CompletionPopup }; /** * Returns the preferred completion mode setting. * * @return @see Completion. Default is @p CompletionPopup. */ static Completion completionMode(); /** * This returns whether or not KDE should use certain GNOME * resources. The resources, in this case, are things like pixmap * directories, applnk paths, etc. * * @return Whether or not KDE should use certain GNOME resources */ static bool honorGnome(); struct KMouseSettings { enum { RightHanded = 0, LeftHanded = 1 }; int handed; // left or right }; /** * This returns the current mouse settings. */ static KMouseSettings & mouseSettings(); /** * The path to the desktop directory of the current user. */ static QString desktopPath() { initStatic(); return *s_desktopPath; } /** * The path to the autostart directory of the current user. */ static QString autostartPath() { initStatic(); return *s_autostartPath; } /** * The path to the trash directory of the current user. */ static QString trashPath() { initStatic(); return *s_trashPath; } /** * The path where documents are stored of the current user. */ static QString documentPath() { initStatic(); return *s_documentPath; } /** * The default color to use when highlighting toolbar buttons */ static QColor toolBarHighlightColor(); static QColor inactiveTitleColor(); static QColor inactiveTextColor(); static QColor activeTitleColor(); static QColor activeTextColor(); static int contrast(); /** * The default colors to use for text and links. */ static QColor baseColor(); // Similair to QColorGroup::base() static QColor textColor(); // Similair to QColorGroup::text() static QColor linkColor(); static QColor visitedLinkColor(); static QColor highlightedTextColor(); // Similair to QColorGroup::hightlightedText() static QColor highlightColor(); // Similair to QColorGroup::highlight() /** * Returns the alternate background color used by @ref KListView with * @ref 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. */ static QColor alternateBackgroundColor(); static QFont generalFont(); static QFont fixedFont(); static QFont toolBarFont(); static QFont menuFont(); static QFont windowTitleFont(); static QFont taskbarFont(); private: /** * reads in all paths from kdeglobals */ static void initStatic(); /** * initialise kde2Blue */ static void initColors(); /** * drop cached values for fonts (called by KApplication) */ static void rereadFontSettings(); /** * drop cached values for paths (called by KApplication) */ static void rereadPathSettings(); /** * drop cached values for mouse settings (called by KApplication) */ static void rereadMouseSettings(); static QString* s_desktopPath; static QString* s_autostartPath; static QString* s_trashPath; static QString* s_documentPath; static QFont *_generalFont; static QFont *_fixedFont; static QFont *_toolBarFont; static QFont *_menuFont; static QFont *_windowTitleFont; static QFont *_taskbarFont; static QColor * kde2Gray; static QColor * kde2Blue; static QColor * kde2AlternateColor; static KMouseSettings *s_mouseSettings; friend class KApplication; }; #endif

Generated by: dfaure on kde.faure.org on Thu Jan 17 22:15:01 2002, using kdoc 2.0a53.