From 3b9bc548c2a5c705895c294e6618fcae901ee347 Mon Sep 17 00:00:00 2001
From: nyamatongwe
SCI_GETCHARACTERPOINTER
- This moves the gap within Scintilla so that the text of the document is stored consecutively
- and ensures there is a NUL character after the text, then returns a pointer to the first character.
+ Move the gap within Scintilla so that the text of the document is stored consecutively
+ and ensure there is a NUL character after the text, then return a pointer to the first character.
Applications may then pass this to a function that accepts a character pointer such as a regular
expression search or a parser. The pointer should not be written to as that may desynchronize
- the internal state of Scintilla.
Since any action in Scintilla may change its internal state this pointer becomes invalid after any call or by allowing user interface activity. The application - should reacquire the pointer after making any call or performing any user-interface calls such + should reacquire the pointer after making any call to Scintilla or performing any user-interface calls such as modifying a progress indicator.
This call takes similar time to inserting a character at the end of the document and this may include moving the document contents. Specifically, all the characters after the document gap -- cgit v1.2.3