#ifndef ads_globalsH #define ads_globalsH /******************************************************************************* ** Qt Advanced Docking System ** Copyright (C) 2017 Uwe Kindler ** ** This library is free software; you can redistribute it and/or ** modify it under the terms of the GNU Lesser General Public ** License as published by the Free Software Foundation; either ** version 2.1 of the License, or (at your option) any later version. ** ** 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 ** Lesser General Public License for more details. ** ** You should have received a copy of the GNU Lesser General Public ** License along with this library; If not, see . ******************************************************************************/ //============================================================================ /// \file ads_globals.h /// \author Uwe Kindler /// \date 24.02.2017 /// \brief Declaration of //============================================================================ //============================================================================ // INCLUDES //============================================================================ #include #include #include #include #include #include #include #include #if defined(Q_OS_UNIX) && !defined(Q_OS_MACOS) #include #endif QT_FORWARD_DECLARE_CLASS(QAbstractButton) #ifndef ADS_STATIC #ifdef ADS_SHARED_EXPORT #define ADS_EXPORT Q_DECL_EXPORT #else #define ADS_EXPORT Q_DECL_IMPORT #endif #else #define ADS_EXPORT #endif // Define ADS_DEBUG_PRINT to enable a lot of debug output #ifdef ADS_DEBUG_PRINT #define ADS_PRINT(s) qDebug() << s #else #define ADS_PRINT(s) #endif // Set ADS_DEBUG_LEVEL to enable additional debug output and to enable layout // dumps to qDebug and std::cout after layout changes #define ADS_DEBUG_LEVEL 0 QT_FORWARD_DECLARE_CLASS(QSplitter) namespace ads { Q_NAMESPACE class CDockSplitter; enum DockWidgetArea { NoDockWidgetArea = 0x00, LeftDockWidgetArea = 0x01, RightDockWidgetArea = 0x02, TopDockWidgetArea = 0x04, BottomDockWidgetArea = 0x08, CenterDockWidgetArea = 0x10, LeftAutoHideArea = 0x20, RightAutoHideArea = 0x40, TopAutoHideArea = 0x80, BottomAutoHideArea = 0x100, InvalidDockWidgetArea = NoDockWidgetArea, OuterDockAreas = TopDockWidgetArea | LeftDockWidgetArea | RightDockWidgetArea | BottomDockWidgetArea, AutoHideDockAreas = LeftAutoHideArea | RightAutoHideArea | TopAutoHideArea | BottomAutoHideArea, AllDockAreas = OuterDockAreas | CenterDockWidgetArea }; Q_DECLARE_FLAGS(DockWidgetAreas, DockWidgetArea) enum eTabIndex { TabDefaultInsertIndex = -1, TabInvalidIndex = -2 }; enum TitleBarButton { TitleBarButtonTabsMenu, TitleBarButtonUndock, TitleBarButtonClose, TitleBarButtonAutoHide, TitleBarButtonMinimize }; /** * The different dragging states */ enum eDragState { DraggingInactive, //!< DraggingInactive DraggingMousePressed, //!< DraggingMousePressed DraggingTab, //!< DraggingTab DraggingFloatingWidget//!< DraggingFloatingWidget }; /** * The different icons used in the UI */ enum eIcon { TabCloseIcon, //!< TabCloseIcon AutoHideIcon, //!< AutoHideIcon DockAreaMenuIcon, //!< DockAreaMenuIcon DockAreaUndockIcon,//!< DockAreaUndockIcon DockAreaCloseIcon, //!< DockAreaCloseIcon DockAreaMinimizeIcon, IconCount, //!< just a delimiter for range checks }; /** * For bitwise combination of dock wdget features */ enum eBitwiseOperator { BitwiseAnd, BitwiseOr }; /** * Each dock container supports 4 sidebars */ enum SideBarLocation { SideBarTop, SideBarLeft, SideBarRight, SideBarBottom, SideBarNone }; Q_ENUMS(SideBarLocation); namespace internal { static const bool RestoreTesting = true; static const bool Restore = false; static const char* const ClosedProperty = "close"; static const char* const DirtyProperty = "dirty"; extern const int FloatingWidgetDragStartEvent; extern const int DockedWidgetDragStartEvent; #if defined(Q_OS_UNIX) && !defined(Q_OS_MACOS) // Utils to directly communicate with the X server /** * Get atom from cache or request it from the XServer. */ xcb_atom_t xcb_get_atom(const char *name); /** * Add a property to a window. Only works on "hidden" windows. */ void xcb_add_prop(bool state, WId window, const char *type, const char *prop); /** * Updates up to two window properties. Can be set on a visible window. */ void xcb_update_prop(bool set, WId window, const char *type, const char *prop, const char *prop2 = nullptr); /** * Only for debugging purposes. */ bool xcb_dump_props(WId window, const char *type); /** * Gets the active window manager from the X11 Server. * Requires a EWMH conform window manager (Almost all common used ones are). * Returns "UNKNOWN" otherwise. */ QString windowManager(); #endif /** * Replace the from widget in the given splitter with the To widget */ void replaceSplitterWidget(QSplitter* Splitter, QWidget* From, QWidget* To); /** * This function walks the splitter tree upwards to hides all splitters * that do not have visible content */ void hideEmptyParentSplitters(CDockSplitter* FirstParentSplitter); /** * Convenience class for QPair to provide better naming than first and * second */ class CDockInsertParam : public QPair { public: using QPair::QPair; Qt::Orientation orientation() const {return this->first;} bool append() const {return this->second;} int insertOffset() const {return append() ? 1 : 0;} }; /** * Returns the insertion parameters for the given dock area */ CDockInsertParam dockAreaInsertParameters(DockWidgetArea Area); /** * Returns the SieBarLocation for the AutoHide dock widget areas */ SideBarLocation toSideBarLocation(DockWidgetArea Area); /** * Returns true for the top or bottom side bar ansd false for the * left and right side bar */ bool isHorizontalSideBarLocation(SideBarLocation Location); /** * Returns true, if the given dock area is a SideBar area */ bool isSideBarArea(DockWidgetArea Area); /** * Searches for the parent widget of the given type. * Returns the parent widget of the given widget or 0 if the widget is not * child of any widget of type T * * It is not safe to use this function in in CDockWidget because only * the current dock widget has a parent. All dock widgets that are not the * current dock widget in a dock area have no parent. */ template T findParent(const QWidget* w) { QWidget* parentWidget = w->parentWidget(); while (parentWidget) { T ParentImpl = qobject_cast(parentWidget); if (ParentImpl) { return ParentImpl; } parentWidget = parentWidget->parentWidget(); } return nullptr; } /** * Creates a semi transparent pixmap from the given pixmap Source. * The Opacity parameter defines the opacity from completely transparent (0.0) * to completely opaque (1.0) */ QPixmap createTransparentPixmap(const QPixmap& Source, qreal Opacity); /** * Helper function for settings flags in a QFlags instance. */ template void setFlag(T& Flags, typename T::enum_type flag, bool on = true) { #if QT_VERSION >= 0x050700 Flags.setFlag(flag, on); #else if(on) { Flags |= flag; } else { Flags &= ~flag; } #endif } /** * Helper function for settings tooltips without cluttering the code with * tests for preprocessor macros */ template void setToolTip(QObjectPtr obj, const QString &tip) { #ifndef QT_NO_TOOLTIP obj->setToolTip(tip); #else Q_UNUSED(obj); Q_UNUSED(tip); #endif } /** * Helper function for access to mouse event global position in Qt5 and */ inline QPoint globalPositionOf(QMouseEvent* ev) { #if (QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)) return ev->globalPosition().toPoint(); #else return ev->globalPos(); #endif } /** * Helper function to set the icon of a certain button. * Use this function to set the icons for the dock area and dock widget buttons. * The function first uses the CustomIconId to get an icon from the * CIconProvider. You can register your custom icons with the icon provider, if * you do not want to use the default buttons and if you do not want to use * stylesheets. * If the IconProvider does not return a valid icon (icon is null), the function * fetches the given standard pixmap from the QStyle. * param[in] Button The button whose icons are to be set * param[in] StandardPixmap The standard pixmap to be used for the button * param[in] CustomIconId The identifier for the custom icon. */ void setButtonIcon(QAbstractButton* Button, QStyle::StandardPixmap StandarPixmap, ads::eIcon CustomIconId); enum eRepolishChildOptions { RepolishIgnoreChildren, RepolishDirectChildren, RepolishChildrenRecursively }; /** * Calls unpolish() / polish for the style of the given widget to update * stylesheet if a property changes */ void repolishStyle(QWidget* w, eRepolishChildOptions Options = RepolishIgnoreChildren); /** * Returns the geometry of the given widget in global space */ QRect globalGeometry(QWidget* w); } // namespace internal } // namespace ads Q_DECLARE_OPERATORS_FOR_FLAGS(ads::DockWidgetAreas) //--------------------------------------------------------------------------- #endif // ads_globalsH