Monkeybread Software - MBS FileMaker Plugin: App.SetDockBadgeLabel

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: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

App.SetDockBadgeLabel

Sets the string to be displayed in the tile's badging area.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
App	2.6	Yes	No	No	No	Yes

MBS( "App.SetDockBadgeLabel"; text ) More

(old name: AppDockTile.setBadgeLabel)

Parameters

Parameter Description Example

text The localized string to display. This string can contain a count value or other badging information. To clear the badge string, specify an empty string "". "123"

Parameter	Description	Example
text	The localized string to display. This string can contain a count value or other badging information. To clear the badge string, specify an empty string "".	"123"

Result

Returns OK on success.

Description

Sets the string to be displayed in the tile's badging area.
The appearance of the badge area is system defined.
Available in macOS v10.5 and later.

iOS added in 7.2, but the badge is a number.

Examples

Set and query dock badge:

Set Variable [$r; Value:MBS( "App.SetDockBadgeLabel"; "123" )]
Show Custom Dialog [MBS( "App.GetDockBadgeLabel" )]

Blog Entries

Release notes

Version 10.5
- Improved App.GetDockBadgeLabel and App.SetDockBadgeLabel for iOS to not cause warning message.
Version 7.2
- Implemented App.SetDockBadgeLabel and App.GetDockBadgeLabel for iOS.

Created 18th August 2014, last changed 10th August 2020

App.RequestUserAttention - App.SetDockIcon

Feedback: Report problem or ask question.