From 89a306f6ebcd3233839bcba38926140feb626612 Mon Sep 17 00:00:00 2001
From: nyamatongwe Last edited 14/August/2013 NH Last edited 22/August/2013 NH There is an overview of the internal design of
Scintilla. SCI_SETMOUSEDOWNCAPTURES(bool captures) The selection is shown by changing the foreground and/or background colours. If one of these
is not set then that attribute is not changed for the selection. The default is to show the
- selection by changing the background to light gray and leaving the foreground the same as when
+ selection by changing the background to light grey and leaving the foreground the same as when
it was not selected. When there is no selection, the current insertion point is marked by the
text caret. This is a vertical line that is normally blinking on and off to attract the users
attention.Scintilla Documentation
-
@@ -1734,7 +1734,7 @@ struct Sci_TextToFind {
SCI_GETADDITIONALSELALPHA
SCI_SETADDITIONALSELFORE(int colour)
SCI_SETADDITIONALSELBACK(int colour)
- Modify the appearence of additional selections so that they can be differentiated from the main selection which has its appearence set with
+ Modify the appearance of additional selections so that they can be differentiated from the main selection which has its appearance set with
,
,
, and
@@ -1745,7 +1745,7 @@ struct Sci_TextToFind {
SCI_GETADDITIONALCARETFORE
SCI_SETADDITIONALCARETSBLINK(bool additionalCaretsBlink)
SCI_GETADDITIONALCARETSBLINK
- Modify the appearence of additional carets so that they can be differentiated from the main caret which has its appearence set with
+ Modify the appearance of additional carets so that they can be differentiated from the main caret which has its appearance set with
,
,
, and
@@ -2237,7 +2237,7 @@ struct Sci_TextToFind {
SCI_GETMOUSEDOWNCAPTURES
When the mouse is pressed inside Scintilla, it is captured so future mouse movement events are
- sent to Scintilla. This behavior may be turned off with
+ sent to Scintilla. This behaviour may be turned off with
SCI_SETMOUSEDOWNCAPTURES(0).Line endings
@@ -2691,7 +2691,7 @@ struct Sci_TextToFind {
SCI_SETCARETWIDTH to a value of
0, 1, 2 or 3 pixels. The default width is 1 pixel. You can read back the current width with
SCI_GETCARETWIDTH. A width of 0 makes the caret invisible (added at version
- 1.50), similar to setting the caret style to CARETSTYLE_INVISIBLE (though not interchangable).
+ 1.50), similar to setting the caret style to CARETSTYLE_INVISIBLE (though not interchangeable).
This setting only affects the width of the cursor when the cursor style is set to line caret
mode, it does not affect the width for a block caret.
When set to SC_CARETSTICKY_WHITESPACE (2), the caret acts like mode 0 (sticky off) except under one
special case; when space or tab characters are inserted. (Including pasting only space/tabs -- undo, redo,
- etc. do not exhibit this behavior..).
SCI_TOGGLECARETSTICKY switches from SC_CARETSTICKY_ON and SC_CARETSTICKY_WHITESPACE
to SC_CARETSTICKY_OFF and from SC_CARETSTICKY_OFF to SC_CARETSTICKY_ON.
SCI_MARGINSETSTYLEOFFSET(256) would allow the margin styles to be numbered from
- 256 upto 511 so they do not overlap styles set by lexers. Each style number set with SCI_MARGINSETSTYLE
+ 256 up to 511 so they do not overlap styles set by lexers. Each style number set with SCI_MARGINSETSTYLE
or SCI_MARGINSETSTYLES has the offset added before looking up the style.
@@ -3176,7 +3176,7 @@ struct Sci_TextToFind {
SCI_ANNOTATIONGETSTYLEOFFSET
Annotation styles may be completely separated from standard text styles by setting a style offset. For example,
SCI_ANNOTATIONSETSTYLEOFFSET(512) would allow the annotation styles to be numbered from
- 512 upto 767 so they do not overlap styles set by lexers (or margins if margins offset is 256).
+ 512 up to 767 so they do not overlap styles set by lexers (or margins if margins offset is 256).
Each style number set with SCI_ANNOTATIONSETSTYLE
or SCI_ANNOTATIONSETSTYLES has the offset added before looking up the style.
SCI_RGBAIMAGESETWIDTH and
SCI_RGBAIMAGESETHEIGHT messages.
A scale factor in percent may be set with SCI_RGBAIMAGESETSCALE. This is useful on OS X with
- a retina display where each display unit is 2 pixels: use a factor of 200 so that each image pixel is dsplayed using a screen pixel.
+ a retina display where each display unit is 2 pixels: use a factor of 200 so that each image pixel is displayed using a screen pixel.
The default scale, 100, will stretch each image pixel to cover 4 screen pixels on a retina display.
Pixmaps use the SC_MARK_RGBAIMAGE marker symbol.
INDIC_SQUIGGLE that draws using a pixmap instead of
as a series of line segments for performance.
Measured to be between 3 and 6 times faster than INDIC_SQUIGGLE on GTK+.
- Apperance will not be as good as INDIC_SQUIGGLE on OS X in HiDPI mode.INDIC_SQUIGGLE on OS X in HiDPI mode.
SCI_AUTOCSETCANCELATSTART(bool cancel)
SCI_AUTOCGETCANCELATSTART
- The default behavior is for the list to be cancelled if the caret moves to the location it
+ The default behaviour is for the list to be cancelled if the caret moves to the location it
was at when the list was displayed. By calling this message with a false argument,
the list is not cancelled until the caret moves at least one character before the word being
completed.
Unhighlighted text is drawn in a mid gray. Selected text is drawn in a dark blue. The +
Unhighlighted text is drawn in a mid grey. Selected text is drawn in a dark blue. The
background is white. These can be changed with
SCI_CALLTIPSETBACK,
SCI_CALLTIPSETFORE, and
@@ -4488,11 +4488,11 @@ struct Sci_TextToFind {
SCI_CALLTIPSETBACK(int colour)
The background colour of call tips can be set with this message; the default colour is white.
It is not a good idea to set a dark colour as the background as the default colour for normal
- calltip text is mid gray and the defaultcolour for highlighted text is dark blue. This also
+ calltip text is mid grey and the default colour for highlighted text is dark blue. This also
sets the background colour of STYLE_CALLTIP.
SCI_CALLTIPSETFORE(int colour)
- The colour of call tip text can be set with this message; the default colour is mid gray.
+ The colour of call tip text can be set with this message; the default colour is mid grey.
This also sets the foreground colour of STYLE_CALLTIP.
SCI_CALLTIPSETFOREHLT(int colour)
@@ -5477,7 +5477,7 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){
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.
+ flags unless they wish to implement quite different behaviour 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.
@@ -5574,7 +5574,7 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){
line.
Wrapping is not performed immediately there is a change but is delayed until the display - is redrawn. This delay improves peformance by allowing a set of changes to be performed + is redrawn. This delay improves performance by allowing a set of changes to be performed and then wrapped and displayed once. Because of this, some operations may not occur as expected. If a file is read and the scroll position moved to a particular line in the text, such as occurs when a container tries to restore a previous editing session, then @@ -6014,7 +6014,7 @@ sptr_t CallScintilla(unsigned int iMessage, uptr_t wParam, sptr_t lParam){
Applications may discover the set of properties used by searching the source code of lexers for lines that contain
GetProperty and a double quoted string and extract the value of the double quoted string as the property name.
- The scintilla/src/LexGen.py script does this and can be used as an example.
+ The scintilla/scripts/LexGen.py script does this and can be used as an example.
Documentation for the property may be located above the call as a multi-line comment starting with
// property <property-name>
CreateWindow call and stored as the
GWLP_ID attribute of the window.
- The value should be small, preferrably less than 16 bits,
+ The value should be small, preferably less than 16 bits,
rather than a pointer as some of the functions will only transmit 16 or 32 bits.
@@ -6956,7 +6956,7 @@ href="#SCI_POSITIONFROMLINE">SCI_POSITIONFROMLINE(lineNumber);
SCEN_CHANGE
SCEN_CHANGE (768) is fired when the text (not the style) of the document changes.
This notification is sent using the WM_COMMAND message on Windows and the
- "Command" signal on GTK+ as this is the behavior of the standard Edit control
+ "Command" signal on GTK+ as this is the behaviour of the standard Edit control
(SCEN_CHANGE has the same value as the Windows Edit control
EN_CHANGE). No other information is sent. If you need more detailed information
use . You can filter the
@@ -6986,7 +6986,7 @@ href="#SCI_POSITIONFROMLINE">SCI_POSITIONFROMLINE(lineNumber);
SCEN_SETFOCUS (512) is fired when Scintilla receives focus and
SCEN_KILLFOCUS (256) when it loses focus. These notifications are sent using the
WM_COMMAND message on Windows and the "Command" signal on GTK+ as this is the
- behavior of the standard Edit control. Unfortunately, these codes do not match the Windows Edit
+ behaviour of the standard Edit control. Unfortunately, these codes do not match the Windows Edit
notification codes EN_SETFOCUS (256) and EN_KILLFOCUS (512). It is
now too late to change the Scintilla codes as clients depend on the current values.
To change the set of lexers in Scintilla, add and remove lexer source files
- (Lex*.cxx) from the scintilla/src directory and run the
- src/LexGen.py script from the src directory to update the make files
- and KeyWords.cxx. LexGen.py requires Python 2.1 or later. If you do
- not have access to Python, you can hand edit KeyWords.cxx in a simple-minded way,
+ (Lex*.cxx) from the scintilla/lexers directory and run the
+ scripts/LexGen.py script from the scripts directory to update the make files
+ and Catalogue.cxx. LexGen.py requires Python 2.5 or later. If you do
+ not have access to Python, you can hand edit Catalogue.cxx in a simple-minded way,
following the patterns of other lexers. The important thing is to include
LINK_LEXER(lmMyLexer); to correspond with the LexerModule
lmMyLexer(...); in your lexer source code.