> For the complete documentation index, see [llms.txt](https://docs.msgfiler.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.msgfiler.com/shortcuts/set-focused-filing.md).

# Set Focused Filing

Sets focus on filing your messages by dimming the screen and hiding all applications except for MsgFiler 4 and Mail.

| Parameters         | Description                                                                                                                              |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Mode               | Toggles Filing Focus on or off.                                                                                                          |
| On/Off             | Sets Filing Focus to on or off. This appears when Mode is Set.                                                                           |
| Use saved settings | When true, uses the Opacity and Duration settings saved in MsgFiler 4. If set to false, the settings you provide will be used and saved. |
| Opacity            | The amount by which to dim the screen. Specify a value between 0.0 and 1.0.                                                              |
| Duration           | The amount of time to dim the screen when entering or exiting Filing Focus. Specify a value between 0 (instant) and 2.0 seconds.         |

| Returns | Description                                         |
| ------- | --------------------------------------------------- |
| Boolean | True if Filing Focus is activated, false otherwise. |