Typedef for QFlags<RenderFlag> which contains an OR combination of RenderFlag values.

Refer to QWidget::RenderFlag for the enum documentation.

This enum describes how to render the widget when calling QWidget::render().

Constructs a widget which is a child of parent, with widget flags set to flags. If parent is nullptr the new widget becomes a window. If parent is another widget, this widget becomes a child window inside parent. The new widget is deleted when its parent is deleted.

The widget flags argument f is normally 0, but it can be set to customize the frame of a window (i.e. parent must be nullptr). To customize the frame use a value composed from the bitwise OR of any of the window flags.

If you add a child widget to an already visible widget you must explicitly show the child to make it visible.

The X11 version of CopperSpice may not be able to deliver all combinations of style flags on all systems. This occurs because CopperSpice can only ask the window manager and the window manager can override the application's settings.

On Windows, CopperSpice can set whatever flags you want.

See also

windowFlags

Destroys the widget.

All this widget's children are deleted first. The application exits if this widget is the main widget.

Returns the value of the acceptDrops property.

Returns the value of the accessibleDescription property.

Returns the value of the accessibleName property.

This event handler is called with the given event whenever the widget's actions are changed.

See also

addAction(), insertAction(), removeAction(), actions(), QActionEvent

Reimplemented in QMenu::actionEvent(), QToolBar::actionEvent(), QToolButton::actionEvent(), QMenuBar::actionEvent()

Returns the (possibly empty) list of this widget's actions.

See also

contextMenuPolicy, insertAction(), removeAction()

Sets the top-level widget containing this widget to be the active window. An active window is a visible top-level window that has the keyboard input focus.

This method performs the same operation as clicking the mouse on the title bar of a top-level window. On X11, the result depends on the Window Manager. If you want to ensure that the window is stacked on top as well you should also call raise(). Note, the window must be visible otherwise activateWindow() has no effect.

On Windows, if you are calling this when the application is not currently the active one then it will not make it the active window. It will change the color of the taskbar entry to indicate that the window has changed in some way. This is because Microsoft does not allow an application to interrupt what the user is currently doing in another application.

See also

isActiveWindow(), window(), show()

Appends action to the list of existing actions available for this widget. A QAction list is typically used to create a context QMenu, however it can be represented in different ways depending on the widget.

A QWidget should only have one of each action. Adding an action which already exists will not cause the same action to be in the widget multiple times. The ownership of action is not transferred to this QWidget.

See also

removeAction(), insertAction(), actions(), QMenu

Appends the given actions to this widget's list of actions.

See also

removeAction(), QMenu, addAction()

Adjusts the size of the widget to fit its contents.

This method uses sizeHint() if it is valid, for example the size hint's width and height are >= 0. Otherwise, it sets the size to the children rectangle that covers all child widgets (the union of all child widget rectangles).

For windows, the screen size is also taken into account. If the sizeHint() is less than (200, 100) and the size policy is expanding, the window will be at least (200, 100). The maximum size of a window is 2/3 of the screen's width and height.

See also

sizeHint(), childrenRect()

Returns the value of the autoFillBackground property.

Returns the background role of the widget. The background role defines the brush from the widget's palette that is used to render the background.

If no explicit background role is set the widget inherits its parent widget's background role.

See also

setBackgroundRole(), foregroundRole()

Returns the QBackingStore this widget will be drawn into.

Returns the value of the baseSize property.

This event handler can be reimplemented to handle state changes. The state being changed in this event can be retrieved through the event supplied.

Reimplemented in QTextEdit::changeEvent(), QPlainTextEdit::changeEvent(), QFileDialog::changeEvent(), QLineEdit::changeEvent(), QMessageBox::changeEvent(), QComboBox::changeEvent(), QTabBar::changeEvent(), QMenu::changeEvent(), QTabWidget::changeEvent(), QToolBar::changeEvent(), QAbstractSpinBox::changeEvent(), QWebView::changeEvent(), QAbstractSlider::changeEvent(), QAbstractButton::changeEvent(), QLabel::changeEvent(), QDialogButtonBox::changeEvent(), QProgressDialog::changeEvent(), QDockWidget::changeEvent(), QToolButton::changeEvent(), QFrame::changeEvent(), QSplitter::changeEvent(), QMenuBar::changeEvent(), QColorDialog::changeEvent(), QFontDialog::changeEvent(), QGroupBox::changeEvent(), QToolBox::changeEvent(), QRubberBand::changeEvent(), QErrorMessage::changeEvent(), QMdiSubWindow::changeEvent()

Returns the visible child widget at point position in the widget's own coordinate system.

Returns the visible child widget at the position (x, y) in the widget's coordinate system. If there is no visible child widget at the specified position the method returns nullptr.

Returns the value of the childrenRect property.

Returns the value of the childrenRegion property.

Removes keyboard input focus from the widget. If the widget has focus then a focusOutEvent is sent to the widget.

See also

hasFocus(), setFocus(), focusInEvent(), focusOutEvent(), setFocusPolicy(), QApplication::focusWidget()

Removes any mask set by setMask().

See also

setMask()

Closes this widget. Returns true if the widget was closed, otherwise returns false.

First it sends the widget a QCloseEvent. The widget is hidden if it accepts the close event. If it ignores the event, nothing happens. The default implementation of QWidget::closeEvent() accepts the close event.

If the widget has the Qt::WA_DeleteOnClose flag, the widget is also deleted. A close events is delivered to the widget no matter if the widget is visible or not.

The QApplication::lastWindowClosed() signal is emitted when the last visible primary window (i.e. window with no parent) with the Qt::WA_QuitOnClose attribute set is closed. By default this attribute is set for all widgets except transient windows such as splash screens, tool windows, and popup menus.

This event handler is called with the given event when CopperSpice receives a window close request for a top-level widget from the window system.

By default, the event is accepted and the widget is closed. You can reimplement this method to change the way the widget responds to window close requests. For example, you can prevent the window from closing by calling ignore() on all events.

Main window applications typically use reimplementations of this method to check whether the user's work has been saved and ask for permission before closing.

See also

event(), hide(), close(), QCloseEvent

Reimplemented in QMessageBox::closeEvent(), QAbstractSpinBox::closeEvent(), QProgressDialog::closeEvent(), QDockWidget::closeEvent(), QDialog::closeEvent(), QWebInspector::closeEvent(), QMdiSubWindow::closeEvent()

