diff --git a/scintilla/call/ScintillaCall.cxx b/scintilla/call/ScintillaCall.cxx index 4bd742922..d8b92aada 100644 --- a/scintilla/call/ScintillaCall.cxx +++ b/scintilla/call/ScintillaCall.cxx @@ -275,12 +275,12 @@ void ScintillaCall::SetTabDrawMode(Scintilla::TabDrawMode tabDrawMode) { Call(Message::SetTabDrawMode, static_cast(tabDrawMode)); } -Position ScintillaCall::PositionFromPoint(int x, int y) { - return Call(Message::PositionFromPoint, x, y); +Position ScintillaCall::PositionFromPoint(Pixels x, Pixels y) { + return Call(Message::PositionFromPoint, static_cast(x), static_cast(y)); } -Position ScintillaCall::PositionFromPointClose(int x, int y) { - return Call(Message::PositionFromPointClose, x, y); +Position ScintillaCall::PositionFromPointClose(Pixels x, Pixels y) { + return Call(Message::PositionFromPointClose, static_cast(x), static_cast(y)); } void ScintillaCall::GotoLine(Line line) { @@ -343,12 +343,12 @@ int ScintillaCall::TabWidth() { return static_cast(Call(Message::GetTabWidth)); } -void ScintillaCall::SetTabMinimumWidth(int pixels) { - Call(Message::SetTabMinimumWidth, pixels); +void ScintillaCall::SetTabMinimumWidth(Pixels pixels) { + Call(Message::SetTabMinimumWidth, static_cast(pixels)); } -int ScintillaCall::TabMinimumWidth() { - return static_cast(Call(Message::GetTabMinimumWidth)); +Pixels ScintillaCall::TabMinimumWidth() { + return static_cast(Call(Message::GetTabMinimumWidth)); } void ScintillaCall::ClearTabStops(Line line) { @@ -415,8 +415,8 @@ void ScintillaCall::MarkerSetBackSelectedTranslucent(int markerNumber, ColourAlp Call(Message::MarkerSetBackSelectedTranslucent, markerNumber, back); } -void ScintillaCall::MarkerSetStrokeWidth(int markerNumber, int hundredths) { - Call(Message::MarkerSetStrokeWidth, markerNumber, hundredths); +void ScintillaCall::MarkerSetStrokeWidth(int markerNumber, Pixels hundredths) { + Call(Message::MarkerSetStrokeWidth, markerNumber, static_cast(hundredths)); } void ScintillaCall::MarkerEnableHighlight(bool enabled) { @@ -475,12 +475,12 @@ MarginType ScintillaCall::MarginTypeN(int margin) { return static_cast(Call(Message::GetMarginTypeN, margin)); } -void ScintillaCall::SetMarginWidthN(int margin, int pixelWidth) { - Call(Message::SetMarginWidthN, margin, pixelWidth); +void ScintillaCall::SetMarginWidthN(int margin, Pixels pixelWidth) { + Call(Message::SetMarginWidthN, margin, static_cast(pixelWidth)); } -int ScintillaCall::MarginWidthN(int margin) { - return static_cast(Call(Message::GetMarginWidthN, margin)); +Pixels ScintillaCall::MarginWidthN(int margin) { + return static_cast(Call(Message::GetMarginWidthN, margin)); } void ScintillaCall::SetMarginMaskN(int margin, int mask) { @@ -931,12 +931,12 @@ IndicFlag ScintillaCall::IndicGetFlags(int indicator) { return static_cast(Call(Message::IndicGetFlags, indicator)); } -void ScintillaCall::IndicSetStrokeWidth(int indicator, int hundredths) { - Call(Message::IndicSetStrokeWidth, indicator, hundredths); +void ScintillaCall::IndicSetStrokeWidth(int indicator, Pixels hundredths) { + Call(Message::IndicSetStrokeWidth, indicator, static_cast(hundredths)); } -int ScintillaCall::IndicGetStrokeWidth(int indicator) { - return static_cast(Call(Message::IndicGetStrokeWidth, indicator)); +Pixels ScintillaCall::IndicGetStrokeWidth(int indicator) { + return static_cast(Call(Message::IndicGetStrokeWidth, indicator)); } void ScintillaCall::SetWhitespaceFore(bool useSetting, Colour fore) { @@ -947,12 +947,12 @@ void ScintillaCall::SetWhitespaceBack(bool useSetting, Colour back) { Call(Message::SetWhitespaceBack, useSetting, back); } -void ScintillaCall::SetWhitespaceSize(int size) { - Call(Message::SetWhitespaceSize, size); +void ScintillaCall::SetWhitespaceSize(Pixels size) { + Call(Message::SetWhitespaceSize, static_cast(size)); } -int ScintillaCall::WhitespaceSize() { - return static_cast(Call(Message::GetWhitespaceSize)); +Pixels ScintillaCall::WhitespaceSize() { + return static_cast(Call(Message::GetWhitespaceSize)); } void ScintillaCall::SetLineState(Line line, int state) { @@ -983,12 +983,12 @@ void ScintillaCall::SetCaretLineBack(Colour back) { Call(Message::SetCaretLineBack, back); } -int ScintillaCall::CaretLineFrame() { - return static_cast(Call(Message::GetCaretLineFrame)); +Pixels ScintillaCall::CaretLineFrame() { + return static_cast(Call(Message::GetCaretLineFrame)); } -void ScintillaCall::SetCaretLineFrame(int width) { - Call(Message::SetCaretLineFrame, width); +void ScintillaCall::SetCaretLineFrame(Pixels width) { + Call(Message::SetCaretLineFrame, static_cast(width)); } void ScintillaCall::StyleSetChangeable(int style, bool changeable) { @@ -1319,20 +1319,20 @@ void ScintillaCall::AllocateLines(Line lines) { Call(Message::AllocateLines, lines); } -void ScintillaCall::SetMarginLeft(int pixelWidth) { - Call(Message::SetMarginLeft, 0, pixelWidth); +void ScintillaCall::SetMarginLeft(Pixels pixelWidth) { + Call(Message::SetMarginLeft, 0, static_cast(pixelWidth)); } -int ScintillaCall::MarginLeft() { - return static_cast(Call(Message::GetMarginLeft)); +Pixels ScintillaCall::MarginLeft() { + return static_cast(Call(Message::GetMarginLeft)); } -void ScintillaCall::SetMarginRight(int pixelWidth) { - Call(Message::SetMarginRight, 0, pixelWidth); +void ScintillaCall::SetMarginRight(Pixels pixelWidth) { + Call(Message::SetMarginRight, 0, static_cast(pixelWidth)); } -int ScintillaCall::MarginRight() { - return static_cast(Call(Message::GetMarginRight)); +Pixels ScintillaCall::MarginRight() { + return static_cast(Call(Message::GetMarginRight)); } bool ScintillaCall::Modify() { @@ -1367,12 +1367,12 @@ bool ScintillaCall::SelectionHidden() { return Call(Message::GetSelectionHidden); } -int ScintillaCall::PointXFromPosition(Position pos) { - return static_cast(Call(Message::PointXFromPosition, 0, pos)); +Pixels ScintillaCall::PointXFromPosition(Position pos) { + return static_cast(Call(Message::PointXFromPosition, 0, pos)); } -int ScintillaCall::PointYFromPosition(Position pos) { - return static_cast(Call(Message::PointYFromPosition, 0, pos)); +Pixels ScintillaCall::PointYFromPosition(Position pos) { + return static_cast(Call(Message::PointYFromPosition, 0, pos)); } Line ScintillaCall::LineFromPosition(Position pos) { @@ -1479,12 +1479,12 @@ bool ScintillaCall::Overtype() { return Call(Message::GetOvertype); } -void ScintillaCall::SetCaretWidth(int pixelWidth) { - Call(Message::SetCaretWidth, pixelWidth); +void ScintillaCall::SetCaretWidth(Pixels pixelWidth) { + Call(Message::SetCaretWidth, static_cast(pixelWidth)); } -int ScintillaCall::CaretWidth() { - return static_cast(Call(Message::GetCaretWidth)); +Pixels ScintillaCall::CaretWidth() { + return static_cast(Call(Message::GetCaretWidth)); } void ScintillaCall::SetTargetStart(Position start) { @@ -1599,8 +1599,8 @@ void ScintillaCall::CallTipSetForeHlt(Colour fore) { Call(Message::CallTipSetForeHlt, fore); } -void ScintillaCall::CallTipUseStyle(int tabSize) { - Call(Message::CallTipUseStyle, tabSize); +void ScintillaCall::CallTipUseStyle(Pixels tabSize) { + Call(Message::CallTipUseStyle, static_cast(tabSize)); } void ScintillaCall::CallTipSetPosition(bool above) { @@ -1791,12 +1791,12 @@ WrapVisualLocation ScintillaCall::WrapVisualFlagsLocation() { return static_cast(Call(Message::GetWrapVisualFlagsLocation)); } -void ScintillaCall::SetWrapStartIndent(int indent) { - Call(Message::SetWrapStartIndent, indent); +void ScintillaCall::SetWrapStartIndent(Pixels indent) { + Call(Message::SetWrapStartIndent, static_cast(indent)); } -int ScintillaCall::WrapStartIndent() { - return static_cast(Call(Message::GetWrapStartIndent)); +Pixels ScintillaCall::WrapStartIndent() { + return static_cast(Call(Message::GetWrapStartIndent)); } void ScintillaCall::SetWrapIndentMode(Scintilla::WrapIndentMode wrapIndentMode) { @@ -1815,12 +1815,12 @@ LineCache ScintillaCall::LayoutCache() { return static_cast(Call(Message::GetLayoutCache)); } -void ScintillaCall::SetScrollWidth(int pixelWidth) { - Call(Message::SetScrollWidth, pixelWidth); +void ScintillaCall::SetScrollWidth(Pixels pixelWidth) { + Call(Message::SetScrollWidth, static_cast(pixelWidth)); } -int ScintillaCall::ScrollWidth() { - return static_cast(Call(Message::GetScrollWidth)); +Pixels ScintillaCall::ScrollWidth() { + return static_cast(Call(Message::GetScrollWidth)); } void ScintillaCall::SetScrollWidthTracking(bool tracking) { @@ -1831,8 +1831,8 @@ bool ScintillaCall::ScrollWidthTracking() { return Call(Message::GetScrollWidthTracking); } -int ScintillaCall::TextWidth(int style, const char *text) { - return static_cast(CallString(Message::TextWidth, style, text)); +Pixels ScintillaCall::TextWidth(int style, const char *text) { + return static_cast(CallString(Message::TextWidth, style, text)); } void ScintillaCall::SetEndAtLastLine(bool endAtLastLine) { @@ -1843,8 +1843,8 @@ bool ScintillaCall::EndAtLastLine() { return Call(Message::GetEndAtLastLine); } -int ScintillaCall::TextHeight(Line line) { - return static_cast(Call(Message::TextHeight, line)); +Pixels ScintillaCall::TextHeight(Line line) { + return static_cast(Call(Message::TextHeight, line)); } void ScintillaCall::SetVScrollBar(bool visible) { @@ -1899,8 +1899,8 @@ void ScintillaCall::LinesJoin() { Call(Message::LinesJoin); } -void ScintillaCall::LinesSplit(int pixelWidth) { - Call(Message::LinesSplit, pixelWidth); +void ScintillaCall::LinesSplit(Pixels pixelWidth) { + Call(Message::LinesSplit, static_cast(pixelWidth)); } void ScintillaCall::SetFoldMarginColour(bool useSetting, Colour back) { @@ -2387,12 +2387,12 @@ void ScintillaCall::DelLineRight() { Call(Message::DelLineRight); } -void ScintillaCall::SetXOffset(int xOffset) { - Call(Message::SetXOffset, xOffset); +void ScintillaCall::SetXOffset(Pixels xOffset) { + Call(Message::SetXOffset, static_cast(xOffset)); } -int ScintillaCall::XOffset() { - return static_cast(Call(Message::GetXOffset)); +Pixels ScintillaCall::XOffset() { + return static_cast(Call(Message::GetXOffset)); } void ScintillaCall::ChooseCaretX() { @@ -2403,8 +2403,8 @@ void ScintillaCall::GrabFocus() { Call(Message::GrabFocus); } -void ScintillaCall::SetXCaretPolicy(Scintilla::CaretPolicy caretPolicy, int caretSlop) { - Call(Message::SetXCaretPolicy, static_cast(caretPolicy), caretSlop); +void ScintillaCall::SetXCaretPolicy(Scintilla::CaretPolicy caretPolicy, Pixels caretSlop) { + Call(Message::SetXCaretPolicy, static_cast(caretPolicy), static_cast(caretSlop)); } void ScintillaCall::SetYCaretPolicy(Scintilla::CaretPolicy caretPolicy, int caretSlop) { @@ -2827,20 +2827,20 @@ Alpha ScintillaCall::IndicGetOutlineAlpha(int indicator) { return static_cast(Call(Message::IndicGetOutlineAlpha, indicator)); } -void ScintillaCall::SetExtraAscent(int extraAscent) { - Call(Message::SetExtraAscent, extraAscent); +void ScintillaCall::SetExtraAscent(Pixels extraAscent) { + Call(Message::SetExtraAscent, static_cast(extraAscent)); } -int ScintillaCall::ExtraAscent() { - return static_cast(Call(Message::GetExtraAscent)); +Pixels ScintillaCall::ExtraAscent() { + return static_cast(Call(Message::GetExtraAscent)); } -void ScintillaCall::SetExtraDescent(int extraDescent) { - Call(Message::SetExtraDescent, extraDescent); +void ScintillaCall::SetExtraDescent(Pixels extraDescent) { + Call(Message::SetExtraDescent, static_cast(extraDescent)); } -int ScintillaCall::ExtraDescent() { - return static_cast(Call(Message::GetExtraDescent)); +Pixels ScintillaCall::ExtraDescent() { + return static_cast(Call(Message::GetExtraDescent)); } MarkerSymbol ScintillaCall::MarkerSymbolDefined(int markerNumber) { @@ -2967,12 +2967,12 @@ void ScintillaCall::AddUndoAction(int token, Scintilla::UndoFlags flags) { Call(Message::AddUndoAction, token, static_cast(flags)); } -Position ScintillaCall::CharPositionFromPoint(int x, int y) { - return Call(Message::CharPositionFromPoint, x, y); +Position ScintillaCall::CharPositionFromPoint(Pixels x, Pixels y) { + return Call(Message::CharPositionFromPoint, static_cast(x), static_cast(y)); } -Position ScintillaCall::CharPositionFromPointClose(int x, int y) { - return Call(Message::CharPositionFromPointClose, x, y); +Position ScintillaCall::CharPositionFromPointClose(Pixels x, Pixels y) { + return Call(Message::CharPositionFromPointClose, static_cast(x), static_cast(y)); } void ScintillaCall::SetMouseSelectionRectangularSwitch(bool mouseSelectionRectangularSwitch) { @@ -3035,8 +3035,8 @@ void ScintillaCall::AddSelection(Position caret, Position anchor) { Call(Message::AddSelection, caret, anchor); } -int ScintillaCall::SelectionFromPoint(int x, int y) { - return static_cast(Call(Message::SelectionFromPoint, x, y)); +int ScintillaCall::SelectionFromPoint(Pixels x, Pixels y) { + return static_cast(Call(Message::SelectionFromPoint, static_cast(x), static_cast(y))); } void ScintillaCall::DropSelectionN(int selection) { diff --git a/scintilla/doc/ScintillaDoc.html b/scintilla/doc/ScintillaDoc.html index 23bbd478a..b48f115b9 100644 --- a/scintilla/doc/ScintillaDoc.html +++ b/scintilla/doc/ScintillaDoc.html @@ -130,7 +130,7 @@

Scintilla Documentation

-

Last edited 22 July 2026 NH

+

Last edited 1 October 2026 NH

Scintilla 5 has moved the lexers from Scintilla into a new Lexilla project.
@@ -231,6 +231,14 @@

Introduction

Equivalent to intptr_t. + + pixels + + A graphical position or dimension in pixels. + Equivalent to int, + Depending on platform and settings, may be physical pixels or scaled logical pixels. + + const char * @@ -760,14 +768,14 @@

Information

SCI_FINDCOLUMN(line line, position column) → position
SCI_POSITIONBEFORE(position pos) → position
SCI_POSITIONAFTER(position pos) → position
- SCI_TEXTWIDTH(int style, const char *text) → int
- SCI_TEXTHEIGHT(line line) → int
- SCI_POSITIONFROMPOINT(int x, int y) → position
- SCI_POSITIONFROMPOINTCLOSE(int x, int y) → position
- SCI_CHARPOSITIONFROMPOINT(int x, int y) → position
- SCI_CHARPOSITIONFROMPOINTCLOSE(int x, int y) → position
- SCI_POINTXFROMPOSITION(<unused>, position pos) → int
- SCI_POINTYFROMPOSITION(<unused>, position pos) → int
+ SCI_TEXTWIDTH(int style, const char *text) → pixels
+ SCI_TEXTHEIGHT(line line) → pixels
+ SCI_POSITIONFROMPOINT(pixels x, pixels y) → position
+ SCI_POSITIONFROMPOINTCLOSE(pixels x, pixels y) → position
+ SCI_CHARPOSITIONFROMPOINT(pixels x, pixels y) → position
+ SCI_CHARPOSITIONFROMPOINTCLOSE(pixels x, pixels y) → position
+ SCI_POINTXFROMPOSITION(<unused>, position pos) → pixels
+ SCI_POINTYFROMPOSITION(<unused>, position pos) → pixels

SCI_GETTEXTLENGTH → position
@@ -842,30 +850,30 @@

Information

If called with a position within a multi byte character will return the position of the start/end of that character.

-

SCI_TEXTWIDTH(int style, const char *text) → int
+

SCI_TEXTWIDTH(int style, const char *text) → pixels
This returns the pixel width of a string drawn in the given style which can be used, for example, to decide how wide to make the line number margin in order to display a given number of numerals.

-

SCI_TEXTHEIGHT(line line) → int
+

SCI_TEXTHEIGHT(line line) → pixels
This returns the height in pixels of a particular line. Currently all lines are the same height.

-

SCI_POSITIONFROMPOINT(int x, int y) → position
- SCI_POSITIONFROMPOINTCLOSE(int x, int y) → position
+

SCI_POSITIONFROMPOINT(pixels x, pixels y) → position
+ SCI_POSITIONFROMPOINTCLOSE(pixels x, pixels y) → position
SCI_POSITIONFROMPOINT finds the closest character position to a point and SCI_POSITIONFROMPOINTCLOSE is similar but returns -1 if the point is outside the window or not close to any characters.

-

SCI_CHARPOSITIONFROMPOINT(int x, int y) → position
- SCI_CHARPOSITIONFROMPOINTCLOSE(int x, int y) → position
+

SCI_CHARPOSITIONFROMPOINT(pixels x, pixels y) → position
+ SCI_CHARPOSITIONFROMPOINTCLOSE(pixels x, pixels y) → position
SCI_CHARPOSITIONFROMPOINT finds the closest character to a point and SCI_CHARPOSITIONFROMPOINTCLOSE is similar but returns -1 if the point is outside the window or not close to any characters. This is similar to the previous methods but finds characters rather than inter-character positions.

-

SCI_POINTXFROMPOSITION(<unused>, position pos) → int
- SCI_POINTYFROMPOSITION(<unused>, position pos) → int
+

SCI_POINTXFROMPOSITION(<unused>, position pos) → pixels
+ SCI_POINTYFROMPOSITION(<unused>, position pos) → pixels
These messages return the x and y display pixel location of text at position pos in the document.

@@ -1225,7 +1233,7 @@

Multiple Selection and Virtual SpaceSCI_CLEARSELECTIONS
SCI_SETSELECTION(position caret, position anchor)
SCI_ADDSELECTION(position caret, position anchor)
- SCI_SELECTIONFROMPOINT(int x, int y) → int
+ SCI_SELECTIONFROMPOINT(pixels x, pixels y) → int
SCI_DROPSELECTIONN(int selection)
SCI_SETMAINSELECTION(int selection)
SCI_GETMAINSELECTION → int
@@ -1404,7 +1412,7 @@

Multiple Selection and Virtual SpaceSCI_SETSELECTION and later selections added with SCI_ADDSELECTION

- SCI_SELECTIONFROMPOINT(int x, int y) → int
+ SCI_SELECTIONFROMPOINT(pixels x, pixels y) → int
Return the index of the selection at the point. If there is no selection at the point, return -1. This can be used to drop a selection or make it the main selection.

@@ -2414,24 +2422,22 @@

Scrolling and automatic scrolling

SCI_SETFIRSTVISIBLELINE(line displayLine)
SCI_GETFIRSTVISIBLELINE → line
- SCI_SETXOFFSET(int xOffset)
- SCI_GETXOFFSET → int
+ SCI_SETXOFFSET(pixels xOffset)
+ SCI_GETXOFFSET → pixels
SCI_SCROLLVERTICAL(line docLine, line subLine)
SCI_LINESCROLL(position columns, line lines)
SCI_SCROLLCARET
SCI_SCROLLRANGE(position secondary, position primary)
- SCI_SETXCARETPOLICY(int caretPolicy, int - caretSlop)
- SCI_SETYCARETPOLICY(int caretPolicy, int - caretSlop)
+ SCI_SETXCARETPOLICY(int caretPolicy, pixels caretSlop)
+ SCI_SETYCARETPOLICY(int caretPolicy, int caretSlop)
SCI_SETVISIBLEPOLICY(int visiblePolicy, int visibleSlop)
SCI_SETHSCROLLBAR(bool visible)
SCI_GETHSCROLLBAR → bool
SCI_SETVSCROLLBAR(bool visible)
SCI_GETVSCROLLBAR → bool
- SCI_SETSCROLLWIDTH(int pixelWidth)
- SCI_GETSCROLLWIDTH → int
+ SCI_SETSCROLLWIDTH(pixels pixelWidth)
+ SCI_GETSCROLLWIDTH → pixels
SCI_SETSCROLLWIDTHTRACKING(bool tracking)
SCI_GETSCROLLWIDTHTRACKING → bool
SCI_SETENDATLASTLINE(bool @@ -2444,8 +2450,8 @@

Scrolling and automatic scrolling

These messages retrieve and set the line number of the first visible line in the Scintilla view. The first line in the document is numbered 0. The value is a visible line rather than a document line.

-

SCI_SETXOFFSET(int xOffset)
- SCI_GETXOFFSET → int
+

SCI_SETXOFFSET(pixels xOffset)
+ SCI_GETXOFFSET → pixels
The xOffset is the horizontal scroll position in pixels of the start of the text view. A value of 0 is the normal position with the first text column visible at the left of the view.

@@ -2493,7 +2499,7 @@

Scrolling and automatic scrolling

position and range between are also visible. This may be used to make a search match visible.

-

SCI_SETXCARETPOLICY(int caretPolicy, int caretSlop)
+

SCI_SETXCARETPOLICY(int caretPolicy, pixels caretSlop)
SCI_SETYCARETPOLICY(int caretPolicy, int caretSlop)
These set the caret policy. The value of caretPolicy is a combination of CARET_SLOP, CARET_STRICT, CARET_JUMPS and @@ -2769,8 +2775,8 @@

Scrolling and automatic scrolling

See also: SCI_LINESCROLL

-

SCI_SETSCROLLWIDTH(int pixelWidth)
- SCI_GETSCROLLWIDTH → int
+

SCI_SETSCROLLWIDTH(pixels pixelWidth)
+ SCI_GETSCROLLWIDTH → pixels
For performance, Scintilla does not measure the display width of the document to determine the properties of the horizontal scroll bar. Instead, an assumed width is used. These messages set and get the document width in pixels assumed by Scintilla. @@ -2798,15 +2804,14 @@

White space

SC_ELEMENT_WHITE_SPACE_BACK : colouralpha
SCI_SETWHITESPACEBACK(bool useSetting, colour back)
- SCI_SETWHITESPACESIZE(int - size)
- SCI_GETWHITESPACESIZE → int
+ SCI_SETWHITESPACESIZE(pixels size)
+ SCI_GETWHITESPACESIZE → pixels
SCI_SETTABDRAWMODE(int tabDrawMode)
SCI_GETTABDRAWMODE → int
- SCI_SETEXTRAASCENT(int extraAscent)
- SCI_GETEXTRAASCENT → int
- SCI_SETEXTRADESCENT(int extraDescent)
- SCI_GETEXTRADESCENT → int
+ SCI_SETEXTRAASCENT(pixels extraAscent)
+ SCI_GETEXTRAASCENT → pixels
+ SCI_SETEXTRADESCENT(pixels extraDescent)
+ SCI_GETEXTRADESCENT → pixels

SCI_SETVIEWWS(int viewWS)
@@ -2871,8 +2876,8 @@

White space

change the white space colours but the element APIs are preferred with SC_ELEMENT_WHITE_SPACE allowing translucency.

-

SCI_SETWHITESPACESIZE(int size)
- SCI_GETWHITESPACESIZE → int
+

SCI_SETWHITESPACESIZE(pixels size)
+ SCI_GETWHITESPACESIZE → pixels
SCI_SETWHITESPACESIZE sets the size of the dots used for mark space characters. The SCI_GETWHITESPACESIZE message retrieves the current size. The value 0 is valid and makes the dots invisible. @@ -2916,10 +2921,10 @@

White space

The effect of using any other tabDrawMode value is undefined.

- SCI_SETEXTRAASCENT(int extraAscent)
- SCI_GETEXTRAASCENT → int
- SCI_SETEXTRADESCENT(int extraDescent)
- SCI_GETEXTRADESCENT → int
+ SCI_SETEXTRAASCENT(pixels extraAscent)
+ SCI_GETEXTRAASCENT → pixels
+ SCI_SETEXTRADESCENT(pixels extraDescent)
+ SCI_GETEXTRADESCENT → pixels
Text is drawn with the base of each character on a 'baseline'. The height of a line is found from the maximum that any style extends above the baseline (its 'ascent'), added to the maximum that any style extends below the baseline (its 'descent'). @@ -4185,8 +4190,8 @@

Selection, caret, and hotspot styles

SCI_GETCARETLINEBACK → colour
SCI_SETCARETLINEBACKALPHA(alpha alpha)
SCI_GETCARETLINEBACKALPHA → int
- SCI_SETCARETLINEFRAME(int width)
- SCI_GETCARETLINEFRAME → int
+ SCI_SETCARETLINEFRAME(pixels width)
+ SCI_GETCARETLINEFRAME → pixels
SCI_SETCARETLINEVISIBLEALWAYS(bool alwaysVisible)
SCI_GETCARETLINEVISIBLEALWAYS → bool
SCI_SETCARETLINEHIGHLIGHTSUBLINE(bool subLine)
@@ -4196,8 +4201,8 @@

Selection, caret, and hotspot styles

SCI_GETCARETPERIOD → int
SCI_SETCARETSTYLE(int caretStyle)
SCI_GETCARETSTYLE → int
- SCI_SETCARETWIDTH(int pixelWidth)
- SCI_GETCARETWIDTH → int
+ SCI_SETCARETWIDTH(pixels pixelWidth)
+ SCI_GETCARETWIDTH → pixels
SCI_SETCARETSTICKY(int useCaretStickyBehaviour)
SCI_GETCARETSTICKY → int
SCI_TOGGLECARETSTICKY
@@ -4373,8 +4378,8 @@

Selection, caret, and hotspot styles

- SCI_SETCARETLINEFRAME(int width)
- SCI_GETCARETLINEFRAME → int
+ SCI_SETCARETLINEFRAME(pixels width)
+ SCI_GETCARETLINEFRAME → pixels
SCI_SETCARETLINEFRAME can be used to display the caret line framed instead of filling the whole background. Set width != 0 to enable this option and width = 0 to disable it.

@@ -4452,8 +4457,8 @@

Selection, caret, and hotspot styles

the cursor is positioned at these characters, which may result in only drawing a part of the cursor character sequence. This is most notable on Windows platforms.

-

SCI_SETCARETWIDTH(int pixelWidth)
- SCI_GETCARETWIDTH → int
+

SCI_SETCARETWIDTH(pixels pixelWidth)
+ SCI_GETCARETWIDTH → pixels
The width of the line caret can be set with SCI_SETCARETWIDTH to a value of between 0 and 20 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, @@ -4639,9 +4644,8 @@

Margins

SCI_GETMARGINS → int
SCI_SETMARGINTYPEN(int margin, int marginType)
SCI_GETMARGINTYPEN(int margin) → int
- SCI_SETMARGINWIDTHN(int margin, int - pixelWidth)
- SCI_GETMARGINWIDTHN(int margin) → int
+ SCI_SETMARGINWIDTHN(int margin, pixels pixelWidth)
+ SCI_GETMARGINWIDTHN(int margin) → pixels
SCI_SETMARGINMASKN(int margin, int mask)
SCI_GETMARGINMASKN(int margin) → int
@@ -4653,12 +4657,10 @@

Margins

SCI_GETMARGINCURSORN(int margin) → int
SCI_SETMARGINBACKN(int margin, colour back)
SCI_GETMARGINBACKN(int margin) → colour
- SCI_SETMARGINLEFT(<unused>, int - pixelWidth)
- SCI_GETMARGINLEFT → int
- SCI_SETMARGINRIGHT(<unused>, int - pixelWidth)
- SCI_GETMARGINRIGHT → int
+ SCI_SETMARGINLEFT(<unused>, pixels pixelWidth)
+ SCI_GETMARGINLEFT → pixels
+ SCI_SETMARGINRIGHT(<unused>, pixels pixelWidth)
+ SCI_GETMARGINRIGHT → pixels
SCI_SETFOLDMARGINCOLOUR(bool useSetting, colour back)
SCI_SETFOLDMARGINHICOLOUR(bool useSetting, colour fore)
SCI_MARGINSETTEXT(line line, const char *text)
@@ -4691,8 +4693,8 @@

Margins

symbol margins that set their background colour to match the STYLE_DEFAULT background and foreground colours or a specified colour.

-

SCI_SETMARGINWIDTHN(int margin, int pixelWidth)
- SCI_GETMARGINWIDTHN(int margin) → int
+

SCI_SETMARGINWIDTHN(int margin, pixels pixelWidth)
+ SCI_GETMARGINWIDTHN(int margin) → pixels
These routines set and get the width of a margin in pixels. A margin with zero width is invisible. By default, Scintilla sets margin 1 for symbols with a width of 16 pixels, so this is a reasonable guess if you are not sure what would be appropriate. Line number margins widths @@ -4752,10 +4754,10 @@

Margins

A margin of type SC_MARGIN_COLOUR may have its colour set with SCI_SETMARGINBACKN.

-

SCI_SETMARGINLEFT(<unused>, int pixelWidth)
- SCI_GETMARGINLEFT → int
- SCI_SETMARGINRIGHT(<unused>, int pixelWidth)
- SCI_GETMARGINRIGHT → int
+

SCI_SETMARGINLEFT(<unused>, pixels pixelWidth)
+ SCI_GETMARGINLEFT → pixels
+ SCI_SETMARGINRIGHT(<unused>, pixels pixelWidth)
+ SCI_GETMARGINRIGHT → pixels
These messages set and get the width of the blank margin on both sides of the text in pixels. The default is to one pixel on each side.

@@ -5547,8 +5549,8 @@

Tabs and Indentation Guides

SCI_SETTABWIDTH(int tabWidth)
SCI_GETTABWIDTH → int
- SCI_SETTABMINIMUMWIDTH(int pixels)
- SCI_GETTABMINIMUMWIDTH → int
+ SCI_SETTABMINIMUMWIDTH(pixels pixels)
+ SCI_GETTABMINIMUMWIDTH → pixels
SCI_CLEARTABSTOPS(line line)
SCI_ADDTABSTOP(line line, int x)
SCI_GETNEXTTABSTOP(line line, int x) → int
@@ -5571,8 +5573,8 @@

Tabs and Indentation Guides

SCI_GETHIGHLIGHTGUIDE → position
-

SCI_SETTABMINIMUMWIDTH(int pixels)
- SCI_GETTABMINIMUMWIDTH → int
+

SCI_SETTABMINIMUMWIDTH(pixels pixels)
+ SCI_GETTABMINIMUMWIDTH → pixels
SCI_SETTABMINIMUMWIDTH sets the minimum size of a tab in pixels to ensure that the tab can be seen. The default value is 2. This is particularly useful with proportional fonts with fractional widths where the character before the tab may end a fraction of a pixel before a tab stop, causing the tab to only be a fraction of @@ -5721,11 +5723,10 @@

Markers

SCI_MARKERSETFORETRANSLUCENT(int markerNumber, colouralpha fore)
SCI_MARKERSETBACK(int markerNumber, colour back)
SCI_MARKERSETBACKTRANSLUCENT(int markerNumber, colouralpha back)
- SCI_MARKERSETBACKSELECTED(int markerNumber, colour - back)
+ SCI_MARKERSETBACKSELECTED(int markerNumber, colour back)
SCI_MARKERSETBACKSELECTEDTRANSLUCENT(int markerNumber, colouralpha back)
- SCI_MARKERSETSTROKEWIDTH(int markerNumber, int hundredths)
+ SCI_MARKERSETSTROKEWIDTH(int markerNumber, pixels hundredths)
SCI_MARKERENABLEHIGHLIGHT(bool enabled)
SCI_MARKERSETLAYER(int markerNumber, int layer)
SCI_MARKERGETLAYER(int markerNumber) → int
@@ -5953,7 +5954,7 @@

Markers

SCI_MARKERSETBACKSELECTEDTRANSLUCENT(int markerNumber, colouralpha back)
This message sets the highlight background colour of a marker number when its folding block is selected. The default colour is #FF0000.

-

SCI_MARKERSETSTROKEWIDTH(int markerNumber, int hundredths)
+

SCI_MARKERSETSTROKEWIDTH(int markerNumber, pixels hundredths)
This message sets the stroke width used to draw the marker in hundredths of a pixel. The default value is 100 indicating a single pixel wide line.

@@ -6112,8 +6113,8 @@

Indicators

SCI_INDICSETFORE(int indicator, colour fore)
SCI_INDICGETFORE(int indicator) → colour
- SCI_INDICSETSTROKEWIDTH(int indicator, int hundredths)
- SCI_INDICGETSTROKEWIDTH(int indicator) → int
+ SCI_INDICSETSTROKEWIDTH(int indicator, pixels hundredths)
+ SCI_INDICGETSTROKEWIDTH(int indicator) → pixels
SCI_INDICSETALPHA(int indicator, alpha alpha)
SCI_INDICGETALPHA(int indicator) → int
SCI_INDICSETOUTLINEALPHA(int indicator, alpha alpha)
@@ -6393,10 +6394,10 @@

Indicators

SCI_INDICSETFORE(1, 0xff0000); (light blue)
SCI_INDICSETFORE(2, 0x0000ff); (light red)

- SCI_INDICSETSTROKEWIDTH(int indicator, int hundredths)
- SCI_INDICGETSTROKEWIDTH(int indicator) → int
-

SCI_INDICSETSTROKEWIDTH(int indicator, int hundredths)
- SCI_INDICGETSTROKEWIDTH(int indicator) → int
+ SCI_INDICSETSTROKEWIDTH(int indicator, pixels hundredths)
+ SCI_INDICGETSTROKEWIDTH(int indicator) → pixels
+

SCI_INDICSETSTROKEWIDTH(int indicator, pixels hundredths)
+ SCI_INDICGETSTROKEWIDTH(int indicator) → pixels
These two messages set and get the stroke width used to draw an indicator in hundredths of a pixel. The default value is 100 indicating a width of one pixel. Some indicator styles do not support setting stroke width, generally where it makes no sense (INDIC_POINT) or @@ -6919,7 +6920,7 @@

Call tips

SCI_CALLTIPSETBACK(colour back)
SCI_CALLTIPSETFORE(colour fore)
SCI_CALLTIPSETFOREHLT(colour fore)
- SCI_CALLTIPUSESTYLE(int tabSize)
+ SCI_CALLTIPUSESTYLE(pixels tabSize)
SCI_CALLTIPSETPOSITION(bool above)
@@ -6983,7 +6984,7 @@

Call tips

The colour of highlighted call tip text can be set with this message; the default colour is dark blue.

-

SCI_CALLTIPUSESTYLE(int tabSize)
+

SCI_CALLTIPUSESTYLE(pixels tabSize)
This message changes the style used for call tips from STYLE_DEFAULT to STYLE_CALLTIP and sets a tab size in screen pixels. If tabsize is less than 1, Tab characters are not treated specially. Once this call has been used, the @@ -8315,15 +8316,15 @@

Line wrapping

SCI_GETWRAPVISUALFLAGSLOCATION → int
SCI_SETWRAPINDENTMODE(int wrapIndentMode)
SCI_GETWRAPINDENTMODE → int
- SCI_SETWRAPSTARTINDENT(int indent)
- SCI_GETWRAPSTARTINDENT → int
+ SCI_SETWRAPSTARTINDENT(pixels indent)
+ SCI_GETWRAPSTARTINDENT → pixels
SCI_SETLAYOUTCACHE(int cacheMode)
SCI_GETLAYOUTCACHE → int
SCI_SETPOSITIONCACHE(int size)
SCI_GETPOSITIONCACHE → int
SCI_SETLAYOUTTHREADS(int threads)
SCI_GETLAYOUTTHREADS → int
- SCI_LINESSPLIT(int pixelWidth)
+ SCI_LINESSPLIT(pixels pixelWidth)
SCI_LINESJOIN
SCI_WRAPCOUNT(line docLine) → line
@@ -8494,8 +8495,8 @@

Line wrapping

-

SCI_SETWRAPSTARTINDENT(int indent)
- SCI_GETWRAPSTARTINDENT → int
+

SCI_SETWRAPSTARTINDENT(pixels indent)
+ SCI_GETWRAPSTARTINDENT → pixels
SCI_SETWRAPSTARTINDENT sets the size of indentation of sublines for wrapped lines in terms of the average character width in STYLE_DEFAULT. @@ -8576,7 +8577,7 @@

Line wrapping

If an application just wants maximum concurrency then call with a large number SCI_SETLAYOUTTHREADS(1000) and that will be reduced to a reasonable value.

-

SCI_LINESSPLIT(int pixelWidth)
+

SCI_LINESSPLIT(pixels pixelWidth)
Split a range of lines indicated by the target into lines that are at most pixelWidth wide. Splitting occurs on word boundaries wherever possible in a similar manner to line wrapping. When pixelWidth is 0 then the width of the window is used. diff --git a/scintilla/doc/ScintillaDownload.html b/scintilla/doc/ScintillaDownload.html index a8274f600..3c65cee3b 100644 --- a/scintilla/doc/ScintillaDownload.html +++ b/scintilla/doc/ScintillaDownload.html @@ -26,9 +26,9 @@ @@ -42,7 +42,7 @@

containing very few restrictions.

- Release 5.6.6 + Release 5.6.7

Source Code @@ -50,8 +50,8 @@

The source code package contains all of the source code for Scintilla but no binary executable code and is available in
    -
  • zip format (1.8M) commonly used on Windows
  • -
  • tgz format (1.7M) commonly used on Linux and compatible operating systems
  • +
  • zip format (1.8M) commonly used on Windows
  • +
  • tgz format (1.7M) commonly used on Linux and compatible operating systems
Instructions for building on both Windows and Linux are included in the readme file.

diff --git a/scintilla/doc/ScintillaHistory.html b/scintilla/doc/ScintillaHistory.html index 4ce73fb98..6e082c358 100644 --- a/scintilla/doc/ScintillaHistory.html +++ b/scintilla/doc/ScintillaHistory.html @@ -597,15 +597,28 @@

Contributors

+
- + Windows   - + GTK/Linux   Stephan T. Lavavej RealMalWare SchreinerMasayuki HINO

Releases

+

+ Release 5.6.8 +

+
    +
  • + Released 28 September 2026. +
  • +
  • + On Win32 fix crash and invisible text for invalid weight and stretch font settings with DirectWrite. + Bug #2520. +
  • +

Release 5.6.7

  • - Released 12 August 2026. + Released 28 September 2026.
  • Reduce memory used by line layouts by storing positions as 32-bit floats instead of 64-bit. @@ -613,6 +626,18 @@

  • Reduce temporary memory use during layout of wide lines with many control characters.
  • +
  • + Fix style ending inside character after deleting last character of document. + Bug #2471. +
  • +
  • + Fix SCI_VERTICALCENTRECARET to not scroll past end. + Bug #2518. +
  • +
  • + For SCI_GETCOLUMN and SCI_FINDCOLUMN treat Unicode line ends similar to ASCII line ends. + Bug #2516. +

Release 5.6.6 diff --git a/scintilla/doc/index.html b/scintilla/doc/index.html index ab1d0bd05..ed8b7b4cc 100644 --- a/scintilla/doc/index.html +++ b/scintilla/doc/index.html @@ -9,7 +9,7 @@ - +