Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | List of all members
QWindowPrivate Class Reference

#include <qwindow_p.h>

+ Inheritance diagram for QWindowPrivate:
+ Collaboration diagram for QWindowPrivate:

Public Types

enum  PositionPolicy { WindowFrameInclusive , WindowFrameExclusive }
 
enum  SiblingPosition { PositionTop , PositionBottom }
 
enum class  FocusTarget {
  First , Last , Current , Next ,
  Prev
}
 
- Public Types inherited from QObjectPrivate
typedef void(* StaticMetaCallFunction) (QObject *, QMetaObject::Call, int, void **)
 
using ConnectionDataPointer = QExplicitlySharedDataPointer<ConnectionData>
 

Public Member Functions

 QWindowPrivate (decltype(QObjectPrivateVersion) version=QObjectPrivateVersion)
 
 ~QWindowPrivate () override
 
void init (QWindow *parent, QScreen *targetScreen=nullptr)
 
void setCursor (const QCursor *c=nullptr)
 
bool applyCursor ()
 
QPoint globalPosition () const
 
QWindow * topLevelWindow (QWindow::AncestorMode mode=QWindow::IncludeTransients) const
 
virtual QWindow * eventReceiver ()
 
virtual QPalette windowPalette () const
 
virtual void setVisible (bool visible)
 
void updateVisibility ()
 
void _q_clearAlert ()
 
void updateSiblingPosition (SiblingPosition)
 
bool windowRecreationRequired (QScreen *newScreen) const
 
void create (bool recursive)
 
void destroy ()
 
void setTopLevelScreen (QScreen *newScreen, bool recreate)
 
void connectToScreen (QScreen *topLevelScreen)
 
void disconnectFromScreen ()
 
void emitScreenChangedRecursion (QScreen *newScreen)
 
QScreen * screenForGeometry (const QRect &rect) const
 
void setTransientParent (QWindow *parent)
 
virtual void clearFocusObject ()
 
virtual void setFocusToTarget (FocusTarget, Qt::FocusReason)
 
virtual QRectF closestAcceptableGeometry (const QRectF &rect) const
 
void setMinOrMaxSize (QSize *oldSizeMember, const QSize &size, qxp::function_ref< void()> funcWidthChanged, qxp::function_ref< void()> funcHeightChanged)
 
virtual bool participatesInLastWindowClosed () const
 
virtual bool treatAsVisible () const
 
virtual void maybeSynthesizeContextMenuEvent (QMouseEvent *event)
 
const QWindow * forwardToPopup (QEvent *event, const QWindow *activePopupOnPress)
 
bool isPopup () const
 
void setAutomaticPositionAndResizeEnabled (bool a)
 
bool updateDevicePixelRatio ()
 
- Public Member Functions inherited from QObjectPrivate
void ensureExtraData ()
 
void setObjectNameWithoutBindings (const QString &name)
 
 QObjectPrivate (decltype(QObjectPrivateVersion) version=QObjectPrivateVersion)
 
virtual ~QObjectPrivate ()
 
void deleteChildren ()
 
void clearBindingStorage ()
 
void setParent_helper (QObject *)
 
void moveToThread_helper ()
 
void setThreadData_helper (QThreadData *currentData, QThreadData *targetData, QBindingStatus *status)
 
QObjectList receiverList (const char *signal) const
 
void ensureConnectionData ()
 
void addConnection (int signal, Connection *c)
 
int signalIndex (const char *signalName, const QMetaObject **meta=nullptr) const
 
bool isSignalConnected (uint signalIdx, bool checkDeclarative=true) const
 
bool maybeSignalConnected (uint signalIndex) const
 
bool isDeclarativeSignalConnected (uint signalIdx) const
 
void connectNotify (const QMetaMethod &signal)
 
void disconnectNotify (const QMetaMethod &signal)
 
void reinitBindingStorageAfterThreadMove ()
 
virtual std::string flagsForDumping () const
 
virtual void writeToDebugStream (QDebug &) const
 
QtPrivate::QPropertyAdaptorSlotObject * getPropertyAdaptorSlotObject (const QMetaProperty &property)
 
- Public Member Functions inherited from QObjectData
 QObjectData ()=default
 
virtual ~QObjectData ()=0
 
const QMetaObject * dynamicMetaObject () const
 

Static Public Member Functions

static QWindowPrivate * get (QWindow *window)
 
static Qt::WindowState effectiveState (Qt::WindowStates)
 
- Static Public Member Functions inherited from QObjectPrivate
static bool removeConnection (Connection *c)
 
static QObjectPrivate * get (QObject *o)
 
