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
QAndroidPlatformScreen Class Reference

#include <qandroidplatformscreen.h>

+ Inheritance diagram for QAndroidPlatformScreen:
+ Collaboration diagram for QAndroidPlatformScreen:

Public Slots

void setPhysicalSize (const QSize &size)
 
void setAvailableGeometry (const QRect &rect)
 
void setSize (const QSize &size)
 
void setSizeParameters (const QSize &physicalSize, const QSize &size, const QRect &availableGeometry)
 
void setRefreshRate (qreal refreshRate)
 
void setOrientation (Qt::ScreenOrientation orientation)
 
- Public Slots inherited from QObject
void deleteLater ()
 \threadsafe
 

Public Member Functions

 QAndroidPlatformScreen (const QJniObject &displayObject)
 
 ~QAndroidPlatformScreen ()
 
QRect geometry () const override
 Reimplement in subclass to return the pixel geometry of the screen.
 
QRect availableGeometry () const override
 Reimplement in subclass to return the pixel geometry of the available space This normally is the desktop screen minus the task manager, global menubar etc.
 
int depth () const override
 Reimplement in subclass to return current depth of the screen.
 
QImage::Format format () const override
 Reimplement in subclass to return the image format which corresponds to the screen format.
 
QSizeF physicalSize () const override
 Reimplement this function in subclass to return the physical size of the screen, in millimeters.
 
QString name () const override
 
QList< Modemodes () const override
 Reimplement this function in subclass to return the list of modes for this screen.
 
int currentMode () const override
 Reimplement this function in subclass to return the index of the current mode from the modes list.
 
int preferredMode () const override
 Reimplement this function in subclass to return the preferred mode index from the modes list.
 
qreal refreshRate () const override
 Reimplement this function in subclass to return the vertical refresh rate of the screen, in Hz.
 
QWindowtopVisibleWindow () const
 
QWindowtopLevelAt (const QPoint &p) const override
 Return the given top level window for a given position.
 
void addWindow (QAndroidPlatformWindow *window)
 
void removeWindow (QAndroidPlatformWindow *window)
 
void raise (QAndroidPlatformWindow *window)
 
void lower (QAndroidPlatformWindow *window)
 
void topVisibleWindowChanged ()
 
int displayId () const override
 
- Public Member Functions inherited from QObject
Q_INVOKABLE QObject (QObject *parent=nullptr)
 Constructs an object with parent object parent.
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects.
 
virtual bool event (QEvent *event)
 This virtual function receives events to an object and should return true if the event e was recognized and processed.
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 Filters events if this object has been installed as an event filter for the watched object.
 
QString objectName () const
 
Q_WEAK_OVERLOAD void setObjectName (const QString &name)
 Sets the object's name to name.
 
void setObjectName (QAnyStringView name)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
QBindable< QStringbindableObjectName ()
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false.
 
bool isWindowType () const
 Returns true if the object is a window; otherwise returns false.
 
bool isQuickItemType () const
 Returns true if the object is a QQuickItem; otherwise returns false.
 
bool signalsBlocked () const noexcept
 Returns true if signals are blocked; otherwise returns false.
 
bool blockSignals (bool b) noexcept
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it).
 
QThreadthread () const
 Returns the thread in which the object lives.
 
bool moveToThread (QThread *thread QT6_DECL_NEW_OVERLOAD_TAIL)
 Changes the thread affinity for this object and its children and returns true on success.
 
int startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)
 This is an overloaded function that will start a timer of type timerType and a timeout of interval milliseconds.
 
int startTimer (std::chrono::nanoseconds time, Qt::TimerType timerType=Qt::CoarseTimer)
 
void killTimer (int id)
 Kills the timer with timer identifier, id.
 
void killTimer (Qt::TimerId id)
 
