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.
wx.stc.StyledTextCtrl is a 1 to 1 mapping of “raw” scintilla interface, whose documentation can be found in the Scintilla website (http://www.scintilla.org/).
Handlers bound for the following event types will receive a wx.stc.StyledTextEvent parameter.
EVT_STC_CHANGE(id, fn): TOWRITE
EVT_STC_STYLENEEDED(id, fn): TOWRITE
EVT_STC_CHARADDED(id, fn): TOWRITE
EVT_STC_SAVEPOINTREACHED(id, fn): TOWRITE
EVT_STC_SAVEPOINTLEFT(id, fn): TOWRITE
EVT_STC_ROMODIFYATTEMPT(id, fn): TOWRITE
EVT_STC_KEY(id, fn): TOWRITE
EVT_STC_DOUBLECLICK(id, fn): TOWRITE
EVT_STC_UPDATEUI(id, fn): TOWRITE
EVT_STC_MODIFIED(id, fn): TOWRITE
EVT_STC_MACRORECORD(id, fn): TOWRITE
EVT_STC_MARGINCLICK(id, fn): TOWRITE
EVT_STC_NEEDSHOWN(id, fn): TOWRITE
EVT_STC_PAINTED(id, fn): TOWRITE
EVT_STC_USERLISTSELECTION(id, fn): TOWRITE
EVT_STC_URIDROPPED(id, fn): TOWRITE
EVT_STC_DWELLSTART(id, fn): TOWRITE
EVT_STC_DWELLEND(id, fn): TOWRITE
EVT_STC_START_DRAG(id, fn): TOWRITE
EVT_STC_DRAG_OVER(id, fn): TOWRITE
EVT_STC_DO_DROP(id, fn): TOWRITE
EVT_STC_ZOOM(id, fn): TOWRITE
EVT_STC_HOTSPOT_CLICK(id, fn): TOWRITE
EVT_STC_HOTSPOT_DCLICK(id, fn): TOWRITE
EVT_STC_CALLTIP_CLICK(id, fn): TOWRITE
EVT_STC_AUTOCOMP_SELECTION(id, fn): TOWRITE
EVT_STC_INDICATOR_CLICK(id, fn): TOWRITE
EVT_STC_INDICATOR_RELEASE(id, fn): TOWRITE
EVT_STC_AUTOCOMP_CANCELLED(id, fn): TOWRITE
EVT_STC_AUTOCOMP_CHAR_DELETED(id, fn): TOWRITE
EVT_STC_HOTSPOT_RELEASE_CLICK(id, fn): TOWRITE
See also
Ctor. |
|
Extend life of document. |
|
Add a selection. |
|
Add array of cells to document. |
|
Add text to the document at current position. |
|
Add text to the document at current position. |
|
Add a container action to the undo stack. |
|
Enlarge the document to a particular size of text bytes. |
|
Clear the annotations from all lines. |
|
Clear annotations from the given line. |
|
Get the number of annotation lines for a line. |
|
Get the style number for the annotations for a line. |
|
Get the start of the range of style numbers used for annotations. |
|
Get the annotation styles for a line. |
|
Get the annotation text for a line. |
|
Get the visibility for the annotations for a view. |
|
Set the style number for the annotations for a line. |
|
Get the start of the range of style numbers used for annotations. |
|
Set the annotation styles for a line. |
|
Set the annotation text for a line. |
|
Set the visibility for the annotations for a view. |
|
Append a string to the end of the document without changing the selection. |
|
Append a string to the end of the document without changing the selection. |
|
Is there an auto-completion list visible? |
|
Remove the auto-completion list from the screen. |
|
User has selected an item so remove the list and insert the selection. |
|
Retrieve whether or not autocompletion is hidden automatically when nothing matches. |
|
Retrieve whether auto-completion cancelled by backspacing before start. |
|
Get auto-completion case insensitive behaviour. |
|
Retrieve whether a single item auto-completion list automatically choose the item. |
|
Get currently selected item position in the auto-completion list. |
|
Retrieve whether or not autocompletion deletes any word characters after the inserted text upon completion. |
|
Retrieve state of ignore case flag. |
|
Set the maximum height, in rows, of auto-completion and user lists. |
|
Get the maximum width, in characters, of auto-completion and user lists. |
|
Retrieve the auto-completion list separator character. |
|
Retrieve the auto-completion list type-separator character. |
|
Retrieve the position of the caret when the auto-completion list was displayed. |
|
Select the item in the auto-completion list that starts with a string. |
|
Set whether or not autocompletion is hidden automatically when nothing matches. |
|
Should the auto-completion list be cancelled if the user backspaces to a position before where the box was created. |
|
Set auto-completion case insensitive behaviour to either prefer case-sensitive matches or have no preference. |
|
Should a single item auto-completion list automatically choose the item. |
|
Set whether or not autocompletion deletes any word characters after the inserted text upon completion. |
|
Define a set of characters that when typed will cause the autocompletion to choose the selected item. |
|
Set whether case is significant when performing auto-completion searches. |
|
Set the maximum height, in rows, of auto-completion and user lists. |
|
Set the maximum width, in characters, of auto-completion and user lists. |
|
Change the separator character in the string setting up an auto-completion list. |
|
Change the type-separator character in the string setting up an auto-completion list. |
|
Display a auto-completion list. |
|
Define a set of character that when typed cancel the auto-completion list. |
|
Call this function to enable auto-completion of the text typed in a single-line text control using the given choices. |
|
Call this function to enable auto-completion of the text using the file system directories. |
|
Call this function to enable auto-completion of the text typed in a single-line text control using all valid file system paths. |
|
Dedent the selected lines. |
|
Start a sequence of actions that is undone and redone as a unit. |
|
Highlight the character at a position indicating there is no matching brace. |
|
Use specified indicator to highlight non matching brace instead of changing its style. |
|
Highlight the characters at two positions. |
|
Use specified indicator to highlight matching braces instead of changing their style. |
|
Find the position of a matching brace or |
|
Is there an active call tip? |
|
Remove the call tip from the screen. |
|
Retrieve the position where the caret was before displaying the call tip. |
|
Set the background colour for the call tip. |
|
Set the foreground colour for the call tip. |
|
Set the foreground colour for the highlighted part of the call tip. |
|
Highlight a segment of the definition. |
|
Set position of calltip, above or below text. |
|
Show a call tip containing a definition near position pos. |
|
Enable use of |
|
Returns |
|
Returns |
|
Will a paste succeed? |
|
Are there any redoable actions in the undo history? |
|
Are there any undoable actions in the undo history? |
|
Cancel any modes such as call tip or auto-completion list display. |
|
Indicate that the internal state of a lexer has changed over a range and therefore there may be a need to redraw. |
|
Sets the new text control value. |
|
Move caret left one character. |
|
Move caret left one character extending selection to new caret position. |
|
Move caret left one character, extending rectangular selection to new caret position. |
|
Find the position of a character from a point within the window. |
|
Find the position of a character from a point within the window. |
|
Move caret right one character. |
|
Move caret right one character extending selection to new caret position. |
|
Move caret right one character, extending rectangular selection to new caret position. |
|
Set the last x chosen value to be the caret x position. |
|
Clear the selection. |
|
Delete all text in the document. |
|
Set all style bytes to 0, remove all folding information. |
|
Clear all the registered images. |
|
Clear selections to a single empty stream selection. |
|
When key+modifier combination km is pressed perform msg. |
|
When key+modifier combination km is pressed do nothing. |
|
Drop all key mappings. |
|
Perform one of the operations defined by the |
|
Colourise a segment of the document using the current lexing language. |
|
Find the next line at or after lineStart that is a contracted fold header line. |
|
Convert all line endings in the document to one mode. |
|
Copy the selection to the clipboard. |
|
Copy the selection, if selection empty copy the line with the caret. |
|
Copy a range of text to the clipboard. |
|
Copy argument text to the clipboard. |
|
Count characters between two positions. |
|
Create the UI elements for a |
|
Create a new document object. |
|
Create an ILoader. |
|
Cut the selection to the clipboard. |
|
Delete back from the current position to the start of the line. |
|
Delete forwards from the current position to the end of the line. |
|
Delete the word to the left of the caret. |
|
Delete the word to the right of the caret. |
|
Delete the word to the right of the caret, but not the trailing non-word characters. |
|
Delete the selection or if no selection, the character before the caret. |
|
Delete the selection or if no selection, the character before the caret. |
|
Delete a range of text in the document. |
|
Retrieve a ‘ |
|
Describe a property. |
|
Allow for simulating a DnD DragOver. |
|
Allow for simulating a DnD DropText. |
|
Find the document line of a display line taking hidden lines into account. |
|
Move caret to last position in document. |
|
Move caret to last position in document extending selection to new caret position. |
|
Move caret to first position in document. |
|
Move caret to first position in document extending selection to new caret position. |
|
Switch from insert to overtype mode or the reverse. |
|
Delete the undo history. |
|
End a sequence of actions that is undone and redone as a unit. |
|
Ensure the caret is visible. |
|
Ensure a particular line is visible by expanding any header line hiding it. |
|
Ensure a particular line is visible by expanding any header line hiding it. |
|
Find the position of a column on a line taking into account tabs and multi-byte characters. |
|
Find some text in the document. |
|
Insert a Form Feed character. |
|
On Windows, will draw the document into a display context such as a printer. |
|
Get the foreground colour of additional carets. |
|
Whether additional carets will blink. |
|
Whether additional carets are visible. |
|
Get the alpha of the selection. |
|
Whether typing can be performed into multiple selections. |
|
Are all lines visible? |
|
Returns the position of the opposite end of the selection to the caret. |
|
Does a backspace pressed when caret is within indentation unindent? |
|
Is drawing done first into a buffer or direct to the screen? |
|
Get the foreground colour of the caret. |
|
Get the background alpha of the caret line. |
|
Get the colour of the background of the line containing the caret. |
|
Is the background of the line containing the caret in a different colour? |
|
Get the time in milliseconds that the caret is on and off. |
|
Can the caret preferred x position only be changed by explicit movement commands? |
|
Returns the current style of the caret. |
|
Returns the width of the insert mode caret. |
|
Returns the character byte at the position. |
|
Compact the document buffer and return a read-only memoryview |
|
Get the code page used to interpret the bytes of the document as characters. |
|
Retrieve the column number of a position, taking tab width into account. |
|
Get the way control characters are displayed. |
|
Retrieve the text of the line containing the caret. |
|
Retrieve the text of the line containing the caret. |
|
Returns the line number of the line with the caret. |
|
Returns the position of the caret. |
|
Returns the style currently used for the new text. |
|
Retrieve a pointer to the document object. |
|
Retrieve the current end of line mode - one of |
|
Retrieve the colour used in edge indication. |
|
Retrieve the column number which text should be kept within. |
|
Retrieve the edge highlight mode. |
|
Retrieve whether the maximum scroll position has the last line at the bottom of the view. |
|
Retrieve the position of the last correctly styled character. |
|
Get extra ascent for each line. |
|
Get extra descent for each line. |
|
Retrieve the display line at the top of the display. |
|
Is a header line expanded? |
|
Retrieve the fold level of a line. |
|
Find the parent line of a child line. |
|
Return a position which, to avoid performance costs, should not be within the range of a call to GetRangePointer. |
|
Get the highlighted indentation guide column. |
|
Returns the current hint string. |
|
Get the back colour for active hotspots. |
|
Get the fore colour for active hotspots. |
|
Get whether underlining for active hotspots. |
|
Get the HotspotSingleLine property. |
|
Get the identifier. |
|
Retrieve indentation size. |
|
Are the indentation guides visible? |
|
Get the current indicator. |
|
Get the current indicator value. |
|
Returns the insertion point, or cursor, position. |
|
Are keys always interpreted as Unicode? |
|
Find the last child line of a header line. |
|
Can be used to prevent the |
|
Returns the zero based index of the last position in the text control, which is equal to the number of characters in the control. |
|
Retrieve the degree of caching of layout information. |
|
Returns the number of bytes in the document. |
|
Retrieve the lexing language of the document. |
|
Retrieve the contents of a line. |
|
Returns the number of lines in the document. |
|
Get the position after the last visible characters on a line. |
|
Retrieve the position before the first non indentation character on a line. |
|
Retrieve the number of columns that a line is indented. |
|
Retrieve the contents of a line. |
|
Retrieve the position of the end of the selection at the given line ( |
|
Retrieve the position of the start of the selection at the given line ( |
|
Retrieve the extra styling information for a line. |
|
Is a line visible? |
|
Which selection is the main selection. |
|
Retrieve the cursor shown in a margin. |
|
Returns the size in pixels of the left margin. |
|
Retrieve the marker mask of a margin. |
|
Get the margin options. |
|
Returns the size in pixels of the right margin. |
|
Retrieve the mouse click sensitivity of a margin. |
|
Retrieve the type of a margin. |
|
Retrieve the width of a margin in pixels. |
|
Returns the margins used by the control. |
|
Which symbol was defined for markerNumber with MarkerDefine. |
|
Retrieve the last line number that has line state. |
|
Get which document modification events are sent to the container. |
|
Is the document different from when it was last saved? |
|
Get whether mouse gets captured. |
|
Retrieve the time the mouse must sit still to generate a mouse dwell event. |
|
Retrieve the effect of pasting when there are multiple selections. |
|
Whether multiple selections can be made. |
|
Returns |
|
Get convert-on-paste setting. |
|
How many entries are allocated to the position cache? |
|
Returns the print colour mode. |
|
Returns the print magnification. |
|
Is printing line wrapped? |
|
Retrieve a ‘property’ value previously set with SetProperty. |
|
Retrieve a ‘property’ value previously set with SetProperty, with ‘$()’ variable replacement on returned buffer. |
|
Retrieve a ‘property’ value previously set with SetProperty, interpreted as an int |
|
Get the set of characters making up punctuation characters. |
|
Returns the string containing the text starting in the positions from and up to to in the control. |
|
Return a read-only pointer to a range of characters in the |
|
In read-only mode? |
|
Get the modifier key used for rectangular selection. |
|
Get cursor type. |
|
Get internal focus flag. |
|
Retrieve the document width assumed for scrolling. |
|
Retrieve whether the scroll width tracks wide lines. |
|
Get the search flags used by SearchInTarget. |
|
Get the alpha of the selection. |
|
Is the selection end of line filled? |
|
Retrieve the selected text. |
|
Retrieve the selected text. |
|
Gets the current selection span. |
|
Returns the position at the end of the selection. |
|
Get the mode of the current selection. |
|
Returns the position at the end of the selection. |
|
Returns the position at the start of the selection. |
|
Returns the position at the start of the selection. |
|
How many selections are there? |
|
Get error status. |
|
Gets the text currently selected in the control. |
|
Returns the style byte at the position. |
|
Retrieve number of bits in style bytes used to hold the lexical state. |
|
Retrieve the number of bits the current lexer needs for styling. |
|
Retrieve a buffer of cells. |
|
Does a tab pressed when caret is within indentation indent? |
|
Retrieve the visible size of a tab. |
|
Retrieve the value of a tag from a regular expression search. |
|
Get the position that ends the target. |
|
Get the position that starts the target. |
|
Get the tech. |
|
Retrieve all the text in the document. |
|
Retrieve the number of characters in the document. |
|
Retrieve a range of text. |
|
Retrieve a range of text. |
|
Retrieve all the text in the document. |
|
Is drawing done in two phases with backgrounds drawn before foregrounds? |
|
Is undo history being collected? |
|
Is the horizontal scroll bar visible? |
|
Retrieve whether tabs will be used in indentation. |
|
Is the vertical scroll bar visible? |
|
Gets the contents of the control. |
|
Are the end of line characters visible? |
|
Are white space characters currently visible? Returns one of |
|
Get the set of characters making up whitespace for when moving or selecting by word. |
|
Get the size of the dots used to mark space characters. |
|
Get the set of characters making up words for when moving or selecting by word. |
|
Retrieve how wrapped sublines are placed. |
|
Retrieve whether text is word wrapped. |
|
Retrieve the start indent for wrapped lines. |
|
Retrieve the display mode of visual flags for wrapped lines. |
|
Retrieve the location of visual flags for wrapped lines. |
|
Retrieve the zoom level. |
|
Set caret to start of a line and ensure it is visible. |
|
Set caret to a position and ensure it is visible. |
|
Make a range of lines invisible. |
|
Draw the selection in normal style or with selection highlighted. |
|
Move caret to first position on line. |
|
Move caret to first position on display line. |
|
Move caret to first position on display line extending selection to new caret position. |
|
Move caret to first position on line extending selection to new caret position. |
|
Move caret to first position on line, extending rectangular selection to new caret position. |
|
These are like their namesakes Home(Extend)?, LineEnd(Extend)?, VCHome(Extend)? except they behave differently when word-wrap is enabled: They go first to the start / end of the display line, like (Home|LineEnd)Display The difference is that, the cursor is already at the point, it goes on to the start or end of the document line, as appropriate for (Home|LineEnd|VCHome)(Extend)?. |
|
Are any indicators present at position? |
|
Turn a indicator off over a range. |
|
Where does a particular indicator end? |
|
Turn a indicator on over a range. |
|
Get the alpha fill colour of the given indicator. |
|
Retrieve the foreground colour of an indicator. |
|
Get the alpha outline colour of the given indicator. |
|
Retrieve the style of an indicator. |
|
Retrieve whether indicator drawn under or over text. |
|
Set the alpha fill colour of the given indicator. |
|
Set the foreground colour of an indicator. |
|
Set the alpha outline colour of the given indicator. |
|
Set an indicator to plain, squiggle or |
|
Set an indicator to draw under text or over(default). |
|
Where does a particular indicator start? |
|
What value does a particular indicator have at at a position? |
|
Insert string at a position. |
|
Insert string at a position. |
|
Returns |
|
Returns |
|
Copy the line containing the caret. |
|
Cut the line containing the caret. |
|
Delete the line containing the caret. |
|
Move caret down one line. |
|
Move caret down one line extending selection to new caret position. |
|
Move caret down one line, extending rectangular selection to new caret position. |
|
Duplicate the current line. |
|
Move caret to last position on line. |
|
Move caret to last position on display line. |
|
Move caret to last position on display line extending selection to new caret position. |
|
Move caret to last position on line extending selection to new caret position. |
|
Move caret to last position on line, extending rectangular selection to new caret position. |
|
Retrieve the line containing a position. |
|
How many characters are on a line, including end of line characters? |
|
Scroll horizontally and vertically. |
|
Scroll the document down, keeping the caret visible. |
|
Scroll the document up, keeping the caret visible. |
|
Switch the current line with the previous. |
|
Move caret up one line. |
|
Move caret up one line extending selection to new caret position. |
|
Move caret up one line, extending rectangular selection to new caret position. |
|
Join the lines in the target. |
|
Retrieves the number of lines completely visible. |
|
Split the lines in the target into lines that are less wide than pixelWidth where possible. |
|
Load the contents of filename into the editor. |
|
Transform the selection to lower case. |
|
Get the style number for the text margin for a line. |
|
Get the start of the range of style numbers used for margin text. |
|
Get the styles in the text margin for a line. |
|
Get the text in the text margin for a line. |
|
Set the style number for the text margin for a line. |
|
Get the start of the range of style numbers used for margin text. |
|
Set the style in the text margin for a line. |
|
Set the text in the text margin for a line. |
|
Clear the margin text on all lines. |
|
Add a marker to a line, returning an |
|
Add a set of markers to a line. |
|
Set the symbol used for a particular marker number, and optionally the fore and background colours. |
|
Define a marker from a bitmap. |
|
Define a marker from |
|
Delete a marker from a line. |
|
Delete all markers with a particular number from all lines. |
|
Delete a marker. |
|
Enable/disable highlight for current folding bloc (smallest one that contains the caret) |
|
Get a bit mask of all the markers set on a line. |
|
Retrieve the line number at which a particular marker is located. |
|
Find the next line at or after lineStart that includes a marker in mask. |
|
Find the previous line before lineStart that includes a marker in mask. |
|
Set the alpha used for a marker that is drawn in the text area, not the margin. |
|
Set the background colour used for a particular marker number. |
|
Set the background colour used for a particular marker number when its folding block is selected. |
|
Set the foreground colour used for a particular marker number. |
|
Move the caret inside current view if it’s not there already. |
|
Move the selected lines down one line, shifting the line below before the selection. |
|
Move the selected lines up one line, shifting the line above after the selection. |
|
Insert a new line, may use a |
|
Move caret one page down. |
|
Move caret one page down extending selection to new caret position. |
|
Move caret one page down, extending rectangular selection to new caret position. |
|
Move caret one page up. |
|
Move caret one page up extending selection to new caret position. |
|
Move caret one page up, extending rectangular selection to new caret position. |
|
Move caret between paragraphs (delimited by empty lines). |
|
Paste the contents of the clipboard into the document replacing the selection. |
|
Retrieve the point in the window where a position is displayed. |
|
Given a valid document position, return the next position taking code page into account. |
|
Given a valid document position, return the previous position taking code page into account. |
|
Retrieve the position at the start of a line. |
|
Find the position from a point within the window. |
|
Find the position from a point within the window but return |
|
Converts given text position to client coordinates in pixels. |
|
For private communication between an application and a known lexer. |
|
Retrieve a ‘ |
|
Retrieve the type of a property. |
|
Set the height for future |
|
Set the width for future |
|
Redoes the next action on the undo history. |
|
Register an image for use in autocompletion lists. |
|
Register an |
|
Release a reference to the document, deleting document if it fades to black. |
|
Removes the text starting at the first given position up to (but not including) the character at the last position. |
|
Replaces the text starting at the first position up to (but not including) the character at the last position with the given text. |
|
Replace the selected text with the argument text. |
|
Replace the target text with the argument text. |
|
Replace the target text with the argument text after \d processing. |
|
Set the main selection to the next selection. |
|
Write the contents of the editor to filename. |
|
Scroll enough to make the given column visible. |
|
Scroll to end of document. |
|
Scroll enough to make the given line visible. |
|
Scroll to start of document. |
|
Sets the current caret position to be the search anchor. |
|
Search for a counted string in the target and set the target to the found range. |
|
Find some text starting at the search anchor. |
|
Find some text starting at the search anchor and moving backwards. |
|
Select all the text in the document. |
|
Deselects selected text in the control. |
|
Duplicate the selection. |
|
Is the selection rectangular? The alternative is the more common stream selection. |
|
Send a message to Scintilla. |
|
Set the foreground colour of additional carets. |
|
Set whether additional carets will blink. |
|
Set whether additional carets are visible. |
|
Set the alpha of the selection. |
|
Set the background colour of additional selections. |
|
Set the foreground colour of additional selections. |
|
Set whether typing can be performed into multiple selections. |
|
Set the selection anchor to a position. |
|
Sets whether a backspace pressed when caret is within indentation unindents. |
|
If drawing is buffered then each line of text is drawn into a bitmap buffer before drawing it to the screen to avoid flicker. |
|
Set the foreground colour of the caret. |
|
Set background alpha of the caret line. |
|
Set the colour of the background of the line containing the caret. |
|
Display the background of the line containing the caret in a different colour. |
|
Get the time in milliseconds that the caret is on and off. |
|
Stop the caret preferred x position changing when the user types. |
|
Set the style of the caret to be drawn. |
|
Set the width of the insert mode caret. |
|
Reset the set of characters for whitespace and word characters to the defaults. |
|
Set the code page used to interpret the bytes of the document as characters. |
|
Change the way control characters are displayed: If symbol is < 32, keep the drawn way, else, use the given character. |
|
Sets the position of the caret. |
|
Change the document object used. |
|
Set the current end of line mode. |
|
Change the colour used in edge indication. |
|
Set the column number of the edge. |
|
The edge may be displayed by a line ( |
|
Makes the text item editable or read-only, overriding the |
|
Set caret to a position, while removing any existing selection. |
|
Sets the scroll range so that maximum scroll position has the last line at the bottom of the view (default). |
|
Set extra ascent for each line. |
|
Set extra descent for each line. |
|
Scroll so that a display line is at the top of the display. |
|
Show the children of a header line. |
|
Set some style options for folding. |
|
Set the fold level of a line. |
|
Set the colours used as a chequerboard pattern in the fold margin. |
|
Set the horizontal scrollbar to use instead of the ont that’s built-in. |
|
Set the highlighted indentation guide column. |
|
Sets a hint shown in an empty unfocused text control. |
|
Set a back colour for active hotspots. |
|
Set a fore colour for active hotspots. |
|
Enable / Disable underlining active hotspots. |
|
Limit hotspots to single line so hotspots on two lines don’t merge. |
|
Set the identifier reported as idFrom in notification messages. |
|
Set the number of spaces used for one level of indentation. |
|
Show or hide indentation guides. |
|
Set the indicator used for IndicatorFillRange and IndicatorClearRange. |
|
Set the value used for IndicatorFillRange. |
|
Sets the insertion point at the given position. |
|
Sets the insertion point at the end of the text control. |
|
Set up the key words used by the lexer. |
|
Always interpret keyboard input as Unicode. |
|
Sets the degree of caching of layout information. |
|
Set the lexing language of the document. |
|
Set the lexing language of the document based on string name. |
|
Change the indentation of a line to a number of columns. |
|
Used to hold extra styling information for each line. |
|
Set the main selection. |
|
Set the cursor shown when the mouse is inside a margin. |
|
Sets the size in pixels of the left margin. |
|
Set a mask that determines which markers are displayed in a margin. |
|
Set the margin options. |
|
Sets the size in pixels of the right margin. |
|
Make a margin sensitive or insensitive to mouse clicks. |
|
Set a margin to be either numeric or symbolic. |
|
Set the width of a margin to a width expressed in pixels. |
|
Set the left and right margin in the edit area, measured in pixels. |
|
This function sets the maximum number of characters the user can enter into the control. |
|
Set which document modification events are sent to the container. |
|
Marks the control as being modified by the user or not. |
|
Set whether the mouse is captured when its button is pressed. |
|
Sets the time the mouse must sit still to generate a mouse dwell event. |
|
Change the effect of pasting when there are multiple selections. |
|
Set whether multiple selections can be made. |
|
Set to overtype ( |
|
Enable/Disable convert-on-paste for line endings. |
|
Set number of entries in position cache. |
|
Modify colours when printing for clearer printed text. |
|
Sets the print magnification added to the point size of each style for printing. |
|
Set printing to line wrapped ( |
|
Set up a value that may be used by a lexer for some optional feature. |
|
Set the set of characters making up punctuation characters Should be called after SetWordChars. |
|
Set to read only or read write. |
|
On GTK+, allow selecting the modifier key to use for mouse-based rectangular selection. |
|
Sets the cursor to one of the |
|
Change internal focus flag. |
|
Remember the current position in the undo history as the position at which the document was saved. |
|
Sets the document width assumed for scrolling. |
|
Sets whether the maximum width line displayed is used to set scroll width. |
|
Set the search flags used by SearchInTarget. |
|
Set the alpha of the selection. |
|
Set the background colour of the main and additional selections and whether to use this setting. |
|
Set the selection to have its end of line filled or not. |
|
Set the foreground colour of the main and additional selections and whether to use this setting. |
|
Selects the text starting at the first position up to (but not including) the character at the last position. |
|
Sets the position that ends the selection - this becomes the currentPosition. |
|
Set the selection mode to stream ( |
|
Sets the position that ends the selection - this becomes the currentPosition. |
|
Sets the position that starts the selection - this becomes the anchor. |
|
Sets the position that starts the selection - this becomes the anchor. |
|
Change error status - 0 = |
|
Divide each styling byte into lexical class bits (default: 5) and indicator bits (default: 3). |
|
Set the styles for a segment of the document. |
|
Change style from current styling position for length characters to a style and move the current styling position to after this newly styled segment. |
|
Sets whether a tab pressed when caret is within indentation indents. |
|
Change the visible size of a tab to be a multiple of the width of a space character. |
|
Sets the position that ends the target which is used for updating the document without affecting the scroll position. |
|
Sets the position that starts the target which is used for updating the document without affecting the scroll position. |
|
Set the technology used. |
|
Replace the contents of the document with the argument text. |
|
Replace the contents of the document with the argument text. |
|
In twoPhaseDraw mode, drawing is performed in two phases, first the background and then the foreground. |
|
Choose between collecting actions into the undo history and discarding them. |
|
Show or hide the horizontal scroll bar. |
|
Indentation will only use space characters if useTabs is |
|
Show or hide the vertical scroll bar. |
|
Set the vertical scrollbar to use instead of the ont that’s built-in. |
|
Sets the new text control value. |
|
Make the end of line characters visible or invisible. |
|
Make white space characters invisible, always visible or visible outside indentation. |
|
Set the way the display area is determined when a particular line is to be moved to by Find, FindNext, GotoLine, etc. |
|
Set the background colour of all whitespace and whether to use this setting. |
|
Set the set of characters making up whitespace for when moving or selecting by word. |
|
Set the foreground colour of all whitespace and whether to use this setting. |
|
Set the size of the dots used to mark space characters. |
|
Set the set of characters making up words for when moving or selecting by word. |
|
Sets how wrapped sublines are placed. |
|
Sets whether text is word wrapped. |
|
Set the start indent for wrapped lines. |
|
Set the display mode of visual flags for wrapped lines. |
|
Set the location of visual flags for wrapped lines. |
|
Set the way the caret is kept visible when going sideways. |
|
Get and Set the xOffset (ie, horizontal scroll position). |
|
Set the way the line the caret is on is kept visible. |
|
Set the zoom level. |
|
Make a range of lines visible. |
|
Start notifying the container of all key presses and commands. |
|
Set the current styling position to pos and the styling mask to mask. |
|
Stop notifying the container of all key presses and commands. |
|
Move caret to bottom of page, or one page down if already at bottom of page. |
|
Move caret to bottom of page, or one page down if already at bottom of page, extending selection to new caret position. |
|
Move caret to top of page, or one page up if already at top of page. |
|
Move caret to top of page, or one page up if already at top of page, extending selection to new caret position. |
|
Clear all the styles and make equivalent to the global default style. |
|
Get the background colour of a style. |
|
Get is a style bold or not. |
|
Get is a style mixed case, or to force upper or lower case. |
|
Get is a style changeable or not (read only). |
|
Get the character set of the font in a style. |
|
Get is a style to have its end of line filled or not. |
|
Get the font facename of a style. |
|
Get the font of a style. |
|
Get the foreground colour of a style. |
|
Get is a style a hotspot or not. |
|
Get is a style italic or not. |
|
Get the size of characters of a style. |
|
Get the size of characters of a style in points multiplied by 100. |
|
Get is a style underlined or not. |
|
Get is a style visible or not. |
|
Get the weight of characters of a style. |
|
Reset the default style to its state at startup. |
|
Set the background colour of a style. |
|
Set a style to be bold or not. |
|
Set a style to be mixed case, or to force upper or lower case. |
|
Set a style to be changeable or not (read only). |
|
Set the character set of the font in a style. |
|
Set a style to have its end of line filled or not. |
|
Set the font of a style. |
|
Set style size, face, bold, italic, and underline attributes from a wx.Font’s attributes. |
|
Set all font style attributes at once. |
|
Set the font encoding to be used by a style. |
|
Set the foreground colour of a style. |
|
Set a style to be a hotspot or not. |
|
Set a style to be italic or not. |
|
Set the size of characters of a style. |
|
Set the size of characters of a style. |
|
Extract style settings from a spec-string which is composed of one or more of the following comma separated elements |
|
Set a style to be underlined or not. |
|
Set a style to be visible or not. |
|
Set the weight of characters of a style. |
|
Swap that caret and anchor of the main selection. |
|
If selection is empty or all on one line replace the selection with a tab character. |
|
Make the target range start and end be the same as the selection range start and end. |
|
Retrieve the height of a particular line of text in pixels. |
|
Measure the pixel width of some text in a particular style. |
|
Switch between sticky and non-sticky: meant to be bound to a key. |
|
Switch a header line between expanded and contracted. |
|
Undo one action in the undo history. |
|
Transform the selection to upper case. |
|
Set whether a pop up menu is displayed automatically when the user presses the wrong mouse button. |
|
Display a list of strings and send notification when user chooses one. |
|
Move caret to before first visible character on line. |
|
Like VCHome but extending selection to new caret position. |
|
Move caret to before first visible character on line. |
|
Centre current line in window. |
|
Find the display line of a document line taking hidden lines into account. |
|
Get position of end of word. |
|
Move caret left one word. |
|
Move caret left one word, position cursor at end of word. |
|
Move caret left one word, position cursor at end of word, extending selection to new caret position. |
|
Move caret left one word extending selection to new caret position. |
|
Move to the previous change in capitalisation. |
|
Move to the previous change in capitalisation extending selection to new caret position. |
|
Move to the change next in capitalisation. |
|
Move to the next change in capitalisation extending selection to new caret position. |
|
Move caret right one word. |
|
Move caret right one word, position cursor at end of word. |
|
Move caret right one word, position cursor at end of word, extending selection to new caret position. |
|
Move caret right one word extending selection to new caret position. |
|
Get position of start of word. |
|
The number of display lines needed to wrap a document line. |
|
Writes the text into the text control at the current insertion position. |
|
Magnify the displayed text by increasing the sizes by 1 point. |
|
Make the displayed text smaller by decreasing the sizes by 1 point. |
|
|
|
Append text to the textctrl, for file-like compatibility. |
wx.stc.
StyledTextCtrl
(Control)¶Possible constructors:
StyledTextCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize,
style=0, name=STCNameStr)
StyledTextCtrl()
A wxWidgets implementation of the Scintilla source code editing component.
__init__
(self, *args, **kw)¶__init__ (self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=STCNameStr)
Ctor.
__init__ (self)
Default constructor.
AddRefDocument
(self, docPointer)¶Extend life of document.
docPointer –
AddSelection
(self, caret, anchor)¶Add a selection.
caret (int) –
anchor (int) –
int
AddStyledText
(self, data)¶Add array of cells to document.
data (MemoryBuffer) –
AddText
(self, text)¶Add text to the document at current position.
text (string) –
AddTextRaw
(self, text, length=-1)¶Add text to the document at current position.
text (int) –
length (int) –
AddUndoAction
(self, token, flags)¶Add a container action to the undo stack.
token (int) –
flags (int) –
Allocate
(self, bytes)¶Enlarge the document to a particular size of text bytes.
bytes (int) –
AnnotationClearAll
(self)¶Clear the annotations from all lines.
AnnotationClearLine
(self, line)¶Clear annotations from the given line.
line (int) –
AnnotationGetLines
(self, line)¶Get the number of annotation lines for a line.
line (int) –
int
AnnotationGetStyle
(self, line)¶Get the style number for the annotations for a line.
line (int) –
int
AnnotationGetStyleOffset
(self)¶Get the start of the range of style numbers used for annotations.
int
AnnotationGetStyles
(self, line)¶Get the annotation styles for a line.
line (int) –
string
AnnotationGetText
(self, line)¶Get the annotation text for a line.
line (int) –
string
AnnotationGetVisible
(self)¶Get the visibility for the annotations for a view.
int
AnnotationSetStyle
(self, line, style)¶Set the style number for the annotations for a line.
line (int) –
style (int) –
AnnotationSetStyleOffset
(self, style)¶Get the start of the range of style numbers used for annotations.
style (int) –
AnnotationSetStyles
(self, line, styles)¶Set the annotation styles for a line.
line (int) –
styles (string) –
AnnotationSetText
(self, line, text)¶Set the annotation text for a line.
line (int) –
text (string) –
AnnotationSetVisible
(self, visible)¶Set the visibility for the annotations for a view.
visible (int) –
AppendText
(self, text)¶Append a string to the end of the document without changing the selection.
text (string) –
AppendTextRaw
(self, text, length=-1)¶Append a string to the end of the document without changing the selection.
text (int) –
length (int) –
AutoCompActive
(self)¶Is there an auto-completion list visible?
bool
AutoCompCancel
(self)¶Remove the auto-completion list from the screen.
AutoCompComplete
(self)¶User has selected an item so remove the list and insert the selection.
AutoCompGetAutoHide
(self)¶Retrieve whether or not autocompletion is hidden automatically when nothing matches.
bool
AutoCompGetCancelAtStart
(self)¶Retrieve whether auto-completion cancelled by backspacing before start.
bool
AutoCompGetCaseInsensitiveBehaviour
(self)¶Get auto-completion case insensitive behaviour.
int
AutoCompGetChooseSingle
(self)¶Retrieve whether a single item auto-completion list automatically choose the item.
bool
AutoCompGetCurrent
(self)¶Get currently selected item position in the auto-completion list.
int
AutoCompGetDropRestOfWord
(self)¶Retrieve whether or not autocompletion deletes any word characters after the inserted text upon completion.
bool
AutoCompGetIgnoreCase
(self)¶Retrieve state of ignore case flag.
bool
AutoCompGetMaxHeight
(self)¶Set the maximum height, in rows, of auto-completion and user lists.
int
AutoCompGetMaxWidth
(self)¶Get the maximum width, in characters, of auto-completion and user lists.
int
AutoCompGetSeparator
(self)¶Retrieve the auto-completion list separator character.
int
AutoCompGetTypeSeparator
(self)¶Retrieve the auto-completion list type-separator character.
int
AutoCompPosStart
(self)¶Retrieve the position of the caret when the auto-completion list was displayed.
int
AutoCompSelect
(self, text)¶Select the item in the auto-completion list that starts with a string.
text (string) –
AutoCompSetAutoHide
(self, autoHide)¶Set whether or not autocompletion is hidden automatically when nothing matches.
autoHide (bool) –
AutoCompSetCancelAtStart
(self, cancel)¶Should the auto-completion list be cancelled if the user backspaces to a position before where the box was created.
cancel (bool) –
AutoCompSetCaseInsensitiveBehaviour
(self, behaviour)¶Set auto-completion case insensitive behaviour to either prefer case-sensitive matches or have no preference.
behaviour (int) –
AutoCompSetChooseSingle
(self, chooseSingle)¶Should a single item auto-completion list automatically choose the item.
chooseSingle (bool) –
AutoCompSetDropRestOfWord
(self, dropRestOfWord)¶Set whether or not autocompletion deletes any word characters after the inserted text upon completion.
dropRestOfWord (bool) –
AutoCompSetFillUps
(self, characterSet)¶Define a set of characters that when typed will cause the autocompletion to choose the selected item.
characterSet (string) –
AutoCompSetIgnoreCase
(self, ignoreCase)¶Set whether case is significant when performing auto-completion searches.
ignoreCase (bool) –
AutoCompSetMaxHeight
(self, rowCount)¶Set the maximum height, in rows, of auto-completion and user lists.
The default is 5 rows.
rowCount (int) –
AutoCompSetMaxWidth
(self, characterCount)¶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.
characterCount (int) –
AutoCompSetSeparator
(self, separatorCharacter)¶Change the separator character in the string setting up an auto-completion list.
Default is space but can be changed if items contain space.
separatorCharacter (int) –
AutoCompSetTypeSeparator
(self, separatorCharacter)¶Change the type-separator character in the string setting up an auto-completion list.
Default is ‘?’ but can be changed if items contain ‘?’.
separatorCharacter (int) –
AutoCompShow
(self, lenEntered, itemList)¶Display a auto-completion list.
The lenEntered parameter indicates how many characters before the caret should be used to provide context.
lenEntered (int) –
itemList (string) –
AutoCompStops
(self, characterSet)¶Define a set of character that when typed cancel the auto-completion list.
characterSet (string) –
AutoComplete
(self, *args, **kw)¶AutoComplete (self, choices)
Call this function to enable auto-completion of the text typed in a single-line text control using the given choices.
Notice that currently this function is only implemented in wxGTK2, wxMSW and OSX/Cocoa (for wx.TextCtrl only, but not for wx.ComboBox) ports and does nothing under the other platforms.
choices (list of strings) –
bool
True
if the auto-completion was enabled or False
if the operation failed, typically because auto-completion is not supported by the current platform.
New in version 2.9.0.
See also
AutoComplete (self, completer)
Enable auto-completion using the provided completer object.
This method should be used instead of AutoComplete
overload taking the array of possible completions if the total number of strings is too big as it allows returning the completions dynamically, depending on the text already entered by user and so is more efficient.
The specified completer object will be used to retrieve the list of possible completions for the already entered text and will be deleted by wx.TextEntry itself when it’s not needed any longer.
Notice that you need to include /textcompleter.h in order to define your class inheriting from wx.TextCompleter.
Currently this method is only implemented in wxMSW and OSX/Cocoa (for wx.TextCtrl only, but not for wx.ComboBox).
completer (wx.TextCompleter) – The object to be used for generating completions if not None
. If it is None
, auto-completion is disabled. The wx.TextEntry object takes ownership of this pointer and will delete it in any case (i.e. even if this method returns False
).
bool
True
if the auto-completion was enabled or False
if the operation failed, typically because auto-completion is not supported by the current platform.
New in version 2.9.2.
See also
AutoCompleteDirectories
(self)¶Call this function to enable auto-completion of the text using the file system directories.
Unlike AutoCompleteFileNames
which completes both file names and directories, this function only completes the directory names.
Notice that currently this function is only implemented in wxMSW port and does nothing under the other platforms.
bool
True
if the auto-completion was enabled or False
if the operation failed, typically because auto-completion is not supported by the current platform.
New in version 2.9.3.
See also
AutoCompleteFileNames
(self)¶Call this function to enable auto-completion of the text typed in a single-line text control using all valid file system paths.
Notice that currently this function is only implemented in wxMSW port and does nothing under the other platforms.
bool
True
if the auto-completion was enabled or False
if the operation failed, typically because auto-completion is not supported by the current platform.
New in version 2.9.0.
See also
BackTab
(self)¶Dedent the selected lines.
BeginUndoAction
(self)¶Start a sequence of actions that is undone and redone as a unit.
May be nested.
BraceBadLight
(self, pos)¶Highlight the character at a position indicating there is no matching brace.
pos (int) –
BraceBadLightIndicator
(self, useBraceBadLightIndicator, indicator)¶Use specified indicator to highlight non matching brace instead of changing its style.
useBraceBadLightIndicator (bool) –
indicator (int) –
BraceHighlight
(self, pos1, pos2)¶Highlight the characters at two positions.
pos1 (int) –
pos2 (int) –
BraceHighlightIndicator
(self, useBraceHighlightIndicator, indicator)¶Use specified indicator to highlight matching braces instead of changing their style.
useBraceHighlightIndicator (bool) –
indicator (int) –
BraceMatch
(self, pos)¶Find the position of a matching brace or INVALID_POSITION
if no match.
pos (int) –
int
CallTipActive
(self)¶Is there an active call tip?
bool
CallTipCancel
(self)¶Remove the call tip from the screen.
CallTipPosAtStart
(self)¶Retrieve the position where the caret was before displaying the call tip.
int
CallTipSetBackground
(self, back)¶Set the background colour for the call tip.
back (wx.Colour) –
CallTipSetForeground
(self, fore)¶Set the foreground colour for the call tip.
fore (wx.Colour) –
CallTipSetForegroundHighlight
(self, fore)¶Set the foreground colour for the highlighted part of the call tip.
fore (wx.Colour) –
CallTipSetHighlight
(self, start, end)¶Highlight a segment of the definition.
start (int) –
end (int) –
CallTipSetPosition
(self, above)¶Set position of calltip, above or below text.
above (bool) –
CallTipShow
(self, pos, definition)¶Show a call tip containing a definition near position pos.
pos (int) –
definition (string) –
CallTipUseStyle
(self, tabSize)¶Enable use of STYLE_CALLTIP
and set call tip tab size in pixels.
tabSize (int) –
CanCopy
(self)¶Returns True
if the selection can be copied to the clipboard.
bool
CanCut
(self)¶Returns True
if the selection can be cut to the clipboard.
bool
CanPaste
(self)¶Will a paste succeed?
bool
CanRedo
(self)¶Are there any redoable actions in the undo history?
bool
CanUndo
(self)¶Are there any undoable actions in the undo history?
bool
Cancel
(self)¶Cancel any modes such as call tip or auto-completion list display.
ChangeLexerState
(self, start, end)¶Indicate that the internal state of a lexer has changed over a range and therefore there may be a need to redraw.
start (int) –
end (int) –
int
ChangeValue
(self, value)¶Sets the new text control value.
It also marks the control as not-modified which means that IsModified() would return False
immediately after the call to ChangeValue
.
The insertion point is set to the start of the control (i.e. position 0) by this function.
This functions does not generate the wxEVT_TEXT
event but otherwise is identical to SetValue
.
See User Generated Events vs Programmatically Generated Events for more information.
value (string) – The new value to set. It may contain newline characters if the text control is multi-line.
New in version 2.7.1.
CharLeft
(self)¶Move caret left one character.
CharLeftExtend
(self)¶Move caret left one character extending selection to new caret position.
CharLeftRectExtend
(self)¶Move caret left one character, extending rectangular selection to new caret position.
CharPositionFromPoint
(self, x, y)¶Find the position of a character from a point within the window.
x (int) –
y (int) –
int
CharPositionFromPointClose
(self, x, y)¶Find the position of a character from a point within the window.
Return INVALID_POSITION
if not close to text.
x (int) –
y (int) –
int
CharRight
(self)¶Move caret right one character.
CharRightExtend
(self)¶Move caret right one character extending selection to new caret position.
CharRightRectExtend
(self)¶Move caret right one character, extending rectangular selection to new caret position.
ChooseCaretX
(self)¶Set the last x chosen value to be the caret x position.
Clear
(self)¶Clear the selection.
ClearAll
(self)¶Delete all text in the document.
ClearDocumentStyle
(self)¶Set all style bytes to 0, remove all folding information.
ClearRegisteredImages
(self)¶Clear all the registered images.
ClearSelections
(self)¶Clear selections to a single empty stream selection.
CmdKeyAssign
(self, key, modifiers, cmd)¶When key+modifier combination km is pressed perform msg.
key (int) –
modifiers (int) –
cmd (int) –
CmdKeyClear
(self, key, modifiers)¶When key+modifier combination km is pressed do nothing.
key (int) –
modifiers (int) –
CmdKeyClearAll
(self)¶Drop all key mappings.
CmdKeyExecute
(self, cmd)¶Perform one of the operations defined by the STC_CMD_
constants.
cmd (int) –
Colourise
(self, start, end)¶Colourise a segment of the document using the current lexing language.
start (int) –
end (int) –
ContractedFoldNext
(self, lineStart)¶Find the next line at or after lineStart that is a contracted fold header line.
Return -1 when no more lines.
lineStart (int) –
int
ConvertEOLs
(self, eolMode)¶Convert all line endings in the document to one mode.
eolMode (int) –
Copy
(self)¶Copy the selection to the clipboard.
CopyAllowLine
(self)¶Copy the selection, if selection empty copy the line with the caret.
CopyRange
(self, start, end)¶Copy a range of text to the clipboard.
Positions are clipped into the document.
start (int) –
end (int) –
CopyText
(self, length, text)¶Copy argument text to the clipboard.
length (int) –
text (string) –
CountCharacters
(self, startPos, endPos)¶Count characters between two positions.
startPos (int) –
endPos (int) –
int
Create
(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=STCNameStr)¶Create the UI elements for a STC
that was created with the default constructor.
(For 2-phase create.)
CreateDocument
(self)¶Create a new document object.
Starts with reference count of 1 and not selected into editor.
CreateLoader
(self, bytes)¶Create an ILoader.
bytes (int) –
Cut
(self)¶Cut the selection to the clipboard.
DelLineLeft
(self)¶Delete back from the current position to the start of the line.
DelLineRight
(self)¶Delete forwards from the current position to the end of the line.
DelWordLeft
(self)¶Delete the word to the left of the caret.
DelWordRight
(self)¶Delete the word to the right of the caret.
DelWordRightEnd
(self)¶Delete the word to the right of the caret, but not the trailing non-word characters.
DeleteBack
(self)¶Delete the selection or if no selection, the character before the caret.
DeleteBackNotLine
(self)¶Delete the selection or if no selection, the character before the caret.
Will not delete the character before at the start of a line.
DeleteRange
(self, pos, deleteLength)¶Delete a range of text in the document.
pos (int) –
deleteLength (int) –
DescribeKeyWordSets
(self)¶Retrieve a ‘
‘ separated list of descriptions of the keyword sets understood by the current lexer.
string
DescribeProperty
(self, name)¶Describe a property.
name (string) –
string
DiscardEdits
(self)¶DoDragOver
(self, x, y, defaultRes)¶Allow for simulating a DnD DragOver.
x (int) –
y (int) –
defaultRes (DragResult) –
DoDropText
(self, x, y, data)¶Allow for simulating a DnD DropText.
x (long) –
y (long) –
data (string) –
bool
DocLineFromVisible
(self, lineDisplay)¶Find the document line of a display line taking hidden lines into account.
lineDisplay (int) –
int
DocumentEnd
(self)¶Move caret to last position in document.
DocumentEndExtend
(self)¶Move caret to last position in document extending selection to new caret position.
DocumentStart
(self)¶Move caret to first position in document.
DocumentStartExtend
(self)¶Move caret to first position in document extending selection to new caret position.
EditToggleOvertype
(self)¶Switch from insert to overtype mode or the reverse.
EmptyUndoBuffer
(self)¶Delete the undo history.
EndUndoAction
(self)¶End a sequence of actions that is undone and redone as a unit.
EnsureCaretVisible
(self)¶Ensure the caret is visible.
EnsureVisible
(self, line)¶Ensure a particular line is visible by expanding any header line hiding it.
line (int) –
EnsureVisibleEnforcePolicy
(self, line)¶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.
line (int) –
FindColumn
(self, line, column)¶Find the position of a column on a line taking into account tabs and multi-byte characters.
If beyond end of line, return line end position.
line (int) –
column (int) –
int
FindText
(self, minPos, maxPos, text, flags=0)¶Find some text in the document.
minPos (int) –
maxPos (int) –
text (string) –
flags (int) –
int
FormFeed
(self)¶Insert a Form Feed character.
FormatRange
(self, doDraw, startPos, endPos, draw, target, renderRect, pageRect)¶On Windows, will draw the document into a display context such as a printer.
GetAdditionalCaretForeground
(self)¶Get the foreground colour of additional carets.
Colour
GetAdditionalCaretsBlink
(self)¶Whether additional carets will blink.
bool
GetAdditionalCaretsVisible
(self)¶Whether additional carets are visible.
bool
GetAdditionalSelAlpha
(self)¶Get the alpha of the selection.
int
GetAdditionalSelectionTyping
(self)¶Whether typing can be performed into multiple selections.
bool
GetAllLinesVisible
(self)¶Are all lines visible?
bool
GetAnchor
(self)¶Returns the position of the opposite end of the selection to the caret.
int
GetBackSpaceUnIndents
(self)¶Does a backspace pressed when caret is within indentation unindent?
bool
GetBufferedDraw
(self)¶Is drawing done first into a buffer or direct to the screen?
bool
GetCaretForeground
(self)¶Get the foreground colour of the caret.
Colour
GetCaretLineBackAlpha
(self)¶Get the background alpha of the caret line.
int
GetCaretLineBackground
(self)¶Get the colour of the background of the line containing the caret.
Colour
GetCaretLineVisible
(self)¶Is the background of the line containing the caret in a different colour?
bool
GetCaretPeriod
(self)¶Get the time in milliseconds that the caret is on and off.
int
GetCaretSticky
(self)¶Can the caret preferred x position only be changed by explicit movement commands?
int
GetCaretStyle
(self)¶Returns the current style of the caret.
int
GetCaretWidth
(self)¶Returns the width of the insert mode caret.
int
GetCharAt
(self, pos)¶Returns the character byte at the position.
pos (int) –
int
GetCharacterPointer
(self)¶Compact the document buffer and return a read-only memoryview object of the characters in the document.
PyObject
GetClassDefaultAttributes
(variant=WINDOW_VARIANT_NORMAL)¶variant (WindowVariant) –
VisualAttributes
GetCodePage
(self)¶Get the code page used to interpret the bytes of the document as characters.
int
GetColumn
(self, pos)¶Retrieve the column number of a position, taking tab width into account.
pos (int) –
int
GetControlCharSymbol
(self)¶Get the way control characters are displayed.
int
GetCurLine
(self)¶Retrieve the text of the line containing the caret.
Returns the index of the caret on the line.
tuple
( String , linePos )
GetCurLineRaw
(self)¶Retrieve the text of the line containing the caret.
Returns the index of the caret on the line.
tuple
( CharBuffer , linePos )
GetCurrentLine
(self)¶Returns the line number of the line with the caret.
int
GetCurrentPos
(self)¶Returns the position of the caret.
int
GetDefaultStyle
(self)¶Returns the style currently used for the new text.
See also
GetDocPointer
(self)¶Retrieve a pointer to the document object.
GetEOLMode
(self)¶Retrieve the current end of line mode - one of CRLF
, CR
, or LF
.
int
GetEdgeColour
(self)¶Retrieve the colour used in edge indication.
Colour
GetEdgeColumn
(self)¶Retrieve the column number which text should be kept within.
int
GetEdgeMode
(self)¶Retrieve the edge highlight mode.
int
GetEndAtLastLine
(self)¶Retrieve whether the maximum scroll position has the last line at the bottom of the view.
bool
GetEndStyled
(self)¶Retrieve the position of the last correctly styled character.
int
GetExtraAscent
(self)¶Get extra ascent for each line.
int
GetExtraDescent
(self)¶Get extra descent for each line.
int
GetFirstVisibleLine
(self)¶Retrieve the display line at the top of the display.
int
GetFoldExpanded
(self, line)¶Is a header line expanded?
line (int) –
bool
GetFoldLevel
(self, line)¶Retrieve the fold level of a line.
line (int) –
int
GetFoldParent
(self, line)¶Find the parent line of a child line.
line (int) –
int
GetGapPosition
(self)¶Return a position which, to avoid performance costs, should not be within the range of a call to GetRangePointer.
int
GetHighlightGuide
(self)¶Get the highlighted indentation guide column.
int
GetHint
(self)¶Returns the current hint string.
See SetHint
for more information about hints.
string
New in version 2.9.0.
GetHotspotActiveBackground
(self)¶Get the back colour for active hotspots.
Colour
GetHotspotActiveForeground
(self)¶Get the fore colour for active hotspots.
Colour
GetHotspotActiveUnderline
(self)¶Get whether underlining for active hotspots.
bool
GetHotspotSingleLine
(self)¶Get the HotspotSingleLine property.
bool
GetIdentifier
(self)¶Get the identifier.
int
GetIndent
(self)¶Retrieve indentation size.
int
GetIndentationGuides
(self)¶Are the indentation guides visible?
int
GetIndicatorCurrent
(self)¶Get the current indicator.
int
GetIndicatorValue
(self)¶Get the current indicator value.
int
GetInsertionPoint
(self)¶Returns the insertion point, or cursor, position.
This is defined as the zero based index of the character position to the right of the insertion point. For example, if the insertion point is at the end of the single-line text control, it is equal to GetLastPosition
.
Notice that insertion position is, in general, different from the index of the character the cursor position at in the string returned by GetValue
. While this is always the case for the single line controls, multi-line controls can use two characters "\\r\\n"
as line separator (this is notably the case under MSW) meaning that indices in the control and its string value are offset by 1 for every line.
Hence to correctly get the character at the current cursor position, taking into account that there can be none if the cursor is at the end of the string, you could do the following:
def GetCurrentChar(self, text_ctrl):
pos = text_ctrl.GetInsertionPoint()
if pos == text_ctrl.GetLastPosition():
return ''
return text_ctrl.GetRange(pos, pos + 1)
long
GetKeysUnicode
(self)¶Are keys always interpreted as Unicode?
bool
GetLastChild
(self, line, level)¶Find the last child line of a header line.
line (int) –
level (int) –
int
GetLastKeydownProcessed
(self)¶Can be used to prevent the EVT_CHAR
handler from adding the char.
bool
GetLastPosition
(self)¶Returns the zero based index of the last position in the text control, which is equal to the number of characters in the control.
long
GetLayoutCache
(self)¶Retrieve the degree of caching of layout information.
int
GetLength
(self)¶Returns the number of bytes in the document.
int
GetLexer
(self)¶Retrieve the lexing language of the document.
int
GetLibraryVersionInfo
()¶VersionInfo
GetLine
(self, line)¶Retrieve the contents of a line.
line (int) –
string
GetLineCount
(self)¶Returns the number of lines in the document.
There is always at least one.
int
GetLineEndPosition
(self, line)¶Get the position after the last visible characters on a line.
line (int) –
int
GetLineIndentPosition
(self, line)¶Retrieve the position before the first non indentation character on a line.
line (int) –
int
GetLineIndentation
(self, line)¶Retrieve the number of columns that a line is indented.
line (int) –
int
GetLineLength
(self, n)¶n (long) –
int
GetLineRaw
(self, line)¶Retrieve the contents of a line.
line (int) –
CharBuffer
GetLineSelEndPosition
(self, line)¶Retrieve the position of the end of the selection at the given line (INVALID_POSITION
if no selection on this line).
line (int) –
int
GetLineSelStartPosition
(self, line)¶Retrieve the position of the start of the selection at the given line (INVALID_POSITION
if no selection on this line).
line (int) –
int
GetLineState
(self, line)¶Retrieve the extra styling information for a line.
line (int) –
int
GetLineText
(self, n)¶n (long) –
string
GetLineVisible
(self, line)¶Is a line visible?
line (int) –
bool
GetMainSelection
(self)¶Which selection is the main selection.
int
GetMarginCursor
(self, margin)¶Retrieve the cursor shown in a margin.
margin (int) –
int
GetMarginLeft
(self)¶Returns the size in pixels of the left margin.
int
GetMarginMask
(self, margin)¶Retrieve the marker mask of a margin.
margin (int) –
int
GetMarginOptions
(self)¶Get the margin options.
int
GetMarginRight
(self)¶Returns the size in pixels of the right margin.
int
GetMarginSensitive
(self, margin)¶Retrieve the mouse click sensitivity of a margin.
margin (int) –
bool
GetMarginType
(self, margin)¶Retrieve the type of a margin.
margin (int) –
int
GetMarginWidth
(self, margin)¶Retrieve the width of a margin in pixels.
margin (int) –
int
GetMargins
(self)¶Returns the margins used by the control.
The x
field of the returned point is the horizontal margin and the y
field is the vertical one.
New in version 2.9.1.
Note
If given margin cannot be accurately determined, its value will be set to -1. On some platforms you cannot obtain valid margin values until you have called SetMargins
.
See also
GetMarkerSymbolDefined
(self, markerNumber)¶Which symbol was defined for markerNumber with MarkerDefine.
markerNumber (int) –
int
GetMaxLineState
(self)¶Retrieve the last line number that has line state.
int
GetModEventMask
(self)¶Get which document modification events are sent to the container.
int
GetModify
(self)¶Is the document different from when it was last saved?
bool
GetMouseDownCaptures
(self)¶Get whether mouse gets captured.
bool
GetMouseDwellTime
(self)¶Retrieve the time the mouse must sit still to generate a mouse dwell event.
int
GetMultiPaste
(self)¶Retrieve the effect of pasting when there are multiple selections.
int
GetMultipleSelection
(self)¶Whether multiple selections can be made.
bool
GetNumberOfLines
(self)¶int
GetOvertype
(self)¶Returns True
if overtype mode is active otherwise False
is returned.
bool
GetPasteConvertEndings
(self)¶Get convert-on-paste setting.
bool
GetPositionCacheSize
(self)¶How many entries are allocated to the position cache?
int
GetPrintColourMode
(self)¶Returns the print colour mode.
int
GetPrintMagnification
(self)¶Returns the print magnification.
int
GetPrintWrapMode
(self)¶Is printing line wrapped?
int
GetProperty
(self, key)¶Retrieve a ‘property’ value previously set with SetProperty.
key (string) –
string
GetPropertyExpanded
(self, key)¶Retrieve a ‘property’ value previously set with SetProperty, with ‘$()’ variable replacement on returned buffer.
key (string) –
string
GetPropertyInt
(self, key)¶Retrieve a ‘property’ value previously set with SetProperty, interpreted as an int AFTER
any ‘$()’ variable replacement.
key (string) –
int
GetPunctuationChars
(self)¶Get the set of characters making up punctuation characters.
string
GetRange
(self, from_, to_)¶Returns the string containing the text starting in the positions from and up to to in the control.
The positions must have been returned by another wx.TextCtrl method. Please note that the positions in a multiline wx.TextCtrl do not correspond to the indices in the string returned by GetValue
because of the different new line representations ( CR
or CR
LF
) and so this method should be used to obtain the correct results instead of extracting parts of the entire value. It may also be more efficient, especially if the control contains a lot of data.
from_ (long) –
to_ (long) –
string
GetRangePointer
(self, position, rangeLength)¶Return a read-only pointer to a range of characters in the document. May move the gap so that the range is contiguous, but will only move up to rangeLength bytes.
PyObject
GetReadOnly
(self)¶In read-only mode?
bool
GetRectangularSelectionAnchor
(self)¶int
GetRectangularSelectionAnchorVirtualSpace
(self)¶int
GetRectangularSelectionCaret
(self)¶int
GetRectangularSelectionCaretVirtualSpace
(self)¶int
GetRectangularSelectionModifier
(self)¶Get the modifier key used for rectangular selection.
int
GetSTCCursor
(self)¶Get cursor type.
int
GetSTCFocus
(self)¶Get internal focus flag.
bool
GetScrollWidth
(self)¶Retrieve the document width assumed for scrolling.
int
GetScrollWidthTracking
(self)¶Retrieve whether the scroll width tracks wide lines.
bool
GetSearchFlags
(self)¶Get the search flags used by SearchInTarget.
int
GetSelAlpha
(self)¶Get the alpha of the selection.
int
GetSelEOLFilled
(self)¶Is the selection end of line filled?
bool
GetSelectedText
(self)¶Retrieve the selected text.
string
GetSelectedTextRaw
(self)¶Retrieve the selected text.
CharBuffer
GetSelection
(self)¶Gets the current selection span.
If the returned values are equal, there was no selection. Please note that the indices returned may be used with the other wx.TextCtrl methods but don’t necessarily represent the correct indices into the string returned by GetValue
for multiline controls under Windows (at least,) you should use GetStringSelection
to get the selected text.
The returned first position.
The returned last position.
tuple
GetSelectionEnd
(self)¶Returns the position at the end of the selection.
int
GetSelectionMode
(self)¶Get the mode of the current selection.
int
GetSelectionNAnchor
(self, selection)¶selection (int) –
int
GetSelectionNAnchorVirtualSpace
(self, selection)¶selection (int) –
int
GetSelectionNCaret
(self, selection)¶selection (int) –
int
GetSelectionNCaretVirtualSpace
(self, selection)¶selection (int) –
int
GetSelectionNEnd
(self, selection)¶Returns the position at the end of the selection.
selection (int) –
int
GetSelectionNStart
(self, selection)¶Returns the position at the start of the selection.
selection (int) –
int
GetSelectionStart
(self)¶Returns the position at the start of the selection.
int
GetSelections
(self)¶How many selections are there?
int
GetStatus
(self)¶Get error status.
int
GetStringSelection
(self)¶Gets the text currently selected in the control.
If there is no selection, the returned string is empty.
string
GetStyle
(self, position, style)¶position (long) –
style (wx.TextAttr) –
bool
GetStyleAt
(self, pos)¶Returns the style byte at the position.
pos (int) –
int
GetStyleBits
(self)¶Retrieve number of bits in style bytes used to hold the lexical state.
int
GetStyleBitsNeeded
(self)¶Retrieve the number of bits the current lexer needs for styling.
int
GetStyledText
(self, startPos, endPos)¶Retrieve a buffer of cells.
startPos (int) –
endPos (int) –
MemoryBuffer
GetTabIndents
(self)¶Does a tab pressed when caret is within indentation indent?
bool
GetTabWidth
(self)¶Retrieve the visible size of a tab.
int
GetTag
(self, tagNumber)¶Retrieve the value of a tag from a regular expression search.
tagNumber (int) –
string
GetTargetEnd
(self)¶Get the position that ends the target.
int
GetTargetStart
(self)¶Get the position that starts the target.
int
GetTechnology
(self)¶Get the tech.
int
GetText
(self)¶Retrieve all the text in the document.
string
GetTextLength
(self)¶Retrieve the number of characters in the document.
int
GetTextRange
(self, startPos, endPos)¶Retrieve a range of text.
startPos (int) –
endPos (int) –
string
GetTextRangeRaw
(self, startPos, endPos)¶Retrieve a range of text.
startPos (int) –
endPos (int) –
CharBuffer
GetTextRaw
(self)¶Retrieve all the text in the document.
CharBuffer
GetTwoPhaseDraw
(self)¶Is drawing done in two phases with backgrounds drawn before foregrounds?
bool
GetUndoCollection
(self)¶Is undo history being collected?
bool
GetUseHorizontalScrollBar
(self)¶Is the horizontal scroll bar visible?
bool
GetUseTabs
(self)¶Retrieve whether tabs will be used in indentation.
bool
GetUseVerticalScrollBar
(self)¶Is the vertical scroll bar visible?
bool
GetValue
(self)¶Gets the contents of the control.
Notice that for a multiline text control, the lines will be separated by (Unix-style) \n
characters, even under Windows where they are separated by a \r\n
sequence in the native control.
string
GetViewEOL
(self)¶Are the end of line characters visible?
bool
GetViewWhiteSpace
(self)¶Are white space characters currently visible? Returns one of SCWS_
constants.
int
GetVirtualSpaceOptions
(self)¶int
GetWhitespaceChars
(self)¶Get the set of characters making up whitespace for when moving or selecting by word.
string
GetWhitespaceSize
(self)¶Get the size of the dots used to mark space characters.
int
GetWordChars
(self)¶Get the set of characters making up words for when moving or selecting by word.
string
GetWrapIndentMode
(self)¶Retrieve how wrapped sublines are placed.
Default is fixed.
int
GetWrapMode
(self)¶Retrieve whether text is word wrapped.
int
GetWrapStartIndent
(self)¶Retrieve the start indent for wrapped lines.
int
GetWrapVisualFlags
(self)¶Retrieve the display mode of visual flags for wrapped lines.
int
GetWrapVisualFlagsLocation
(self)¶Retrieve the location of visual flags for wrapped lines.
int
GetXOffset
(self)¶int
GetZoom
(self)¶Retrieve the zoom level.
int
GotoLine
(self, line)¶Set caret to start of a line and ensure it is visible.
line (int) –
GotoPos
(self, pos)¶Set caret to a position and ensure it is visible.
pos (int) –
HideLines
(self, lineStart, lineEnd)¶Make a range of lines invisible.
lineStart (int) –
lineEnd (int) –
HideSelection
(self, normal)¶Draw the selection in normal style or with selection highlighted.
normal (bool) –
HitTestPos
(self, pt)¶pt (wx.Point) –
tuple
( wx.TextCtrlHitTestResult, pos )
HitTest
(self, pt)¶pt (wx.Point) –
tuple
( wx.TextCtrlHitTestResult, col, row )
Home
(self)¶Move caret to first position on line.
HomeDisplay
(self)¶Move caret to first position on display line.
HomeDisplayExtend
(self)¶Move caret to first position on display line extending selection to new caret position.
HomeExtend
(self)¶Move caret to first position on line extending selection to new caret position.
HomeRectExtend
(self)¶Move caret to first position on line, extending rectangular selection to new caret position.
HomeWrap
(self)¶These are like their namesakes Home(Extend)?, LineEnd(Extend)?, VCHome(Extend)? except they behave differently when word-wrap is enabled: They go first to the start / end of the display line, like (Home|LineEnd)Display The difference is that, the cursor is already at the point, it goes on to the start or end of the document line, as appropriate for (Home|LineEnd|VCHome)(Extend)?.
HomeWrapExtend
(self)¶IndicatorAllOnFor
(self, position)¶Are any indicators present at position?
position (int) –
int
IndicatorClearRange
(self, position, clearLength)¶Turn a indicator off over a range.
position (int) –
clearLength (int) –
IndicatorEnd
(self, indicator, position)¶Where does a particular indicator end?
indicator (int) –
position (int) –
int
IndicatorFillRange
(self, position, fillLength)¶Turn a indicator on over a range.
position (int) –
fillLength (int) –
IndicatorGetAlpha
(self, indicator)¶Get the alpha fill colour of the given indicator.
indicator (int) –
int
IndicatorGetForeground
(self, indic)¶Retrieve the foreground colour of an indicator.
indic (int) –
Colour
IndicatorGetOutlineAlpha
(self, indicator)¶Get the alpha outline colour of the given indicator.
indicator (int) –
int
IndicatorGetStyle
(self, indic)¶Retrieve the style of an indicator.
indic (int) –
int
IndicatorGetUnder
(self, indic)¶Retrieve whether indicator drawn under or over text.
indic (int) –
bool
IndicatorSetAlpha
(self, indicator, alpha)¶Set the alpha fill colour of the given indicator.
indicator (int) –
alpha (int) –
IndicatorSetForeground
(self, indic, fore)¶Set the foreground colour of an indicator.
indic (int) –
fore (wx.Colour) –
IndicatorSetOutlineAlpha
(self, indicator, alpha)¶Set the alpha outline colour of the given indicator.
indicator (int) –
alpha (int) –
IndicatorSetStyle
(self, indic, style)¶Set an indicator to plain, squiggle or TT
.
indic (int) –
style (int) –
IndicatorSetUnder
(self, indic, under)¶Set an indicator to draw under text or over(default).
indic (int) –
under (bool) –
IndicatorStart
(self, indicator, position)¶Where does a particular indicator start?
indicator (int) –
position (int) –
int
IndicatorValueAt
(self, indicator, position)¶What value does a particular indicator have at at a position?
indicator (int) –
position (int) –
int
InsertText
(self, pos, text)¶Insert string at a position.
pos (int) –
text (string) –
InsertTextRaw
(self, pos, text)¶Insert string at a position.
pos (int) –
text (int) –
IsEditable
(self)¶Returns True
if the controls contents may be edited by user (note that it always can be changed by the program).
In other words, this functions returns True
if the control hasn’t been put in read-only mode by a previous call to SetEditable
.
bool
IsEmpty
(self)¶Returns True
if the control is currently empty.
This is the same as GetValue
.empty() but can be much more efficient for the multiline controls containing big amounts of text.
bool
New in version 2.7.1.
IsModified
(self)¶bool
LineCopy
(self)¶Copy the line containing the caret.
LineCut
(self)¶Cut the line containing the caret.
LineDelete
(self)¶Delete the line containing the caret.
LineDown
(self)¶Move caret down one line.
LineDownExtend
(self)¶Move caret down one line extending selection to new caret position.
LineDownRectExtend
(self)¶Move caret down one line, extending rectangular selection to new caret position.
LineDuplicate
(self)¶Duplicate the current line.
LineEnd
(self)¶Move caret to last position on line.
LineEndDisplay
(self)¶Move caret to last position on display line.
LineEndDisplayExtend
(self)¶Move caret to last position on display line extending selection to new caret position.
LineEndExtend
(self)¶Move caret to last position on line extending selection to new caret position.
LineEndRectExtend
(self)¶Move caret to last position on line, extending rectangular selection to new caret position.
LineEndWrap
(self)¶LineEndWrapExtend
(self)¶LineFromPosition
(self, pos)¶Retrieve the line containing a position.
pos (int) –
int
LineLength
(self, line)¶How many characters are on a line, including end of line characters?
line (int) –
int
LineScroll
(self, columns, lines)¶Scroll horizontally and vertically.
columns (int) –
lines (int) –
LineScrollDown
(self)¶Scroll the document down, keeping the caret visible.
LineScrollUp
(self)¶Scroll the document up, keeping the caret visible.
LineTranspose
(self)¶Switch the current line with the previous.
LineUp
(self)¶Move caret up one line.
LineUpExtend
(self)¶Move caret up one line extending selection to new caret position.
LineUpRectExtend
(self)¶Move caret up one line, extending rectangular selection to new caret position.
LinesJoin
(self)¶Join the lines in the target.
LinesOnScreen
(self)¶Retrieves the number of lines completely visible.
int
LinesSplit
(self, pixelWidth)¶Split the lines in the target into lines that are less wide than pixelWidth where possible.
pixelWidth (int) –
LoadFile
(self, filename)¶Load the contents of filename into the editor.
filename (string) –
bool
LowerCase
(self)¶Transform the selection to lower case.
MarginGetStyle
(self, line)¶Get the style number for the text margin for a line.
line (int) –
int
MarginGetStyleOffset
(self)¶Get the start of the range of style numbers used for margin text.
int
MarginGetStyles
(self, line)¶Get the styles in the text margin for a line.
line (int) –
string
MarginGetText
(self, line)¶Get the text in the text margin for a line.
line (int) –
string
MarginSetStyle
(self, line, style)¶Set the style number for the text margin for a line.
line (int) –
style (int) –
MarginSetStyleOffset
(self, style)¶Get the start of the range of style numbers used for margin text.
style (int) –
MarginSetStyles
(self, line, styles)¶Set the style in the text margin for a line.
line (int) –
styles (string) –
MarginSetText
(self, line, text)¶Set the text in the text margin for a line.
line (int) –
text (string) –
MarginTextClearAll
(self)¶Clear the margin text on all lines.
MarkDirty
(self)¶MarkerAdd
(self, line, markerNumber)¶Add a marker to a line, returning an ID
which can be used to find or delete the marker.
line (int) –
markerNumber (int) –
int
MarkerAddSet
(self, line, set)¶Add a set of markers to a line.
line (int) –
set (int) –
MarkerDefine
(self, markerNumber, markerSymbol, foreground=NullColour, background=NullColour)¶Set the symbol used for a particular marker number, and optionally the fore and background colours.
MarkerDefineBitmap
(self, markerNumber, bmp)¶Define a marker from a bitmap.
markerNumber (int) –
bmp (wx.Bitmap) –
MarkerDefineRGBAImage
(self, markerNumber, pixels)¶Define a marker from RGBA
data.
It has the width and height from RGBAImageSetWidth/Height. You must ensure that the buffer is at least widthheight4 bytes long.
MarkerDelete
(self, line, markerNumber)¶Delete a marker from a line.
line (int) –
markerNumber (int) –
MarkerDeleteAll
(self, markerNumber)¶Delete all markers with a particular number from all lines.
markerNumber (int) –
MarkerDeleteHandle
(self, handle)¶Delete a marker.
handle (int) –
MarkerEnableHighlight
(self, enabled)¶Enable/disable highlight for current folding bloc (smallest one that contains the caret)
enabled (bool) –
MarkerGet
(self, line)¶Get a bit mask of all the markers set on a line.
line (int) –
int
MarkerLineFromHandle
(self, handle)¶Retrieve the line number at which a particular marker is located.
handle (int) –
int
MarkerNext
(self, lineStart, markerMask)¶Find the next line at or after lineStart that includes a marker in mask.
Return -1 when no more lines.
lineStart (int) –
markerMask (int) –
int
MarkerPrevious
(self, lineStart, markerMask)¶Find the previous line before lineStart that includes a marker in mask.
lineStart (int) –
markerMask (int) –
int
MarkerSetAlpha
(self, markerNumber, alpha)¶Set the alpha used for a marker that is drawn in the text area, not the margin.
markerNumber (int) –
alpha (int) –
MarkerSetBackground
(self, markerNumber, back)¶Set the background colour used for a particular marker number.
markerNumber (int) –
back (wx.Colour) –
MarkerSetBackgroundSelected
(self, markerNumber, back)¶Set the background colour used for a particular marker number when its folding block is selected.
markerNumber (int) –
back (wx.Colour) –
MarkerSetForeground
(self, markerNumber, fore)¶Set the foreground colour used for a particular marker number.
markerNumber (int) –
fore (wx.Colour) –
MoveCaretInsideView
(self)¶Move the caret inside current view if it’s not there already.
MoveSelectedLinesDown
(self)¶Move the selected lines down one line, shifting the line below before the selection.
MoveSelectedLinesUp
(self)¶Move the selected lines up one line, shifting the line above after the selection.
NewLine
(self)¶Insert a new line, may use a CRLF
, CR
or LF
depending on EOL
mode.
PageDown
(self)¶Move caret one page down.
PageDownExtend
(self)¶Move caret one page down extending selection to new caret position.
PageDownRectExtend
(self)¶Move caret one page down, extending rectangular selection to new caret position.
PageUp
(self)¶Move caret one page up.
PageUpExtend
(self)¶Move caret one page up extending selection to new caret position.
PageUpRectExtend
(self)¶Move caret one page up, extending rectangular selection to new caret position.
ParaDown
(self)¶Move caret between paragraphs (delimited by empty lines).
ParaDownExtend
(self)¶ParaUp
(self)¶ParaUpExtend
(self)¶Paste
(self)¶Paste the contents of the clipboard into the document replacing the selection.
PointFromPosition
(self, pos)¶Retrieve the point in the window where a position is displayed.
pos (int) –
Point
PositionAfter
(self, pos)¶Given a valid document position, return the next position taking code page into account.
Maximum value returned is the last position in the document.
pos (int) –
int
PositionBefore
(self, pos)¶Given a valid document position, return the previous position taking code page into account.
Returns 0 if passed 0.
pos (int) –
int
PositionFromLine
(self, line)¶Retrieve the position at the start of a line.
line (int) –
int
PositionFromPoint
(self, pt)¶Find the position from a point within the window.
pt (wx.Point) –
int
PositionFromPointClose
(self, x, y)¶Find the position from a point within the window but return INVALID_POSITION
if not close to text.
x (int) –
y (int) –
int
PositionToCoords
(self, pos)¶Converts given text position to client coordinates in pixels.
This function allows finding where is the character at the given position displayed in the text control.
pos (long) – Text position in 0 to GetLastPosition
range (inclusive).
On success returns a wx.Point which contains client coordinates for the given position in pixels, otherwise returns wx.DefaultPosition
.
New in version 2.9.3.
Availability
Only available for MSW, GTK . Additionally, wxGTK only implements this method for multiline controls and wx.DefaultPosition
is always returned for the single line ones.
See also
PositionToXY
(self, pos)¶pos (long) –
tuple
( bool, x, y )
PrivateLexerCall
(self, operation, pointer)¶For private communication between an application and a known lexer.
operation (int) –
pointer –
PropertyNames
(self)¶Retrieve a ‘
‘ separated list of properties understood by the current lexer.
string
PropertyType
(self, name)¶Retrieve the type of a property.
name (string) –
int
RGBAImageSetHeight
(self, height)¶Set the height for future RGBA
image data.
height (int) –
RGBAImageSetWidth
(self, width)¶Set the width for future RGBA
image data.
width (int) –
Redo
(self)¶Redoes the next action on the undo history.
RegisterImage
(self, type, bmp)¶Register an image for use in autocompletion lists.
type (int) –
bmp (wx.Bitmap) –
RegisterRGBAImage
(self, type, pixels)¶Register an RGBA
image for use in autocompletion lists.
It has the width and height from RGBAImageSetWidth/Height. You must ensure that the buffer is at least widthheight4 bytes long.
ReleaseDocument
(self, docPointer)¶Release a reference to the document, deleting document if it fades to black.
docPointer –
Remove
(self, from_, to_)¶Removes the text starting at the first given position up to (but not including) the character at the last position.
This function puts the current insertion point position at to as a side effect.
from_ (long) –
to_ (long) –
The first position.
The last position.
Replace
(self, from_, to_, value)¶Replaces the text starting at the first position up to (but not including) the character at the last position with the given text.
This function puts the current insertion point position at to as a side effect.
from_ (long) –
to_ (long) –
value (string) – The value to replace the existing text with.
The first position.
The last position.
ReplaceSelection
(self, text)¶Replace the selected text with the argument text.
text (string) –
ReplaceTarget
(self, text)¶Replace the target text with the argument text.
Text is counted so it can contain NULs. Returns the length of the replacement text.
text (string) –
int
ReplaceTargetRE
(self, text)¶Replace the target text with the argument text after \d processing.
Text is counted so it can contain NULs. Looks for \d where d is between 1 and 9 and replaces these with the strings matched in the last search operation which were surrounded by ( and ). Returns the length of the replacement text including any change caused by processing the \d patterns.
text (string) –
int
RotateSelection
(self)¶Set the main selection to the next selection.
SaveFile
(self, filename)¶Write the contents of the editor to filename.
filename (string) –
bool
ScrollToColumn
(self, column)¶Scroll enough to make the given column visible.
column (int) –
ScrollToEnd
(self)¶Scroll to end of document.
ScrollToLine
(self, line)¶Scroll enough to make the given line visible.
line (int) –
ScrollToStart
(self)¶Scroll to start of document.
SearchAnchor
(self)¶Sets the current caret position to be the search anchor.
SearchInTarget
(self, text)¶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.
text (string) –
int
SearchNext
(self, flags, text)¶Find some text starting at the search anchor.
Does not ensure the selection is visible.
flags (int) –
text (string) –
int
SearchPrev
(self, flags, text)¶Find some text starting at the search anchor and moving backwards.
Does not ensure the selection is visible.
flags (int) –
text (string) –
int
SelectAll
(self)¶Select all the text in the document.
SelectNone
(self)¶Deselects selected text in the control.
New in version 2.9.5.
SelectionDuplicate
(self)¶Duplicate the selection.
If selection empty duplicate the line containing the caret.
SelectionIsRectangle
(self)¶Is the selection rectangular? The alternative is the more common stream selection.
bool
SendMsg
(self, msg, wp=0, lp=0)¶Send a message to Scintilla.
msg (int) –
wp (wx.UIntPtr) –
lp (wx.IntPtr) –
wx.IntPtr
SetAdditionalCaretForeground
(self, fore)¶Set the foreground colour of additional carets.
fore (wx.Colour) –
SetAdditionalCaretsBlink
(self, additionalCaretsBlink)¶Set whether additional carets will blink.
additionalCaretsBlink (bool) –
SetAdditionalCaretsVisible
(self, additionalCaretsBlink)¶Set whether additional carets are visible.
additionalCaretsBlink (bool) –
SetAdditionalSelAlpha
(self, alpha)¶Set the alpha of the selection.
alpha (int) –
SetAdditionalSelBackground
(self, back)¶Set the background colour of additional selections.
Must have previously called SetSelBack with non-zero first argument for this to have an effect.
back (wx.Colour) –
SetAdditionalSelForeground
(self, fore)¶Set the foreground colour of additional selections.
Must have previously called SetSelFore with non-zero first argument for this to have an effect.
fore (wx.Colour) –
SetAdditionalSelectionTyping
(self, additionalSelectionTyping)¶Set whether typing can be performed into multiple selections.
additionalSelectionTyping (bool) –
SetAnchor
(self, posAnchor)¶Set the selection anchor to a position.
The anchor is the opposite end of the selection from the caret.
posAnchor (int) –
SetBackSpaceUnIndents
(self, bsUnIndents)¶Sets whether a backspace pressed when caret is within indentation unindents.
bsUnIndents (bool) –
SetBufferedDraw
(self, buffered)¶If drawing is buffered then each line of text is drawn into a bitmap buffer before drawing it to the screen to avoid flicker.
buffered (bool) –
SetCaretForeground
(self, fore)¶Set the foreground colour of the caret.
fore (wx.Colour) –
SetCaretLineBackAlpha
(self, alpha)¶Set background alpha of the caret line.
alpha (int) –
SetCaretLineBackground
(self, back)¶Set the colour of the background of the line containing the caret.
back (wx.Colour) –
SetCaretLineVisible
(self, show)¶Display the background of the line containing the caret in a different colour.
show (bool) –
SetCaretPeriod
(self, periodMilliseconds)¶Get the time in milliseconds that the caret is on and off.
0 = steady on.
periodMilliseconds (int) –
SetCaretSticky
(self, useCaretStickyBehaviour)¶Stop the caret preferred x position changing when the user types.
useCaretStickyBehaviour (int) –
SetCaretStyle
(self, caretStyle)¶Set the style of the caret to be drawn.
caretStyle (int) –
SetCaretWidth
(self, pixelWidth)¶Set the width of the insert mode caret.
pixelWidth (int) –
SetCharsDefault
(self)¶Reset the set of characters for whitespace and word characters to the defaults.
SetCodePage
(self, codePage)¶Set the code page used to interpret the bytes of the document as characters.
codePage (int) –
SetControlCharSymbol
(self, symbol)¶Change the way control characters are displayed: If symbol is < 32, keep the drawn way, else, use the given character.
symbol (int) –
SetCurrentPos
(self, pos)¶Sets the position of the caret.
pos (int) –
SetDefaultStyle
(self, style)¶style (wx.TextAttr) –
bool
SetDocPointer
(self, docPointer)¶Change the document object used.
docPointer –
SetEOLMode
(self, eolMode)¶Set the current end of line mode.
eolMode (int) –
SetEdgeColour
(self, edgeColour)¶Change the colour used in edge indication.
edgeColour (wx.Colour) –
SetEdgeColumn
(self, column)¶Set the column number of the edge.
If text goes past the edge then it is highlighted.
column (int) –
SetEdgeMode
(self, mode)¶The edge may be displayed by a line (EDGE_LINE
) or by highlighting text that goes beyond it (EDGE_BACKGROUND
) or not displayed at all (EDGE_NONE
).
mode (int) –
SetEditable
(self, editable)¶Makes the text item editable or read-only, overriding the wx.TE_READONLY
flag.
editable (bool) – If True
, the control is editable. If False
, the control is read-only.
See also
SetEmptySelection
(self, pos)¶Set caret to a position, while removing any existing selection.
pos (int) –
SetEndAtLastLine
(self, endAtLastLine)¶Sets the scroll range so that maximum scroll position has the last line at the bottom of the view (default).
Setting this to False
allows scrolling one page below the last line.
endAtLastLine (bool) –
SetExtraAscent
(self, extraAscent)¶Set extra ascent for each line.
extraAscent (int) –
SetExtraDescent
(self, extraDescent)¶Set extra descent for each line.
extraDescent (int) –
SetFirstVisibleLine
(self, lineDisplay)¶Scroll so that a display line is at the top of the display.
lineDisplay (int) –
SetFoldExpanded
(self, line, expanded)¶Show the children of a header line.
line (int) –
expanded (bool) –
SetFoldFlags
(self, flags)¶Set some style options for folding.
flags (int) –
SetFoldLevel
(self, line, level)¶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.
line (int) –
level (int) –
SetFoldMarginColour
(self, useSetting, back)¶Set the colours used as a chequerboard pattern in the fold margin.
useSetting (bool) –
back (wx.Colour) –
SetHScrollBar
(self, bar)¶Set the horizontal scrollbar to use instead of the ont that’s built-in.
bar (wx.ScrollBar) –
SetHighlightGuide
(self, column)¶Set the highlighted indentation guide column.
0 = no highlighted guide.
column (int) –
SetHint
(self, hint)¶Sets a hint shown in an empty unfocused text control.
The hints are usually used to indicate to the user what is supposed to be entered into the given entry field, e.g. a common use of them is to show an explanation of what can be entered in a wx.SearchCtrl.
The hint is shown (usually greyed out) for an empty control until it gets focus and is shown again if the control loses it and remains empty. It won’t be shown once the control has a non-empty value, although it will be shown again if the control contents is cleared. Because of this, it generally only makes sense to use hints with the controls which are initially empty.
Notice that hints are known as cue banners under MSW or placeholder strings under OS X.
hint (string) –
bool
New in version 2.9.0.
Note
For the platforms without native hints support (and currently only the MSW port does have it and even there it is only used under Windows Vista and later only), the implementation has several known limitations. Notably, the hint display will not be properly updated if you change wx.TextEntry contents programmatically when the hint is displayed using methods other than SetValue
or ChangeValue
or others which use them internally (e.g. Clear
). In other words, currently you should avoid calling methods such as WriteText
or Replace
when using hints and the text control is empty.
Note
Hints can only be used for single line text controls, native multi-line text controls don’t support hints under any platform and hence wxWidgets doesn’t provide them neither.
SetHotspotActiveBackground
(self, useSetting, back)¶Set a back colour for active hotspots.
useSetting (bool) –
back (wx.Colour) –
SetHotspotActiveForeground
(self, useSetting, fore)¶Set a fore colour for active hotspots.
useSetting (bool) –
fore (wx.Colour) –
SetHotspotActiveUnderline
(self, underline)¶Enable / Disable underlining active hotspots.
underline (bool) –
SetHotspotSingleLine
(self, singleLine)¶Limit hotspots to single line so hotspots on two lines don’t merge.
singleLine (bool) –
SetIdentifier
(self, identifier)¶Set the identifier reported as idFrom in notification messages.
identifier (int) –
SetIndent
(self, indentSize)¶Set the number of spaces used for one level of indentation.
indentSize (int) –
SetIndentationGuides
(self, indentView)¶Show or hide indentation guides.
indentView (int) –
SetIndicatorCurrent
(self, indicator)¶Set the indicator used for IndicatorFillRange and IndicatorClearRange.
indicator (int) –
SetIndicatorValue
(self, value)¶Set the value used for IndicatorFillRange.
value (int) –
SetInsertionPoint
(self, pos)¶Sets the insertion point at the given position.
pos (long) – Position to set, in the range from 0 to GetLastPosition
inclusive.
SetInsertionPointEnd
(self)¶Sets the insertion point at the end of the text control.
This is equivalent to calling wx.TextCtrl.SetInsertionPoint
with wx.TextCtrl.GetLastPosition
argument.
SetKeyWords
(self, keywordSet, keyWords)¶Set up the key words used by the lexer.
keywordSet (int) –
keyWords (string) –
SetKeysUnicode
(self, keysUnicode)¶Always interpret keyboard input as Unicode.
keysUnicode (bool) –
SetLastKeydownProcessed
(self, val)¶val (bool) –
SetLayoutCache
(self, mode)¶Sets the degree of caching of layout information.
mode (int) –
SetLexer
(self, lexer)¶Set the lexing language of the document.
lexer (int) –
SetLexerLanguage
(self, language)¶Set the lexing language of the document based on string name.
language (string) –
SetLineIndentation
(self, line, indentSize)¶Change the indentation of a line to a number of columns.
line (int) –
indentSize (int) –
SetLineState
(self, line, state)¶Used to hold extra styling information for each line.
line (int) –
state (int) –
SetMainSelection
(self, selection)¶Set the main selection.
selection (int) –
SetMarginCursor
(self, margin, cursor)¶Set the cursor shown when the mouse is inside a margin.
margin (int) –
cursor (int) –
SetMarginLeft
(self, pixelWidth)¶Sets the size in pixels of the left margin.
pixelWidth (int) –
SetMarginMask
(self, margin, mask)¶Set a mask that determines which markers are displayed in a margin.
margin (int) –
mask (int) –
SetMarginOptions
(self, marginOptions)¶Set the margin options.
marginOptions (int) –
SetMarginRight
(self, pixelWidth)¶Sets the size in pixels of the right margin.
pixelWidth (int) –
SetMarginSensitive
(self, margin, sensitive)¶Make a margin sensitive or insensitive to mouse clicks.
margin (int) –
sensitive (bool) –
SetMarginType
(self, margin, marginType)¶Set a margin to be either numeric or symbolic.
margin (int) –
marginType (int) –
SetMarginWidth
(self, margin, pixelWidth)¶Set the width of a margin to a width expressed in pixels.
margin (int) –
pixelWidth (int) –
SetMargins
(self, left, right)¶Set the left and right margin in the edit area, measured in pixels.
left (int) –
right (int) –
SetMaxLength
(self, len)¶This function sets the maximum number of characters the user can enter into the control.
In other words, it allows limiting the text value length to len not counting the terminating NUL
character.
If len is 0, the previously set max length limit, if any, is discarded and the user may enter as much text as the underlying native text control widget supports (typically at least 32Kb). If the user tries to enter more characters into the text control when it already is filled up to the maximal length, a wxEVT_TEXT_MAXLEN
event is sent to notify the program about it (giving it the possibility to show an explanatory message, for example) and the extra input is discarded.
Note that in wxGTK this function may only be used with single line text controls.
len (long) –
SetModEventMask
(self, mask)¶Set which document modification events are sent to the container.
mask (int) –
SetModified
(self, modified)¶Marks the control as being modified by the user or not.
modified (bool) –
See also
SetMouseDownCaptures
(self, captures)¶Set whether the mouse is captured when its button is pressed.
captures (bool) –
SetMouseDwellTime
(self, periodMilliseconds)¶Sets the time the mouse must sit still to generate a mouse dwell event.
periodMilliseconds (int) –
SetMultiPaste
(self, multiPaste)¶Change the effect of pasting when there are multiple selections.
multiPaste (int) –
SetMultipleSelection
(self, multipleSelection)¶Set whether multiple selections can be made.
multipleSelection (bool) –
SetOvertype
(self, overtype)¶Set to overtype (True
) or insert mode.
overtype (bool) –
SetPasteConvertEndings
(self, convert)¶Enable/Disable convert-on-paste for line endings.
convert (bool) –
SetPositionCacheSize
(self, size)¶Set number of entries in position cache.
size (int) –
SetPrintColourMode
(self, mode)¶Modify colours when printing for clearer printed text.
mode (int) –
SetPrintMagnification
(self, magnification)¶Sets the print magnification added to the point size of each style for printing.
magnification (int) –
SetPrintWrapMode
(self, mode)¶Set printing to line wrapped (SC_WRAP_WORD
) or not line wrapped (SC_WRAP_NONE
).
mode (int) –
SetProperty
(self, key, value)¶Set up a value that may be used by a lexer for some optional feature.
key (string) –
value (string) –
SetPunctuationChars
(self, characters)¶Set the set of characters making up punctuation characters Should be called after SetWordChars.
characters (string) –
SetReadOnly
(self, readOnly)¶Set to read only or read write.
readOnly (bool) –
SetRectangularSelectionAnchor
(self, posAnchor)¶posAnchor (int) –
SetRectangularSelectionAnchorVirtualSpace
(self, space)¶space (int) –
SetRectangularSelectionCaret
(self, pos)¶pos (int) –
SetRectangularSelectionCaretVirtualSpace
(self, space)¶space (int) –
SetRectangularSelectionModifier
(self, modifier)¶On GTK+, allow selecting the modifier key to use for mouse-based rectangular selection.
Often the window manager requires Alt+Mouse Drag for moving windows. Valid values are SCMOD_CTRL(default), SCMOD_ALT
, or SCMOD_SUPER
.
modifier (int) –
SetSTCCursor
(self, cursorType)¶Sets the cursor to one of the SC_CURSOR
values.
cursorType (int) –
SetSTCFocus
(self, focus)¶Change internal focus flag.
focus (bool) –
SetSavePoint
(self)¶Remember the current position in the undo history as the position at which the document was saved.
SetScrollWidth
(self, pixelWidth)¶Sets the document width assumed for scrolling.
pixelWidth (int) –
SetScrollWidthTracking
(self, tracking)¶Sets whether the maximum width line displayed is used to set scroll width.
tracking (bool) –
SetSearchFlags
(self, flags)¶Set the search flags used by SearchInTarget.
flags (int) –
SetSelAlpha
(self, alpha)¶Set the alpha of the selection.
alpha (int) –
SetSelBackground
(self, useSetting, back)¶Set the background colour of the main and additional selections and whether to use this setting.
useSetting (bool) –
back (wx.Colour) –
SetSelEOLFilled
(self, filled)¶Set the selection to have its end of line filled or not.
filled (bool) –
SetSelForeground
(self, useSetting, fore)¶Set the foreground colour of the main and additional selections and whether to use this setting.
useSetting (bool) –
fore (wx.Colour) –
SetSelection
(self, from_, to_)¶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.
from_ (long) –
to_ (long) –
The first position.
The last position.
See also
SetSelectionEnd
(self, pos)¶Sets the position that ends the selection - this becomes the currentPosition.
pos (int) –
SetSelectionMode
(self, mode)¶Set the selection mode to stream (SC_SEL_STREAM
) or rectangular (SC_SEL_RECTANGLE/SC_SEL_THIN) or by lines (SC_SEL_LINES
).
mode (int) –
SetSelectionNAnchor
(self, selection, posAnchor)¶selection (int) –
posAnchor (int) –
SetSelectionNAnchorVirtualSpace
(self, selection, space)¶selection (int) –
space (int) –
SetSelectionNCaret
(self, selection, pos)¶selection (int) –
pos (int) –
SetSelectionNCaretVirtualSpace
(self, selection, space)¶selection (int) –
space (int) –
SetSelectionNEnd
(self, selection, pos)¶Sets the position that ends the selection - this becomes the currentPosition.
selection (int) –
pos (int) –
SetSelectionNStart
(self, selection, pos)¶Sets the position that starts the selection - this becomes the anchor.
selection (int) –
pos (int) –
SetSelectionStart
(self, pos)¶Sets the position that starts the selection - this becomes the anchor.
pos (int) –
SetStatus
(self, statusCode)¶Change error status - 0 = wx.OK
.
statusCode (int) –
SetStyle
(self, start, end, style)¶start (long) –
end (long) –
style (wx.TextAttr) –
bool
SetStyleBits
(self, bits)¶Divide each styling byte into lexical class bits (default: 5) and indicator bits (default: 3).
If a lexer requires more than 32 lexical states, then this is used to expand the possible states.
bits (int) –
SetStyleBytes
(self, length, styleBytes)¶Set the styles for a segment of the document.
length (int) –
styleBytes (int) –
SetStyling
(self, length, style)¶Change style from current styling position for length characters to a style and move the current styling position to after this newly styled segment.
length (int) –
style (int) –
SetTabIndents
(self, tabIndents)¶Sets whether a tab pressed when caret is within indentation indents.
tabIndents (bool) –
SetTabWidth
(self, tabWidth)¶Change the visible size of a tab to be a multiple of the width of a space character.
tabWidth (int) –
SetTargetEnd
(self, pos)¶Sets the position that ends the target which is used for updating the document without affecting the scroll position.
pos (int) –
SetTargetStart
(self, pos)¶Sets the position that starts the target which is used for updating the document without affecting the scroll position.
pos (int) –
SetTechnology
(self, technology)¶Set the technology used.
technology (int) –
SetText
(self, text)¶Replace the contents of the document with the argument text.
text (string) –
SetTextRaw
(self, text)¶Replace the contents of the document with the argument text.
text (int) –
SetTwoPhaseDraw
(self, twoPhase)¶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.
twoPhase (bool) –
SetUndoCollection
(self, collectUndo)¶Choose between collecting actions into the undo history and discarding them.
collectUndo (bool) –
SetUseHorizontalScrollBar
(self, show)¶Show or hide the horizontal scroll bar.
show (bool) –
SetUseTabs
(self, useTabs)¶Indentation will only use space characters if useTabs is False
, otherwise it will use a combination of tabs and spaces.
useTabs (bool) –
SetUseVerticalScrollBar
(self, show)¶Show or hide the vertical scroll bar.
show (bool) –
SetVScrollBar
(self, bar)¶Set the vertical scrollbar to use instead of the ont that’s built-in.
bar (wx.ScrollBar) –
SetValue
(self, value)¶Sets the new text control value.
It also marks the control as not-modified which means that IsModified() would return False
immediately after the call to SetValue
.
The insertion point is set to the start of the control (i.e. position 0) by this function.
Note that, unlike most other functions changing the controls values, this function generates a wxEVT_TEXT
event. To avoid this you can use ChangeValue
instead.
value (string) – The new value to set. It may contain newline characters if the text control is multi-line.
SetViewEOL
(self, visible)¶Make the end of line characters visible or invisible.
visible (bool) –
SetViewWhiteSpace
(self, viewWS)¶Make white space characters invisible, always visible or visible outside indentation.
viewWS (int) –
SetVirtualSpaceOptions
(self, virtualSpaceOptions)¶virtualSpaceOptions (int) –
SetVisiblePolicy
(self, visiblePolicy, visibleSlop)¶Set the way the display area is determined when a particular line is to be moved to by Find, FindNext, GotoLine, etc.
visiblePolicy (int) –
visibleSlop (int) –
SetWhitespaceBackground
(self, useSetting, back)¶Set the background colour of all whitespace and whether to use this setting.
useSetting (bool) –
back (wx.Colour) –
SetWhitespaceChars
(self, characters)¶Set the set of characters making up whitespace for when moving or selecting by word.
Should be called after SetWordChars.
characters (string) –
SetWhitespaceForeground
(self, useSetting, fore)¶Set the foreground colour of all whitespace and whether to use this setting.
useSetting (bool) –
fore (wx.Colour) –
SetWhitespaceSize
(self, size)¶Set the size of the dots used to mark space characters.
size (int) –
SetWordChars
(self, characters)¶Set the set of characters making up words for when moving or selecting by word.
First sets defaults like SetCharsDefault.
characters (string) –
SetWrapIndentMode
(self, mode)¶Sets how wrapped sublines are placed.
Default is fixed.
mode (int) –
SetWrapMode
(self, mode)¶Sets whether text is word wrapped.
mode (int) –
SetWrapStartIndent
(self, indent)¶Set the start indent for wrapped lines.
indent (int) –
SetWrapVisualFlags
(self, wrapVisualFlags)¶Set the display mode of visual flags for wrapped lines.
wrapVisualFlags (int) –
SetWrapVisualFlagsLocation
(self, wrapVisualFlagsLocation)¶Set the location of visual flags for wrapped lines.
wrapVisualFlagsLocation (int) –
SetXCaretPolicy
(self, caretPolicy, caretSlop)¶Set the way the caret is kept visible when going sideways.
The exclusion zone is given in pixels.
caretPolicy (int) –
caretSlop (int) –
SetXOffset
(self, newOffset)¶Get and Set the xOffset (ie, horizontal scroll position).
newOffset (int) –
SetYCaretPolicy
(self, caretPolicy, caretSlop)¶Set the way the line the caret is on is kept visible.
The exclusion zone is given in lines.
caretPolicy (int) –
caretSlop (int) –
SetZoom
(self, zoom)¶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.
zoom (int) –
ShowLines
(self, lineStart, lineEnd)¶Make a range of lines visible.
lineStart (int) –
lineEnd (int) –
ShowPosition
(self, pos)¶pos (long) –
StartRecord
(self)¶Start notifying the container of all key presses and commands.
StartStyling
(self, pos, mask)¶Set the current styling position to pos and the styling mask to mask.
The styling mask can be used to protect some bits in each styling byte from modification.
pos (int) –
mask (int) –
StopRecord
(self)¶Stop notifying the container of all key presses and commands.
StutteredPageDown
(self)¶Move caret to bottom of page, or one page down if already at bottom of page.
StutteredPageDownExtend
(self)¶Move caret to bottom of page, or one page down if already at bottom of page, extending selection to new caret position.
StutteredPageUp
(self)¶Move caret to top of page, or one page up if already at top of page.
StutteredPageUpExtend
(self)¶Move caret to top of page, or one page up if already at top of page, extending selection to new caret position.
StyleClearAll
(self)¶Clear all the styles and make equivalent to the global default style.
StyleGetBackground
(self, style)¶Get the background colour of a style.
style (int) –
Colour
StyleGetBold
(self, style)¶Get is a style bold or not.
style (int) –
bool
StyleGetCase
(self, style)¶Get is a style mixed case, or to force upper or lower case.
style (int) –
int
StyleGetChangeable
(self, style)¶Get is a style changeable or not (read only).
Experimental feature, currently buggy.
style (int) –
bool
StyleGetCharacterSet
(self, style)¶Get the character set of the font in a style.
style (int) –
int
StyleGetEOLFilled
(self, style)¶Get is a style to have its end of line filled or not.
style (int) –
bool
StyleGetFaceName
(self, style)¶Get the font facename of a style.
style (int) –
string
StyleGetFont
(self, style)¶Get the font of a style.
style (int) –
Font
StyleGetForeground
(self, style)¶Get the foreground colour of a style.
style (int) –
Colour
StyleGetHotSpot
(self, style)¶Get is a style a hotspot or not.
style (int) –
bool
StyleGetItalic
(self, style)¶Get is a style italic or not.
style (int) –
bool
StyleGetSize
(self, style)¶Get the size of characters of a style.
style (int) –
int
StyleGetSizeFractional
(self, style)¶Get the size of characters of a style in points multiplied by 100.
style (int) –
int
StyleGetUnderline
(self, style)¶Get is a style underlined or not.
style (int) –
bool
StyleGetVisible
(self, style)¶Get is a style visible or not.
style (int) –
bool
StyleGetWeight
(self, style)¶Get the weight of characters of a style.
style (int) –
int
StyleResetDefault
(self)¶Reset the default style to its state at startup.
StyleSetBackground
(self, style, back)¶Set the background colour of a style.
style (int) –
back (wx.Colour) –
StyleSetBold
(self, style, bold)¶Set a style to be bold or not.
style (int) –
bold (bool) –
StyleSetCase
(self, style, caseForce)¶Set a style to be mixed case, or to force upper or lower case.
style (int) –
caseForce (int) –
StyleSetChangeable
(self, style, changeable)¶Set a style to be changeable or not (read only).
Experimental feature, currently buggy.
style (int) –
changeable (bool) –
StyleSetCharacterSet
(self, style, characterSet)¶Set the character set of the font in a style.
Converts the Scintilla character set values to a FontEncoding.
style (int) –
characterSet (int) –
StyleSetEOLFilled
(self, style, filled)¶Set a style to have its end of line filled or not.
style (int) –
filled (bool) –
StyleSetFaceName
(self, style, fontName)¶Set the font of a style.
style (int) –
fontName (string) –
StyleSetFont
(self, styleNum, font)¶Set style size, face, bold, italic, and underline attributes from a wx.Font’s attributes.
styleNum (int) –
font (wx.Font) –
StyleSetFontAttr
(self, styleNum, size, faceName, bold, italic, underline, encoding=FONTENCODING_DEFAULT)¶Set all font style attributes at once.
styleNum (int) –
size (int) –
faceName (string) –
bold (bool) –
italic (bool) –
underline (bool) –
encoding (FontEncoding) –
StyleSetFontEncoding
(self, style, encoding)¶Set the font encoding to be used by a style.
style (int) –
encoding (FontEncoding) –
StyleSetForeground
(self, style, fore)¶Set the foreground colour of a style.
style (int) –
fore (wx.Colour) –
StyleSetHotSpot
(self, style, hotspot)¶Set a style to be a hotspot or not.
style (int) –
hotspot (bool) –
StyleSetItalic
(self, style, italic)¶Set a style to be italic or not.
style (int) –
italic (bool) –
StyleSetSize
(self, style, sizePoints)¶Set the size of characters of a style.
style (int) –
sizePoints (int) –
StyleSetSizeFractional
(self, style, caseForce)¶Set the size of characters of a style.
Size is in points multiplied by 100.
style (int) –
caseForce (int) –
StyleSetSpec
(self, styleNum, spec)¶Extract style settings from a spec-string which is composed of one or more of the following comma separated elements:
bold turns on bold italic turns on italics fore:[name or #``RRGGBB]`` sets the foreground colour back:[name or #``RRGGBB]`` sets the background colour face:[facename] sets the font face name to use size:[num] sets the font size in points eol turns on eol filling underline turns on underlining
styleNum (int) –
spec (string) –
StyleSetUnderline
(self, style, underline)¶Set a style to be underlined or not.
style (int) –
underline (bool) –
StyleSetVisible
(self, style, visible)¶Set a style to be visible or not.
style (int) –
visible (bool) –
StyleSetWeight
(self, style, weight)¶Set the weight of characters of a style.
style (int) –
weight (int) –
SwapMainAnchorCaret
(self)¶Swap that caret and anchor of the main selection.
Tab
(self)¶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.
TargetFromSelection
(self)¶Make the target range start and end be the same as the selection range start and end.
TextHeight
(self, line)¶Retrieve the height of a particular line of text in pixels.
line (int) –
int
TextWidth
(self, style, text)¶Measure the pixel width of some text in a particular style.
NUL
terminated text argument. Does not handle tab or control characters.
style (int) –
text (string) –
int
ToggleCaretSticky
(self)¶Switch between sticky and non-sticky: meant to be bound to a key.
ToggleFold
(self, line)¶Switch a header line between expanded and contracted.
line (int) –
Undo
(self)¶Undo one action in the undo history.
UpperCase
(self)¶Transform the selection to upper case.
UsePopUp
(self, allowPopUp)¶Set whether a pop up menu is displayed automatically when the user presses the wrong mouse button.
allowPopUp (bool) –
UserListShow
(self, listType, itemList)¶Display a list of strings and send notification when user chooses one.
listType (int) –
itemList (string) –
VCHome
(self)¶Move caret to before first visible character on line.
If already there move to first character on line.
VCHomeExtend
(self)¶Like VCHome but extending selection to new caret position.
VCHomeRectExtend
(self)¶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.
VCHomeWrap
(self)¶VCHomeWrapExtend
(self)¶VerticalCentreCaret
(self)¶Centre current line in window.
VisibleFromDocLine
(self, line)¶Find the display line of a document line taking hidden lines into account.
line (int) –
int
WordEndPosition
(self, pos, onlyWordCharacters)¶Get position of end of word.
pos (int) –
onlyWordCharacters (bool) –
int
WordLeft
(self)¶Move caret left one word.
WordLeftEnd
(self)¶Move caret left one word, position cursor at end of word.
WordLeftEndExtend
(self)¶Move caret left one word, position cursor at end of word, extending selection to new caret position.
WordLeftExtend
(self)¶Move caret left one word extending selection to new caret position.
WordPartLeft
(self)¶Move to the previous change in capitalisation.
WordPartLeftExtend
(self)¶Move to the previous change in capitalisation extending selection to new caret position.
WordPartRight
(self)¶Move to the change next in capitalisation.
WordPartRightExtend
(self)¶Move to the next change in capitalisation extending selection to new caret position.
WordRight
(self)¶Move caret right one word.
WordRightEnd
(self)¶Move caret right one word, position cursor at end of word.
WordRightEndExtend
(self)¶Move caret right one word, position cursor at end of word, extending selection to new caret position.
WordRightExtend
(self)¶Move caret right one word extending selection to new caret position.
WordStartPosition
(self, pos, onlyWordCharacters)¶Get position of start of word.
pos (int) –
onlyWordCharacters (bool) –
int
WrapCount
(self, line)¶The number of display lines needed to wrap a document line.
line (int) –
int
WriteText
(self, text)¶Writes the text into the text control at the current insertion position.
text (string) – Text to write to the text control.
Note
Newlines in the text string are the only control characters allowed, and they will cause appropriate line breaks. See operator<<() and AppendText
for more convenient ways of writing to the window. After the write operation, the insertion point will be at the end of the inserted text, so subsequent write operations will be appended. To append text after the user may have interacted with the control, call wx.TextCtrl.SetInsertionPointEnd
before writing.
XYToPosition
(self, x, y)¶x (long) –
y (long) –
long
ZoomIn
(self)¶Magnify the displayed text by increasing the sizes by 1 point.
ZoomOut
(self)¶Make the displayed text smaller by decreasing the sizes by 1 point.
flush
(self)¶NOP
, for file-like compatibility.
write
(self, text)¶Append text to the textctrl, for file-like compatibility.
AdditionalCaretForeground
¶See GetAdditionalCaretForeground
and SetAdditionalCaretForeground
AdditionalCaretsBlink
¶AdditionalCaretsVisible
¶See GetAdditionalCaretsVisible
and SetAdditionalCaretsVisible
AdditionalSelAlpha
¶AdditionalSelectionTyping
¶See GetAdditionalSelectionTyping
and SetAdditionalSelectionTyping
AllLinesVisible
¶BackSpaceUnIndents
¶BufferedDraw
¶See GetBufferedDraw
and SetBufferedDraw
CaretForeground
¶See GetCaretForeground
and SetCaretForeground
CaretLineBackAlpha
¶CaretLineBackground
¶CaretLineVisible
¶CaretPeriod
¶See GetCaretPeriod
and SetCaretPeriod
CaretSticky
¶See GetCaretSticky
and SetCaretSticky
CaretStyle
¶See GetCaretStyle
and SetCaretStyle
CaretWidth
¶See GetCaretWidth
and SetCaretWidth
CharacterPointer
¶CodePage
¶See GetCodePage
and SetCodePage
ControlCharSymbol
¶CurLine
¶See GetCurLine
CurLineRaw
¶See GetCurLineRaw
CurrentLine
¶See GetCurrentLine
CurrentPos
¶See GetCurrentPos
and SetCurrentPos
DefaultStyle
¶See GetDefaultStyle
and SetDefaultStyle
DocPointer
¶See GetDocPointer
and SetDocPointer
EOLMode
¶See GetEOLMode
and SetEOLMode
EdgeColour
¶See GetEdgeColour
and SetEdgeColour
EdgeColumn
¶See GetEdgeColumn
and SetEdgeColumn
EdgeMode
¶See GetEdgeMode
and SetEdgeMode
EndAtLastLine
¶See GetEndAtLastLine
and SetEndAtLastLine
EndStyled
¶See GetEndStyled
ExtraAscent
¶See GetExtraAscent
and SetExtraAscent
ExtraDescent
¶See GetExtraDescent
and SetExtraDescent
FirstVisibleLine
¶GapPosition
¶See GetGapPosition
HighlightGuide
¶See GetHighlightGuide
and SetHighlightGuide
HotspotActiveBackground
¶HotspotActiveForeground
¶HotspotActiveUnderline
¶HotspotSingleLine
¶Identifier
¶See GetIdentifier
and SetIdentifier
IndentationGuides
¶IndicatorCurrent
¶IndicatorValue
¶See GetIndicatorValue
and SetIndicatorValue
InsertionPoint
¶See GetInsertionPoint
and SetInsertionPoint
KeysUnicode
¶See GetKeysUnicode
and SetKeysUnicode
LastKeydownProcessed
¶LastPosition
¶See GetLastPosition
LayoutCache
¶See GetLayoutCache
and SetLayoutCache
LineCount
¶See GetLineCount
MainSelection
¶See GetMainSelection
and SetMainSelection
MarginLeft
¶See GetMarginLeft
and SetMarginLeft
MarginOptions
¶See GetMarginOptions
and SetMarginOptions
MarginRight
¶See GetMarginRight
and SetMarginRight
Margins
¶See GetMargins
MaxLineState
¶See GetMaxLineState
ModEventMask
¶See GetModEventMask
and SetModEventMask
MouseDownCaptures
¶MouseDwellTime
¶See GetMouseDwellTime
and SetMouseDwellTime
MultiPaste
¶See GetMultiPaste
and SetMultiPaste
MultipleSelection
¶NumberOfLines
¶See GetNumberOfLines
Overtype
¶See GetOvertype
and SetOvertype
PasteConvertEndings
¶PositionCacheSize
¶PrintColourMode
¶See GetPrintColourMode
and SetPrintColourMode
PrintMagnification
¶PrintWrapMode
¶See GetPrintWrapMode
and SetPrintWrapMode
PunctuationChars
¶RangePointer
¶See GetRangePointer
ReadOnly
¶See GetReadOnly
and SetReadOnly
RectangularSelectionAnchor
¶See GetRectangularSelectionAnchor
and SetRectangularSelectionAnchor
RectangularSelectionAnchorVirtualSpace
¶See GetRectangularSelectionAnchorVirtualSpace
and SetRectangularSelectionAnchorVirtualSpace
RectangularSelectionCaret
¶See GetRectangularSelectionCaret
and SetRectangularSelectionCaret
RectangularSelectionCaretVirtualSpace
¶See GetRectangularSelectionCaretVirtualSpace
and SetRectangularSelectionCaretVirtualSpace
RectangularSelectionModifier
¶See GetRectangularSelectionModifier
and SetRectangularSelectionModifier
STCCursor
¶See GetSTCCursor
and SetSTCCursor
STCFocus
¶See GetSTCFocus
and SetSTCFocus
ScrollWidth
¶See GetScrollWidth
and SetScrollWidth
ScrollWidthTracking
¶SearchFlags
¶See GetSearchFlags
and SetSearchFlags
SelAlpha
¶See GetSelAlpha
and SetSelAlpha
SelEOLFilled
¶See GetSelEOLFilled
and SetSelEOLFilled
SelectedText
¶See GetSelectedText
SelectedTextRaw
¶SelectionEnd
¶See GetSelectionEnd
and SetSelectionEnd
SelectionMode
¶See GetSelectionMode
and SetSelectionMode
SelectionStart
¶See GetSelectionStart
and SetSelectionStart
Selections
¶See GetSelections
StringSelection
¶StyleBits
¶See GetStyleBits
and SetStyleBits
StyleBitsNeeded
¶TabIndents
¶See GetTabIndents
and SetTabIndents
TabWidth
¶See GetTabWidth
and SetTabWidth
TargetEnd
¶See GetTargetEnd
and SetTargetEnd
TargetStart
¶See GetTargetStart
and SetTargetStart
Technology
¶See GetTechnology
and SetTechnology
TextLength
¶See GetTextLength
TextRaw
¶See GetTextRaw
and SetTextRaw
TwoPhaseDraw
¶See GetTwoPhaseDraw
and SetTwoPhaseDraw
UndoCollection
¶See GetUndoCollection
and SetUndoCollection
UseHorizontalScrollBar
¶UseTabs
¶See GetUseTabs
and SetUseTabs
UseVerticalScrollBar
¶ViewEOL
¶See GetViewEOL
and SetViewEOL
ViewWhiteSpace
¶See GetViewWhiteSpace
and SetViewWhiteSpace
VirtualSpaceOptions
¶WhitespaceChars
¶See GetWhitespaceChars
and SetWhitespaceChars
WhitespaceSize
¶See GetWhitespaceSize
and SetWhitespaceSize
WordChars
¶See GetWordChars
and SetWordChars
WrapIndentMode
¶See GetWrapIndentMode
and SetWrapIndentMode
WrapMode
¶See GetWrapMode
and SetWrapMode
WrapStartIndent
¶See GetWrapStartIndent
and SetWrapStartIndent
WrapVisualFlags
¶See GetWrapVisualFlags
and SetWrapVisualFlags
WrapVisualFlagsLocation
¶See GetWrapVisualFlagsLocation
and SetWrapVisualFlagsLocation
XOffset
¶See GetXOffset
and SetXOffset