The contentsMargins method returns the widget's contents margins.

See also

getContentsMargins(), setContentsMargins(), contentsRect()

Returns the area inside the widget's margins.

See also

setContentsMargins(), getContentsMargins()

The event handler for the given event can be reimplemented in a subclass to receive widget context menu events. The handler is called when the widget's contextMenuPolicy is Qt::DefaultContextMenu.

The default implementation ignores the context event.

See also

event(), customContextMenuRequested(), QContextMenuEvent

Reimplemented in QTextEdit::contextMenuEvent(), QComboBox::contextMenuEvent(), QPlainTextEdit::contextMenuEvent(), QLineEdit::contextMenuEvent(), QGraphicsView::contextMenuEvent(), QMainWindow::contextMenuEvent(), QAbstractSpinBox::contextMenuEvent(), QWebView::contextMenuEvent(), QLabel::contextMenuEvent(), QAbstractScrollArea::contextMenuEvent(), QDialog::contextMenuEvent(), QScrollBar::contextMenuEvent(), QMdiSubWindow::contextMenuEvent()

Returns the value of the contextMenuPolicy property.

Creates a new widget window if window is 0, otherwise sets the widget's window to window.

Initializes the window (sets the geometry etc.) if initializeWindow is true. If initializeWindow is false, no initialization is performed. This parameter only makes sense if window is a valid window.

Destroys the old window if destroyOldWindow is true. If destroyOldWindow is false, you are responsible for destroying the window yourself (using platform native code).

The QWidget constructor calls create(0,true,true) to create a window for this widget.

Creates a new QWidget which contains the given window. The new QWidget will take ownership of the given window. The new QWidget is created as a child of parent and with the given window flags. Once the window has been embedded into the new QWidget, the widget will control the window's geometry and visibility. You should not call QWindow::setGeometry(), QWindow::show() or QWindow::hide() on the window. The window can be removed from the QWidget by calling QWindow::setParent().

The widget is attached as a native child window to the top level window it belongs to. When a widget is used as a child of QAbstractScrollArea or QMdiArea, it will create a native window for every widget in its parent chain to allow for proper stacking and clipping in this use case. Creating a native window for the widget also allows for proper stacking and clipping. This must be done before showing the widget. Applications with multiple native child windows may have minor performance issues.

The following is a list of known limitations.

Stacking Order

The window will stack on top of the widget hierarchy as an opaque box. The stacking order of multiple overlapping widget instances is undefined.

Rendering Integration

The widget can not be used with QGraphicsProxyWidget or QWidget::render()

Focus Handling

The widget can have any focus policy and it will delegate focus to the window via a call to QWindow::requestActivate(). However, returning to the normal focus chain from the QWindow instance will be up to the QWindow instance implementation. Calling QWindow::requestActivate() may or not give the window focus, this is platform dependent.

Returns the value of the cursor property.

This signal is emitted when the widget's contextMenuPolicy is Qt::CustomContextMenu, and the user has requested a context menu on the widget. The position pos is the position of the context menu event that the widget receives. Normally this is in widget coordinates. The exception to this rule is QAbstractScrollArea and its subclasses that map the context menu event to coordinates of the viewport() .

See also

mapToGlobal(), QMenu, contextMenuPolicy

Frees up window system resources. Destroys the widget window if destroyWindow is true. This method () calls itself recursively for all the child widgets, passing destroySubWindows for the destroyWindow parameter. To have more control over destruction of subwidgets, destroy subwidgets selectively first.

This method is usually called from the QWidget destructor.

This event handler is called when a drag is in progress and the mouse enters this widget. The event is passed in the event parameter. If the event is ignored, the widget will not receive any drag move events.

Refer to the Drag and Drop documentation for an overview of how to provide drag and drop in your application.

See also

QDrag, QDragEnterEvent

Reimplemented in QAbstractItemView::dragEnterEvent(), QTextEdit::dragEnterEvent(), QPlainTextEdit::dragEnterEvent(), QGraphicsView::dragEnterEvent(), QLineEdit::dragEnterEvent(), QWebView::dragEnterEvent(), QAbstractScrollArea::dragEnterEvent()

This event handler is called when a drag is in progress and the mouse leaves this widget. The event is passed in the event parameter.

Refer to the Drag and Drop documentation for an overview of how to provide drag and drop in your application.

See also

QDrag, QDragLeaveEvent

Reimplemented in QAbstractItemView::dragLeaveEvent(), QTextEdit::dragLeaveEvent(), QPlainTextEdit::dragLeaveEvent(), QGraphicsView::dragLeaveEvent(), QLineEdit::dragLeaveEvent(), QListView::dragLeaveEvent(), QWebView::dragLeaveEvent(), QAbstractScrollArea::dragLeaveEvent()

The event handler is called if a drag is in progress, and when any of the following conditions occur: the cursor enters this widget, the cursor moves within this widget, or a modifier key is pressed on the keyboard while this widget has the focus.

Refer to the Drag and Drop documentation for an overview of how to provide drag and drop in your application.

See also

QDrag, QDragMoveEvent

Reimplemented in QAbstractItemView::dragMoveEvent(), QTextEdit::dragMoveEvent(), QPlainTextEdit::dragMoveEvent(), QGraphicsView::dragMoveEvent(), QLineEdit::dragMoveEvent(), QTreeView::dragMoveEvent(), QListView::dragMoveEvent(), QWebView::dragMoveEvent(), QAbstractScrollArea::dragMoveEvent()

This event handler is called when the drag is dropped on this widget.

Refer to the Drag and Drop documentation for an overview of how to provide drag and drop in your application.

See also

QDrag, QDropEvent

Reimplemented in QTreeWidget::dropEvent(), QAbstractItemView::dropEvent(), QTableWidget::dropEvent(), QTextEdit::dropEvent(), QListWidget::dropEvent(), QPlainTextEdit::dropEvent(), QGraphicsView::dropEvent(), QLineEdit::dropEvent(), QListView::dropEvent(), QWebView::dropEvent(), QAbstractScrollArea::dropEvent()

Returns the effective window system identifier of the widget. For example, the native parent's window system identifier. If the widget is native, this method returns the native widget ID. Otherwise, the window ID of the first native parent widget, the top-level widget that contains this widget, is returned.

See also

nativeParentWidget()