template<typename T >
findChild (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 Returns the child of this object that can be cast into type T and that is called name, or \nullptr if there is no such object.
 
template<typename T >
QList< T > findChildren (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects.
 
template<typename T >
findChild (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
template<typename T >
QList< T > findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
const QObjectListchildren () const
 Returns a list of child objects.
 
void setParent (QObject *parent)
 Makes the object a child of parent.
 
void installEventFilter (QObject *filterObj)
 Installs an event filter filterObj on this object.
 
void removeEventFilter (QObject *obj)
 Removes an event filter object obj from this object.
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=nullptr, const QObject *receiver=nullptr, const char *member=nullptr) const
 
bool disconnect (const QObject *receiver, const char *member=nullptr) const
 
void dumpObjectTree () const
 Dumps a tree of children to the debug output.
 
void dumpObjectInfo () const
 Dumps information about signal connections, etc.
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value.
 
bool setProperty (const char *name, QVariant &&value)
 
QVariant property (const char *name) const
 Returns the value of the object's name property.
 
QList< QByteArraydynamicPropertyNames () const
 
QBindingStoragebindingStorage ()
 
const QBindingStoragebindingStorage () const
 
QObjectparent () const
 Returns a pointer to the parent object.
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false.
 
- Public Member Functions inherited from QPlatformScreen
 QPlatformScreen ()
 
virtual ~QPlatformScreen ()
 
virtual bool isPlaceholder () const
 
virtual QPixmap grabWindow (WId window, int x, int y, int width, int height) const
 This function is called when Qt needs to be able to grab the content of a window.
 
virtual QColorSpace colorSpace () const
 
virtual qreal devicePixelRatio () const
 Reimplement this function in subclass to return the device pixel ratio for the screen.
 
QWindowList windows () const
 Return all windows residing on this screen.
 
virtual QList< QPlatformScreen * > virtualSiblings () const
 Returns a list of all the platform screens that are part of the same virtual desktop.
 
const QPlatformScreenscreenForPosition (const QPoint &point) const
 Find the sibling screen corresponding to globalPos.
 
QScreenscreen () const
 
virtual QString manufacturer () const
 Reimplement this function in subclass to return the manufacturer of this screen.
 
virtual QString model () const
 Reimplement this function in subclass to return the model of this screen.
 
virtual QString serialNumber () const
 Reimplement this function in subclass to return the serial number of this screen.
 
virtual QPlatformCursorcursor () const
 Reimplement this function in subclass to return the cursor of the screen.
 
virtual SubpixelAntialiasingType subpixelAntialiasingTypeHint () const
 Returns a hint about this screen's subpixel layout structure.
 
virtual PowerState powerState () const
 Returns the current power state.
 
virtual void setPowerState (PowerState state)
 Sets the power state for this screen.
 

Protected Types

typedef QList< QAndroidPlatformWindow * > WindowStackType
 

Protected Attributes

WindowStackType m_windowStack
 
QRect m_availableGeometry
 
int m_depth
 
QImage::Format m_format
 
QSizeF m_physicalSize
 
qreal m_refreshRate
 
QString m_name
 
QList< Modem_modes
 
int m_currentMode = 0
 
int m_displayId = -1
 
- Protected Attributes inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Protected Attributes inherited from QPlatformScreen
QScopedPointer< QPlatformScreenPrivated_ptr
 

Private Member Functions

QDpi logicalDpi () const override
 Reimplement this function in subclass to return the logical horizontal and vertical dots per inch metrics of the screen.
 
QDpi logicalBaseDpi () const override
 Reimplement to return the base logical DPI for the platform.
 
Qt::ScreenOrientation orientation () const override
 Reimplement this function in subclass to return the current orientation of the screen, for example based on accelerometer data to determine the device orientation.
 
Qt::ScreenOrientation nativeOrientation () const override
 Reimplement this function in subclass to return the native orientation of the screen, e.g.
 

Additional Inherited Members

- Public Types inherited from QPlatformScreen
enum  SubpixelAntialiasingType {
  Subpixel_None , Subpixel_RGB , Subpixel_BGR , Subpixel_VRGB ,
  Subpixel_VBGR
}
 
enum  PowerState { PowerStateOn , PowerStateStandby , PowerStateSuspend , PowerStateOff }
 
- Signals inherited from QObject
void destroyed (QObject *=nullptr)
 This signal is emitted immediately before the object obj is destroyed, after any instances of QPointer have been notified, and cannot be blocked.
 
void objectNameChanged (const QString &objectName, QPrivateSignal)
 This signal is emitted after the object's name has been changed.
 
- Static Public Member Functions inherited from QObject
static QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 \threadsafe
 
static QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1 , typename Func2 >
static QMetaObject::Connection connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::ContextTypeForFunctor< Func2 >::ContextType *context, Func2 &&slot, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1 , typename Func2 >
static QMetaObject::Connection connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 &&slot)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 \threadsafe
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static bool disconnect (const QMetaObject::Connection &)
 Disconnect a connection.
 
template<typename Func1 , typename Func2 >
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot)
 
