Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous

Overview Module Use Devguide Index
Methods' Summary Attributes' Summary Methods' Details Attributes' Details

:: com :: sun :: star :: xml :: dom ::

interface XCharacterData
Base Interfaces
XCharacterData
┗ XNode
XNode
(referenced interface's summary:)
The primary dom datatype
Methods' Summary
appendData Append the string to the end of the character data of the node. Throws: DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.  
deleteData Remove a range of 16-bit units from the node. Throws: DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative. NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.  
getData Return the character data of the node that implements this interface. Throws: DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. DOMException - DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform.  
getLength The number of 16-bit units that are available through data and the substringData method below.  
insertData Insert a string at the specified 16-bit unit offset. Throws: DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data. NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.  
replaceData Replace the characters starting at the specified 16-bit unit offset with the specified string. Throws; DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative. NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.  
setData Set the character data of the node that implements this interface. Throws: DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. DOMException - DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform.  
subStringData Extracts a range of data from the node. Throws: DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative. DOMSTRING_SIZE_ERR: Raised if the specified range of text does not fit into a DOMString.  
Methods' Details
appendData
void
appendData( [in] string  arg )
raises( DOMException );
Description
Append the string to the end of the character data of the node. Throws: DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
deleteData
void
deleteData( [in] long  offset,
[in] long  count )
raises( DOMException );
Description
Remove a range of 16-bit units from the node. Throws: DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative. NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
getData
string
getData()
raises( DOMException );
Description
Return the character data of the node that implements this interface. Throws: DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. DOMException - DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform.
getLength
long
getLength();
Description
The number of 16-bit units that are available through data and the substringData method below.
insertData
void
insertData( [in] long  offset,
[in] string  arg )
raises( DOMException );
Description
Insert a string at the specified 16-bit unit offset. Throws: DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data. NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
replaceData
void
replaceData( [in] long  offset,
[in] long  count,
[in] string  arg )
raises( DOMException );
Description
Replace the characters starting at the specified 16-bit unit offset with the specified string. Throws; DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative. NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
setData
void
setData( [in] string  data )
raises( DOMException );
Description
Set the character data of the node that implements this interface. Throws: DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. DOMException - DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform.
subStringData
string
subStringData( [in] long  offset,
[in] long  count )
raises( DOMException );
Description
Extracts a range of data from the node. Throws: DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative. DOMSTRING_SIZE_ERR: Raised if the specified range of text does not fit into a DOMString.
Top of Page

Copyright © 2013, The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache, the Apache feather logo, Apache OpenOffice and OpenOffice.org are trademarks of The Apache Software Foundation. Other names may be trademarks of their respective owners.

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.