Ensures the widget has been polished by QStyle and has a proper font and palette.

QWidget calls this method after it has been fully constructed but before it is shown the very first time. You can call this method if you want to ensure that the widget is polished before doing an operation. For example, the correct font size might be needed in the widget's sizeHint() reimplementation. This method is called from the default implementation of sizeHint().

Polishing is useful for final initialization that must happen after all constructors (from base classes as well as from subclasses) have been called. If you need to change some settings when a widget is polished, reimplement event() and handle the QEvent::Polish event type.

Note

The method is declared const so it can be called from other const methods, for example sizeHint().

See also

event()

The event handler can be reimplemented in a subclass to receive widget enter events which are passed in the event parameter. An event is sent to the widget when the mouse cursor enters the widget.

See also

leaveEvent(), mouseMoveEvent(), event()

Reimplemented in QMenu::enterEvent(), QToolButton::enterEvent()

This is the main event handler and it handles the given event. You can reimplement this method in a subclass, but we recommend using one of the specialized event handlers instead.

Key press and release events are treated differently from other events. event() checks for Tab and Shift+Tab and tries to move the focus appropriately. If there is no widget to move the focus to (or the key press is not Tab or Shift+Tab), event() calls keyPressEvent().

Mouse and tablet event handling is also slightly special: only when the widget is enabled, event() will call the specialized handlers such as mousePressEvent(), otherwise it will discard the event.

This method returns true if the event was recognized, otherwise it returns false. If the recognized event was accepted (see QEvent::accepted), any further processing such as event propagation to the parent widget stops.

See also

closeEvent(), focusInEvent(), focusOutEvent(), enterEvent(), keyPressEvent(), keyReleaseEvent(), leaveEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), moveEvent(), paintEvent(), resizeEvent(), QObject::event(), QObject::timerEvent()

Returns a pointer to the widget with a window identifier or handle matching id.

The window identifier type depends on the underlying window system, see qwindowdefs.h for the actual definition. If there is no widget with this identifier then nullptr is returned.

This event handler can be reimplemented in a subclass to receive keyboard focus events for the widget. The default implementation updates the widget if a focusPolicy() is specified. The event is passed in the event parameter.

A widget normally must the setFocusPolicy() to something other than Qt::NoFocus in order to receive focus events.

See also

focusOutEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event(), QFocusEvent

Reimplemented in QMdiSubWindow::focusInEvent(), QAbstractItemView::focusInEvent(), QTextEdit::focusInEvent(), QPlainTextEdit::focusInEvent(), QGraphicsView::focusInEvent(), QComboBox::focusInEvent(), QLineEdit::focusInEvent(), QDateTimeEdit::focusInEvent(), QWebView::focusInEvent(), QAbstractSpinBox::focusInEvent(), QLabel::focusInEvent(), QAbstractButton::focusInEvent(), QMenuBar::focusInEvent(), QGroupBox::focusInEvent(), QPushButton::focusInEvent()

Move keyboard focus to the next widget and returns true if it can find a widget or false if it can not.

See also

focusPreviousChild()

Finds a new widget to give the keyboard focus to, as appropriate for Tab and Shift+Tab, and returns true if it can find a new widget, or false if it can not.

If next is true this method searches forward, if next is false it searches backward.

You may want to reimplement this method. For example, a web browser might reimplement it to move its "current active link" forward or backward, and call focusNextPrevChild() only when it reaches the last or first link on the "page".

Child widgets call focusNextPrevChild() on their parent widgets, but only the window that contains the child widgets decides where to redirect focus. By reimplementing this method for an object, you thus gain control of focus traversal for all child widgets.

See also

focusNextChild(), focusPreviousChild()

Reimplemented in QAbstractItemView::focusNextPrevChild(), QTextEdit::focusNextPrevChild(), QGraphicsView::focusNextPrevChild(), QPlainTextEdit::focusNextPrevChild(), QMenu::focusNextPrevChild(), QDateTimeEdit::focusNextPrevChild(), QWebView::focusNextPrevChild(), QLabel::focusNextPrevChild(), QTextBrowser::focusNextPrevChild(), QScrollArea::focusNextPrevChild()

This event handler can be reimplemented in a subclass to receive keyboard focus events for the widget. The default implementation updates the widget if a focusPolicy() is specified. The events is passed in the event parameter.

A widget normally must setFocusPolicy() to something other than Qt::NoFocus in order to receive focus events.

See also

focusInEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event(), QFocusEvent

Reimplemented in QMdiSubWindow::focusOutEvent(), QAbstractItemView::focusOutEvent(), QTextEdit::focusOutEvent(), QPlainTextEdit::focusOutEvent(), QGraphicsView::focusOutEvent(), QComboBox::focusOutEvent(), QLineEdit::focusOutEvent(), QWebView::focusOutEvent(), QAbstractSpinBox::focusOutEvent(), QLabel::focusOutEvent(), QAbstractButton::focusOutEvent(), QTextBrowser::focusOutEvent(), QMenuBar::focusOutEvent(), QPushButton::focusOutEvent()

Returns the value of the focusPolicy property.

Move keyboard focus to the previous widget and returns true if it can find a widget or false if it can not.

See also

focusNextChild()

Returns the focus proxy or nullptr if there is no focus proxy.

See also

setFocusProxy()

Returns the last child of this widget that setFocus had been called on. For top level widgets this is the widget that will get focus in case this window gets activated.

This is not the same as QApplication::focusWidget(), which returns the focus widget in the currently active window.

Returns the value of the font property.

Returns the font info for the widget's current font. Equivalent to calling QFontInto(widget->font()).

See also

font(), fontMetrics(), setFont()

Returns the font metrics for the widget's current font. Equivalent to calling QFontMetrics(widget->font()).

See also

font(), fontInfo(), setFont()

Returns the foreground role. The foreground role defines the color from the widget's palette that is used to draw the foreground.

If no explicit foreground role is set, the method returns a role that contrasts with the background role.

See also

setForegroundRole(), backgroundRole()

Returns the value of the frameGeometry property.

Returns the value of the frameSize property.

Returns the value of the geometry property.

Returns the widget's contents margins for left, top, right, and bottom.

See also

setContentsMargins(), contentsRect()

Renders the widget into a pixmap restricted by the given rectangle. If the widget has any children, then they are also painted in the appropriate positions.

If a rectangle with an invalid size is specified (the default), the entire widget is painted.

