This function pastes an entire source text document specified by text_doc2 into the active selection of the destination text document specified by text_doc, replacing any currently selected text.
Parameter | Description |
---|---|
text_doc |
Handle of the associated text document instance. This is the destination text document. |
text_doc2 |
Handle of the text document to be pasted. This is the source text document. |
paste_flags |
A set of bit values to fine tune the behavior of the function.
|
If the function was successful, the return value will be the number of pasted characters. Otherwise, the function returns -1. The function will also return -1 if there are multiple (non-contiguous) or block (rectangular) active selections in the text document.
This function makes it possible to insert another text document into the active selection of the current text document. The source text can be styled/formatted if required. It is expected that the source text document will represent at least a single paragraph of Unicode text when paste_flags is set to 0.
In order to view the modified text document it is necessary to subsequently call the txTextDraw function.