App.RequestUserAttention
------------------------

Starts a user attention request.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [App](component_App.md) | [6.1](newinversion61.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |

MBS( "App.RequestUserAttention" { ; Critical } ) 

**MBS**( **"App.RequestUserAttention";** /\* Starts a user attention request. \*/  
**$Critical**) /\* Optional; Pass 1 if critical or 0 if informative.e.g. 0 \*/ 

### 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](AppCancelUserAttentionRequest.md) 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

- [App.CancelUserAttentionRequest](AppCancelUserAttentionRequest.md)

### Example Databases

- [Window/Flash Window and Jump Dock](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Window/Flash%20Window%20and%20Jump%20Dock.shtml#2ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin 6.1 für OS X/Windows](https://www.mbsplugins.de/archive/2016-03-08/MBS_FileMaker_Plugin_61_fuuml;/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plug-in 6.1 for OS X/Windows](https://www.mbsplugins.de/archive/2016-03-08/MBS_FileMaker_Plug-in_61_for_O/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 6.1pr4](https://www.mbsplugins.de/archive/2016-03-03/MBS_FileMaker_Plugin_version_6/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 2nd March 2016 , last changed 2nd March 2016

  
[App.ProcessID](AppProcessID.md) - [App.SetDockBadgeLabel](AppSetDockBadgeLabel.md)

[HTML Version](AppRequestUserAttention.shtml)