diff -r 913c9751c067 -r 716254ccbcc0 org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-270C6C2A-5EBB-4ACC-A231-064F17E85F4A.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-270C6C2A-5EBB-4ACC-A231-064F17E85F4A.html Fri Mar 05 19:11:15 2010 -0800 @@ -0,0 +1,110 @@ + + +
Description:
+The Delete
method deletes a calendar from the device
+or one or more entries from a calendar. Entries are deleted from the specified
+calendar or, if no calendar is specified, from the default one.
For deleting a calendar, this method is called synchronously. For deleting +calendar entries, this method can be called both synchronously and asynchronously.
+Syntax:
+For synchronous calls:
+result = so.IDataSource.Delete(criteria);+ +
For asynchronous calls:
+result = so.IDataSource.Delete(criteria, callback);+ +
Arguments:
+criteria
:
This is an object that specifies which calendar or calendar entries +to delete. For more information about the object properties and how to define +them, see section Criteria for deleting calendar information.
+ +callback
:
The callback
argument is the name of the method
+that is executed when an asynchronous Delete
call has
+results or status information to return. You must define this method separately.
+Follow the instructions in section Defining the callback handler for an asynchronous method to
+define the callback
method.
This argument is used only with an asynchronous Delete
call.
Return value:
+If synchronous, the Delete
method returns an object
+that contains an error code and an error message.
If asynchronous, the method returns an object that contains a transaction
+ID for the callback
instance,
+an error code, and an error message. When the asynchronous call has completed, callback
returns
+an object that contains an error code and an error message (see Table: Callback return value).
+ Property + |
+ Description + |
+ Value + |
---|---|---|
+
|
+
+ This is a number used as an identification to match transactions started
+with an asynchronous This property is only valid for asynchronous calls. + |
++ |
+
|
+
+ This is a number that specifies a predefined error code. + |
++ + | +
+
|
+
+ This is a text string that describes the error. + |
++ + | +
Remarks:
+The default calendar cannot be deleted.
To delete a calendar or entries from a calendar, the corresponding +calendar file must exist on the device.
Example code:
+ +For the complete source of a sample widget +that demonstrates how to use this Service API, see the full example.
+ + + + +