Qt
Internal/Contributor docs for the Qt SDK. <b>Note:</b> These are NOT official API docs; those are found <a href='https://doc.qt.io/'>here</a>.
Loading...
Searching...
No Matches
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 ()
 
 ~QWindowPrivate () override
 
void init (QWindow *parent, QScreen *targetScreen=nullptr)
 
void setCursor (const QCursor *c=nullptr)
 
bool applyCursor ()
 
QPoint globalPosition () const
 
QWindowtopLevelWindow (QWindow::AncestorMode mode=QWindow::IncludeTransients) const
 
virtual QWindoweventReceiver ()
 
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)
 
QScreenscreenForGeometry (const QRect &rect) const
 
void setTransientParent (QWindow *parent)
 
virtual void clearFocusObject ()
 
virtual void setFocusToTarget (QWindowPrivate::FocusTarget)
 
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 void processSafeAreaMarginsChanged ()
 
virtual bool participatesInLastWindowClosed () const
 
virtual bool treatAsVisible () const
 
bool isPopup () const
 
void setAutomaticPositionAndResizeEnabled (bool a)
 
bool updateDevicePixelRatio ()
 
- Public Member Functions inherited from QObjectPrivate
void ensureExtraData ()
 
 QObjectPrivate (int version=QObjectPrivateVersion)
 
virtual ~QObjectPrivate ()
 
void deleteChildren ()
 
void clearBindingStorage ()
 
void checkForIncompatibleLibraryVersion (int version) const
 
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::QPropertyAdaptorSlotObjectgetPropertyAdaptorSlotObject (const QMetaProperty &property)
 
- Public Member Functions inherited from QObjectData
 QObjectData ()=default
 
virtual ~QObjectData ()=0
 
QMetaObjectdynamicMetaObject () const
 

Static Public Member Functions

static QWindowPrivateget (QWindow *window)
 
static Qt::WindowState effectiveState (Qt::WindowStates)
 
- Static Public Member Functions inherited from QObjectPrivate
static bool removeConnection (Connection *c)
 
static QObjectPrivateget (QObject *o)
 
