# Source: kglobalsettings.h |
Annotated List
Files
Globals
Hierarchy
Index

    /* This file is part of the KDE libraries
       Copyright (C) 2000 David Faure <faure@kde.org>

       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 <qstring.h>
    #include <qcolor.h>
    #include <qfont.h>

    #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 <faure@kde.org>
     * @version $Id: kglobalsettings.h,v 1.21 2000/12/01 23:53:41 waba Exp $
     */
    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:
         * <pre>
         * 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();
         *       }
         *    }
         * }
         * </pre>
         *
         */

        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
         *
         * @return CompletionNone:  Completion should be disabled
         *         CompletionAuto:  Automatic completion
         *         CompletionMan:   Like automatic completion except the user initiates
         *                          the completion using the completion key as in CompletionEOL
         *         CompletionShell: Attempts to mimic the completion feature found in
         *                          typical *nix shell enviornments.
         *         CompletionPopup: automatic completion, but the matches are not
         *                          put into the edit-widget, but into a popup box.
         **/

        enum Completion { CompletionNone=1, CompletionAuto, CompletionMan,
    		      CompletionShell, 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()

        static QFont generalFont();
        static QFont fixedFont();
        static QFont toolBarFont();
        static QFont menuFont();

    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 QColor * kde2Gray;
        static QColor * kde2Blue;
        static KMouseSettings *s_mouseSettings;

        friend class KApplication;
    };

    #endif

Generated by: root@i386.ports.openbsd.org on Wed Apr 25 13:58:13 2001, using kdoc 2.0a53.