wxStyledTextCtrl
Description
A wxWidgets implementation of the Scintilla source code editing component.
As well as features found in standard text editing components, Scintilla includes features especially useful when editing and debugging source code. These include support for syntax styling, error indicators, code completion and call tips.
The selection margin can contain markers like those used in debuggers to indicate breakpoints and the current line. Styling choices are more open than with many editors, allowing the use of proportional fonts, bold and italics, multiple foreground and background colours and multiple fonts.
wxStyledTextCtrl is a 1 to 1 mapping of "raw" scintilla interface, whose documentation can be found in the Scintilla website (http://www.scintilla.org/).
Please see wxStyledTextEvent for the documentation of all event types you can use with wxStyledTextCtrl.
Index of the member groups
Links for quick access to the various categories of wxStyledTextCtrl functions:
See: wxStyledTextEvent
This class is derived (and can use functions) from: wxControl wxWindow wxEvtHandler
wxWidgets docs: wxStyledTextCtrl
new() -> wxStyledTextCtrl()
Default ctor.
new(Parent) -> wxStyledTextCtrl()
Types
new(Parent, Options :: [Option]) -> wxStyledTextCtrl()
Types
Ctor.
destroy(This :: wxStyledTextCtrl()) -> ok
Destructor.
create(This, Parent) -> boolean()
create(This, Parent, Options :: [Option]) -> boolean()
Create the UI elements for a STC that was created with the default ctor.
(For 2-phase create.)
addText(This, Text) -> ok
Add text to the document at current position.
insertText(This, Pos, Text) -> ok
Insert string at a position.
clearAll(This) -> ok
Types
Delete all text in the document.
clearDocumentStyle(This) -> ok
Types
Set all style bytes to 0, remove all folding information.
getLength(This) -> integer()
Types
Returns the number of bytes in the document.
getCharAt(This, Pos) -> integer()
Returns the character byte at the position.
getCurrentPos(This) -> integer()
Types
Returns the position of the caret.
getAnchor(This) -> integer()
Types
Returns the position of the opposite end of the selection to the caret.
getStyleAt(This, Pos) -> integer()
Returns the style byte at the position.
redo(This) -> ok
Types
Redoes the next action on the undo history.
setUndoCollection(This, CollectUndo) -> ok
Choose between collecting actions into the undo history and discarding them.
selectAll(This) -> ok
Types
Select all the text in the document.
setSavePoint(This) -> ok
Types
Remember the current position in the undo history as the position at which the document was saved.
canRedo(This) -> boolean()
Types
Are there any redoable actions in the undo history?
markerLineFromHandle(This, MarkerHandle) -> integer()
Retrieve the line number at which a particular marker is located.
markerDeleteHandle(This, MarkerHandle) -> ok
Delete a marker.
getUndoCollection(This) -> boolean()
Types
Is undo history being collected?
getViewWhiteSpace(This) -> integer()
Types
Are white space characters currently visible? Returns one of wxSTC_WS_* constants.
setViewWhiteSpace(This, ViewWS) -> ok
Make white space characters invisible, always visible or visible outside indentation.
The input should be one of the ?wxSTC_WS_* constants.
positionFromPoint(This, Pt) -> integer()
Find the position from a point within the window.
positionFromPointClose(This, X, Y) -> integer()
Find the position from a point within the window but return wxSTC_INVALID_POSITION if not close to text.
gotoLine(This, Line) -> ok
Set caret to start of a line and ensure it is visible.
gotoPos(This, Caret) -> ok
Set caret to a position and ensure it is visible.
setAnchor(This, Anchor) -> ok
Set the selection anchor to a position.
The anchor is the opposite end of the selection from the caret.
getCurLine(This) -> Result
Retrieve the text of the line containing the caret.
linePos can optionally be passed in to receive the index of the caret on the line.
getEndStyled(This) -> integer()
Types
Retrieve the position of the last correctly styled character.
convertEOLs(This, EolMode) -> ok
Convert all line endings in the document to one mode.
getEOLMode(This) -> integer()
Types
Retrieve the current end of line mode - one of wxSTC_EOL_CRLF, wxSTC_EOL_CR, or wxSTC_EOL_LF.
setEOLMode(This, EolMode) -> ok
Set the current end of line mode.
The input should be one of the ?wxSTC_EOL_* constants.
startStyling(This, Start) -> ok
Set the current styling position to start.
setStyling(This, Length, Style) -> ok
Change style from current styling position for length characters to a style and move the current styling position to after this newly styled segment.
getBufferedDraw(This) -> boolean()
Types
Is drawing done first into a buffer or direct to the screen?
setBufferedDraw(This, Buffered) -> ok
If drawing is buffered then each line of text is drawn into a bitmap buffer before drawing it to the screen to avoid flicker.
setTabWidth(This, TabWidth) -> ok
Change the visible size of a tab to be a multiple of the width of a space character.
getTabWidth(This) -> integer()
Types
Retrieve the visible size of a tab.
setCodePage(This, CodePage) -> ok
Set the code page used to interpret the bytes of the document as characters.
markerDefine(This, MarkerNumber, MarkerSymbol) -> ok
markerDefine(This, MarkerNumber, MarkerSymbol,
             Options :: [Option]) ->
                ok
Types
    {foreground, wx:wx_colour()} | {background, wx:wx_colour()}
Set the symbol used for a particular marker number, and optionally the fore and background colours.
The second argument should be one of the ?wxSTC_MARK_* constants.
markerSetForeground(This, MarkerNumber, Fore) -> ok
Set the foreground colour used for a particular marker number.
markerSetBackground(This, MarkerNumber, Back) -> ok
Set the background colour used for a particular marker number.
markerAdd(This, Line, MarkerNumber) -> integer()
Add a marker to a line, returning an ID which can be used to find or delete the marker.
markerDelete(This, Line, MarkerNumber) -> ok
Delete a marker from a line.
markerDeleteAll(This, MarkerNumber) -> ok
Delete all markers with a particular number from all lines.
markerGet(This, Line) -> integer()
Get a bit mask of all the markers set on a line.
markerNext(This, LineStart, MarkerMask) -> integer()
Find the next line at or after lineStart that includes a marker in mask.
Return -1 when no more lines.
markerPrevious(This, LineStart, MarkerMask) -> integer()
Find the previous line before lineStart that includes a marker in mask.
markerDefineBitmap(This, MarkerNumber, Bmp) -> ok
Define a marker with a wxBitmap.
markerAddSet(This, Line, MarkerSet) -> ok
Add a set of markers to a line.
markerSetAlpha(This, MarkerNumber, Alpha) -> ok
Set the alpha used for a marker that is drawn in the text area, not the margin.
setMarginType(This, Margin, MarginType) -> ok
Set a margin to be either numeric or symbolic.
The second argument should be one of the ?wxSTC_MARGIN_* constants.
getMarginType(This, Margin) -> integer()
Retrieve the type of a margin.
The return value will be one of the ?wxSTC_MARGIN_* constants.
setMarginWidth(This, Margin, PixelWidth) -> ok
Set the width of a margin to a width expressed in pixels.
getMarginWidth(This, Margin) -> integer()
Retrieve the width of a margin in pixels.
setMarginMask(This, Margin, Mask) -> ok
Set a mask that determines which markers are displayed in a margin.
getMarginMask(This, Margin) -> integer()
Retrieve the marker mask of a margin.
setMarginSensitive(This, Margin, Sensitive) -> ok
Make a margin sensitive or insensitive to mouse clicks.
getMarginSensitive(This, Margin) -> boolean()
Retrieve the mouse click sensitivity of a margin.
styleClearAll(This) -> ok
Types
Clear all the styles and make equivalent to the global default style.
styleSetForeground(This, Style, Fore) -> ok
Set the foreground colour of a style.
styleSetBackground(This, Style, Back) -> ok
Set the background colour of a style.
styleSetBold(This, Style, Bold) -> ok
Set a style to be bold or not.
styleSetItalic(This, Style, Italic) -> ok
Set a style to be italic or not.
styleSetSize(This, Style, SizePoints) -> ok
Set the size of characters of a style.
styleSetFaceName(This, Style, FontName) -> ok
Set the font of a style.
styleSetEOLFilled(This, Style, EolFilled) -> ok
Set a style to have its end of line filled or not.
styleResetDefault(This) -> ok
Types
Reset the default style to its state at startup.
styleSetUnderline(This, Style, Underline) -> ok
Set a style to be underlined or not.
styleSetCase(This, Style, CaseVisible) -> ok
Set a style to be mixed case, or to force upper or lower case.
The second argument should be one of the ?wxSTC_CASE_* constants.
styleSetHotSpot(This, Style, Hotspot) -> ok
Set a style to be a hotspot or not.
setSelForeground(This, UseSetting, Fore) -> ok
Set the foreground colour of the main and additional selections and whether to use this setting.
setSelBackground(This, UseSetting, Back) -> ok
Set the background colour of the main and additional selections and whether to use this setting.
getSelAlpha(This) -> integer()
Types
Get the alpha of the selection.
setSelAlpha(This, Alpha) -> ok
Set the alpha of the selection.
setCaretForeground(This, Fore) -> ok
Set the foreground colour of the caret.
cmdKeyAssign(This, Key, Modifiers, Cmd) -> ok
When key+modifier combination keyDefinition is pressed perform sciCommand.
The second argument should be a bit list containing one or more of the ?wxSTC_KEYMOD_* constants and the third argument should be one of the ?wxSTC_CMD_* constants.
cmdKeyClear(This, Key, Modifiers) -> ok
When key+modifier combination keyDefinition is pressed do nothing.
The second argument should be a bit list containing one or more of the ?wxSTC_KEYMOD_* constants.
cmdKeyClearAll(This) -> ok
Types
Drop all key mappings.
setStyleBytes(This, Length) -> integer()
Set the styles for a segment of the document.
styleSetVisible(This, Style, Visible) -> ok
Set a style to be visible or not.
getCaretPeriod(This) -> integer()
Types
Get the time in milliseconds that the caret is on and off.
setCaretPeriod(This, PeriodMilliseconds) -> ok
Get the time in milliseconds that the caret is on and off.
0 = steady on.
setWordChars(This, Characters) -> ok
Set the set of characters making up words for when moving or selecting by word.
First sets defaults like SetCharsDefault.
beginUndoAction(This) -> ok
Types
Start a sequence of actions that is undone and redone as a unit.
May be nested.
endUndoAction(This) -> ok
Types
End a sequence of actions that is undone and redone as a unit.
indicatorSetStyle(This, Indicator, IndicatorStyle) -> ok
Set an indicator to plain, squiggle or TT.
The second argument should be one of the ?wxSTC_INDIC_* constants.
indicatorGetStyle(This, Indicator) -> integer()
Retrieve the style of an indicator.
The return value will be one of the ?wxSTC_INDIC_* constants.
indicatorSetForeground(This, Indicator, Fore) -> ok
Set the foreground colour of an indicator.
indicatorGetForeground(This, Indicator) -> wx:wx_colour4()
Retrieve the foreground colour of an indicator.
setWhitespaceForeground(This, UseSetting, Fore) -> ok
Set the foreground colour of all whitespace and whether to use this setting.
setWhitespaceBackground(This, UseSetting, Back) -> ok
Set the background colour of all whitespace and whether to use this setting.
getStyleBits(This) -> integer()
Types
Retrieve number of bits in style bytes used to hold the lexical state.
Deprecated:
setLineState(This, Line, State) -> ok
Used to hold extra styling information for each line.
getLineState(This, Line) -> integer()
Retrieve the extra styling information for a line.
getMaxLineState(This) -> integer()
Types
Retrieve the last line number that has line state.
getCaretLineVisible(This) -> boolean()
Types
Is the background of the line containing the caret in a different colour?
setCaretLineVisible(This, Show) -> ok
Display the background of the line containing the caret in a different colour.
getCaretLineBackground(This) -> wx:wx_colour4()
Types
Get the colour of the background of the line containing the caret.
setCaretLineBackground(This, Back) -> ok
Set the colour of the background of the line containing the caret.
autoCompShow(This, LengthEntered, ItemList) -> ok
Display a auto-completion list.
The lengthEntered parameter indicates how many characters before the caret should be used to provide context.
autoCompCancel(This) -> ok
Types
Remove the auto-completion list from the screen.
autoCompActive(This) -> boolean()
Types
Is there an auto-completion list visible?
autoCompPosStart(This) -> integer()
Types
Retrieve the position of the caret when the auto-completion list was displayed.
autoCompComplete(This) -> ok
Types
User has selected an item so remove the list and insert the selection.
autoCompStops(This, CharacterSet) -> ok
Define a set of character that when typed cancel the auto-completion list.
autoCompSetSeparator(This, SeparatorCharacter) -> ok
Change the separator character in the string setting up an auto-completion list.
Default is space but can be changed if items contain space.
autoCompGetSeparator(This) -> integer()
Types
Retrieve the auto-completion list separator character.
autoCompSelect(This, Select) -> ok
Select the item in the auto-completion list that starts with a string.
autoCompSetCancelAtStart(This, Cancel) -> ok
Should the auto-completion list be cancelled if the user backspaces to a position before where the box was created.
autoCompGetCancelAtStart(This) -> boolean()
Types
Retrieve whether auto-completion cancelled by backspacing before start.
autoCompSetFillUps(This, CharacterSet) -> ok
Define a set of characters that when typed will cause the autocompletion to choose the selected item.
autoCompSetChooseSingle(This, ChooseSingle) -> ok
Should a single item auto-completion list automatically choose the item.
autoCompGetChooseSingle(This) -> boolean()
Types
Retrieve whether a single item auto-completion list automatically choose the item.
autoCompSetIgnoreCase(This, IgnoreCase) -> ok
Set whether case is significant when performing auto-completion searches.
autoCompGetIgnoreCase(This) -> boolean()
Types
Retrieve state of ignore case flag.
userListShow(This, ListType, ItemList) -> ok
Display a list of strings and send notification when user chooses one.
autoCompSetAutoHide(This, AutoHide) -> ok
Set whether or not autocompletion is hidden automatically when nothing matches.
autoCompGetAutoHide(This) -> boolean()
Types
Retrieve whether or not autocompletion is hidden automatically when nothing matches.
autoCompSetDropRestOfWord(This, DropRestOfWord) -> ok
Set whether or not autocompletion deletes any word characters after the inserted text upon completion.
autoCompGetDropRestOfWord(This) -> boolean()
Types
Retrieve whether or not autocompletion deletes any word characters after the inserted text upon completion.
registerImage(This, Type, Bmp) -> ok
Register an image for use in autocompletion lists.
clearRegisteredImages(This) -> ok
Types
Clear all the registered images.
autoCompGetTypeSeparator(This) -> integer()
Types
Retrieve the auto-completion list type-separator character.
autoCompSetTypeSeparator(This, SeparatorCharacter) -> ok
Change the type-separator character in the string setting up an auto-completion list.
Default is '?' but can be changed if items contain '?'.
autoCompSetMaxWidth(This, CharacterCount) -> ok
Set the maximum width, in characters, of auto-completion and user lists.
Set to 0 to autosize to fit longest item, which is the default.
autoCompGetMaxWidth(This) -> integer()
Types
Get the maximum width, in characters, of auto-completion and user lists.
autoCompSetMaxHeight(This, RowCount) -> ok
Set the maximum height, in rows, of auto-completion and user lists.
The default is 5 rows.
autoCompGetMaxHeight(This) -> integer()
Types
Set the maximum height, in rows, of auto-completion and user lists.
setIndent(This, IndentSize) -> ok
Set the number of spaces used for one level of indentation.
getIndent(This) -> integer()
Types
Retrieve indentation size.
setUseTabs(This, UseTabs) -> ok
Indentation will only use space characters if useTabs is false, otherwise it will use a combination of tabs and spaces.
getUseTabs(This) -> boolean()
Types
Retrieve whether tabs will be used in indentation.
setLineIndentation(This, Line, Indentation) -> ok
Change the indentation of a line to a number of columns.
getLineIndentation(This, Line) -> integer()
Retrieve the number of columns that a line is indented.
getLineIndentPosition(This, Line) -> integer()
Retrieve the position before the first non indentation character on a line.
getColumn(This, Pos) -> integer()
Retrieve the column number of a position, taking tab width into account.
setUseHorizontalScrollBar(This, Visible) -> ok
Show or hide the horizontal scroll bar.
getUseHorizontalScrollBar(This) -> boolean()
Types
Is the horizontal scroll bar visible?
setIndentationGuides(This, IndentView) -> ok
Show or hide indentation guides.
The input should be one of the ?wxSTC_IV_* constants.
getIndentationGuides(This) -> integer()
Types
Are the indentation guides visible?
The return value will be one of the ?wxSTC_IV_* constants.
setHighlightGuide(This, Column) -> ok
Set the highlighted indentation guide column.
0 = no highlighted guide.
getHighlightGuide(This) -> integer()
Types
Get the highlighted indentation guide column.
getLineEndPosition(This, Line) -> integer()
Get the position after the last visible characters on a line.
getCodePage(This) -> integer()
Types
Get the code page used to interpret the bytes of the document as characters.
getCaretForeground(This) -> wx:wx_colour4()
Types
Get the foreground colour of the caret.
getReadOnly(This) -> boolean()
Types
In read-only mode?
setCurrentPos(This, Caret) -> ok
Sets the position of the caret.
setSelectionStart(This, Anchor) -> ok
Sets the position that starts the selection - this becomes the anchor.
getSelectionStart(This) -> integer()
Types
Returns the position at the start of the selection.
setSelectionEnd(This, Caret) -> ok
Sets the position that ends the selection - this becomes the caret.
getSelectionEnd(This) -> integer()
Types
Returns the position at the end of the selection.
setPrintMagnification(This, Magnification) -> ok
Sets the print magnification added to the point size of each style for printing.
getPrintMagnification(This) -> integer()
Types
Returns the print magnification.
setPrintColourMode(This, Mode) -> ok
Modify colours when printing for clearer printed text.
The input should be one of the ?wxSTC_PRINT_* constants.
getPrintColourMode(This) -> integer()
Types
Returns the print colour mode.
The return value will be one of the ?wxSTC_PRINT_* constants.
findText(This, MinPos, MaxPos, Text) -> integer()
findText(This, MinPos, MaxPos, Text, Options :: [Option]) ->
            integer()
Types
Find some text in the document. @param minPos The position (starting from zero) in the document at which to begin the search @param maxPos The last position (starting from zero) in the document to which the search will be restricted. @param text The text to search for. @param flags (Optional) The search flags. This should be a bit list containing one or more of the @link wxStyledTextCtrl::wxSTC_FIND_WHOLEWORD wxSTC_FIND_* @endlink constants.
Return: The position (starting from zero) in the document at which the text was found or wxSTC_INVALID_POSITION if the search fails.
Remark: A backwards search can be performed by setting minPos to be greater than maxPos.
formatRange(This, DoDraw, StartPos, EndPos, Draw, Target,
            RenderRect, PageRect) ->
               integer()
Types
    {X :: integer(),
     Y :: integer(),
     W :: integer(),
     H :: integer()}
On Windows, will draw the document into a display context such as a printer.
getFirstVisibleLine(This) -> integer()
Types
Retrieve the display line at the top of the display.
getLine(This, Line) -> unicode:charlist()
Retrieve the contents of a line.
getLineCount(This) -> integer()
Types
Returns the number of lines in the document.
There is always at least one.
setMarginLeft(This, PixelWidth) -> ok
Sets the size in pixels of the left margin.
getMarginLeft(This) -> integer()
Types
Returns the size in pixels of the left margin.
setMarginRight(This, PixelWidth) -> ok
Sets the size in pixels of the right margin.
getMarginRight(This) -> integer()
Types
Returns the size in pixels of the right margin.
getModify(This) -> boolean()
Types
Is the document different from when it was last saved?
setSelection(This, From, To) -> ok
Selects the text starting at the first position up to (but not including) the character at the last position.
If both parameters are equal to -1 all text in the control is selected.
Notice that the insertion point will be moved to from by this function.
See: selectAll/1
getSelectedText(This) -> unicode:charlist()
Types
Retrieve the selected text.
getTextRange(This, StartPos, EndPos) -> unicode:charlist()
Retrieve a range of text.
hideSelection(This, Hide) -> ok
Draw the selection in normal style or with selection highlighted.
lineFromPosition(This, Pos) -> integer()
Retrieve the line containing a position.
positionFromLine(This, Line) -> integer()
Retrieve the position at the start of a line.
lineScroll(This, Columns, Lines) -> ok
Scroll horizontally and vertically.
ensureCaretVisible(This) -> ok
Types
Ensure the caret is visible.
replaceSelection(This, Text) -> ok
Replace the selected text with the argument text.
setReadOnly(This, ReadOnly) -> ok
Set to read only or read write.
canPaste(This) -> boolean()
Types
Will a paste succeed?
canUndo(This) -> boolean()
Types
Are there any undoable actions in the undo history?
emptyUndoBuffer(This) -> ok
Types
Delete the undo history.
undo(This) -> ok
Types
Undo one action in the undo history.
cut(This) -> ok
Types
Cut the selection to the clipboard.
copy(This) -> ok
Types
Copy the selection to the clipboard.
paste(This) -> ok
Types
Paste the contents of the clipboard into the document replacing the selection.
clear(This) -> ok
Types
Clear the selection.
setText(This, Text) -> ok
Replace the contents of the document with the argument text.
getText(This) -> unicode:charlist()
Types
Retrieve all the text in the document.
getTextLength(This) -> integer()
Types
Retrieve the number of characters in the document.
getOvertype(This) -> boolean()
Types
Returns true if overtype mode is active otherwise false is returned.
setCaretWidth(This, PixelWidth) -> ok
Set the width of the insert mode caret.
getCaretWidth(This) -> integer()
Types
Returns the width of the insert mode caret.
setTargetStart(This, Start) -> ok
Sets the position that starts the target which is used for updating the document without affecting the scroll position.
getTargetStart(This) -> integer()
Types
Get the position that starts the target.
setTargetEnd(This, End) -> ok
Sets the position that ends the target which is used for updating the document without affecting the scroll position.
getTargetEnd(This) -> integer()
Types
Get the position that ends the target.
replaceTarget(This, Text) -> integer()
Replace the target text with the argument text.
Text is counted so it can contain NULs. Returns the length of the replacement text.
searchInTarget(This, Text) -> integer()
Search for a counted string in the target and set the target to the found range.
Text is counted so it can contain NULs. Returns length of range or -1 for failure in which case target is not moved.
setSearchFlags(This, SearchFlags) -> ok
Set the search flags used by SearchInTarget.
The input should be a bit list containing one or more of the ?wxSTC_FIND_* constants.
getSearchFlags(This) -> integer()
Types
Get the search flags used by SearchInTarget.
The return value will be a bit list containing one or more of the ?wxSTC_FIND_* constants.
callTipShow(This, Pos, Definition) -> ok
Show a call tip containing a definition near position pos.
callTipCancel(This) -> ok
Types
Remove the call tip from the screen.
callTipActive(This) -> boolean()
Types
Is there an active call tip?
callTipPosAtStart(This) -> integer()
Types
Retrieve the position where the caret was before displaying the call tip.
Since: 3.1.0
callTipSetHighlight(This, HighlightStart, HighlightEnd) -> ok
Highlight a segment of the definition.
callTipSetBackground(This, Back) -> ok
Set the background colour for the call tip.
callTipSetForeground(This, Fore) -> ok
Set the foreground colour for the call tip.
callTipSetForegroundHighlight(This, Fore) -> ok
Set the foreground colour for the highlighted part of the call tip.
callTipUseStyle(This, TabSize) -> ok
Enable use of wxSTC_STYLE_CALLTIP and set call tip tab size in pixels.
visibleFromDocLine(This, DocLine) -> integer()
Find the display line of a document line taking hidden lines into account.
docLineFromVisible(This, DisplayLine) -> integer()
Find the document line of a display line taking hidden lines into account.
wrapCount(This, DocLine) -> integer()
The number of display lines needed to wrap a document line.
setFoldLevel(This, Line, Level) -> ok
Set the fold level of a line.
This encodes an integer level along with flags indicating whether the line is a header and whether it is effectively white space.
getFoldLevel(This, Line) -> integer()
Retrieve the fold level of a line.
getLastChild(This, Line, Level) -> integer()
Find the last child line of a header line.
getFoldParent(This, Line) -> integer()
Find the parent line of a child line.
showLines(This, LineStart, LineEnd) -> ok
Make a range of lines visible.
hideLines(This, LineStart, LineEnd) -> ok
Make a range of lines invisible.
getLineVisible(This, Line) -> boolean()
Is a line visible?
setFoldExpanded(This, Line, Expanded) -> ok
Show the children of a header line.
getFoldExpanded(This, Line) -> boolean()
Is a header line expanded?
toggleFold(This, Line) -> ok
Switch a header line between expanded and contracted.
ensureVisible(This, Line) -> ok
Ensure a particular line is visible by expanding any header line hiding it.
setFoldFlags(This, Flags) -> ok
Set some style options for folding.
The second argument should be a bit list containing one or more of the ?wxSTC_FOLDFLAG_* constants.
ensureVisibleEnforcePolicy(This, Line) -> ok
Ensure a particular line is visible by expanding any header line hiding it.
Use the currently set visibility policy to determine which range to display.
setTabIndents(This, TabIndents) -> ok
Sets whether a tab pressed when caret is within indentation indents.
getTabIndents(This) -> boolean()
Types
Does a tab pressed when caret is within indentation indent?
setBackSpaceUnIndents(This, BsUnIndents) -> ok
Sets whether a backspace pressed when caret is within indentation unindents.
getBackSpaceUnIndents(This) -> boolean()
Types
Does a backspace pressed when caret is within indentation unindent?
setMouseDwellTime(This, PeriodMilliseconds) -> ok
Sets the time the mouse must sit still to generate a mouse dwell event.
The input should be a time in milliseconds or wxSTC_TIME_FOREVER.
getMouseDwellTime(This) -> integer()
Types
Retrieve the time the mouse must sit still to generate a mouse dwell event.
The return value will be a time in milliseconds or wxSTC_TIME_FOREVER.
wordStartPosition(This, Pos, OnlyWordCharacters) -> integer()
Get position of start of word.
wordEndPosition(This, Pos, OnlyWordCharacters) -> integer()
Get position of end of word.
setWrapMode(This, WrapMode) -> ok
Sets whether text is word wrapped.
The input should be one of the ?wxSTC_WRAP_* constants.
getWrapMode(This) -> integer()
Types
Retrieve whether text is word wrapped.
The return value will be one of the ?wxSTC_WRAP_* constants.
setWrapVisualFlags(This, WrapVisualFlags) -> ok
Set the display mode of visual flags for wrapped lines.
The input should be a bit list containing one or more of the ?wxSTC_WRAPVISUALFLAG_* constants.
getWrapVisualFlags(This) -> integer()
Types
Retrieve the display mode of visual flags for wrapped lines.
The return value will be a bit list containing one or more of the ?wxSTC_WRAPVISUALFLAG_* constants.
setWrapVisualFlagsLocation(This, WrapVisualFlagsLocation) -> ok
Set the location of visual flags for wrapped lines.
The input should be a bit list containing one or more of the ?wxSTC_WRAPVISUALFLAGLOC_* constants.
getWrapVisualFlagsLocation(This) -> integer()
Types
Retrieve the location of visual flags for wrapped lines.
The return value will be a bit list containing one or more of the ?wxSTC_WRAPVISUALFLAGLOC_* constants.
setWrapStartIndent(This, Indent) -> ok
Set the start indent for wrapped lines.
getWrapStartIndent(This) -> integer()
Types
Retrieve the start indent for wrapped lines.
setLayoutCache(This, CacheMode) -> ok
Sets the degree of caching of layout information.
The input should be one of the ?wxSTC_CACHE_* constants.
getLayoutCache(This) -> integer()
Types
Retrieve the degree of caching of layout information.
The return value will be one of the ?wxSTC_CACHE_* constants.
setScrollWidth(This, PixelWidth) -> ok
Sets the document width assumed for scrolling.
getScrollWidth(This) -> integer()
Types
Retrieve the document width assumed for scrolling.
textWidth(This, Style, Text) -> integer()
Measure the pixel width of some text in a particular style.
Does not handle tab or control characters.
getEndAtLastLine(This) -> boolean()
Types
Retrieve whether the maximum scroll position has the last line at the bottom of the view.
textHeight(This, Line) -> integer()
Retrieve the height of a particular line of text in pixels.
setUseVerticalScrollBar(This, Visible) -> ok
Show or hide the vertical scroll bar.
getUseVerticalScrollBar(This) -> boolean()
Types
Is the vertical scroll bar visible?
appendText(This, Text) -> ok
Append a string to the end of the document without changing the selection.
getTwoPhaseDraw(This) -> boolean()
Types
Is drawing done in two phases with backgrounds drawn before foregrounds?
setTwoPhaseDraw(This, TwoPhase) -> ok
In twoPhaseDraw mode, drawing is performed in two phases, first the background and then the foreground.
This avoids chopping off characters that overlap the next run.
targetFromSelection(This) -> ok
Types
Make the target range start and end be the same as the selection range start and end.
linesJoin(This) -> ok
Types
Join the lines in the target.
linesSplit(This, PixelWidth) -> ok
Split the lines in the target into lines that are less wide than pixelWidth where possible.
setFoldMarginColour(This, UseSetting, Back) -> ok
Set one of the colours used as a chequerboard pattern in the fold margin.
setFoldMarginHiColour(This, UseSetting, Fore) -> ok
Set the other colour used as a chequerboard pattern in the fold margin.
lineDown(This) -> ok
Types
Move caret down one line.
lineDownExtend(This) -> ok
Types
Move caret down one line extending selection to new caret position.
lineUp(This) -> ok
Types
Move caret up one line.
lineUpExtend(This) -> ok
Types
Move caret up one line extending selection to new caret position.
charLeft(This) -> ok
Types
Move caret left one character.
charLeftExtend(This) -> ok
Types
Move caret left one character extending selection to new caret position.
charRight(This) -> ok
Types
Move caret right one character.
charRightExtend(This) -> ok
Types
Move caret right one character extending selection to new caret position.
wordLeft(This) -> ok
Types
Move caret left one word.
wordLeftExtend(This) -> ok
Types
Move caret left one word extending selection to new caret position.
wordRight(This) -> ok
Types
Move caret right one word.
wordRightExtend(This) -> ok
Types
Move caret right one word extending selection to new caret position.
home(This) -> ok
Types
Move caret to first position on line.
homeExtend(This) -> ok
Types
Move caret to first position on line extending selection to new caret position.
lineEnd(This) -> ok
Types
Move caret to last position on line.
lineEndExtend(This) -> ok
Types
Move caret to last position on line extending selection to new caret position.
documentStart(This) -> ok
Types
Move caret to first position in document.
documentStartExtend(This) -> ok
Types
Move caret to first position in document extending selection to new caret position.
documentEnd(This) -> ok
Types
Move caret to last position in document.
documentEndExtend(This) -> ok
Types
Move caret to last position in document extending selection to new caret position.
pageUp(This) -> ok
Types
Move caret one page up.
pageUpExtend(This) -> ok
Types
Move caret one page up extending selection to new caret position.
pageDown(This) -> ok
Types
Move caret one page down.
pageDownExtend(This) -> ok
Types
Move caret one page down extending selection to new caret position.
editToggleOvertype(This) -> ok
Types
Switch from insert to overtype mode or the reverse.
cancel(This) -> ok
Types
Cancel any modes such as call tip or auto-completion list display.
deleteBack(This) -> ok
Types
Delete the selection or if no selection, the character before the caret.
tab(This) -> ok
Types
If selection is empty or all on one line replace the selection with a tab character.
If more than one line selected, indent the lines.
backTab(This) -> ok
Types
Dedent the selected lines.
newLine(This) -> ok
Types
Insert a new line, may use a CRLF, CR or LF depending on EOL mode.
formFeed(This) -> ok
Types
Insert a Form Feed character.
vCHome(This) -> ok
Types
Move caret to before first visible character on line.
If already there move to first character on line.
vCHomeExtend(This) -> ok
Types
Like VCHome but extending selection to new caret position.
zoomIn(This) -> ok
Types
Magnify the displayed text by increasing the sizes by 1 point.
zoomOut(This) -> ok
Types
Make the displayed text smaller by decreasing the sizes by 1 point.
delWordLeft(This) -> ok
Types
Delete the word to the left of the caret.
delWordRight(This) -> ok
Types
Delete the word to the right of the caret.
lineCut(This) -> ok
Types
Cut the line containing the caret.
lineDelete(This) -> ok
Types
Delete the line containing the caret.
lineTranspose(This) -> ok
Types
Switch the current line with the previous.
lineDuplicate(This) -> ok
Types
Duplicate the current line.
lowerCase(This) -> ok
Types
Transform the selection to lower case.
upperCase(This) -> ok
Types
Transform the selection to upper case.
lineScrollDown(This) -> ok
Types
Scroll the document down, keeping the caret visible.
lineScrollUp(This) -> ok
Types
Scroll the document up, keeping the caret visible.
deleteBackNotLine(This) -> ok
Types
Delete the selection or if no selection, the character before the caret.
Will not delete the character before at the start of a line.
homeDisplay(This) -> ok
Types
Move caret to first position on display line.
homeDisplayExtend(This) -> ok
Types
Move caret to first position on display line extending selection to new caret position.
lineEndDisplay(This) -> ok
Types
Move caret to last position on display line.
lineEndDisplayExtend(This) -> ok
Types
Move caret to last position on display line extending selection to new caret position.
homeWrapExtend(This) -> ok
Types
Like HomeExtend but when word-wrap is enabled extends first to start of display line HomeDisplayExtend, then to start of document line HomeExtend.
lineEndWrap(This) -> ok
Types
Like LineEnd but when word-wrap is enabled goes first to end of display line LineEndDisplay, then to start of document line LineEnd.
lineEndWrapExtend(This) -> ok
Types
Like LineEndExtend but when word-wrap is enabled extends first to end of display line LineEndDisplayExtend, then to start of document line LineEndExtend.
vCHomeWrap(This) -> ok
Types
Like VCHome but when word-wrap is enabled goes first to start of display line VCHomeDisplay, then behaves like VCHome.
vCHomeWrapExtend(This) -> ok
Types
Like VCHomeExtend but when word-wrap is enabled extends first to start of display line VCHomeDisplayExtend, then behaves like VCHomeExtend.
lineCopy(This) -> ok
Types
Copy the line containing the caret.
moveCaretInsideView(This) -> ok
Types
Move the caret inside current view if it's not there already.
lineLength(This, Line) -> integer()
How many characters are on a line, including end of line characters?
braceHighlight(This, PosA, PosB) -> ok
Highlight the characters at two positions.
braceBadLight(This, Pos) -> ok
Highlight the character at a position indicating there is no matching brace.
braceMatch(This, Pos) -> integer()
Find the position of a matching brace or wxSTC_INVALID_POSITION if no match.
getViewEOL(This) -> boolean()
Types
Are the end of line characters visible?
setViewEOL(This, Visible) -> ok
Make the end of line characters visible or invisible.
setModEventMask(This, EventMask) -> ok
Set which document modification events are sent to the container.
The input should be a bit list containing one or more of the ?wxSTC_MOD_* constants, the ?wxSTC_PERFORMED_* constants, wxSTC_STARTACTION, wxSTC_MULTILINEUNDOREDO, wxSTC_MULTISTEPUNDOREDO, and wxSTC_LASTSTEPINUNDOREDO. The input can also be wxSTC_MODEVENTMASKALL to indicate that all changes should generate events.
getEdgeColumn(This) -> integer()
Types
Retrieve the column number which text should be kept within.
setEdgeColumn(This, Column) -> ok
Set the column number of the edge.
If text goes past the edge then it is highlighted.
setEdgeMode(This, EdgeMode) -> ok
The edge may be displayed by a line (wxSTC_EDGE_LINE/wxSTC_EDGE_MULTILINE) or by highlighting text that goes beyond it (wxSTC_EDGE_BACKGROUND) or not displayed at all (wxSTC_EDGE_NONE).
The input should be one of the ?wxSTC_EDGE_* constants.
getEdgeMode(This) -> integer()
Types
Retrieve the edge highlight mode.
The return value will be one of the ?wxSTC_EDGE_* constants.
getEdgeColour(This) -> wx:wx_colour4()
Types
Retrieve the colour used in edge indication.
setEdgeColour(This, EdgeColour) -> ok
Change the colour used in edge indication.
searchAnchor(This) -> ok
Types
Sets the current caret position to be the search anchor.
searchNext(This, SearchFlags, Text) -> integer()
Find some text starting at the search anchor.
Does not ensure the selection is visible.
searchPrev(This, SearchFlags, Text) -> integer()
Find some text starting at the search anchor and moving backwards.
Does not ensure the selection is visible.
linesOnScreen(This) -> integer()
Types
Retrieves the number of lines completely visible.
usePopUp(This, PopUpMode) -> ok
Set whether a pop up menu is displayed automatically when the user presses the wrong mouse button on certain areas.
The input should be one of the ?wxSTC_POPUP_* constants.
Remark: When wxContextMenuEvent is used to create a custom popup menu, this function should be called with wxSTC_POPUP_NEVER. Otherwise the default menu will be shown instead of the custom one.
selectionIsRectangle(This) -> boolean()
Types
Is the selection rectangular? The alternative is the more common stream selection.
setZoom(This, ZoomInPoints) -> ok
Set the zoom level.
This number of points is added to the size of all fonts. It may be positive to magnify or negative to reduce.
getZoom(This) -> integer()
Types
Retrieve the zoom level.
getModEventMask(This) -> integer()
Types
Get which document modification events are sent to the container.
The return value will wxSTC_MODEVENTMASKALL if all changes generate events. Otherwise it will be a bit list containing one or more of the ?wxSTC_MOD_* constants, the ?wxSTC_PERFORMED_* constants, wxSTC_STARTACTION, wxSTC_MULTILINEUNDOREDO, wxSTC_MULTISTEPUNDOREDO, and wxSTC_LASTSTEPINUNDOREDO.
setSTCFocus(This, Focus) -> ok
Change internal focus flag.
getSTCFocus(This) -> boolean()
Types
Get internal focus flag.
setStatus(This, Status) -> ok
Change error status - 0 = OK.
The input should be one of the ?wxSTC_STATUS_* constants.
getStatus(This) -> integer()
Types
Get error status.
The return value will be one of the ?wxSTC_STATUS_* constants.
setMouseDownCaptures(This, Captures) -> ok
Set whether the mouse is captured when its button is pressed.
getMouseDownCaptures(This) -> boolean()
Types
Get whether mouse gets captured.
setSTCCursor(This, CursorType) -> ok
Sets the cursor to one of the wxSTC_CURSOR* values.
getSTCCursor(This) -> integer()
Types
Get cursor type.
The return value will be one of the ?wxSTC_CURSOR* constants.
setControlCharSymbol(This, Symbol) -> ok
Change the way control characters are displayed: If symbol is < 32, keep the drawn way, else, use the given character.
getControlCharSymbol(This) -> integer()
Types
Get the way control characters are displayed.
wordPartLeft(This) -> ok
Types
Move to the previous change in capitalisation.
wordPartLeftExtend(This) -> ok
Types
Move to the previous change in capitalisation extending selection to new caret position.
wordPartRight(This) -> ok
Types
Move to the change next in capitalisation.
wordPartRightExtend(This) -> ok
Types
Move to the next change in capitalisation extending selection to new caret position.
setVisiblePolicy(This, VisiblePolicy, VisibleSlop) -> ok
Set the way the display area is determined when a particular line is to be moved to by Find, FindNext, GotoLine, etc.
The first argument should be a bit list containing one or more of the ?wxSTC_VISIBLE_* constants.
delLineLeft(This) -> ok
Types
Delete back from the current position to the start of the line.
delLineRight(This) -> ok
Types
Delete forwards from the current position to the end of the line.
getXOffset(This) -> integer()
Types
Get the xOffset (ie, horizontal scroll position).
chooseCaretX(This) -> ok
Types
Set the last x chosen value to be the caret x position.
setXCaretPolicy(This, CaretPolicy, CaretSlop) -> ok
Set the way the caret is kept visible when going sideways.
The exclusion zone is given in pixels.
The first argument should be a bit list containing one or more of the ?wxSTC_CARET_* constants.
setYCaretPolicy(This, CaretPolicy, CaretSlop) -> ok
Set the way the line the caret is on is kept visible.
The exclusion zone is given in lines.
The first argument should be a bit list containing one or more of the ?wxSTC_CARET_* constants.
getPrintWrapMode(This) -> integer()
Types
Is printing line wrapped?
The return value will be one of the ?wxSTC_WRAP_* constants.
setHotspotActiveForeground(This, UseSetting, Fore) -> ok
Set a fore colour for active hotspots.
setHotspotActiveBackground(This, UseSetting, Back) -> ok
Set a back colour for active hotspots.
setHotspotActiveUnderline(This, Underline) -> ok
Enable / Disable underlining active hotspots.
setHotspotSingleLine(This, SingleLine) -> ok
Limit hotspots to single line so hotspots on two lines don't merge.
paraDownExtend(This) -> ok
Types
Extend selection down one paragraph (delimited by empty lines).
paraUp(This) -> ok
Types
Move caret up one paragraph (delimited by empty lines).
paraUpExtend(This) -> ok
Types
Extend selection up one paragraph (delimited by empty lines).
positionBefore(This, Pos) -> integer()
Given a valid document position, return the previous position taking code page into account.
Returns 0 if passed 0.
positionAfter(This, Pos) -> integer()
Given a valid document position, return the next position taking code page into account.
Maximum value returned is the last position in the document.
copyRange(This, Start, End) -> ok
Copy a range of text to the clipboard.
Positions are clipped into the document.
copyText(This, Length, Text) -> ok
Copy argument text to the clipboard.
setSelectionMode(This, SelectionMode) -> ok
Set the selection mode to stream (wxSTC_SEL_STREAM) or rectangular (wxSTC_SEL_RECTANGLE/wxSTC_SEL_THIN) or by lines (wxSTC_SEL_LINES).
getSelectionMode(This) -> integer()
Types
Get the mode of the current selection.
The return value will be one of the ?wxSTC_SEL_* constants.
lineDownRectExtend(This) -> ok
Types
Move caret down one line, extending rectangular selection to new caret position.
lineUpRectExtend(This) -> ok
Types
Move caret up one line, extending rectangular selection to new caret position.
charLeftRectExtend(This) -> ok
Types
Move caret left one character, extending rectangular selection to new caret position.
charRightRectExtend(This) -> ok
Types
Move caret right one character, extending rectangular selection to new caret position.
homeRectExtend(This) -> ok
Types
Move caret to first position on line, extending rectangular selection to new caret position.
vCHomeRectExtend(This) -> ok
Types
Move caret to before first visible character on line.
If already there move to first character on line. In either case, extend rectangular selection to new caret position.
lineEndRectExtend(This) -> ok
Types
Move caret to last position on line, extending rectangular selection to new caret position.
pageUpRectExtend(This) -> ok
Types
Move caret one page up, extending rectangular selection to new caret position.
pageDownRectExtend(This) -> ok
Types
Move caret one page down, extending rectangular selection to new caret position.
stutteredPageUp(This) -> ok
Types
Move caret to top of page, or one page up if already at top of page.
stutteredPageUpExtend(This) -> ok
Types
Move caret to top of page, or one page up if already at top of page, extending selection to new caret position.
stutteredPageDown(This) -> ok
Types
Move caret to bottom of page, or one page down if already at bottom of page.
stutteredPageDownExtend(This) -> ok
Types
Move caret to bottom of page, or one page down if already at bottom of page, extending selection to new caret position.
wordLeftEnd(This) -> ok
Types
Move caret left one word, position cursor at end of word.
wordLeftEndExtend(This) -> ok
Types
Move caret left one word, position cursor at end of word, extending selection to new caret position.
wordRightEnd(This) -> ok
Types
Move caret right one word, position cursor at end of word.
wordRightEndExtend(This) -> ok
Types
Move caret right one word, position cursor at end of word, extending selection to new caret position.
setWhitespaceChars(This, Characters) -> ok
Set the set of characters making up whitespace for when moving or selecting by word.
Should be called after SetWordChars.
setCharsDefault(This) -> ok
Types
Reset the set of characters for whitespace and word characters to the defaults.
autoCompGetCurrent(This) -> integer()
Types
Get currently selected item position in the auto-completion list.