template<typename Func1 >
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *receiver, void **zero)
 
- Static Public Member Functions inherited from QPlatformScreen
static QPlatformScreenplatformScreenForWindow (const QWindow *window)
 
static int angleBetween (Qt::ScreenOrientation a, Qt::ScreenOrientation b)
 
static QTransform transformBetween (Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &target)
 
static QRect mapBetween (Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &rect)
 
static QDpi overrideDpi (const QDpi &in)
 
- Protected Member Functions inherited from QObject
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns \nullptr.
 
int senderSignalIndex () const
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal.
 
bool isSignalConnected (const QMetaMethod &signal) const
 
virtual void timerEvent (QTimerEvent *event)
 This event handler can be reimplemented in a subclass to receive timer events for the object.
 
virtual void childEvent (QChildEvent *event)
 This event handler can be reimplemented in a subclass to receive child events.
 
virtual void customEvent (QEvent *event)
 This event handler can be reimplemented in a subclass to receive custom events.
 
virtual void connectNotify (const QMetaMethod &signal)
 
virtual void disconnectNotify (const QMetaMethod &signal)
 
 QObject (QObjectPrivate &dd, QObject *parent=nullptr)
 
- Protected Member Functions inherited from QPlatformScreen
void resizeMaximizedWindows ()
 Convenience method to resize all the maximized and fullscreen windows of this platform screen.
 
- Properties inherited from QObject
QString objectName
 the name of this object
 

Detailed Description

Definition at line 21 of file qandroidplatformscreen.h.

Member Typedef Documentation

◆ WindowStackType

Constructor & Destructor Documentation

◆ QAndroidPlatformScreen()

QAndroidPlatformScreen::QAndroidPlatformScreen ( const QJniObject & displayObject)

Definition at line 63 of file qandroidplatformscreen.cpp.

◆ ~QAndroidPlatformScreen()

QAndroidPlatformScreen::~QAndroidPlatformScreen ( )

Definition at line 131 of file qandroidplatformscreen.cpp.

Member Function Documentation

◆ addWindow()

void QAndroidPlatformScreen::addWindow ( QAndroidPlatformWindow * window)

Definition at line 156 of file qandroidplatformscreen.cpp.

References QtAndroid::backendRegister(), QAndroidPlatformWindow::isRaster(), m_windowStack, and topVisibleWindowChanged().

+ Here is the call graph for this function:

◆ availableGeometry()

QRect QAndroidPlatformScreen::availableGeometry ( ) const
inlineoverridevirtual

Reimplement in subclass to return the pixel geometry of the available space This normally is the desktop screen minus the task manager, global menubar etc.

Reimplemented from QPlatformScreen.

Definition at line 31 of file qandroidplatformscreen.h.

◆ currentMode()

int QAndroidPlatformScreen::currentMode ( ) const
inlineoverridevirtual

Reimplement this function in subclass to return the index of the current mode from the modes list.

The default implementation returns 0.

See also
QPlatformScreen::modes
Since
5.9

Reimplemented from QPlatformScreen.

Definition at line 38 of file qandroidplatformscreen.h.

References m_currentMode.

◆ depth()

int QAndroidPlatformScreen::depth ( ) const
inlineoverridevirtual

Reimplement in subclass to return current depth of the screen.

Implements QPlatformScreen.

Definition at line 32 of file qandroidplatformscreen.h.

References m_depth.

◆ displayId()

int QAndroidPlatformScreen::displayId ( ) const
override

Definition at line 246 of file qandroidplatformscreen.cpp.

References m_displayId.

◆ format()

QImage::Format QAndroidPlatformScreen::format ( ) const
inlineoverridevirtual

Reimplement in subclass to return the image format which corresponds to the screen format.

Implements QPlatformScreen.

Definition at line 33 of file qandroidplatformscreen.h.

◆ geometry()

QRect QAndroidPlatformScreen::geometry ( ) const
inlineoverridevirtual

Reimplement in subclass to return the pixel geometry of the screen.

Implements QPlatformScreen.

Definition at line 30 of file qandroidplatformscreen.h.

◆ logicalBaseDpi()

QDpi QAndroidPlatformScreen::logicalBaseDpi ( ) const
overrideprivatevirtual

