Thursday, December 22, 2005

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

NETCF | Windows Mobile

Comments are closed.