From 6eba3b88529b2993404ecd3ceff789f5c97021d8 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 ++++++++++++++++++++++++++++++++++++++++++++++- doc/ScintillaHistory.html | 4 ++++ 2 files changed, 53 insertions(+), 1 deletion(-) (limited to 'doc') 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. diff --git a/doc/ScintillaHistory.html b/doc/ScintillaHistory.html index e6298995c..1288f76ac 100644 --- a/doc/ScintillaHistory.html +++ b/doc/ScintillaHistory.html @@ -442,6 +442,10 @@ Released 11 December 2013.

  • + Basic implementations of common folding methods added to Scintilla to make it + easier for containers to implement folding. +
    • +
  • Haskell folder improved. Bug #1459 .
    • -- cgit v1.2.3