summaryrefslogtreecommitdiffstats
path: root/tdecore/kglobalsettings.h
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-02-15 23:21:33 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-02-15 23:21:33 -0600
commit71abba5631126445560d6ab309a51c28745a0b74 (patch)
treecebdb0db1f78eccd9dae0742734ccaf6d167c028 /tdecore/kglobalsettings.h
parented99a30644c19b0a3cf0d2147243532df4daa16b (diff)
downloadtdelibs-71abba5631126445560d6ab309a51c28745a0b74.tar.gz
tdelibs-71abba5631126445560d6ab309a51c28745a0b74.zip
Fix prior commit
Diffstat (limited to 'tdecore/kglobalsettings.h')
-rw-r--r--tdecore/kglobalsettings.h584
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