static const QObjectPrivate * get (const QObject *o)
 
template<typename Func1, typename Func2>
static QMetaObject::Connection connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiverPrivate, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1, typename Func2>
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiverPrivate, Func2 slot)
 
static QMetaObject::Connection connectImpl (const QObject *sender, int signal_index, const QObject *receiver, void **slot, QtPrivate::QSlotObjectBase *slotObj, int type, const int *types, const QMetaObject *senderMetaObject)
 
static QMetaObject::Connection connect (const QObject *sender, int signal_index, QtPrivate::QSlotObjectBase *slotObj, Qt::ConnectionType type)
 
static QMetaObject::Connection connect (const QObject *sender, int signal_index, const QObject *receiver, QtPrivate::QSlotObjectBase *slotObj, Qt::ConnectionType type)
 
static bool disconnect (const QObject *sender, int signal_index, void **slot)
 
static bool disconnect (const QObject *sender, int signal_index, const QObject *receiver, void **slot)
 

Public Attributes

QWindow::SurfaceType surfaceType = QWindow::RasterSurface
 
Qt::WindowFlags windowFlags = Qt::Window
 
QWindow * parentWindow = nullptr
 
QPlatformWindow * platformWindow = nullptr
 
bool visible = false
 
bool visibilityOnDestroy = false
 
bool exposed = false
 
bool inClose = false
 
QSurfaceFormat requestedFormat
 
QString windowTitle
 
QString windowFilePath
 
QIcon windowIcon
 
QRect geometry
 
qreal devicePixelRatio = 1.0
 
Qt::WindowStates windowState = Qt::WindowNoState
 
QWindow::Visibility visibility = QWindow::Hidden
 
bool resizeEventPending = true
 
bool receivedExpose = false
 
PositionPolicy positionPolicy = WindowFrameExclusive
 
bool positionAutomatic = true
 
bool resizeAutomatic = true
 
Qt::ScreenOrientation contentOrientation = Qt::PrimaryOrientation
 
qreal opacity = 1
 
QRegion mask
 
QSize minimumSize = {0, 0}
 
QSize maximumSize = {QWINDOWSIZE_MAX, QWINDOWSIZE_MAX}
 
QSize baseSize
 
QSize sizeIncrement
 
Qt::WindowModality modality = Qt::NonModal
 
bool blockedByModalWindow = false
 
bool updateRequestPending = false
 
bool transientParentPropertySet = false
 
QPointer< QWindow > transientParent
 
QPointer< QScreen > topLevelScreen
 
QCursor cursor = {Qt::ArrowCursor}
 
bool hasCursor = false
 
QElapsedTimer lastComposeTime
 
- Public Attributes inherited from QObjectPrivate
ExtraData * extraData
 
QAtomicPointer< QThreadData > threadData
 
QAtomicPointer< ConnectionData > connections
 
union { 
 
   QObject *   currentChildBeingDeleted 
 
   QAbstractDeclarativeData *   declarativeData 
 
};  
 
QAtomicPointer< QtSharedPointer::ExternalRefCountData > sharedRefcount
 
- Public Attributes inherited from QObjectData
QObject * q_ptr
 
QObject * parent
 
QObjectList children
 
uint isWidget: 1
 
uint blockSig: 1
 
uint wasDeleted: 1
 
uint isDeletingChildren: 1
 
uint sendChildEvents: 1
 
uint receiveChildEvents: 1
 
uint isWindow: 1
 
uint deleteLaterCalled: 1
 
uint isQuickItem: 1
 
uint willBeWidget: 1
 
uint wasWidget: 1
 
uint receiveParentEvents: 1
 
uint unused: 20
 
QAtomicInt postedEvents
 
QDynamicMetaObjectData * metaObject
 
QBindingStorage bindingStorage
 

Detailed Description

Definition at line 33 of file qwindow_p.h.

Member Enumeration Documentation

◆ FocusTarget

enum class QWindowPrivate::FocusTarget
strong
Enumerator
First 
Last 
Current 
Next 
Prev 

Definition at line 80 of file qwindow_p.h.

◆ PositionPolicy

enum QWindowPrivate::PositionPolicy
Enumerator
WindowFrameInclusive 
WindowFrameExclusive 

Definition at line 38 of file qwindow_p.h.

◆ SiblingPosition

enum QWindowPrivate::SiblingPosition
Enumerator
PositionTop 
PositionBottom 

Definition at line 65 of file qwindow_p.h.

Constructor & Destructor Documentation

◆ QWindowPrivate()

