| 1 | /* |
| 2 | This file is part of the KDE libraries |
| 3 | SPDX-FileCopyrightText: 2003 Luboš Luňák <l.lunak@kde.org> |
| 4 | |
| 5 | SPDX-License-Identifier: LGPL-2.1-or-later |
| 6 | */ |
| 7 | |
| 8 | #ifndef KUSERTIMESTAMP_H |
| 9 | #define KUSERTIMESTAMP_H |
| 10 | |
| 11 | #include <kwindowsystem_export.h> |
| 12 | |
| 13 | /*! |
| 14 | * \namespace KUserTimestamp |
| 15 | * \inmodule KWindowSystem |
| 16 | */ |
| 17 | namespace KUserTimestamp |
| 18 | { |
| 19 | /*! |
| 20 | * Returns the last user action timestamp or 0 if no user activity has taken place yet. |
| 21 | * \sa updateuserTimestamp |
| 22 | */ |
| 23 | KWINDOWSYSTEM_EXPORT unsigned long userTimestamp(); |
| 24 | |
| 25 | /*! |
| 26 | * Updates the last user action timestamp to the given time, or to the current time, |
| 27 | * if 0 is given. Do not use unless you're really sure what you're doing. |
| 28 | * Consult focus stealing prevention section in kdebase/kwin/README. |
| 29 | */ |
| 30 | KWINDOWSYSTEM_EXPORT void updateUserTimestamp(unsigned long time = 0); |
| 31 | } |
| 32 | |
| 33 | #endif |
| 34 | |