static const QObjectPrivateget (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
 
QWindowparentWindow = nullptr
 
QPlatformWindowplatformWindow = 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< QWindowtransientParent
 
QPointer< QScreentopLevelScreen
 
QCursor cursor = {Qt::ArrowCursor}
 
bool hasCursor = false
 
QElapsedTimer lastComposeTime
 
- Public Attributes inherited from QObjectPrivate
ExtraDataextraData
 
QAtomicPointer< QThreadDatathreadData
 
QAtomicPointer< ConnectionDataconnections
 
union { 
 
   QObject *   currentChildBeingDeleted 
 
   QAbstractDeclarativeData *   declarativeData 
 
};  
 
QAtomicPointer< QtSharedPointer::ExternalRefCountDatasharedRefcount
 
- Public Attributes inherited from QObjectData
QObjectq_ptr
 
QObjectparent
 
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
 
QDynamicMetaObjectDatametaObject
 
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

Enumerator
WindowFrameInclusive 
WindowFrameExclusive 

Definition at line 38 of file qwindow_p.h.

◆ SiblingPosition

Enumerator
PositionTop 
PositionBottom 

Definition at line 65 of file qwindow_p.h.

Constructor & Destructor Documentation

◆ QWindowPrivate()

QWindowPrivate::QWindowPrivate ( )
default

◆ ~QWindowPrivate()

QWindowPrivate::~QWindowPrivate ( )
overridedefault

Member Function Documentation

◆ _q_clearAlert()

void QWindowPrivate::_q_clearAlert ( )

Definition at line 3038 of file qwindow.cpp.

References QPlatformWindow::isAlertState(), platformWindow, and QPlatformWindow::setAlertState().

+ Here is the call graph for this function:

◆ applyCursor()

bool QWindowPrivate::applyCursor ( )

Definition at line 3115 of file qwindow.cpp.

References QPlatformScreen::cursor(), cursor, QScreen::handle(), hasCursor, QGuiApplication::overrideCursor(), QPlatformCursor::OverrideCursor, platformWindow, and screen.

Referenced by setCursor(), and setVisible().

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

◆ clearFocusObject()

void QWindowPrivate::clearFocusObject ( )
virtual

Reimplemented in QWidgetWindowPrivate, and QQuickWindowPrivate.

Definition at line 597 of file qwindow.cpp.

◆ closestAcceptableGeometry()

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

Reimplemented in QWidgetWindowPrivate.

Definition at line 604 of file qwindow.cpp.

References Q_UNUSED, and rect.

◆ connectToScreen()

void QWindowPrivate::connectToScreen ( QScreen * topLevelScreen)

Definition at line 487 of file qwindow.cpp.

References disconnectFromScreen(), screen, and topLevelScreen.

Referenced by init(), and setTopLevelScreen().

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

◆ create()

void QWindowPrivate::create ( bool recursive)

◆ destroy()

◆ disconnectFromScreen()

void QWindowPrivate::disconnectFromScreen ( )

Definition at line 481 of file qwindow.cpp.

References topLevelScreen.

Referenced by connectToScreen().

+ Here is the caller graph for this function:

◆ effectiveState()

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

Definition at line 1419 of file qwindow.cpp.

References state, Qt::WindowFullScreen, Qt::WindowMaximized, Qt::WindowMinimized, and Qt::WindowNoState.

Referenced by QCocoaWindow::applyWindowState(), and QGuiApplicationPrivate::processWindowStateChangedEvent().

+ Here is the caller graph for this function:

◆ emitScreenChangedRecursion()

void QWindowPrivate::emitScreenChangedRecursion ( QScreen * newScreen)

Definition at line 493 of file qwindow.cpp.

References child, and emit.

Referenced by setTopLevelScreen().

+ Here is the caller graph for this function:

◆ eventReceiver()

virtual QWindow * QWindowPrivate::eventReceiver ( )
inlinevirtual

Reimplemented in QWidgetWindowPrivate.

Definition at line 58 of file qwindow_p.h.

◆ get()

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

Definition at line 106 of file qwindow_p.h.

References window().

Referenced by QBackingStoreDefaultCompositor::flush(), QQuickPointerHandler::parentContains(), QGuiApplicationPrivate::processExposeEvent(), QGuiApplicationPrivate::processScreenLogicalDotsPerInchChange(), QGuiApplicationPrivate::processWindowDevicePixelRatioChangedEvent(), QOpenGLCompositorBackingStore::rhiFlush(), QOffscreenWindow::setVisible(), shouldApplyDarkFrame(), QGuiApplicationPrivate::showModalWindow(), QCocoaWindow::updateTitleBarButtons(), and QApplicationPrivate::windowNeverBlocked().

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

◆ globalPosition()

QPoint QWindowPrivate::globalPosition ( ) const

Definition at line 2935 of file qwindow.cpp.

References QPlatformWindow::mapToGlobal().

+ Here is the call graph for this function:

◆ init()

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

◆ isPopup()

bool QWindowPrivate::isPopup ( ) const
inline

Definition at line 100 of file qwindow_p.h.

References Qt::Popup, and Qt::WindowType_Mask.

◆ participatesInLastWindowClosed()

bool QWindowPrivate::participatesInLastWindowClosed ( ) const
virtual

Reimplemented in QWidgetWindowPrivate.

Definition at line 2378 of file qwindow.cpp.

References Qt::ToolTip.

Referenced by QWidgetWindowPrivate::participatesInLastWindowClosed().

+ Here is the caller graph for this function:

◆ processSafeAreaMarginsChanged()

virtual void QWindowPrivate::processSafeAreaMarginsChanged ( )
inlinevirtual

Reimplemented in QWidgetWindowPrivate.

Definition at line 95 of file qwindow_p.h.

◆ screenForGeometry()

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

Definition at line 1848 of file qwindow.cpp.

References QRect::center(), QRect::contains(), QScreen::geometry, QRect::intersects(), and screen.

Referenced by create().

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

◆ setAutomaticPositionAndResizeEnabled()

void QWindowPrivate::setAutomaticPositionAndResizeEnabled ( bool a)
inline

Definition at line 101 of file qwindow_p.h.

◆ setCursor()

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

Definition at line 3091 of file qwindow.cpp.

References applyCursor(), Qt::ArrowCursor, cursor, QEvent::CursorChange, hasCursor, Qt::LastCursor, QCoreApplication::sendEvent(), and QCursor::shape().

+ Here is the call graph for this function:

◆ setFocusToTarget()

virtual void QWindowPrivate::setFocusToTarget ( QWindowPrivate::FocusTarget )
inlinevirtual

Reimplemented in QWidgetWindowPrivate, and QQuickWindowPrivate.

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 610 of file qwindow.cpp.

References QSize::expandedTo(), QSize::height(), maximumSize, minimumSize, platformWindow, QPlatformWindow::propagateSizeHints(), Q_ASSERT, QWINDOWSIZE_MAX, and QSize::width().

+ Here is the call graph for this function:

◆ setTopLevelScreen()

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

Definition at line 503 of file qwindow.cpp.

References connectToScreen(), create(), emitScreenChangedRecursion(), parentWindow, platformWindow, qWarning, topLevelScreen, visibilityOnDestroy, and windowRecreationRequired().

Referenced by create().

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

◆ setTransientParent()

void QWindowPrivate::setTransientParent ( QWindow * parent)

Definition at line 1561 of file qwindow.cpp.

References QObjectData::parent, and transientParentPropertySet.

◆ setVisible()

void QWindowPrivate::setVisible ( bool visible)
virtual

Reimplemented in QWidgetWindowPrivate, and QQuickWidgetOffscreenWindowPrivate.

Definition at line 343 of file qwindow.cpp.

References applyCursor(), QGuiApplicationPrivate::applyWindowGeometrySpecificationTo(), emit, hasCursor, QGuiApplicationPrivate::hideModalWindow(), QGuiApplicationPrivate::instance(), QString::isEmpty(), QGuiApplication::modalWindow(), QGuiApplication::overrideCursor(), parentWindow, platformWindow, qApp, QT_CONFIG, QEvent::Quit, QCoreApplication::removePostedEvents(), QCoreApplication::sendEvent(), QPlatformWindow::setVisible(), QGuiApplicationPrivate::showModalWindow(), QGuiApplicationPrivate::updateBlockedStatus(), updateVisibility(), visible, and Qt::Window.

Referenced by QWidgetWindowPrivate::setVisible().

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

◆ topLevelWindow()

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

Definition at line 2957 of file qwindow.cpp.

References QObjectData::parent, and window().

+ Here is the call graph for this function:

◆ treatAsVisible()

bool QWindowPrivate::treatAsVisible ( ) const
virtual

Reimplemented in QWidgetWindowPrivate.

Definition at line 2399 of file qwindow.cpp.

◆ updateDevicePixelRatio()

bool QWindowPrivate::updateDevicePixelRatio ( )

Definition at line 1400 of file qwindow.cpp.

References QPlatformWindow::devicePixelRatio(), devicePixelRatio, QEvent::DevicePixelRatioChange, QHighDpiScaling::factor(), platformWindow, and QCoreApplication::sendEvent().

Referenced by create(), QPlatformWindow::deliverUpdateRequest(), and init().

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

◆ updateSiblingPosition()

void QWindowPrivate::updateSiblingPosition ( SiblingPosition position)

Definition at line 449 of file qwindow.cpp.

References position(), PositionTop, Q_ASSERT, and QList< T >::size().

+ Here is the call graph for this function:

◆ updateVisibility()

void QWindowPrivate::updateVisibility ( )

Definition at line 428 of file qwindow.cpp.

References emit, visibility, visible, Qt::WindowFullScreen, Qt::WindowMaximized, Qt::WindowMinimized, and windowState.

Referenced by setVisible().

+ Here is the caller graph for this function:

◆ windowPalette()

virtual QPalette QWindowPrivate::windowPalette ( ) const
inlinevirtual

Reimplemented in QQuickApplicationWindowPrivate.

Definition at line 59 of file qwindow_p.h.

◆ windowRecreationRequired()

bool QWindowPrivate::windowRecreationRequired ( QScreen * newScreen) const

Definition at line 473 of file qwindow.cpp.

References platformWindow.

Referenced by setTopLevelScreen().

+ Here is the caller graph for this function:

Member Data Documentation

◆ baseSize

QSize QWindowPrivate::baseSize

Definition at line 141 of file qwindow_p.h.

◆ blockedByModalWindow

bool QWindowPrivate::blockedByModalWindow = false

Definition at line 145 of file qwindow_p.h.

◆ contentOrientation

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

Definition at line 135 of file qwindow_p.h.

◆ cursor

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

Definition at line 154 of file qwindow_p.h.

Referenced by applyCursor(), and setCursor().

◆ devicePixelRatio

qreal QWindowPrivate::devicePixelRatio = 1.0

Definition at line 123 of file qwindow_p.h.

Referenced by init(), and updateDevicePixelRatio().

◆ exposed

bool QWindowPrivate::exposed = false

Definition at line 116 of file qwindow_p.h.

Referenced by destroy().

◆ geometry

QRect QWindowPrivate::geometry

Definition at line 122 of file qwindow_p.h.

Referenced by create().

◆ hasCursor

bool QWindowPrivate::hasCursor = false

Definition at line 155 of file qwindow_p.h.

Referenced by applyCursor(), setCursor(), and setVisible().

◆ inClose

bool QWindowPrivate::inClose = false

Definition at line 117 of file qwindow_p.h.

◆ lastComposeTime

QElapsedTimer QWindowPrivate::lastComposeTime

Definition at line 158 of file qwindow_p.h.

◆ mask

QRegion QWindowPrivate::mask

Definition at line 137 of file qwindow_p.h.

◆ maximumSize

QSize QWindowPrivate::maximumSize = {QWINDOWSIZE_MAX, QWINDOWSIZE_MAX}

Definition at line 140 of file qwindow_p.h.

Referenced by setMinOrMaxSize().

◆ minimumSize

QSize QWindowPrivate::minimumSize = {0, 0}

Definition at line 139 of file qwindow_p.h.

Referenced by setMinOrMaxSize().

◆ modality

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

Definition at line 144 of file qwindow_p.h.

◆ opacity

qreal QWindowPrivate::opacity = 1

Definition at line 136 of file qwindow_p.h.

Referenced by QQuickWindowPrivate::updateDirtyNode().

◆ parentWindow

QWindow* QWindowPrivate::parentWindow = nullptr

Definition at line 112 of file qwindow_p.h.

Referenced by init(), setTopLevelScreen(), and setVisible().

◆ platformWindow

◆ positionAutomatic

bool QWindowPrivate::positionAutomatic = true

Definition at line 129 of file qwindow_p.h.

◆ positionPolicy

PositionPolicy QWindowPrivate::positionPolicy = WindowFrameExclusive

Definition at line 128 of file qwindow_p.h.

◆ receivedExpose

bool QWindowPrivate::receivedExpose = false

Definition at line 127 of file qwindow_p.h.

Referenced by destroy().

◆ requestedFormat

QSurfaceFormat QWindowPrivate::requestedFormat

Definition at line 118 of file qwindow_p.h.

Referenced by init().

◆ resizeAutomatic

bool QWindowPrivate::resizeAutomatic = true

Definition at line 134 of file qwindow_p.h.

◆ resizeEventPending

bool QWindowPrivate::resizeEventPending = true

Definition at line 126 of file qwindow_p.h.

Referenced by destroy().

◆ sizeIncrement

QSize QWindowPrivate::sizeIncrement

Definition at line 142 of file qwindow_p.h.

◆ surfaceType

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

Definition at line 110 of file qwindow_p.h.

◆ topLevelScreen

QPointer<QScreen> QWindowPrivate::topLevelScreen

Definition at line 151 of file qwindow_p.h.

Referenced by connectToScreen(), disconnectFromScreen(), init(), and setTopLevelScreen().

◆ transientParent

QPointer<QWindow> QWindowPrivate::transientParent

Definition at line 150 of file qwindow_p.h.

◆ transientParentPropertySet

bool QWindowPrivate::transientParentPropertySet = false

Definition at line 148 of file qwindow_p.h.

Referenced by setTransientParent().

◆ updateRequestPending

bool QWindowPrivate::updateRequestPending = false

Definition at line 147 of file qwindow_p.h.

Referenced by create(), and QPlatformWindow::deliverUpdateRequest().

◆ visibility

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

◆ visibilityOnDestroy

bool QWindowPrivate::visibilityOnDestroy = false

Definition at line 115 of file qwindow_p.h.

Referenced by destroy(), and setTopLevelScreen().

◆ visible

bool QWindowPrivate::visible = false

◆ windowFilePath

QString QWindowPrivate::windowFilePath

Definition at line 120 of file qwindow_p.h.

◆ windowFlags

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

Definition at line 111 of file qwindow_p.h.

◆ windowIcon

QIcon QWindowPrivate::windowIcon

Definition at line 121 of file qwindow_p.h.

◆ windowState

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

Definition at line 124 of file qwindow_p.h.

Referenced by updateVisibility().

◆ windowTitle

QString QWindowPrivate::windowTitle

Definition at line 119 of file qwindow_p.h.


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