QWindowPrivate::QWindowPrivate ( decltype(QObjectPrivateVersion) version = QObjectPrivateVersion)

Definition at line 208 of file qwindow.cpp.

◆ ~QWindowPrivate()

QWindowPrivate::~QWindowPrivate ( )
overridedefault

Member Function Documentation

◆ _q_clearAlert()

void QWindowPrivate::_q_clearAlert ( )

Definition at line 3178 of file qwindow.cpp.

◆ applyCursor()

bool QWindowPrivate::applyCursor ( )

Definition at line 3255 of file qwindow.cpp.

◆ clearFocusObject()

void QWindowPrivate::clearFocusObject ( )
virtual

Reimplemented in QQuickWindowPrivate, QWidgetWindowPrivate, and QWidgetWindowPrivate.

Definition at line 610 of file qwindow.cpp.

◆ closestAcceptableGeometry()

QRectF QWindowPrivate::closestAcceptableGeometry ( const QRectF & rect) const
virtual

Reimplemented in QWidgetWindowPrivate, and QWidgetWindowPrivate.

Definition at line 617 of file qwindow.cpp.

◆ connectToScreen()

void QWindowPrivate::connectToScreen ( QScreen * topLevelScreen)

Definition at line 500 of file qwindow.cpp.

◆ create()

void QWindowPrivate::create ( bool recursive)

Definition at line 539 of file qwindow.cpp.

◆ destroy()

void QWindowPrivate::destroy ( )

Definition at line 2116 of file qwindow.cpp.

◆ disconnectFromScreen()

void QWindowPrivate::disconnectFromScreen ( )

Definition at line 494 of file qwindow.cpp.

◆ effectiveState()

Qt::WindowState QWindowPrivate::effectiveState ( Qt::WindowStates state)
static

Definition at line 1440 of file qwindow.cpp.

◆ emitScreenChangedRecursion()

void QWindowPrivate::emitScreenChangedRecursion ( QScreen * newScreen)

Definition at line 506 of file qwindow.cpp.

◆ eventReceiver()

virtual QWindow * QWindowPrivate::eventReceiver ( )
inlinevirtual

Reimplemented in QWidgetWindowPrivate, and QWidgetWindowPrivate.

Definition at line 58 of file qwindow_p.h.

◆ forwardToPopup()

const QWindow * QWindowPrivate::forwardToPopup ( QEvent * event,
const QWindow * activePopupOnPress )

Returns the popup window that has consumed event, if any. activePopupOnPress is the window that we have observed previously handling the press.

Definition at line 2470 of file qwindow.cpp.

◆ get()

static QWindowPrivate * QWindowPrivate::get ( QWindow * window)
inlinestatic

Definition at line 108 of file qwindow_p.h.

◆ globalPosition()

QPoint QWindowPrivate::globalPosition ( ) const

Definition at line 3075 of file qwindow.cpp.

◆ init()

void QWindowPrivate::init ( QWindow * parent,
QScreen * targetScreen = nullptr )

Definition at line 215 of file qwindow.cpp.

◆ isPopup()

bool QWindowPrivate::isPopup ( ) const
inline

Definition at line 102 of file qwindow_p.h.

◆ maybeSynthesizeContextMenuEvent()

void QWindowPrivate::maybeSynthesizeContextMenuEvent ( QMouseEvent * event)
virtual

Synthesize and send a QContextMenuEvent if the given event is a suitable mouse event (a right-button press or release, depending on QStyleHints::contextMenuTrigger()). On most platforms, it's done on mouse press; on Windows, it's done on release, because of the potential to support right-button clicks and drags to select or lasso items, and then still getting a context menu at the end of that gesture. (That is in conflict with supporting the press-drag-release gesture to select menu items on the context menus themselves. Context menus can be implemented that way by handling the separate press, move and release events.)

Any time the event was already handled in some way, it should be accepted, but mere acceptance of the mouse event cannot be taken to indicate that it's not necessary to synthesize a QContextMenuEvent here, because the Windows use case requires doing one thing (selecting items) with the mouse events, and then doing something completely different with the QContextMenuEvent. In other words, QContextMenuEvent is very different from other kinds of optional followup events synthesized from unhandled events (like the way we synthesize a QMouseEvent only if a QTabletEvent was not handled). Furthermore, there's enough legacy widget code that doesn't call ignore() on unhandled mouse events. So it's uncertain whether this can change in Qt 7.

The QContextMenuEvent occurs at the scenePosition(). The position() was likely already "localized" during the previous delivery.

