From 6652c4eadad09cf6ea23b690c92d70b55a49d57f Mon Sep 17 00:00:00 2001
From: Neil
- The currently supported platforms, Windows, GTK+/Linux and wxWindows are fairly similar in + The currently supported platforms, Windows, GTK+/Linux and wxWindows are fairly similar in many ways. Each has windows, menus and bitmaps. These features generally work in similar ways so each has a way to move a window or draw a red line. Sometimes one platform requires a sequence of @@ -100,7 +100,7 @@ have to use the limited set of already available colours.
A Palette object holds a set of colour pairs and can make the appropriate calls to ask to - allocate these colours and to see what the platform has decided will be allowed. + allocate these colours and to see what the platform has decided will be allowed.The bulk of Scintilla's code is platform independent. This is made up of the CellBuffer, - ContractionState, Document, Editor, Indicator, LineMarker, Style, ViewStyle, KeyMap, + ContractionState, Document, Editor, Indicator, LineMarker, Style, ViewStyle, KeyMap, ScintillaBase, CallTip, and AutoComplete primary classes.
@@ -204,14 +204,14 @@The Editor object is central to Scintilla. It is responsible for displaying a document and - responding to user actions and requests from the container. It uses ContractionState, Indicator, - LineMarker, Style, and ViewStyle objects to display the document and a KeyMap class to - map key presses to functions. - The visibility of each line is kept in the ContractionState which is also responsible for mapping + responding to user actions and requests from the container. It uses ContractionState, Indicator, + LineMarker, Style, and ViewStyle objects to display the document and a KeyMap class to + map key presses to functions. + The visibility of each line is kept in the ContractionState which is also responsible for mapping from display lines to documents lines and vice versa.
- There may be multiple Editor objects attached to one Document object. Changes to a + There may be multiple Editor objects attached to one Document object. Changes to a document are broadcast to the editors through the DocWatcher mechanism.
- These images may be used under the same license as Scintilla. + These images may be used under the same license as Scintilla.
- Drawn by Iago Rubio, Philippe Lhoste, and Neil Hodgson. + Drawn by Iago Rubio, Philippe Lhoste, and Neil Hodgson.
zip format (70K) diff --git a/doc/Lexer.txt b/doc/Lexer.txt index 0aeb66bae..9b9e54f5a 100644 --- a/doc/Lexer.txt +++ b/doc/Lexer.txt @@ -47,7 +47,7 @@ The task of a lexer can be summarized briefly: for each range r of characters that are to be colored the same, the lexer should call styler.ColourTo(i, state) - + where i is the position of the last character of the range r. The lexer should set the state variable to the coloring state of the character at position i and continue until the entire text has been colored. @@ -139,8 +139,8 @@ characters in ASCII for operators, comment markers, etc. Special case: Folding -Folding may be performed in the lexer function. It is better to use a -separate folder function as that avoids some troublesome interaction +Folding may be performed in the lexer function. It is better to use a +separate folder function as that avoids some troublesome interaction between styling and folding. The folder function will be run after the lexer function if folding is enabled. The rest of this section explains how to perform folding within the lexer function. @@ -148,15 +148,15 @@ how to perform folding within the lexer function. During initialization, lexers that support folding set bool fold = styler.GetPropertyInt("fold"); - + If folding is enabled in the editor, fold will be TRUE and the lexer should call: styler.SetLevel(line, level); - + at the end of each line and just before exiting. -The line parameter is simply the count of the number of newlines seen. +The line parameter is simply the count of the number of newlines seen. It's initial value is styler.GetLine(startPos) and it is incremented (after calling styler.SetLevel) whenever a newline is seen. @@ -169,7 +169,7 @@ comments, of course). The following flag bits, defined in Scintilla.h, may be set or cleared in the flags parameter. The SC_FOLDLEVELWHITEFLAG flag is set if the lexer considers that the line contains nothing but whitespace. The -SC_FOLDLEVELHEADERFLAG flag indicates that the line is a fold point. +SC_FOLDLEVELHEADERFLAG flag indicates that the line is a fold point. This normally means that the next line has a greater level than present line. However, the lexer may have some other basis for determining a fold point. For example, a lexer might create a header line for the @@ -193,7 +193,7 @@ seen: if ((levelCurrent > levelPrev) && (visChars > 0)) lev |= SC_FOLDLEVELHEADERFLAG; styler.SetLevel(lineCurrent, lev); - + // reinitialize the folding vars describing the present line. lineCurrent++; visChars = 0; // Number of non-whitespace characters on the line. @@ -210,7 +210,7 @@ The following code appears in the C++ lexer just before exit: flagsNext &= ~SC_FOLDLEVELNUMBERMASK; styler.SetLevel(lineCurrent, levelPrev | flagsNext); } - + Don't worry about performance diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html index 34722f259..5a5a3a532 100644 --- a/doc/ScintillaDoc.html +++ b/doc/ScintillaDoc.html @@ -2730,7 +2730,7 @@ struct Sci_TextToFind {
SCI_STYLESETCASE(int styleNumber, int caseMode)
SCI_STYLEGETCASE(int styleNumber)
The value of caseMode determines how text is displayed. You can set upper case
- (SC_CASE_UPPER, 1) or lower case (SC_CASE_LOWER, 2) or camel case (SC_CASE_CAMEL, 3)
+ (SC_CASE_UPPER, 1) or lower case (SC_CASE_LOWER, 2) or camel case (SC_CASE_CAMEL, 3)
or display normally (SC_CASE_MIXED, 0). This does not change the stored text, only how it is
displayed.
chlistCompletionMethodSCN_AUTOCCOMPLETED notification
for the possible values for listCompletionMethod.
SCN_URIDROPPED
@@ -7396,13 +7396,13 @@ for line = lineStart to lineEnd do SCI_ENSUREVISIBLE(line) next
chlistCompletionMethod
- SCI_AUTOCSELECT message
+ SCI_AUTOCSELECT message
triggered the completion. ch is 0.SCN_FOCUSOUT (2029) when it loses focus.
SCN_AUTOCCOMPLETED
- This notification is generated after an autocompletion has inserted its
+ This notification is generated after an autocompletion has inserted its
text. The fields are identical to the
SCN_AUTOCSELECTION
@@ -7643,7 +7643,7 @@ EM_FORMATRANGE
SCI_GETUSEPALETTE Deprecated
Scintilla no longer supports palette mode. The last version to support palettes was 2.29.
Any calls to these methods should be removed.
SCI_SETKEYSUNICODE(bool keysUnicode) Deprecated
SCI_GETKEYSUNICODE Deprecated
On Windows, Scintilla no longer supports narrow character windows so input is always treated as Unicode.
Of course, fancier handling could be implemented. For example, if the previous line was the
start of a control construct, the next line could be automatically indented one tab further.
@@ -249,7 +249,7 @@ SPAN {
class='S11'>endStyled, notification->position);
-
+
Colourize(start, end) retrieves the specified range of text and then calls ColourizeDoc in
keywords.cxx. It starts the process by calling:
@@ -259,7 +259,7 @@ SPAN {
class='S11'>SCI_STARTSTYLING,
startPos, 31);
-
+
and then for each token of the text, calling:
@@ -268,7 +268,7 @@ SPAN { class='S11'>SCI_SETSTYLING, length, style);
where style is a number from 0 to 31 whose appearance has been defined using the
SCI_STYLESET... messages.
@@ -324,7 +324,7 @@ SPAN {
class='S10'>= linebuf + startword;
-
+
Then if a calltip is available it can be displayed. The calltip appears immediately below
the position specified. The calltip can be multiple lines separated by newlines (\n).
@@ -344,7 +344,7 @@ SPAN {
class='S11'>wordLen - 1, calltip);
-
+
The calltip can be removed when a closing parenthesis is entered:
@@ -360,7 +360,7 @@ SPAN { SCI_CALLTIPCANCEL, 0, 0);Obviously, it is up the application to look after supplying the appropriate calltip text.
-- cgit v1.2.3