You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
626 lines
19 KiB
626 lines
19 KiB
/* 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 path where documents are stored of the current user.
|
|
* @return the path of the videos directory
|
|
*/
|
|
static TQString videosPath() { initStatic(); return *s_videosPath; }
|
|
|
|
/**
|
|
* The path where documents are stored of the current user.
|
|
* @return the path of the music directory
|
|
*/
|
|
static TQString musicPath() { initStatic(); return *s_musicPath; }
|
|
|
|
/**
|
|
* The path where documents are stored of the current user.
|
|
* @return the path of the downloads directory
|
|
*/
|
|
static TQString downloadPath() { initStatic(); return *s_downloadPath; }
|
|
|
|
/**
|
|
* The path where documents are stored of the current user.
|
|
* @return the path of the pictures directory
|
|
*/
|
|
static TQString picturesPath() { initStatic(); return *s_picturesPath; }
|
|
|
|
/**
|
|
* The path where templates are stored of the current user.
|
|
* @return the path of the templates directory
|
|
*/
|
|
static TQString templatesPath() { initStatic(); return *s_templatesPath; }
|
|
|
|
/**
|
|
* The path of the public share of the current user.
|
|
* @return the path of the public share directory
|
|
*/
|
|
static TQString publicSharePath() { initStatic(); return *s_publicSharePath; }
|
|
|
|
/**
|
|
* 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 TQString* s_picturesPath;
|
|
static TQString* s_templatesPath;
|
|
static TQString* s_publicSharePath;
|
|
static TQString* s_downloadPath;
|
|
static TQString* s_musicPath;
|
|
static TQString* s_videosPath;
|
|
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
|