The synthesis from a mouse button event could be done in the platform plugin, but so far on Windows it's not done: WM_CONTEXTMENU is not generated by the OS, because we never call the default window procedure that would do that in response to unhandled WM_RBUTTONUP. If we eventually want to do that, we would have to avoid doing it here, on platforms where the platform plugin is responsible for it.

QGuiApplicationPrivate::processContextMenuEvent also allows keyboard-triggered context menu events that the QPA plugin might generate. On Windows, the keyboard may have a menu key. On macOS, control-return is the usual shortcut; on Gnome, it's shift-F10; and so on.

Reimplemented in QQuickWindowPrivate.

Definition at line 2800 of file qwindow.cpp.

◆ participatesInLastWindowClosed()

bool QWindowPrivate::participatesInLastWindowClosed ( ) const
virtual

Reimplemented in QWidgetWindowPrivate, and QWidgetWindowPrivate.

Definition at line 2439 of file qwindow.cpp.

◆ screenForGeometry()

QScreen * QWindowPrivate::screenForGeometry ( const QRect & rect) const

Definition at line 1869 of file qwindow.cpp.

◆ setAutomaticPositionAndResizeEnabled()

void QWindowPrivate::setAutomaticPositionAndResizeEnabled ( bool a)
inline

Definition at line 103 of file qwindow_p.h.

◆ setCursor()

void QWindowPrivate::setCursor ( const QCursor * c = nullptr)

Definition at line 3231 of file qwindow.cpp.

◆ setFocusToTarget()

virtual void QWindowPrivate::setFocusToTarget ( FocusTarget ,
Qt::FocusReason  )
inlinevirtual

Reimplemented in QQuickWindowPrivate, QWidgetWindowPrivate, and QWidgetWindowPrivate.

Definition at line 87 of file qwindow_p.h.

◆ setMinOrMaxSize()

void QWindowPrivate::setMinOrMaxSize ( QSize * oldSizeMember,
const QSize & size,
qxp::function_ref< void()> funcWidthChanged,
qxp::function_ref< void()> funcHeightChanged )

Definition at line 623 of file qwindow.cpp.

◆ setTopLevelScreen()

void QWindowPrivate::setTopLevelScreen ( QScreen * newScreen,
bool recreate )

Definition at line 516 of file qwindow.cpp.

◆ setTransientParent()

void QWindowPrivate::setTransientParent ( QWindow * parent)

Definition at line 1582 of file qwindow.cpp.

◆ setVisible()

void QWindowPrivate::setVisible ( bool visible)
virtual

Reimplemented in QQuickPopupWindowPrivate, QQuickPopupWindowPrivate, QQuickWidgetOffscreenWindowPrivate, QQuickWidgetOffscreenWindowPrivate, QWidgetWindowPrivate, and QWidgetWindowPrivate.

Definition at line 349 of file qwindow.cpp.

◆ topLevelWindow()

QWindow * QWindowPrivate::topLevelWindow ( QWindow::AncestorMode mode = QWindow::IncludeTransients) const

Definition at line 3097 of file qwindow.cpp.

◆ treatAsVisible()

bool QWindowPrivate::treatAsVisible ( ) const
virtual

Reimplemented in QWidgetWindowPrivate, and QWidgetWindowPrivate.

Definition at line 2460 of file qwindow.cpp.

◆ updateDevicePixelRatio()

bool QWindowPrivate::updateDevicePixelRatio ( )

Definition at line 1413 of file qwindow.cpp.

◆ updateSiblingPosition()

void QWindowPrivate::updateSiblingPosition ( SiblingPosition position)

Definition at line 462 of file qwindow.cpp.

◆ updateVisibility()

void QWindowPrivate::updateVisibility ( )

Definition at line 441 of file qwindow.cpp.

◆ windowPalette()

virtual QPalette QWindowPrivate::windowPalette ( ) const
inlinevirtual

Reimplemented in QQuickApplicationWindowPrivate, and QQuickApplicationWindowPrivate.

Definition at line 59 of file qwindow_p.h.

◆ windowRecreationRequired()

bool QWindowPrivate::windowRecreationRequired ( QScreen * newScreen) const

Definition at line 486 of file qwindow.cpp.

Member Data Documentation

◆ baseSize

QSize QWindowPrivate::baseSize

Definition at line 143 of file qwindow_p.h.

◆ blockedByModalWindow

bool QWindowPrivate::blockedByModalWindow = false

Definition at line 147 of file qwindow_p.h.

◆ contentOrientation

Qt::ScreenOrientation QWindowPrivate::contentOrientation = Qt::PrimaryOrientation

Definition at line 137 of file qwindow_p.h.

◆ cursor

