Tk_GetUserInactiveTime(3tk)

πŸ“¦
version 9.0.4 Β· 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ Tk_GetUserInactiveTime β€” the manual page, but make it cute ✨

okay so bestie, welcome to the Tk Library Procedures section of the man pages πŸ’– this one's about Tk_GetUserInactiveTime and Tk_ResetUserInactiveTime, and their whole entire job is discovering the user inactivity time πŸ‘‘ like, how long has it been since your human last touched a key or wiggled a mouse. iconic behaviour tbh.


🌸 NAME 🌸

Tk_GetUserInactiveTime, Tk_ResetUserInactiveTime β€” discover user inactivity time ✨


πŸŽ€ SYNOPSIS πŸŽ€

#include <tk.h>

long
Tk_GetUserInactiveTime(display)

Tk_ResetUserInactiveTime(display)

πŸ’… ARGUMENTS πŸ’…

  • Display *display (in) β€” the display whose user inactivity timer is getting queried or reset. that's it, that's the whole arg 🫢

πŸ¦‹ DESCRIPTION πŸ¦‹

Tk_GetUserInactiveTime returns the number of milliseconds that have passed since the last user interaction (usually via keyboard or mouse) with the respective display. so like, the longer the number, the longer your user has been ignoring you 😭

On systems and displays that do not support querying the user inactivity time, -1 is returned. no cap, that's your "bestie I literally cannot tell you" signal πŸ’€

Tk_ResetUserInactiveTime resets the user inactivity timer of the given display to zero. back to the starting line, fresh slate, main character energy 🌈

On windowing systems that do not support multiple displays, display can be passed as NULL. so if your system is a one-display-only kinda situation, NULL is totally fine to hand over ✨

⭐ KEYWORDS ⭐

idle, inactive


and that's the whole page bestie, you ate that πŸ“ go forth and query those inactivity timers with confidence, periodt πŸ’…

signing off with love β€” this one comes from Tk 8.5, dated back in the day, page Tk_GetUserInactiveTime(3tk) πŸŽ€

πŸ“¦ where this page comes from