dockutils.h

浏览该文件的文档.

 
#pragma once
 
#include "qxdock_global.h"
 
#include <QStyle>
#include <QAbstractButton>
#include <QMouseEvent>
 
#if QX_DOCK_X11
#include <xcb/xcb.h>
#endif
 
// #define QX_DOCK_DEBUG
// #define QX_DOCK_DEBUG_PRINT
 
// Define QX_DOCK_DEBUG_PRINT to enable a lot of debug output
#ifdef QX_DOCK_DEBUG_PRINT
#define QX_DOCK_PRINT(s) qDebug() << __FUNCTION__ << s
#else
#define QX_DOCK_PRINT(s)
#endif
 
class QSplitter;
 
QX_DOCK_BEGIN_NAMESPACE
 
class DockSplitter;
 
namespace internal
{
extern const int FloatingWidgetDragStartEvent;
extern const int DockedWidgetDragStartEvent;
static const char *const LocationProperty = "Location";
static const char *const DirtyProperty = "dirty";
static const char *const ClosedProperty = "close";
static const bool RestoreTesting = true;
static const bool Restore = false;
 
template <class T> 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
}
 
template <class QObjectPtr> void setToolTip(QObjectPtr obj, const QString &tip)
{
#ifndef QT_NO_TOOLTIP
    obj->setToolTip(tip);
#else
    Q_UNUSED(obj);
    Q_UNUSED(tip);
#endif
}
 
template <class T> T findParent(const QWidget *w)
{
    QWidget *pw = w->parentWidget();
    while (pw) {
        T parentImpl = qobject_cast<T>(pw);
        if (parentImpl) {
            return parentImpl;
        }
        pw = pw->parentWidget();
    }
    return nullptr;
}
 
inline QPoint globalPositionOf(QMouseEvent *e)
{
#if (QT_VERSION >= QT_VERSION_CHECK(6, 0, 0))
    return e->globalPosition().toPoint();
#else
    return e->globalPos();
#endif
}
 
QPixmap createTransparentPixmap(const QPixmap &source, qreal opacity);
 
void setButtonIcon(QAbstractButton *b, QStyle::StandardPixmap pixmap, Qx::DockIcon iconId);
 
void replaceSplitterWidget(QSplitter *splitter, QWidget *from, QWidget *to);
 
void hideEmptyParentSplitters(DockSplitter *firstParentSplitter);
 
class DockInsertParam : public QPair<Qt::Orientation, bool>
{
public:
    using QPair<Qt::Orientation, bool>::QPair;
    Qt::Orientation orientation() const
    {
        return this->first;
    }
    bool append() const
    {
        return this->second;
    }
    int insertOffset() const
    {
        return append() ? 1 : 0;
    }
};
 
DockInsertParam dockAreaInsertParameters(Qx::DockWidgetArea area);
 
Qx::DockSideBarArea toSideBarArea(Qx::DockWidgetArea area);
bool isHorizontalSideBarArea(Qx::DockSideBarArea area);
bool isSideBarArea(Qx::DockWidgetArea area);
 
enum RepolishChildOptions {
    RepolishIgnoreChildren,
    RepolishDirectChildren,
    RepolishChildrenRecursively
};
 
void repolishStyle(QWidget *w, RepolishChildOptions options = RepolishIgnoreChildren);
 
#if QX_DOCK_X11
// Utils to directly communicate with the X server
xcb_atom_t xcb_get_atom(const char *name);
 
void xcb_add_prop(bool state, WId window, const char *type, const char *prop);
void xcb_update_prop(bool set, WId window, const char *type, const char *prop, const char *prop2 = nullptr);
bool xcb_dump_props(WId window, const char *type);
QString windowManager();
#endif
 
#ifdef QX_DOCK_DEBUG
void setBackgroudColor(QWidget *w);
#define QXDOCK_SET_BGCOLOR(w) internal::setBackgroudColor(w)
#else
#define QXDOCK_SET_BGCOLOR(w)
#endif   // QX_DOCK_DEBUG
 
}   // internal
 
QX_DOCK_END_NAMESPACE