From 3438ec5950c6ff3fcd9d4feb5c831ebbde93d60c Mon Sep 17 00:00:00 2001 From: nyamatongwe Date: Wed, 24 Apr 2013 16:30:16 +1000 Subject: Added automatic folding options. --- doc/ScintillaDoc.html | 50 +++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 49 insertions(+), 1 deletion(-) (limited to 'doc/ScintillaDoc.html') diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html index 9621ea19e..1c2dd7c2f 100644 --- a/doc/ScintillaDoc.html +++ b/doc/ScintillaDoc.html @@ -82,7 +82,7 @@

Scintilla Documentation

-

Last edited 18/January/2013 NH

+

Last edited 24/April/2013 NH

There is an overview of the internal design of Scintilla.
@@ -5175,6 +5175,8 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){ SCI_GETALLLINESVISIBLE
SCI_SETFOLDLEVEL(int line, int level)
SCI_GETFOLDLEVEL(int line)
+ SCI_SETAUTOMATICFOLD(int automaticFold)
+ SCI_GETAUTOMATICFOLD
SCI_SETFOLDFLAGS(int flags)
SCI_GETLASTCHILD(int line, int level)
SCI_GETFOLDPARENT(int line)
@@ -5394,6 +5396,52 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){ so that any range hidden underneath this line can be shown.

+

SCI_SETAUTOMATICFOLD(int automaticFold)
+ SCI_GETAUTOMATICFOLD
+ Instead of implementing all the logic for handling folding in the container, Scintilla can provide behaviour + that is adequate for many applications. The automaticFold argument is a bit set defining + which of the 3 pieces of folding implementation should be enabled. Most applications should be able to use the + SC_AUTOMATICFOLD_SHOW and SC_AUTOMATICFOLD_CHANGE + flags unless they wish to implement quite different behavious such as defining their own fold structure. + SC_AUTOMATICFOLD_CLICK is more likely to be set off when an application would + like to add or change click behaviour such as showing method headers only when Shift+Alt is used in + conjunction with a click. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SymbolValueEffect
SC_AUTOMATICFOLD_SHOW1Automatically show lines as needed. + This avoids sending the SCN_NEEDSHOWN notification.
SC_AUTOMATICFOLD_CLICK2Handle clicks in fold margin automatically. + This avoids sending the SCN_MARGINCLICK notification for folding margins.
SC_AUTOMATICFOLD_CHANGE4Show lines as needed when fold structure is changed. + The SCN_MODIFIED notification is still sent unless it is disabled by the + container.
+

SCI_CONTRACTEDFOLDNEXT(int lineStart)
Search efficiently for lines that are contracted fold headers. This is useful when saving the user's folding when switching documents or saving folding with a file. -- cgit v1.2.3