Reimplement to return the base logical DPI for the platform.

This DPI value should correspond to a standard-DPI (1x) display. The default implementation returns 96.

QtGui will use this value (together with logicalDpi) to compute the scale factor when high-DPI scaling is enabled, as follows: factor = logicalDPI / baseDPI

Reimplemented from QPlatformScreen.

Definition at line 316 of file qandroidplatformscreen.cpp.

References androidLogicalDpi.

◆ logicalDpi()

QDpi QAndroidPlatformScreen::logicalDpi ( ) const
overrideprivatevirtual

Reimplement this function in subclass to return the logical horizontal and vertical dots per inch metrics of the screen.

The logical dots per inch metrics are used by Qt to scale the user interface.

The default implementation returns logicalBaseDpi(), which results in a UI scale factor of 1.0.

See also
physicalSize

Reimplemented from QPlatformScreen.

Definition at line 310 of file qandroidplatformscreen.cpp.

◆ lower()

void QAndroidPlatformScreen::lower ( QAndroidPlatformWindow * window)

Definition at line 203 of file qandroidplatformscreen.cpp.

References QtAndroid::backendRegister(), m_windowStack, and topVisibleWindowChanged().

+ Here is the call graph for this function:

◆ modes()

QList< Mode > QAndroidPlatformScreen::modes ( ) const
inlineoverridevirtual

Reimplement this function in subclass to return the list of modes for this screen.

The default implementation returns a list with only one mode from the current screen size and refresh rate.

See also
QPlatformScreen::geometry
QPlatformScreen::refreshRate
Since
5.9

Reimplemented from QPlatformScreen.

Definition at line 37 of file qandroidplatformscreen.h.

◆ name()

QString QAndroidPlatformScreen::name ( ) const
inlineoverridevirtual

Reimplemented from QPlatformScreen.

Definition at line 36 of file qandroidplatformscreen.h.

Referenced by testing.tools.encode_pdf_filter._PdfStream::RegisterByName().

+ Here is the caller graph for this function:

◆ nativeOrientation()

Qt::ScreenOrientation QAndroidPlatformScreen::nativeOrientation ( ) const
overrideprivatevirtual

Reimplement this function in subclass to return the native orientation of the screen, e.g.

the orientation where the logo sticker of the device appears the right way up.

The default implementation returns Qt::PrimaryOrientation.

Reimplemented from QPlatformScreen.

Definition at line 326 of file qandroidplatformscreen.cpp.

◆ orientation()

Qt::ScreenOrientation QAndroidPlatformScreen::orientation ( ) const
overrideprivatevirtual

Reimplement this function in subclass to return the current orientation of the screen, for example based on accelerometer data to determine the device orientation.

The default implementation returns Qt::PrimaryOrientation.

Reimplemented from QPlatformScreen.

Definition at line 321 of file qandroidplatformscreen.cpp.

◆ physicalSize()

QSizeF QAndroidPlatformScreen::physicalSize ( ) const
inlineoverridevirtual

Reimplement this function in subclass to return the physical size of the screen, in millimeters.

The physical size represents the actual physical dimensions of the display.

The default implementation takes the pixel size of the screen, considers a resolution of 100 dots per inch, and returns the calculated physical size. A device with a screen that has different resolutions will need to be supported by a suitable reimplementation of this function.

See also
logcalDpi

Reimplemented from QPlatformScreen.

Definition at line 34 of file qandroidplatformscreen.h.

◆ preferredMode()

int QAndroidPlatformScreen::preferredMode ( ) const
inlineoverridevirtual

Reimplement this function in subclass to return the preferred mode index from the modes list.

The default implementation returns 0.

See also
QPlatformScreen::modes
Since
5.9

Reimplemented from QPlatformScreen.

Definition at line 39 of file qandroidplatformscreen.h.

References m_currentMode.

◆ raise()

void QAndroidPlatformScreen::raise ( QAndroidPlatformWindow * window)

Definition at line 188 of file qandroidplatformscreen.cpp.

References QtAndroid::backendRegister(), m_windowStack, and topVisibleWindowChanged().

+ Here is the call graph for this function:

◆ refreshRate()

qreal QAndroidPlatformScreen::refreshRate ( ) const
inlineoverridevirtual

Reimplement this function in subclass to return the vertical refresh rate of the screen, in Hz.

The default returns 60, a sensible default for modern displays.