QCursor QWindowPrivate::cursor = {Qt::ArrowCursor}

Definition at line 156 of file qwindow_p.h.

◆ devicePixelRatio

qreal QWindowPrivate::devicePixelRatio = 1.0

Definition at line 125 of file qwindow_p.h.

◆ exposed

bool QWindowPrivate::exposed = false

Definition at line 118 of file qwindow_p.h.

◆ geometry

QRect QWindowPrivate::geometry

Definition at line 124 of file qwindow_p.h.

◆ hasCursor

bool QWindowPrivate::hasCursor = false

Definition at line 157 of file qwindow_p.h.

◆ inClose

bool QWindowPrivate::inClose = false

Definition at line 119 of file qwindow_p.h.

◆ lastComposeTime

QElapsedTimer QWindowPrivate::lastComposeTime

Definition at line 160 of file qwindow_p.h.

◆ mask

QRegion QWindowPrivate::mask

Definition at line 139 of file qwindow_p.h.

◆ maximumSize

QSize QWindowPrivate::maximumSize = {QWINDOWSIZE_MAX, QWINDOWSIZE_MAX}

Definition at line 142 of file qwindow_p.h.

◆ minimumSize

QSize QWindowPrivate::minimumSize = {0, 0}

Definition at line 141 of file qwindow_p.h.

◆ modality

Qt::WindowModality QWindowPrivate::modality = Qt::NonModal

Definition at line 146 of file qwindow_p.h.

◆ opacity

qreal QWindowPrivate::opacity = 1

Definition at line 138 of file qwindow_p.h.

◆ parentWindow

QWindow* QWindowPrivate::parentWindow = nullptr

Definition at line 114 of file qwindow_p.h.

◆ platformWindow

QPlatformWindow* QWindowPrivate::platformWindow = nullptr

Definition at line 115 of file qwindow_p.h.

◆ positionAutomatic

bool QWindowPrivate::positionAutomatic = true

Definition at line 131 of file qwindow_p.h.

◆ positionPolicy

PositionPolicy QWindowPrivate::positionPolicy = WindowFrameExclusive

Definition at line 130 of file qwindow_p.h.

◆ receivedExpose

bool QWindowPrivate::receivedExpose = false

Definition at line 129 of file qwindow_p.h.

◆ requestedFormat

QSurfaceFormat QWindowPrivate::requestedFormat

Definition at line 120 of file qwindow_p.h.

◆ resizeAutomatic

bool QWindowPrivate::resizeAutomatic = true

Definition at line 136 of file qwindow_p.h.

◆ resizeEventPending

bool QWindowPrivate::resizeEventPending = true

Definition at line 128 of file qwindow_p.h.

◆ sizeIncrement

QSize QWindowPrivate::sizeIncrement

Definition at line 144 of file qwindow_p.h.

◆ surfaceType

QWindow::SurfaceType QWindowPrivate::surfaceType = QWindow::RasterSurface

Definition at line 112 of file qwindow_p.h.

◆ topLevelScreen

QPointer<QScreen> QWindowPrivate::topLevelScreen

Definition at line 153 of file qwindow_p.h.

◆ transientParent

QPointer<QWindow> QWindowPrivate::transientParent

Definition at line 152 of file qwindow_p.h.

◆ transientParentPropertySet

bool QWindowPrivate::transientParentPropertySet = false

Definition at line 150 of file qwindow_p.h.

◆ updateRequestPending

bool QWindowPrivate::updateRequestPending = false

Definition at line 149 of file qwindow_p.h.

◆ visibility

QWindow::Visibility QWindowPrivate::visibility = QWindow::Hidden

Definition at line 127 of file qwindow_p.h.

◆ visibilityOnDestroy

bool QWindowPrivate::visibilityOnDestroy = false

Definition at line 117 of file qwindow_p.h.

◆ visible

bool QWindowPrivate::visible = false

Definition at line 116 of file qwindow_p.h.

◆ windowFilePath

QString QWindowPrivate::windowFilePath

Definition at line 122 of file qwindow_p.h.

◆ windowFlags

Qt::WindowFlags QWindowPrivate::windowFlags = Qt::Window

Definition at line 113 of file qwindow_p.h.

◆ windowIcon

QIcon QWindowPrivate::windowIcon

Definition at line 123 of file qwindow_p.h.

◆ windowState

Qt::WindowStates QWindowPrivate::windowState = Qt::WindowNoState

Definition at line 126 of file qwindow_p.h.

◆ windowTitle

QString QWindowPrivate::windowTitle

Definition at line 121 of file qwindow_p.h.

The documentation for this class was generated from the following files: