Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

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

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