See also

render(), QPixmap

Subscribes the widget to a given gestureType with specific flags.

See also

ungrabGesture(), QGestureEvent

Grabs the keyboard input.

This widget will receive all keyboard events until releaseKeyboard() is called. No other widgets will receive any keyboard events. Mouse events are not affected by this call. Use grabMouse() to grab mouse events.

The focus widget is not affected except that it does not receive any keyboard events. The setFocus() method moves the focus as usual, but the new focus widget receives keyboard events only after releaseKeyboard() is called.

If a different widget is currently grabbing keyboard input, that widget's grab is released first.

See also

releaseKeyboard(), grabMouse(), releaseMouse(), focusWidget()

Grabs the mouse input. This widget receives all mouse events until releaseMouse() is called; other widgets get no mouse events at all. Keyboard events are not affected. Use grabKeyboard() if you want to grab that.

Problems in applications which grab the mouse can make the computer unresponsive. This method should be used with extreme caution.

It is almost never necessary to grab the mouse. CopperSpice grabs the mouse when a mouse button is pressed and keeps it until the last button is released. Only visible widgets can grab mouse input. If isVisible() returns false for a widget, that widget can not call grabMouse().

Note

Mac OS X developers using Cocoa and calling grabMouse() on a widget only works when the mouse is inside the frame of that widget. For Carbon it works outside the widget's frame as well, similar to Windows and X11.

See also

releaseMouse(), grabKeyboard(), releaseKeyboard()

Grabs the mouse input and changes the cursor shape. The cursor will assume shape cursor and this widget will be the only one to receive mouse events until releaseMouse() is called().

See also

releaseMouse(), grabKeyboard(), releaseKeyboard(), setCursor()

Adds a shortcut to the CopperSpice shortcut system that watches for the given key sequence in the given context. If the context is Qt::ApplicationShortcut the shortcut applies to the application as a whole. Otherwise, it is either local to this widget, Qt::WidgetShortcut, or to the window itself, Qt::WindowShortcut.

If the same key sequence has been grabbed by several widgets when the key sequence is pressed, a QEvent::Shortcut event is sent to all the widgets in a non-deterministic order. The QShortcutEvent::isAmbiguous() method will return true for this event.

Warning

This method is normally not required. Instead, create QActions with the shortcut key sequences you require (if you also want equivalent menu options and toolbar buttons), or create QShortcuts if you just need key sequences. Both QAction and QShortcut handle all the event filtering for you, and provide signals which are triggered when the user triggers the key sequence, so are much easier to use than this low-level method.

See also

releaseShortcut(), setShortcutEnabled()

The graphicsEffect method returns a pointer to the widget's graphics effect. If the widget has no graphics effect, a nullptr is returned.

See also

setGraphicsEffect()

Returns the proxy widget for the corresponding embedded widget in a graphics view, otherwise returns a nullptr.

See also

QGraphicsProxyWidget::createProxyForChildWidget(), QGraphicsScene::addWidget()

Returns true if this widget currently has edit focus, otherwise false.

See also

setEditFocus()

Returns the value of the hasFocus property.

Returns true if the widget's preferred height depends on its width, otherwise returns false.

Reimplemented in QTabWidget::hasHeightForWidth()

Returns the value of the mouseTracking property.

Returns the value of the height property.

Returns the preferred height for this widget, given the width.

If this widget has a layout, the default implementation returns the layout's preferred height. if there is no layout, the default implementation returns -1 indicating that the preferred height does not depend on the width.

Reimplemented in QTabWidget::heightForWidth(), QLabel::heightForWidth(), QMenuBar::heightForWidth(), QCommandLinkButton::heightForWidth()

Hides the widget. This method is equivalent to calling setVisible(false).

Note

If you are working with QDialog or its subclasses and you invoke show() after this method, the dialog will be displayed in its original position.

See also

hideEvent(), isHidden(), show(), setVisible(), isVisible(), close()

The event handler can be reimplemented in a subclass to receive widget hide events. Hide events are sent to widgets immediately after they have been hidden.

Note: A widget receives spontaneous show and hide events when its mapping status is changed by the window system, e.g. a spontaneous hide event when the user minimizes the window, and a spontaneous show event when the window is restored again. After receiving a spontaneous hide event, a widget is still considered visible in the sense of isVisible().

See also

visible, event(), QHideEvent

Reimplemented in QMdiSubWindow::hideEvent(), QComboBox::hideEvent(), QMenu::hideEvent(), QTabBar::hideEvent(), QAbstractSpinBox::hideEvent(), QScrollBar::hideEvent(), QSizeGrip::hideEvent(), QWebInspector::hideEvent()

Initializes the painter pen, background and font to the same as the given widget's. This method is called automatically when the painter is opened on a QWidget.

Reimplemented from QPaintDevice

The event handler can be reimplemented in a subclass to receive Input Method composition events. This handler is called when the state of the input method changes.

When creating custom text editing widgets the Qt::WA_InputMethodEnabled window attribute must be set explicitly using the setAttribute() in order to receive input method events.

The default implementation calls event->ignore() which rejects the Input Method event.

See also

event(), QInputMethodEvent

Reimplemented in QAbstractItemView::inputMethodEvent(), QTextEdit::inputMethodEvent(), QPlainTextEdit::inputMethodEvent(), QGraphicsView::inputMethodEvent(), QComboBox::inputMethodEvent(), QLineEdit::inputMethodEvent(), QWebView::inputMethodEvent()

Returns the value of the property.

This method is only relevant for input widgets. It is used by the input method to query a set of properties of the widget to be able to support complex input method operations as support for surrounding text and reconversions.

The given query specifies which property is queried.

See also

inputMethodEvent(), QInputMethodEvent, inputMethodHints

Reimplemented in QLineEdit::inputMethodQuery(), QAbstractItemView::inputMethodQuery(), QGraphicsView::inputMethodQuery(), QComboBox::inputMethodQuery(), QAbstractSpinBox::inputMethodQuery(), QTextEdit::inputMethodQuery(), QPlainTextEdit::inputMethodQuery(), QWebView::inputMethodQuery()

Inserts the action to the current QWidget list of actions before the action before. It appends the action if before is a nullptr or not a valid action for this widget. A QWidget should only have one of each action.

See also

removeAction(), addAction(), QMenu, contextMenuPolicy, actions()

