POOMTask object

Only after you log in using the general POOM object can you add or remove tasks. The POOMTask object lets you copy and display tasks, and get and set task recurrences, but you must use functions on the general POOM object to add or remove tasks.

Properties

Unless otherwise noted, properties of the String datatype have a limit of 1023 characters, and properties of the Date datatype require values greater than 12/31/1899 and less than 1/1/3000.

POOMTask property	Datatype	Description
Body	String	Specifies annotations for a task in text format. The text limit is 60K. For more information, see the BodyInk property.
BodyInk	Blob	Specifies annotations for a task in a blob in Pocket Word Ink (PWI) format that can be set to an Ink control such as the PocketBuilder Signature control. You must call the Add function on the POOM object to add the task to the repository before you set or get the Body and BodyInk properties. When you set one of these properties, its value is automatically updated in the repository.
Categories	String	Specifies the categories to which a task is assigned.
CompletedDate	Date	Specifies the date when the task was completed.
DueDate	Date	Specifies the date when the task is scheduled to be completed.
Importance	POOMTaskPriority (enumeration)	Specifies the importance or priority of the task. Values are: ImportanceLow! ImportanceNormal! ImportanceHigh!
IsComplete	Boolean	Specifies whether the task is complete. Values are: true – To indicate that the task is complete false – (Default) To indicate that the task is not complete
IsRecurring	Boolean	Indicates whether a task recurs. This is a readonly property that is set if you specify a recurrence pattern.
IsReminderSet	Boolean	Specifies whether the user should be reminded of a task.
IsSensitive	Boolean	Specifies whether the task is private.
IsTeamTask	Boolean	Specifies whether the task is a team task.
OID	Long	Specifies the object identifier for a task. This is a read-only property.
ReminderOptions	Long	Specifies how the reminders for a task are transmitted. Values are: 1 – activates the light-emitting diode (LED) 2 – activates the vibration indicator if one exists 4 – displays a dialog box 8 – plays the sound specified in the ReminderSoundFile property 16 – repeats the reminder Values are additive. For example, a value of 24 specifies that the specified sound file is played and the reminder is repeated.
ReminderSoundFile	String	Specifies the path to a sound file. Can be used only if IsReminderSet is set to true and ReminderOptions property is set.
ReminderTime	DateTime	Specifies the date and time of a reminder for the task.
StartDate	Date	Specifies the date when the task is scheduled to start. A value must be assigned to this property before you can add a task to the POOM repository. (You can add a task by calling Add on the POOM object.)
Subject	String	Specifies the subject for a task. The text limit for the subject is 4095 characters.

Functions

POOMTask function	Datatype returned	Description
ClearRecurrencePattern	Integer	Clears the recurrence pattern for a task and sets it as a task with a single instance.
Display	Integer	Displays the task using the default display in Pocket Outlook or the window specified as an optional argument to the POOM Login function.
GetRecurrence	POOMRecurrence	Returns the POOMRecurrence object associated with the appointment.
SetRecurrence	Integer	Sets a recurrence pattern for a task.
SkipRecurrence	Integer	Moves to the next occurrence in a recurring task.
Update	Integer	Updates the existing task in the repository.