SetProperty Method
Sets the value of a specific Atom feed property.
Syntax
int SetProperty(const QString& qsPropertyName, const QString& qsPropertyValue);
Remarks
This method is intended for extending functionality of the Atom class. It will set the value for a specific field of this Atom feed. Property is the name of the property according to the following convention: root/element@attribute. The root field can be either of the two following values:
| feed | This treats the channel as the root level, and element is any property of the channel. If an empty string ("") is supplied for the root field, the class will assume channel as the root. |
| entry[x] | This treats the channel's x-th entry as the root level The field element is any property of an entry. |
The element field can be any property of the root field, and attribute can be any property of that field. If an attribute is not supplied, Value will be placed in the text portion of element. For example:
AtomControl.SetProperty("entry[5]/link@type", "text/html")
Note: in order to add non-standard fields (i.e. fields that are not defined in the Atom specification), element must be prefixed with a namespace that defines that field. The same applies for the attribute field. Use the Namespaces properties to define and list namespaces.
Error Handling
This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)