Inserts the actions to current QWidget before the action before. It appends the action if before is a nullptr or not a valid action for this widget. A QWidget can have at most one of each action.

See also

removeAction(), QMenu, insertAction(), contextMenuPolicy

Returns the value of the isActiveWindow property.

Returns true if this widget is a parent, (or grandparent and so on to any level), of the given child, and both widgets are within the same window, otherwise returns false.

Returns the value of the enabled property.

Returns true if this widget would become enabled if parent is enabled, otherwise returns false. This is the case if neither the widget itself nor every parent up to but excluding ancestor has been explicitly disabled.

Calling isEnabledTo(0) is equivalent to calling isEnabled().

See also

setEnabled(), enabled

Deprecated:

Equivalent to calling isEnabled().

Returns the value of the fullScreen property.

Returns true if the widget is hidden, otherwise returns false. A hidden widget will only become visible when show() is called on it. It will not be automatically shown when the parent is shown. To check visibility, use ! isVisible() instead (notice the exclamation mark).

isHidden() implies !isVisible(), but a widget can be not visible and not hidden at the same time. This is the case for widgets that are children of widgets that are not visible.

Widgets are hidden if:

• they were created as independent windows,
• they were created as children of visible widgets,
• hide() or setVisible(false) was called.

Returns the value of the maximized property.

Returns the value of the minimized property.

Returns the value of the modal property.

Deprecated:

Use isWindow() instead.

Returns the value of the visible property.

Returns true if this widget would become visible if parent is shown, otherwise returns false. The true case occurs if neither the widget itself nor any parent up to but excluding ancestor has been explicitly hidden.

This method will still return true if the widget is obscured by other windows on the screen, but could be physically visible if it or they were to be moved.

isVisibleTo(0) is identical to isVisible().

See also

show(), hide(), isVisible()

Returns true if the widget is an independent window, otherwise returns false.

A window is a widget that is not visually the child of any other widget and that usually has a frame and a window title.

A window can have a parent widget. It will then be grouped with its parent and deleted when the parent is deleted, minimized when the parent is minimized etc. If supported by the window manager, it will also have a common taskbar entry with its parent.

QDialog and QMainWindow widgets are by default windows, even if a parent widget is specified in the constructor. This behavior is specified by the Qt::Window flag.

See also

window(), isModal(), parentWidget()

Returns the value of the windowModified property.

Returns the widget that is currently grabbing the keyboard input. If no widget in this application is currently grabbing the keyboard, nullptr is returned.

See also

grabMouse(), mouseGrabber()

The event handler for the given event can be reimplemented in a subclass to receive key press events for the widget. A widget must call setFocusPolicy() to accept focus initially and have focus in order to receive a key press event.

If you reimplement this handler it is very important to call the base class implementation if you do not act upon the key. A QKeyEvent starts with isAccepted() set to true so you do not need to call QKeyEvent::accept(). Do not call the base class implementation if you consume the key event.

The default implementation closes popup widgets if the user presses Esc, otherwise the event is ignored and the widget's parent can react to it.

See also

