Clarify RequestUserAttention() behaviour under wxGTK

Document that this function may not have any effect even though it is
implemented because it also requires run-time support.

Closes #26593.

Co-authored-by: Vadim Zeitlin <vadim@wxwidgets.org>
This commit is contained in:
songjin
2026-06-16 00:06:55 +02:00
committed by Vadim Zeitlin
co-authored by Vadim Zeitlin
parent a66bf5d897
commit 192eb68e05
+5 -4
View File
@@ -384,10 +384,11 @@ public:
@note This function should normally be only used when the application
is not already in foreground.
This function is currently implemented for Win32 where it flashes
the window icon in the taskbar, and for wxGTK with task bars
supporting it.
This function is currently implemented under Windows where it flashes
the window icon in the taskbar, and in wxGTK, but its behaviour there
depends on support from the desktop environment or window manager: if
the current environment does not support window urgency hints, calling
this function has no visible effect.
*/
virtual void RequestUserAttention(int flags = wxUSER_ATTENTION_INFO);