Reimplemented from QPlatformScreen.

Definition at line 40 of file qandroidplatformscreen.h.

◆ removeWindow()

void QAndroidPlatformScreen::removeWindow ( QAndroidPlatformWindow * window)

Definition at line 174 of file qandroidplatformscreen.cpp.

References QtAndroid::backendRegister(), m_windowStack, and topVisibleWindowChanged().

+ Here is the call graph for this function:

◆ setAvailableGeometry

void QAndroidPlatformScreen::setAvailableGeometry ( const QRect & rect)
slot

Definition at line 264 of file qandroidplatformscreen.cpp.

◆ setOrientation

void QAndroidPlatformScreen::setOrientation ( Qt::ScreenOrientation orientation)
slot

Definition at line 259 of file qandroidplatformscreen.cpp.

◆ setPhysicalSize

void QAndroidPlatformScreen::setPhysicalSize ( const QSize & size)
slot

Definition at line 217 of file qandroidplatformscreen.cpp.

◆ setRefreshRate

void QAndroidPlatformScreen::setRefreshRate ( qreal refreshRate)
slot

Definition at line 251 of file qandroidplatformscreen.cpp.

◆ setSize

void QAndroidPlatformScreen::setSize ( const QSize & size)
slot

Definition at line 222 of file qandroidplatformscreen.cpp.

◆ setSizeParameters

void QAndroidPlatformScreen::setSizeParameters ( const QSize & physicalSize,
const QSize & size,
const QRect & availableGeometry )
slot

Definition at line 228 of file qandroidplatformscreen.cpp.

◆ topLevelAt()

QWindow * QAndroidPlatformScreen::topLevelAt ( const QPoint & pos) const
overridevirtual

Return the given top level window for a given position.

Default implementation retrieves a list of all top level windows and finds the first window which contains point pos

Reimplemented from QPlatformScreen.

Definition at line 147 of file qandroidplatformscreen.cpp.

Referenced by QtAndroid::topLevelWindowAt().

+ Here is the caller graph for this function:

◆ topVisibleWindow()

QWindow * QAndroidPlatformScreen::topVisibleWindow ( ) const
inline

Definition at line 135 of file qandroidplatformscreen.cpp.

◆ topVisibleWindowChanged()

void QAndroidPlatformScreen::topVisibleWindowChanged ( )

Definition at line 294 of file qandroidplatformscreen.cpp.

References QtAndroidMenu::setActiveTopLevelWindow(), QAndroidPlatformWindow::updateFocusedEditText(), and QAndroidPlatformWindow::updateSystemUiVisibility().

Referenced by addWindow(), lower(), raise(), and removeWindow().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Member Data Documentation

◆ m_availableGeometry

QRect QAndroidPlatformScreen::m_availableGeometry
protected

Definition at line 63 of file qandroidplatformscreen.h.

◆ m_currentMode

int QAndroidPlatformScreen::m_currentMode = 0
protected

Definition at line 70 of file qandroidplatformscreen.h.

Referenced by currentMode(), and preferredMode().

◆ m_depth

int QAndroidPlatformScreen::m_depth
protected

Definition at line 64 of file qandroidplatformscreen.h.

Referenced by depth().

◆ m_displayId

int QAndroidPlatformScreen::m_displayId = -1
protected

Definition at line 71 of file qandroidplatformscreen.h.

Referenced by displayId().

◆ m_format

QImage::Format QAndroidPlatformScreen::m_format
protected

Definition at line 65 of file qandroidplatformscreen.h.

◆ m_modes

QList<Mode> QAndroidPlatformScreen::m_modes
protected

Definition at line 69 of file qandroidplatformscreen.h.

◆ m_name

QString QAndroidPlatformScreen::m_name
protected

Definition at line 68 of file qandroidplatformscreen.h.

◆ m_physicalSize

QSizeF QAndroidPlatformScreen::m_physicalSize
protected

Definition at line 66 of file qandroidplatformscreen.h.

◆ m_refreshRate

qreal QAndroidPlatformScreen::m_refreshRate
protected

Definition at line 67 of file qandroidplatformscreen.h.

◆ m_windowStack

WindowStackType QAndroidPlatformScreen::m_windowStack
protected

Definition at line 62 of file qandroidplatformscreen.h.

Referenced by addWindow(), lower(), raise(), and removeWindow().


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