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

Calendar.Item.SetPriority

Sets the priority of a task/reminder.

Component Version macOS Windows Linux Server iOS SDK
Calendar 3.4 ✅ Yes ❌ No ❌ No ❌ No ❌ No
MBS( "Calendar.Item.SetPriority"; reminderRef; value )   More

Parameters

Parameter Description Example
reminderRef The reference to the reminder. $reminderRef
value The new priority level.

Result

Returns error or OK.

Description

Sets the priority of a task/reminder.
The iCalendar specification allows priority to be specified with an integer in the range of 0-9, with 0 representing an undefined priority, 1 the highest priority, and 9 the lowest priority. When a user sets the priority to high, medium or low in iCal saves the priority as 1, 5, or 9 respectively. Clients are encouraged to use these values when setting a task's priority, but is is possible to specify any integer value from 0 to 9. In iCal, a task with a priority in the range of 1-4 will show up as high priority, a task with a priority of 5 will be displayed as having medium priority, and 6-9 will be displayed as having a low priority.

See also

Blog Entries

This function checks for a license.

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


Calendar.Item.SetNotes - Calendar.Item.SetStartDate