Topics
All
MacOS
(Only)
Windows
(Only)
Linux
(Only, Not)
iOS
(Only, Not)
Components
Crossplatform Mac & Win
Server
Client
Old
Deprecated
Guides
Examples
Videos
New in version:
12.2
12.3
12.4
12.5
13.0
13.1
13.2
13.3
13.4
13.5
Statistic
FMM
Blog
App.RequestUserAttention
Starts a user attention request.
Component |
Version |
macOS |
Windows |
Linux |
Server |
iOS SDK |
App
|
6.1 |
✅ Yes |
❌ No |
❌ No |
❌ No |
❌ No |
MBS( "App.RequestUserAttention" { ; Critical } )
More
MBS(
"App.RequestUserAttention"; /* Starts a user attention request. */
$Critical) /* Optional; Pass 1 if critical or 0 if informative.e.g. 0 */
Less
Parameters
Parameter |
Description |
Example |
Flags |
Critical |
Pass 1 if critical or 0 if informative. |
0 |
Optional |
Result
Returns number or error.
Description
Starts a user attention request.
Returns the identifier for the request. You can use this value to cancel the request later using the App.CancelUserAttentionRequest method.
Activating the app cancels the user attention request. A spoken notification will occur if spoken notifications are enabled. Sending App.RequestUserAttention to an app that is already active has no effect.
If the inactive app presents a modal panel, this method will be invoked with critical = 1 automatically. The modal panel is not brought to the front for an inactive app.
This method is a way to have the dock icon jumping.
Examples
Request attention:
Set Variable [$r; Value:MBS( "App.RequestUserAttention"; 1 )]
See also
Example Databases
Blog Entries
This function checks for a license.
Created 2nd March 2016, last changed 2nd March 2016
App.ProcessID
-
App.SetDockBadgeLabel