Calendar.Item.SetPriority
-------------------------

Sets the priority of a task/reminder.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Calendar](component_Calendar.md) | [3.4](newinversion34.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |

### Deprecated

This function was [deprecated](deprecated.md).

MBS( "Calendar.Item.SetPriority"; reminderRef; Value ) 

**MBS**( **"Calendar.Item.SetPriority";** /\* Sets the priority of a task/reminder. \*/  
**$reminderRef**; /\* The reference to the reminder. \*/   
**$Value**) /\* The new priority level. \*/ 

### 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

- [Calendar.Item.GetPriority](CalendarItemGetPriority.md)
- [Calendar.Item.SetDueDate](CalendarItemSetDueDate.md)
- [Calendar.Item.SetEndDate](CalendarItemSetEndDate.md)
- [Calendar.Item.SetLocation](CalendarItemSetLocation.md)
- [Calendar.NewReminder](CalendarNewReminder.md)
- [Calendar.SaveReminder](CalendarSaveReminder.md)

### Blog Entries

- [Todo/Reminder Synchronization for FileMaker on Mac using MBS Plugin](https://www.mbsplugins.de/archive/2016-09-22/TodoReminder_Synchronization_f/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

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

  
[Calendar.Item.SetNotes](CalendarItemSetNotes.md) - [Calendar.Item.SetStartDate](CalendarItemSetStartDate.md)

[HTML Version](CalendarItemSetPriority.shtml)