diff options
Diffstat (limited to 'tdecore/kglobalsettings.h')
| -rw-r--r-- | tdecore/kglobalsettings.h | 584 |
1 files changed, 0 insertions, 584 deletions
diff --git a/tdecore/kglobalsettings.h b/tdecore/kglobalsettings.h deleted file mode 100644 index 0e11426d2..000000000 --- a/tdecore/kglobalsettings.h +++ /dev/null @@ -1,584 +0,0 @@ -/* 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 "tdelibs_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 TDECORE_EXPORT TDEGlobalSettings -{ - 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 = TDEGlobalSettings::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 TDEPopupMenu. - * @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 TDEPopupMenus. - * @return whether tear-off handles are inserted in TDEPopupMenus. - * @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 TDECompletion 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 TDEIO::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 TDEListView with - * TDEListViewItem. 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 TDEListView 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 TDEApplication) - */ - static void rereadFontSettings(); - /** - * drop cached values for paths (called by TDEApplication) - */ - static void rereadPathSettings(); - /** - * drop cached values for mouse settings (called by TDEApplication) - */ - 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 TDEApplication; -}; - -#endif |