keyReleaseEvent(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event(), QKeyEvent

Reimplemented in QMdiSubWindow::keyPressEvent(), QAbstractItemView::keyPressEvent(), QTextEdit::keyPressEvent(), QGraphicsView::keyPressEvent(), QComboBox::keyPressEvent(), QPlainTextEdit::keyPressEvent(), QMessageBox::keyPressEvent(), QLineEdit::keyPressEvent(), QMenu::keyPressEvent(), QTabBar::keyPressEvent(), QDateTimeEdit::keyPressEvent(), QTreeView::keyPressEvent(), QCalendarWidget::keyPressEvent(), QTabWidget::keyPressEvent(), QWebView::keyPressEvent(), QAbstractSpinBox::keyPressEvent(), QLabel::keyPressEvent(), QAbstractSlider::keyPressEvent(), QAbstractButton::keyPressEvent(), QTextBrowser::keyPressEvent(), QAbstractScrollArea::keyPressEvent(), QDialog::keyPressEvent(), QMenuBar::keyPressEvent(), QPushButton::keyPressEvent(), QKeySequenceEdit::keyPressEvent()

The event handler for the given event can be reimplemented in a subclass to receive key release events for the widget. A widget must call setFocusPolicy() to accept focus initially and have focus in order to receive a key release event.

If you reimplement this handler it is very important to call the base class implementation if you do not act upon the key. A QKeyEvent starts with isAccepted() set to true so you do not need to call QKeyEvent::accept(). Do not call the base class implementation if you consume the key event.

The default implementation closes popup widgets if the user presses Esc. Otherwise the event is ignored and the widget's parent can react to it.

See also

keyPressEvent(), QKeyEvent::ignore(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event(), QKeyEvent

Reimplemented in QTextEdit::keyReleaseEvent(), QGraphicsView::keyReleaseEvent(), QComboBox::keyReleaseEvent(), QPlainTextEdit::keyReleaseEvent(), QWebView::keyReleaseEvent(), QAbstractSpinBox::keyReleaseEvent(), QAbstractButton::keyReleaseEvent(), QKeySequenceEdit::keyReleaseEvent()

Returns the layout manager that is installed on this widget or a nullptr if no layout manager is installed.

The layout manager sets the geometry of the widget's children that have been added to the layout.

See also

setLayout(), sizePolicy(), Layout Management

Returns the value of the layoutDirection property.

This event handler can be reimplemented in a subclass to receive widget leave events which are passed in the event parameter.

A leave event is sent to the widget when the mouse cursor leaves the widget.

See also

enterEvent(), mouseMoveEvent(), event()

Reimplemented in QMdiSubWindow::leaveEvent(), QMenu::leaveEvent(), QToolButton::leaveEvent(), QMenuBar::leaveEvent()

Returns the value of the locale property.

Lowers the widget to the bottom of the parent widget's stack.

After this call the widget will be visually behind (and therefore obscured by) any overlapping sibling widgets.

See also

raise(), stackUnder()

Translates the widget coordinate pos from the coordinate system of parent to this widget's coordinate system. The parent must not be 0 and must be a parent of the calling widget.

See also

mapTo(), mapFromParent(), mapFromGlobal(), underMouse()

Translates the global screen coordinate pos to widget coordinates.

See also

mapToGlobal(), mapFrom(), mapFromParent()

Translates the parent widget coordinate pos to widget coordinates.

Same as mapFromGlobal() if the widget has no parent.

See also

mapToParent(), mapFrom(), mapFromGlobal(), underMouse()

Translates the widget coordinate pos to the coordinate system of parent. The parent must not be 0 and must be a parent of the calling widget.

See also

mapFrom(), mapToParent(), mapToGlobal(), underMouse()

Translates the widget coordinate pos to global screen coordinates. For example, mapToGlobal(QPoint(0,0)) would give the global coordinates of the top-left pixel of the widget.

See also

mapFromGlobal(), mapTo(), mapToParent()

Translates the widget coordinate pos to a coordinate in the parent widget.

Same as mapToGlobal() if the widget has no parent.

See also

mapFromParent(), mapTo(), mapToGlobal(), underMouse()

Returns the mask currently set on a widget. If no mask is set the return value will be an empty region.

See also

setMask(), clearMask(), QRegion::isEmpty()

Returns the value of the maximumHeight property.

Returns the value of the maximumSize property.

Returns the value of the maximumWidth property.

Internal implementation of the virtual QPaintDevice::metric() method. The value for metric is the metric to get.

Reimplemented from QPaintDevice::metric()

Returns the value of the minimumHeight property.

Returns the value of the minimumSize property.

Returns the value of the minimumSizeHint property.

Reimplemented in QComboBox::minimumSizeHint(), QInputDialog::minimumSizeHint(), QLineEdit::minimumSizeHint(), QTabBar::minimumSizeHint(), QTabWidget::minimumSizeHint(), QAbstractSpinBox::minimumSizeHint(), QCalendarWidget::minimumSizeHint(), QLabel::minimumSizeHint(), QProgressBar::minimumSizeHint(), QMdiArea::minimumSizeHint(), QAbstractScrollArea::minimumSizeHint(), QSplitter::minimumSizeHint(), QMenuBar::minimumSizeHint(), QGroupBox::minimumSizeHint(), QToolButton::minimumSizeHint(), QMdiSubWindow::minimumSizeHint(), QSlider::minimumSizeHint(), QDialog::minimumSizeHint(), QDial::minimumSizeHint(), QCommandLinkButton::minimumSizeHint(), QPushButton::minimumSizeHint(), QCheckBox::minimumSizeHint(), QRadioButton::minimumSizeHint()

Returns the value of the minimumWidth property.

The event handler for the given event can be reimplemented in a subclass to receive mouse double click events for the widget. The default implementation generates a normal mouse press event.

Note

The widget will also receive mouse press and mouse release events in addition to the double click event. It is up to the developer to ensure that the application interprets these events correctly.

See also

mousePressEvent(), mouseReleaseEvent(), mouseMoveEvent(), event(), QMouseEvent

Reimplemented in QMdiSubWindow::mouseDoubleClickEvent(), QAbstractItemView::mouseDoubleClickEvent(), QTextEdit::mouseDoubleClickEvent(), QGraphicsView::mouseDoubleClickEvent(), QPlainTextEdit::mouseDoubleClickEvent(), QLineEdit::mouseDoubleClickEvent(), QHeaderView::mouseDoubleClickEvent(), QTreeView::mouseDoubleClickEvent(), QWebView::mouseDoubleClickEvent(), QAbstractScrollArea::mouseDoubleClickEvent()

Returns the widget that is currently grabbing the mouse input. If no widget in this application is currently grabbing the mouse a nullptr is returned.

See also

grabMouse(), keyboardGrabber()

This given event can be reimplemented in a subclass to receive mouse move events for the widget. If mouse tracking is switched off, mouse move events only occur if a mouse button is pressed while the mouse is being moved. If mouse tracking is switched on, mouse move events occur even if no mouse button is pressed.

QMouseEvent::pos() reports the position of the mouse cursor, relative to this widget. For press and release events, the position is usually the same as the position of the last mouse move event, but it might be different if the user's hand shakes. This is a feature of the underlying window system, not CopperSpice.

If you want to show a tooltip immediately, while the mouse is moving (e.g., to get the mouse coordinates with QMouseEvent::pos() and show them as a tooltip), you must first enable mouse tracking as described above. Then, to ensure that the tooltip is updated immediately, you must call QToolTip::showText() instead of setToolTip() in your implementation of mouseMoveEvent().

See also

setMouseTracking(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), event(), QMouseEvent

Reimplemented in QMdiSubWindow::mouseMoveEvent(), QAbstractItemView::mouseMoveEvent(), QTextEdit::mouseMoveEvent(), QGraphicsView::mouseMoveEvent(), QPlainTextEdit::mouseMoveEvent(), QLineEdit::mouseMoveEvent(), QHeaderView::mouseMoveEvent(), QMenu::mouseMoveEvent(), QTabBar::mouseMoveEvent(), QTreeView::mouseMoveEvent(), QListView::mouseMoveEvent(), QAbstractSpinBox::mouseMoveEvent(), QWebView::mouseMoveEvent(), QLabel::mouseMoveEvent(), QAbstractButton::mouseMoveEvent(), QSplitterHandle::mouseMoveEvent(), QTextBrowser::mouseMoveEvent(), QAbstractScrollArea::mouseMoveEvent(), QMenuBar::mouseMoveEvent(), QGroupBox::mouseMoveEvent(), QSlider::mouseMoveEvent(), QDial::mouseMoveEvent(), QCheckBox::mouseMoveEvent(), QScrollBar::mouseMoveEvent(), QRadioButton::mouseMoveEvent(), QSizeGrip::mouseMoveEvent()

The event handler for the given event can be reimplemented in a subclass to receive mouse press events for the widget.

If you create new widgets in the mousePressEvent() the mouseReleaseEvent() may not end up where you expect, depending on the underlying window system (or X11 window manager), the widgets' location and maybe more.

The default implementation implements the closing of popup widgets when you click outside the window. For other widget types it does nothing.

See also

mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent

Reimplemented in QMdiSubWindow::mousePressEvent(), QAbstractItemView::mousePressEvent(), QTextEdit::mousePressEvent(), QGraphicsView::mousePressEvent(), QPlainTextEdit::mousePressEvent(), QComboBox::mousePressEvent(), QLineEdit::mousePressEvent(), QHeaderView::mousePressEvent(), QDateTimeEdit::mousePressEvent(), QMenu::mousePressEvent(), QTabBar::mousePressEvent(), QCalendarWidget::mousePressEvent(), QTreeView::mousePressEvent(), QAbstractSpinBox::mousePressEvent(), QWebView::mousePressEvent(), QLabel::mousePressEvent(), QAbstractButton::mousePressEvent(), QSplitterHandle::mousePressEvent(), QTextBrowser::mousePressEvent(), QToolButton::mousePressEvent(), QMenuBar::mousePressEvent(), QAbstractScrollArea::mousePressEvent(), QGroupBox::mousePressEvent(), QSlider::mousePressEvent(), QDial::mousePressEvent(), QSplashScreen::mousePressEvent(), QScrollBar::mousePressEvent(), QSizeGrip::mousePressEvent()

TThis given event can be reimplemented in a subclass to receive mouse release events for the widget.

See also

mousePressEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent

Reimplemented in QMdiSubWindow::mouseReleaseEvent(), QAbstractItemView::mouseReleaseEvent(), QTextEdit::mouseReleaseEvent(), QGraphicsView::mouseReleaseEvent(), QPlainTextEdit::mouseReleaseEvent(), QComboBox::mouseReleaseEvent(), QLineEdit::mouseReleaseEvent(), QHeaderView::mouseReleaseEvent(), QMenu::mouseReleaseEvent(), QTabBar::mouseReleaseEvent(), QTreeView::mouseReleaseEvent(), QListView::mouseReleaseEvent(), QAbstractSpinBox::mouseReleaseEvent(), QWebView::mouseReleaseEvent(), QLabel::mouseReleaseEvent(), QAbstractButton::mouseReleaseEvent(), QSplitterHandle::mouseReleaseEvent(), QTextBrowser::mouseReleaseEvent(), QToolButton::mouseReleaseEvent(), QAbstractScrollArea::mouseReleaseEvent(), QMenuBar::mouseReleaseEvent(), QGroupBox::mouseReleaseEvent(), QSlider::mouseReleaseEvent(), QDial::mouseReleaseEvent(), QScrollBar::mouseReleaseEvent(), QSizeGrip::mouseReleaseEvent()

Sets the value of the pos property to point.

Sets the value of the pos property to x, y.

This event handler can be reimplemented in a subclass to receive widget move events which are passed in the event parameter. When the widget receives this event, it is already at the new position.

The old position is accessible through QMoveEvent::oldPos().

See also

resizeEvent(), event(), move(), QMoveEvent

Reimplemented in QMdiSubWindow::moveEvent(), QRubberBand::moveEvent(), QSizeGrip::moveEvent()

This special event handler can be reimplemented in a subclass to receive native platform events identified by eventType which are passed in the message parameter.

In your reimplementation of this method, if you want to stop the event being handled by CopperSpice, return true and set result. If you return false this native event is passed back to CopperSpice, which translates the event into a CopperSpice event and sends it to the widget.

This method supersedes the event filter methods x11Event(), winEvent(), and macEvent().

Note

Events are only delivered to this event handler if the widget is has a native Window handle.

Reimplemented in QWizard::nativeEvent()

Returns the native parent for this widget. This is the next ancestor widget that has a system identifier or nullptr if it does not have any native parent.

See also

effectiveWinId()

Returns the next widget in this widget's focus chain.

See also

previousInFocusChain()

Returns the value of the normalGeometry property.

Sets the window flags for the widget to flags, without telling the window system.

See also

setWindowFlags()

Returns the widget's paint engine.

This method should not be called explicitly by the user, since it is meant for reimplementation purposes only. The method is called by CopperSpice internally, and the default implementation may not always return a valid pointer.

Implements QPaintDevice::paintEngine()

Reimplemented in QGLWidget::paintEngine()

This event handler can be reimplemented in a subclass to receive paint events passed in event. A paint event is a request to repaint all or part of a widget. It can happen for one of the following reasons.

• repaint() or update() was invoked
• widget was obscured and has now been uncovered
• some other reason

Many widgets can simply repaint their entire surface when asked to, but some slow widgets need to optimize by painting only the requested region: QPaintEvent::region(). This speed optimization does not change the result, as painting is clipped to that region during event processing. QListView and QTableView do this, for example.

CopperSpice also tries to speed up painting by merging multiple paint events into one. When update() is called several times or the window system sends several paint events, CopperSpice merges these events into one event with a larger region (see QRegion::united()). The repaint() method does not permit this optimization, so we suggest using update() whenever possible.

When the paint event occurs, the update region has normally been erased, so you are painting on the widget's background. The background can be set using setBackgroundRole() and setPalette().

QWidget automatically double-buffers its painting, so there is no need to write double-buffering code in paintEvent() to avoid flicker.

For the X11 platform it is possible to toggle global double buffering by calling qt_x11_set_global_double_buffer().

Generally you should refrain from calling update() or repaint() inside a paintEvent(). For example, calling update() or repaint() on children inside a paintevent() results in undefined behavior; the child may or may not get a paint event.

Warning

If you are using a custom paint engine without the CopperSpice backingstore, Qt::WA_PaintOnScreen must be set. Otherwise, QWidget::paintEngine() will never be called; the backingstore will be used instead.

See also

event(), repaint(), update(), QPainter, QPixmap, QPaintEvent

Reimplemented in QMdiArea::paintEvent(), QMdiSubWindow::paintEvent(), QAbstractButton::paintEvent(), QGLWidget::paintEvent(), QTextEdit::paintEvent(), QGraphicsView::paintEvent(), QPlainTextEdit::paintEvent(), QComboBox::paintEvent(), QLineEdit::paintEvent(), QMenu::paintEvent(), QHeaderView::paintEvent(), QDateTimeEdit::paintEvent(), QListView::paintEvent(), QTabBar::paintEvent(), QWizard::paintEvent(), QTreeView::paintEvent(), QTabWidget::paintEvent(), QToolBar::paintEvent(), QAbstractSpinBox::paintEvent(), QTableView::paintEvent(), QLabel::paintEvent(), QWebView::paintEvent(), QSplitterHandle::paintEvent(), QLCDNumber::paintEvent(), QProgressBar::paintEvent(), QTextBrowser::paintEvent(), QDockWidget::paintEvent(), QFrame::paintEvent(), QToolButton::paintEvent(), QMenuBar::paintEvent(), QAbstractScrollArea::paintEvent(), QGroupBox::paintEvent(), QOpenGLWidget::paintEvent(), QSlider::paintEvent(), QDial::paintEvent(), QPushButton::paintEvent(), QStatusBar::paintEvent(), QRubberBand::paintEvent(), QCheckBox::paintEvent(), QSvgWidget::paintEvent(), QCommandLinkButton::paintEvent(), QScrollBar::paintEvent(), QFocusFrame::paintEvent(), QRadioButton::paintEvent(), QSizeGrip::paintEvent()

Returns the value of the palette property.

Returns the parent of this widget or nullptr if it does not have any parent widget.

Returns the value of the pos property.

Returns the previous widget in this widget's focus chain.

See also

nextInFocusChain()

Raises this widget to the top of the parent widget's stack. After this call the widget will be visually in front of any overlapping sibling widgets.

When using activateWindow() you can call this method to ensure that the window is stacked on top.

See also

lower(), stackUnder()

Returns the value of the rect property.

Releases the keyboard grab.

See also

grabKeyboard(), grabMouse(), releaseMouse()

Releases the mouse grab.

See also

grabMouse(), grabKeyboard(), releaseKeyboard()

Removes the shortcut with the given id from the CopperSpice shortcut system. The widget will no longer receive QEvent::Shortcut events for the shortcut's key sequence (unless it has other shortcuts with the same key sequence).

Warning

You should not normally need to use this method since the CopperSpice shortcut system removes shortcuts automatically when their parent widget is destroyed. It is better to use QAction or QShortcut to handle shortcuts, since they are easier to use than this low-level method. This is an expensive operation.

See also

grabShortcut(), setShortcutEnabled()

Removes the given action from this widget's list of actions.

See also

insertAction(), actions(), insertAction()

Renders the sourceRegion of this widget into the target using renderFlags to determine how to render. Rendering starts at targetOffset in the target.

If sourceRegion is a null region this method will use QWidget::rect() as the region. Ensure that you call QPainter::end() for the target device's active painter (if any) before rendering.

Note

To obtain the contents of an OpenGL widget, use QGLWidget::grabFrameBuffer() or QGLWidget::renderPixmap() instead.

Renders the widget into the painter's QPainter::device(). Transformations and settings applied to the painter will be used when rendering.

Note

The painter object must be active. On Mac OS X the widget will be rendered into a QPixmap and then drawn by the painter.

See also

QPainter::device()

Repaints the widget directly by calling paintEvent() immediately, unless updates are disabled or the widget is hidden. We suggest only using repaint() if you need an immediate repaint, for example during animation. In almost all circumstances update() is better, as it permits CopperSpice to optimize for speed and minimize flicker.

Warning

If you call repaint() in a method which can be called from paintEvent(), you may experience and infinite recursion. The update() method never causes recursion.

See also

update(), paintEvent(), setUpdatesEnabled()

This method repaints the given rectangle rect inside the widget.

This method repaints the given region inside the widget.

This methods repaints a rectangle (x, y, w, h) inside the widget.

If w is negative, it is replaced with width() - x, and if h is negative, it is replaced width height() - y.

Returns the value of the size property.

Sets the value of the size property to w, h.

This event handler can be reimplemented in a subclass to receive widget resize events which are passed in the event parameter. When resizeEvent() is called, the widget already has its new geometry. The old size is accessible through QResizeEvent::oldSize().

The widget will be erased and receive a paint event immediately after processing the resize event. No drawing need be (or should be) done inside this handler.

See also

moveEvent(), event(), resize(), QResizeEvent, paintEvent()

Reimplemented in QMdiArea::resizeEvent(), QMdiSubWindow::resizeEvent(), QAbstractItemView::resizeEvent(), QGLWidget::resizeEvent(), QTextEdit::resizeEvent(), QGraphicsView::resizeEvent(), QPlainTextEdit::resizeEvent(), QComboBox::resizeEvent(), QMessageBox::resizeEvent(), QTabBar::resizeEvent(), QListView::resizeEvent(), QCalendarWidget::resizeEvent(), QWizard::resizeEvent(), QTabWidget::resizeEvent(), QAbstractSpinBox::resizeEvent(), QWebView::resizeEvent(), QSplitterHandle::resizeEvent(), QMenuBar::resizeEvent(), QSplitter::resizeEvent(), QDialog::resizeEvent(), QAbstractScrollArea::resizeEvent(), QGroupBox::resizeEvent(), QDesktopWidget::resizeEvent(), QOpenGLWidget::resizeEvent(), QColumnView::resizeEvent(), QDial::resizeEvent(), QScrollArea::resizeEvent(), QStatusBar::resizeEvent(), QRubberBand::resizeEvent(), QWebInspector::resizeEvent()

Restores the geometry and state top-level widgets stored in the byte array geometry. Returns true on success, otherwise returns false.

If the restored geometry is off-screen, it will be modified to be inside the available screen geometry.

To restore geometry saved using QSettings, you can use code like this:

Refer to Window Geometry documentation for an overview of geometry issues with windows.

Use QMainWindow::restoreState() to restore the geometry and the state of toolbars and dock widgets.

See also

saveGeometry(), QSettings, QMainWindow::saveState(), QMainWindow::restoreState()

Saves the current geometry and state for top-level widgets. To save the geometry when the window closes, you can implement a close event as shown below.

Use QMainWindow::saveState() to save the geometry and the state of toolbars and dock widgets.

Refer to Window Geometry documentation for an overview of geometry issues with windows.

See also

restoreGeometry(), QMainWindow::saveState(), QMainWindow::restoreState()

Scrolls the widget including its children dx pixels to the right and dy downward. Both dx and dy may be negative.

After scrolling, the widgets will receive paint events for the areas that need to be repainted. For widgets that CopperSpice knows to be opaque, this is only the newly exposed parts. For example, if an opaque widget is scrolled 8 pixels to the left, only an 8-pixel wide stripe at the right edge needs updating.

Since widgets propagate the contents of their parents by default, you need to set the autoFillBackground property, or use setAttribute() to set the Qt::WA_OpaquePaintEvent attribute, to make a widget opaque.

For widgets that use contents propagation, a scroll will cause an update of the entire scroll area.

This method only scrolls rect and does not move the children of the widget. If rect is empty or invalid the result is undefined.

See also

QScrollArea

Sets the value of the acceptDrops property to on.