Windows Mobile 5.0 introduces a managed API which wraps both POOM and a subset of CEMAPI (enough to send an Email / Sms). The table below is designed to show how the managed objects map to the interfaces which will be familiar to seasoned POOM developers. It also shows those parts of POOM which are not available through the managed APIs:-
Native | Managed |
IPOutlookApp | OutlookSession |
· | Automatically handled |
· | Automatic – call Dispose on your OutlookSession when finished |
· | Not Supported – Get OS version with System.Environment.OSVersion.Version |
· | Use strongly typed folder properties – Appointments, Contacts & Tasks Infrared not supported |
· | Use default constructor for specific item type |
· | Use constructor for item which accepts an ItemId e.g. new Contact(new ItemId(oid) |
· | Obsolete |
· | Obsolete |
· | Obsolete |
· | Not Supported |
IFolder | Folder – AppointmentFolder, ContactFolder, TaskFolder Infrared not supported |
· | Items |
· | N/A inferred from the Folder type |
· | N/A |
· | Not Supported |
· | Not Supported |
· | Not Supported |
IPOutlookItemCollection | PimItemCollection – AppointmentCollection, ContactCollection, TaskCollection |
· | Add |
· | Count |
· | Find (Requires a PropertyDescriptor) |
· | Not Supported |
· · 1-based index | Default indexer – () VB or [] C# 0-based index |
· | RemoveAt – also implements Remove(PimItem) |
· | Restrict |
· | Sort |
· | Not Supported |
· | Not Supported |
IAppointment | Appointment |
· | Call Clear on the AppointmentRecurrence |
· | RecurrencePattern |
· | Accessible by named properties or via Ids through the Properties collection |
· | Update |
· | Send |
· | Delete |
· | Cancel |
· | Copy |
· | ShowDialog |
· | ItemId |
· | BodyInk no longer supported on WM5.0 |
IContact | Contact |
· | Accessible by named properties or via Ids through the Properties collection |
· | Update |
· | Delete |
· | Copy |
· | ShowDialog |
· | ItemId |
· | BodyInk no longer supported on WM5.0 |
ITask | Task |
· | Call Clear on the TaskRecurrence |
· | RecurrencePattern |
· | Accessible by named properties or via Ids through the Properties collection |
· | Update |
· | Delete |
· | Call Skip on the TaskRecurrence |
· | Copy |
· | ShowDialog |
· | ItemId |
· | BodyInk no longer supported on WM5.0 |
IItem | New in WM5.0 supports access to custom properties etc Functionality is available via Appointment, Contact and Task types |
IRecipients | RecipientCollection Shared with the Email (MAPI) support |
IRecipient | Recipient Shared with the Email (MAPI) support |
IRecurrencePattern | Recurrence – AppointmentRecurrence, TaskRecurrence Properties follow same names as native equivalent. Managed types such as TimeSpan and DateTime are used as appropriate. Enums defined for Months, WeekOfMonth, DaysOfWeek |
IExceptions | Not supported |
IException | Not supported |
ITimeZone | Not supported |