void |
insertString( |
[in] XTextRange |
xRange, |
| [in] string |
aString, |
| [in] boolean |
bAbsorb ); |
- Description
- inserts a string of characters into the text.
The string may contain the following white spaces:
- blank
- tab
- cr (which will insert a paragraph break)
- lf (which will insert a line break)
- Parameter xRange
- specifies the position of insertion. For example,
XSimpleText::createTextCursor() can be used to
get an XTextRange for this argument.
If the parameter bAbsorb() was `TRUE`
the text range will contain the new inserted string, otherwise
the range (and it's text) will remain unchanged.
- Parameter aString
- specifies the string to insert.
- Parameter bAbsorb
- specifies whether the text spanned by xRange will be
replaced. If `TRUE` then the content of xRange will
be replaced by aString, otherwise aString
will be inserted at the beginning of xRange.
@code{.java}
xText.insertString( xTextCursor, "Hello " + aName + ",", false )
xText.insertControlCharacter( xTextCursor,
ControlCharacter.PARAGRAPH_BREAK, false );
xText.insertString( xTextCursor, "more text ...", false )
@endcode
|