KToggleFullScreenAction Class
An action for switching between to/from full screen mode. More...
| Header: | #include <KToggleFullScreenAction> |
| CMake: | find_package(KF6 REQUIRED COMPONENTS WidgetsAddons)target_link_libraries(mytarget PRIVATE KF6::WidgetsAddons) |
| Inherits: | KToggleAction |
Public Functions
| KToggleFullScreenAction(QObject *parent) | |
| KToggleFullScreenAction(QWidget *window, QObject *parent) | |
| void | setWindow(QWidget *window) |
Static Public Members
(since 4.0.3) void | setFullScreen(QWidget *window, bool set) |
Detailed Description
Note that QWidget::isFullScreen() may reflect the new or the old state depending on how the action was triggered (by the application or from the window manager). Also don't try to track the window state yourself. Rely on this action's state (isChecked()) instead.
Important: If you need to set/change the fullscreen state manually, use KToggleFullScreenAction::setFullScreen() or a similar function, do not call directly the slot connected to the toggled() signal. The slot still needs to explicitly set the window state though.
Note: Do NOT use QWidget::showFullScreen() or QWidget::showNormal(). They have several side-effects besides just switching the fullscreen state (for example, showNormal() resets all window states, not just fullscreen). Use the KToggleFullScreenAction::setFullScreen() helper function.
Member Function Documentation
[explicit] KToggleFullScreenAction::KToggleFullScreenAction(QObject *parent)
Create a KToggleFullScreenAction. Call setWindow() to associate this action with a window.
parent This action's parent object.
KToggleFullScreenAction::KToggleFullScreenAction(QWidget *window, QObject *parent)
Create a KToggleFullScreenAction
window the window that will switch to/from full screen mode
parent This action's parent object.
[static, since 4.0.3] void KToggleFullScreenAction::setFullScreen(QWidget *window, bool set)
Helper function to set or reset the fullscreen state of a window.
Use this function rather than showFullScreen()/showNormal() QWidget functions.
This function was introduced in 4.0.3.
void KToggleFullScreenAction::setWindow(QWidget *window)
Sets the window that will be related to this action.