diff options
Diffstat (limited to 'tdecore/kglobalsettings.h')
| -rw-r--r-- | tdecore/kglobalsettings.h | 584 |
1 files changed, 584 insertions, 0 deletions
diff --git a/tdecore/kglobalsettings.h b/tdecore/kglobalsettings.h new file mode 100644 index 000000000..07a6f2ccb --- /dev/null +++ b/tdecore/kglobalsettings.h @@ -0,0 +1,584 @@ +/* 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., 51 Franklin Street, Fifth Floor, + Boston, MA 02110-1301, USA. +*/ +#ifndef _KGLOBALSETTINGS_H +#define _KGLOBALSETTINGS_H + +#include <tqstring.h> +#include <tqcolor.h> +#include <tqfont.h> +#include "kdelibs_export.h" + +#define KDE_DEFAULT_SINGLECLICK false +#define KDE_DEFAULT_ICONTEXTROUNDED true +#define KDE_DEFAULT_INSERTTEAROFFHANDLES 0 +#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 +#define KDE_DEFAULT_WHEEL_ZOOM false +#define KDE_DEFAULT_ICON_ON_PUSHBUTTON true +#define KDE_DEFAULT_OPAQUE_RESIZE true +#define KDE_DEFAULT_BUTTON_LAYOUT 0 +#define KDE_DEFAULT_SHADE_SORT_COLUMN true +#define KDE_DEFAULT_KONQ_ACTIVATION_EFFECT true + +class KURL; + +/** + * Access the KDE global configuration. + * + * @author David Faure <faure@kde.org> + */ +class KDECORE_EXPORT KGlobalSettings +{ + public: + + /** + * 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 TQWidget::mousePressEvent(). + * When the position of the mouse (newPos) + * in a TQWidget::mouseMoveEvent() exceeds this threshold + * you may start a drag + * which should originate from oldPos. + * + * Example code: + * \code + * void KColorCells::mousePressEvent( TQMouseEvent *e ) + * { + * mOldPos = e->pos(); + * } + * + * void KColorCells::mouseMoveEvent( TQMouseEvent *e ) + * { + * if( !(e->state() && LeftButton)) return; + * + * int delay = KGlobalSettings::dndEventDelay(); + * TQPoint 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(); + * } + * } + * } + * \endcode + * @return the threshold for drag & drop in pixels + */ + + static int dndEventDelay(); + + /** + * Returns whether KDE runs in single (default) or double click + * mode. + * see http://developer.kde.org/documentation/standards/kde/style/mouse/index.html + * @return true if single click mode, or false if double click mode. + **/ + static bool singleClick(); + + /** + * Returns whether icon text is drawn in a rounded style + * @return true if rounded, or false if rectangular. + **/ + static bool iconUseRoundedRect(); + + /** + * This enum describes the return type for insertTearOffHandle() whether 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 + **/ + enum TearOffHandle { + Disable = 0, ///< disable tear-off handles + ApplicationLevel, ///< enable on application level + Enable ///< enable tear-off handles + }; + + /** + * Returns whether tear-off handles are inserted in KPopupMenus. + * @return whether tear-off handles are inserted in KPopupMenus. + * @since 3.1 + **/ + static TearOffHandle insertTearOffHandle(); + + /** + * Checks whether the cursor changes over icons. + * @return the KDE setting for "change cursor over icon" + */ + static bool changeCursorOverIcon(); + + /** + * Checks whether to show feedback when in item (specifically an + * icon) is activated. + * @return whether to show some feedback when an item is activated. + */ + static bool visualActivate(); + + /** + * Returns the speed of the visual activation feedback. + * @return the speed of the visual activation feedback, between + * 0 for minimum and 100 for maximum speed + */ + 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 (); + + /** + * This enum describes the completion mode used for by the KCompletion class. + * See <a href="http://developer.kde.org/documentation/standards/kde/style/keys/completion.html"> + * the styleguide</a>. + **/ + enum Completion { + /** + * No completion is used. + */ + CompletionNone=1, + /** + * Text is automatically filled in whenever possible. + */ + CompletionAuto, + /** + * Same as automatic except shortest match is used for completion. + */ + CompletionMan, + /** + * Complete text much in the same way as a typical *nix shell would. + */ + CompletionShell, + /** + * Lists all possible matches in a popup list-box to choose from. + */ + CompletionPopup, + /** + * Lists all possible matches in a popup list-box to choose from, and automatically + * fill the result whenever possible. + */ + CompletionPopupAuto + }; + + /** + * Returns the preferred completion mode setting. + * + * @return Completion. Default is @p CompletionPopup. + */ + static Completion completionMode(); + + /** + * Describes the mouse settings. + */ + struct KMouseSettings + { + enum { RightHanded = 0, LeftHanded = 1 }; + int handed; // left or right + }; + + /** + * This returns the current mouse settings. + * On Windows, settings are retrieved from the system. + * @return the current mouse settings + */ + static KMouseSettings & mouseSettings(); + + /** + * The path to the desktop directory of the current user. + * @return the user's desktop directory + */ + static TQString desktopPath() { initStatic(); return *s_desktopPath; } + + /** + * The path to the autostart directory of the current user. + * @return the path of the autostart directory + */ + static TQString autostartPath() { initStatic(); return *s_autostartPath; } + + /** + * DEPRECATED (starting from kde-3.4). + * This isn't where the trash contents is, anymore. + * Use KIO::trash() to trash files, "trash:/" to list the trash contents. + */ + static TQString trashPath() { initStatic(); return *s_trashPath; } + // KDE4: if you want to remove the above, move it to kdesktop/init.cc, which needs + // to know the old location of the trash + + /** + * The path where documents are stored of the current user. + * @return the path of the document directory + */ + static TQString documentPath() { initStatic(); return *s_documentPath; } + + + /** + * The default color to use when highlighting toolbar buttons. + * @return the toolbar highlight color + */ + static TQColor toolBarHighlightColor(); + + /** + * The default color to use for inactive titles. + * @return the inactive title color + */ + static TQColor inactiveTitleColor(); + + /** + * The default color to use for inactive texts. + * @return the inactive text color + */ + static TQColor inactiveTextColor(); + + /** + * The default color to use for active titles. + * @return the active title color + */ + static TQColor activeTitleColor(); + + /** + * The default color to use for active texts. + * @return the active text color + */ + static TQColor activeTextColor(); + + /** + * Returns the contrast for borders. + * @return the contrast (between 0 for minimum and 10 for maximum + * contrast) + */ + static int contrast(); + + /** + * Returns the button background color + * @return the button background color + * @since 3.4 + */ + static TQColor buttonBackground(); + + /** + * Returns the button text color + * @return the button text color + * @since 3.4 + */ + static TQColor buttonTextColor(); + + /** + * Returns the default base (background) color. + * @return the default base (background) color + * @see TQColorGroup::base() + */ + static TQColor baseColor(); + + /** + * Returns the default text color. + * @return the default text color + * @see TQColorGroup::text() + */ + static TQColor textColor(); + + /** + * Returns the default link color. + * @return the default link color + */ + static TQColor linkColor(); + + /** + * Returns the default color for visited links. + * @return the default color for visited links + */ + static TQColor visitedLinkColor(); + + /** + * Returns the default color for highlighted text. + * @return the default color for highlighted text + * @see TQColorGroup::hightlightedText() + */ + static TQColor highlightedTextColor(); + + /** + * Returns the default color for text highlights. + * @return the default color for text highlights + * @see TQColorGroup::hightlight() + */ + static TQColor highlightColor(); + + /** + * 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. + * @return the alternate background color + * @see calculateAlternateBackgroundColor + */ + static TQColor alternateBackgroundColor(); + + /** + * Calculates a color based on @p base to be used as alternating + * color for e.g. listviews. + * @param base the base for the calculation + * @return the calculated color + * @see alternateBackgroundColor + */ + static TQColor calculateAlternateBackgroundColor(const TQColor& base); + + /** + * Returns if the sorted column in a KListView shall be drawn with a + * shaded background color. + * @return true if the sorted column shall be shaded + * @since 3.4 + */ + static bool shadeSortColumn(); + + /** + * Returns the default general font. + * @return the default general font. + */ + static TQFont generalFont(); + + /** + * Returns the default fixed font. + * @return the default fixed font. + */ + static TQFont fixedFont(); + + /** + * Returns the default toolbar font. + * @return the default toolbar font. + */ + static TQFont toolBarFont(); + + /** + * Returns the default menu font. + * @return the default menu font. + */ + static TQFont menuFont(); + + /** + * Returns the default window title font. + * @return the default window title font. + */ + static TQFont windowTitleFont(); + + /** + * Returns the default taskbar font. + * @return the default taskbar font. + */ + static TQFont taskbarFont(); + + /** + * Returns a font of approx. 48 pt. capable of showing @p text. + * @param text the text to test + * @return the font that is capable to show the text with 48 pt + * @since 3.1 + */ + static TQFont largeFont(const TQString &text = TQString::null); + + /** + * 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. + * @return true if the user chose multi head + */ + static bool isMultiHead(); + + /** + * Typically, TQScrollView derived classes can be scrolled fast by + * holding down the Ctrl-button during wheel-scrolling. + * But TQTextEdit and derived classes perform zooming instead of fast + * scrolling. + * + * This value determines whether the user wants to zoom or scroll fast + * with Ctrl-wheelscroll. + * @return true if the user wishes to zoom with the mouse wheel, + * false for scrolling + * @since 3.1 + */ + static bool wheelMouseZooms(); + + /** + * 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). + * + * @return the geometry to use for the desktop. Note that it might not + * start at (0,0). + * @since 3.2 + */ + static TQRect splashScreenDesktopGeometry(); + + /** + * 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. + * + * @param point a reference point for the widget, for instance one that the + * widget should be adjacent or on top of. + * + * @return the geometry to use for the desktop. Note that it might not + * start at (0,0). + * @since 3.2 + */ + static TQRect desktopGeometry(const TQPoint& point); + + /** + * 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). + * + * @param w the widget in question. This is used to determine which screen + * to use in Xinerama or multi-head mode. + * + * @return the geometry to use for the desktop. Note that it might not + * start at (0,0). + * @since 3.2 + */ + static TQRect desktopGeometry(TQWidget* w); + + /** + * This function determines if the user wishes to see icons on the + * push buttons. + * + * @return Returns true if user wants to show icons. + * + * @since 3.2 + */ + static bool showIconsOnPushButtons(); + + /** + * This function determines if the user wishes to see previews + * for the selected url + * + * @return Returns true if user wants to show previews. + * + * @since 3.2 + */ + static bool showFilePreview(const KURL &); + + /** + * This function determines if the user wishes to see icon + * activation effects in Konqueror or KDesktop + * + * @return Returns true if user wants to show activation effects. + * + * @since 3.5.12 + */ + static bool showKonqIconActivationEffect(); + + /** + * Whether the user wishes to use opaque resizing. Primarily + * intended for TQSplitter::setOpaqueResize() + * + * @return Returns true if user wants to use opaque resizing. + * + * @since 3.2 + */ + static bool opaqueResize(); + + /** + * The layout scheme to use for dialog buttons + * + * @return Returns the number of the scheme to use. + * @see KDialogBase::setButtonStyle() + * @since 3.3 + */ + static int buttonLayout(); + +private: + /** + * reads in all paths from kdeglobals + */ + static void initStatic(); + /** + * initialize colors + */ + 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 TQString* s_desktopPath; + static TQString* s_autostartPath; + static TQString* s_trashPath; + static TQString* s_documentPath; + static TQFont *_generalFont; + static TQFont *_fixedFont; + static TQFont *_toolBarFont; + static TQFont *_menuFont; + static TQFont *_windowTitleFont; + static TQFont *_taskbarFont; + static TQFont *_largeFont; + static TQColor * _trinity4Blue; + static TQColor * _inactiveBackground; + static TQColor * _inactiveForeground; + static TQColor * _activeBackground; + static TQColor * _buttonBackground; + static TQColor * _selectBackground; + static TQColor * _linkColor; + static TQColor * _visitedLinkColor; + static TQColor * alternateColor; + static KMouseSettings *s_mouseSettings; + + friend class KApplication; +}; + +#endif |