PocketOutlook Native Managed Map

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


· Logon


Automatically handled


· Logoff


Automatic – call Dispose on your OutlookSession when finished


· get_Version


Not Supported – Get OS version with System.Environment.OSVersion.Version


· GetDefaultFolder


Use strongly typed folder properties – Appointments, Contacts & Tasks


Infrared not supported


· CreateItem


Use default constructor for specific item type


· GetItemFromOid


Use constructor for item which accepts an ItemId e.g.


new Contact(new ItemId(oid)


· City Methods (Removed in Pocket PC 2002)


Obsolete


· ReceiveFromInfrared (Obsolete from Pocket PC 2002)


Obsolete


· get_OutlookCompatible


Obsolete


· GetTimeZoneFromIndex


Not Supported


IFolder


Folder – AppointmentFolder, ContactFolder, TaskFolder


Infrared not supported


· get_Items


Items


· get_DefaultItemType


N/A inferred from the Folder type


· get_Application


N/A


· AddItemToInfraredFolder


Not Supported


· SendToInfrared


Not Supported


· ReceiveFromInfrared


Not Supported


IPOutlookItemCollection


PimItemCollection – AppointmentCollection, ContactCollection, TaskCollection


· Add


Add


· get_Count


Count


· Find


Find (Requires a PropertyDescriptor)


· FindNext


Not Supported


· Item


· 1-based index


Default indexer – () VB or [] C#


0-based index


· Remove


RemoveAt – also implements Remove(PimItem)


· Restrict


Restrict


· Sort


Sort


· get_IncludeRecurrences


Not Supported


· put_IncludeRecurrences


Not Supported


IAppointment


Appointment


· ClearRecurrencePattern


Call Clear on the AppointmentRecurrence


· GetRecurrencePattern


RecurrencePattern


· get_* / put_*


Accessible by named properties or via Ids through the Properties collection


· Save


Update


· Send


Send


· Delete


Delete


· Cancel


Cancel


· Copy


Copy


· Display


ShowDialog


· get_Oid


ItemId


· get_BodyInk / put_BodyInk


BodyInk no longer supported on WM5.0


IContact


Contact


· get_* / put_*


Accessible by named properties or via Ids through the Properties collection


· Save


Update


· Delete


Delete


· Copy


Copy


· Display


ShowDialog


· get_Oid


ItemId


· get_BodyInk / put_BodyInk


BodyInk no longer supported on WM5.0


ITask


Task


· ClearRecurrencePattern


Call Clear on the TaskRecurrence


· GetRecurrencePattern


RecurrencePattern


· get_* / put_*


Accessible by named properties or via Ids through the Properties collection


· Save


Update


· Delete


Delete


· SkipRecurrence


Call Skip on the TaskRecurrence


· Copy


Copy


· Display


ShowDialog


· get_Oid


ItemId


· get_BodyInk / put_BodyInk


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