]>
git.saurik.com Git - wxWidgets.git/blob - wxPython/wx/py/wxd/stc_.py
1 """StyledTextCtrl decorator class module.
4 __author__
= "Patrick K. O'Brien <pobrien@orbtech.com>"
6 __revision__
= "$Revision$"[11:-2]
9 # These are not the real wxPython classes. These are Python versions
10 # for documentation purposes. They are also used to apply docstrings
11 # to the real wxPython classes, which are SWIG-generated wrappers for
15 from Controls
import Control
16 import Parameters
as wx
19 class StyledTextCtrl(Control
):
20 """StyledTextCtrl class."""
22 def __init__(self
, parent
, id, pos
=wx
.DefaultPosition
,
23 size
=wx
.DefaultSize
, style
=0, name
=wx
.PySTCNameStr
):
24 """Create a StyledTextCtrl instance."""
27 def AddRefDocument(self
, docPointer
):
28 """Extend life of document."""
31 def AddStyledText(self
, data
):
32 """Add array of cells to document."""
35 def AddText(self
, text
):
36 """Add text to the document."""
39 def AutoCompActive(self
):
40 """Is there an auto-completion list visible?"""
43 def AutoCompCancel(self
):
44 """Remove the auto-completion list from the screen."""
47 def AutoCompComplete(self
):
48 """User has selected an item so remove the list and insert the
52 def AutoCompGetAutoHide(self
):
53 """Return whether or not autocompletion is hidden
54 automatically when nothing matches."""
57 def AutoCompGetCancelAtStart(self
):
58 """Return whether auto-completion cancelled by backspacing
62 def AutoCompGetChooseSingle(self
):
63 """Return whether a single item auto-completion list
64 automatically choose the item."""
67 def AutoCompGetDropRestOfWord(self
):
68 """Return whether or not autocompletion deletes any word
69 characters after the inserted text upon completion."""
72 def AutoCompGetIgnoreCase(self
):
73 """Return state of ignore case flag."""
76 def AutoCompGetSeparator(self
):
77 """Return the auto-completion list separator character."""
80 def AutoCompPosStart(self
):
81 """Return the position of the caret when the auto-completion
82 list was displayed."""
85 def AutoCompSelect(self
, text
):
86 """Select the item in the auto-completion list that starts
90 def AutoCompSetAutoHide(self
, autoHide
):
91 """Set whether or not autocompletion is hidden automatically
92 when nothing matches."""
95 def AutoCompSetCancelAtStart(self
, cancel
):
96 """Should the auto-completion list be cancelled if the user
97 backspaces to a position before where the box was created."""
100 def AutoCompSetChooseSingle(self
, chooseSingle
):
101 """Should a single item auto-completion list automatically
105 def AutoCompSetDropRestOfWord(self
, dropRestOfWord
):
106 """Set whether or not autocompletion deletes any word
107 characters after the inserted text upon completion."""
110 def AutoCompSetFillUps(self
, characterSet
):
111 """Define a set of characters that when typed will cause the
112 autocompletion to choose the selected item."""
115 def AutoCompSetIgnoreCase(self
, ignoreCase
):
116 """Set whether case is significant when performing
117 auto-completion searches."""
120 def AutoCompSetSeparator(self
, separatorCharacter
):
121 """Change the separator character in the string setting up an
122 auto-completion list. Default is space but can be changed if
123 items contain space."""
126 def AutoCompShow(self
, lenEntered
, itemList
):
127 """Display a auto-completion list.
129 The lenEntered parameter indicates how many characters before
130 the caret should be used to provide context."""
133 def AutoCompStops(self
, characterSet
):
134 """Define a set of character that when typed cancel the
135 auto-completion list."""
138 def BeginUndoAction(self
):
139 """Start a sequence of actions that is undone and redone as a
140 unit. May be nested."""
143 def BraceBadLight(self
, pos
):
144 """Highlight the character at a position indicating there is
145 no matching brace."""
148 def BraceHighlight(self
, pos1
, pos2
):
149 """Highlight the characters at two positions."""
152 def BraceMatch(self
, pos
):
153 """Find the position of a matching brace or INVALID_POSITION
157 def CallTipActive(self
):
158 """Is there an active call tip?"""
161 def CallTipCancel(self
):
162 """Remove the call tip from the screen."""
165 def CallTipPosAtStart(self
):
166 """Return the position where the caret was before displaying
170 def CallTipSetBackground(self
, back
):
171 """Set the background colour for the call tip."""
174 def CallTipSetHighlight(self
, start
, end
):
175 """Highlight a segment of the definition."""
178 def CallTipShow(self
, pos
, definition
):
179 """Show a call tip containing a definition near position pos."""
183 """Will a paste succeed?"""
187 """Are there any redoable actions in the undo history?"""
191 """Are there any undoable actions in the undo history?"""
195 """Clear the selection."""
199 """Delete all text in the document."""
202 def ClearDocumentStyle(self
):
203 """Set all style bytes to 0, remove all folding information."""
206 def CmdKeyAssign(self
, key
, modifiers
, cmd
):
207 """When key+modifier combination km is pressed perform msg."""
210 def CmdKeyClear(self
, key
, modifiers
):
211 """When key+modifier combination km do nothing."""
214 def CmdKeyClearAll(self
):
215 """Drop all key mappings."""
218 def CmdKeyExecute(self
, cmd
):
219 """Perform one of the operations defined by the STC_CMD_*
223 def Colourise(self
, start
, end
):
224 """Colourise a segment of the document using the current
228 def ConvertEOLs(self
, eolMode
):
229 """Convert all line endings in the document to one mode."""
233 """Copy the selection to the clipboard."""
236 def CreateDocument(self
):
237 """Create a new document object.
239 Starts with reference count of 1 and not selected into editor."""
243 """Cut the selection to the clipboard."""
246 def DelLineLeft(self
):
247 """Delete from the current position to the start of the line."""
250 def DelLineRight(self
):
251 """Delete from the current position to the end of the line."""
254 def DocLineFromVisible(self
, lineDisplay
):
255 """Find the document line of a display line taking hidden
256 lines into account."""
259 def EmptyUndoBuffer(self
):
260 """Delete the undo history."""
263 def EndUndoAction(self
):
264 """End a sequence of actions that is undone and redone as a
268 def EnsureCaretVisible(self
):
269 """Ensure the caret is visible."""
272 def EnsureVisible(self
, line
):
273 """Ensure a particular line is visible by expanding any header
277 def EnsureVisibleEnforcePolicy(self
, line
):
278 """Ensure a particular line is visible by expanding any header
279 line hiding it. Use the currently set visibility policy to
280 determine which range to display."""
283 def FindText(self
, minPos
, maxPos
, text
, flags
=0):
284 """Find some text in the document."""
287 def FormatRange(self
, doDraw
, startPos
, endPos
, draw
,
288 target
, renderRect
, pageRect
):
289 """On Windows, will draw the document into a display context
290 such as a printer."""
294 """Return the position of the opposite end of the selection to
298 def GetBackSpaceUnIndents(self
):
299 """Does a backspace pressed when caret is within indentation
303 def GetBufferedDraw(self
):
304 """Is drawing done first into a buffer or direct to the
308 def GetCaretForeground(self
):
309 """Return the foreground colour of the caret."""
312 def GetCaretLineBack(self
):
313 """Return the colour of the background of the line containing
317 def GetCaretLineVisible(self
):
318 """Is the background of the line containing the caret in a
322 def GetCaretPeriod(self
):
323 """Return the time in milliseconds that the caret is on and
327 def GetCaretWidth(self
):
328 """Return the width of the insert mode caret."""
331 def GetCharAt(self
, pos
):
332 """Return the character byte at the position."""
335 def GetCodePage(self
):
336 """Return the code page used to interpret the bytes of the
337 document as characters."""
340 def GetColumn(self
, pos
):
341 """Return the column number of a position, taking tab width
345 def GetControlCharSymbol(self
):
346 """Return the way control characters are displayed."""
349 def GetCurLine(self
):
350 """Return (text, pos) tuple with the text of the line
351 containing the caret and the position of the caret within the
355 def GetCurrentLine(self
):
356 """Return the line number of the line with the caret."""
359 def GetCurrentPos(self
):
360 """Return the position of the caret."""
364 """Return cursor type."""
367 def GetDocPointer(self
):
368 """Return a pointer to the document object."""
371 def GetEOLMode(self
):
372 """Return the current end of line mode: CRLF, CR, or LF."""
375 def GetEdgeColour(self
):
376 """Return the colour used in edge indication."""
379 def GetEdgeColumn(self
):
380 """Return the column number which text should be kept within."""
383 def GetEdgeMode(self
):
384 """Return the edge highlight mode."""
387 def GetEndAtLastLine(self
):
388 """Return whether the maximum scroll position has the last
389 line at the bottom of the view."""
392 def GetEndStyled(self
):
393 """Return the position of the last correctly styled character."""
396 def GetFirstVisibleLine(self
):
397 """Return the line at the top of the display."""
400 def GetFoldExpanded(self
, line
):
401 """Is a header line expanded?"""
404 def GetFoldLevel(self
, line
):
405 """Return the fold level of a line."""
408 def GetFoldParent(self
, line
):
409 """Find the parent line of a child line."""
412 def GetHighlightGuide(self
):
413 """Return the highlighted indentation guide column."""
417 """Return indentation size."""
420 def GetIndentationGuides(self
):
421 """Are the indentation guides visible?"""
424 def GetLastChild(self
, line
, level
):
425 """Find the last child line of a header line."""
428 def GetLastKeydownProcessed(self
):
429 """Can be used to prevent the EVT_CHAR handler from adding the
433 def GetLayoutCache(self
):
434 """Return the degree of caching of layout information."""
438 """Return the number of characters in the document."""
442 """Return the lexing language of the document."""
445 def GetLine(self
, line
):
446 """Return the contents of a line."""
449 def GetLineCount(self
):
450 """Return the number of lines in the document. There is
451 always at least one."""
454 def GetLineEndPosition(self
, line
):
455 """Return the position after the last visible characters on a
459 def GetLineIndentPosition(self
, line
):
460 """Return the position before the first non indentation
461 character on a line."""
464 def GetLineIndentation(self
, line
):
465 """Return the number of columns that a line is indented."""
468 def GetLineState(self
, line
):
469 """Return the extra styling information for a line."""
472 def GetLineVisible(self
, line
):
473 """Is a line visible?"""
476 def GetMarginLeft(self
):
477 """Return the size in pixels of the left margin."""
480 def GetMarginMask(self
, margin
):
481 """Return the marker mask of a margin."""
484 def GetMarginRight(self
):
485 """Return the size in pixels of the right margin."""
488 def GetMarginSensitive(self
, margin
):
489 """Return the mouse click sensitivity of a margin."""
492 def GetMarginType(self
, margin
):
493 """Return the type of a margin."""
496 def GetMarginWidth(self
, margin
):
497 """Return the width of a margin in pixels."""
500 def GetMaxLineState(self
):
501 """Return the last line number that has line state."""
504 def GetModEventMask(self
):
505 """Return which document modification events are sent to the
510 """Is the document different from when it was last saved?"""
513 def GetMouseDownCaptures(self
):
514 """Return whether mouse gets captured."""
517 def GetMouseDwellTime(self
):
518 """Return the time the mouse must sit still to generate a
519 mouse dwell event."""
522 def GetOvertype(self
):
523 """Return true if overtype mode is active otherwise false is
527 def GetPrintColourMode(self
):
528 """Return the print colour mode."""
531 def GetPrintMagnification(self
):
532 """Return the print magnification."""
535 def GetReadOnly(self
):
536 """In read-only mode?"""
539 def GetSTCFocus(self
):
540 """Return internal focus flag."""
543 def GetScrollWidth(self
):
544 """Return the document width assumed for scrolling."""
547 def GetSearchFlags(self
):
548 """Return the search flags used by SearchInTarget."""
551 def GetSelectedText(self
):
552 """Return the selected text."""
555 def GetSelectionEnd(self
):
556 """Return the position at the end of the selection."""
559 def GetSelection(self
):
560 """Return the start and end positions of the current
564 def GetSelectionStart(self
):
565 """Return the position at the start of the selection."""
569 """Return error status."""
572 def GetStyleAt(self
, pos
):
573 """Return the style byte at the position."""
576 def GetStyleBits(self
):
577 """Return number of bits in style bytes used to hold the
581 def GetStyledText(self
, startPos
, endPos
):
582 """Return a buffer of cells."""
585 def GetTabIndents(self
):
586 """Does a tab pressed when caret is within indentation indent?"""
589 def GetTabWidth(self
):
590 """Return the visible size of a tab."""
593 def GetTargetEnd(self
):
594 """Return the position that ends the target."""
597 def GetTargetStart(self
):
598 """Return the position that starts the target."""
602 """Return all the text in the document."""
605 def GetTextLength(self
):
606 """Return the number of characters in the document."""
609 def GetTextRange(self
, startPos
, endPos
):
610 """Return a range of text."""
613 def GetUndoCollection(self
):
614 """Is undo history being collected?"""
617 def GetUseHorizontalScrollBar(self
):
618 """Is the horizontal scroll bar visible?"""
621 def GetUseTabs(self
):
622 """Return whether tabs will be used in indentation."""
625 def GetViewEOL(self
):
626 """Are the end of line characters visible?"""
629 def GetViewWhiteSpace(self
):
630 """Are white space characters currently visible? Return one
631 of SCWS_* constants."""
634 def GetWrapMode(self
):
635 """Return whether text is word wrapped."""
638 def GetXOffset(self
):
639 """Return the xOffset (self, ie, horizonal scroll position)."""
643 """Return the zoom level."""
646 def GotoLine(self
, line
):
647 """Set caret to start of a line and ensure it is visible."""
650 def GotoPos(self
, pos
):
651 """Set caret to a position and ensure it is visible."""
654 def HideLines(self
, lineStart
, lineEnd
):
655 """Make a range of lines invisible."""
658 def HideSelection(self
, normal
):
659 """Draw the selection in normal style or with selection
663 def HomeDisplay(self
):
664 """Move caret to first position on display line."""
667 def HomeDisplayExtend(self
):
668 """Move caret to first position on display line extending
669 selection to new caret position."""
672 def IndicatorGetForeground(self
, indic
):
673 """Return the foreground colour of an indicator."""
676 def IndicatorGetStyle(self
, indic
):
677 """Return the style of an indicator."""
680 def IndicatorSetForeground(self
, indic
, fore
):
681 """Set the foreground colour of an indicator."""
684 def IndicatorSetStyle(self
, indic
, style
):
685 """Set an indicator to plain, squiggle or TT."""
688 def InsertText(self
, pos
, text
):
689 """Insert string at a position."""
692 def LineEndDisplay(self
):
693 """Move caret to last position on display line."""
696 def LineEndDisplayExtend(self
):
697 """Move caret to last position on display line extending
698 selection to new caret position."""
701 def LineFromPosition(self
, pos
):
702 """Return the line containing a position."""
705 def LineLength(self
, line
):
706 """How many characters are on a line, not including end of
710 def LineScroll(self
, columns
, lines
):
711 """Scroll horizontally and vertically."""
714 def LinesOnScreen(self
):
715 """Retrieves the number of lines completely visible."""
718 def MarkerAdd(self
, line
, markerNumber
):
719 """Add a marker to a line, return an ID that can be used to
720 find or delete the marker."""
723 def MarkerDefine(self
, markerNumber
, markerSymbol
,
724 foreground
=wx
.NullColour
, background
=wx
.NullColour
):
725 """Set the symbol used for a particular marker number, and
726 optionally the fore and background colours."""
729 def MarkerDelete(self
, line
, markerNumber
):
730 """Delete a marker from a line."""
733 def MarkerDeleteAll(self
, markerNumber
):
734 """Delete all markers with a particular number from all lines."""
737 def MarkerDeleteHandle(self
, handle
):
738 """Delete a marker."""
741 def MarkerGet(self
, line
):
742 """Return a bit mask of all the markers set on a line."""
745 def MarkerLineFromHandle(self
, handle
):
746 """Return the line number at which a particular marker is
750 def MarkerNext(self
, lineStart
, markerMask
):
751 """Find the next line after lineStart that includes a marker
755 def MarkerPrevious(self
, lineStart
, markerMask
):
756 """Find the previous line before lineStart that includes a
760 def MarkerSetBackground(self
, markerNumber
, back
):
761 """Set the background colour used for a particular marker
765 def MarkerSetForeground(self
, markerNumber
, fore
):
766 """Set the foreground colour used for a particular marker
770 def MoveCaretInsideView(self
):
771 """Move the caret inside current view if it is not there
776 """Paste the contents of the clipboard into the document
777 replacing the selection."""
780 def PointFromPosition(self
, pos
):
781 """Return the point in the window where a position is
785 def PositionFromLine(self
, line
):
786 """Return the position at the start of a line."""
789 def PositionFromPoint(self
, pt
):
790 """Find the position from a point within the window."""
793 def PositionFromPointClose(self
, x
, y
):
794 """Find the position from a point within the window but return
795 INVALID_POSITION if not close to text."""
799 """Redo the next action on the undo history."""
802 def ReleaseDocument(self
, docPointer
):
803 """Release a reference to the document, deleting document if
804 it fades to black."""
807 def ReplaceSelection(self
, text
):
808 """Replace the selected text with the argument text."""
811 def ReplaceTarget(self
, text
):
812 """Replace the target text with the argument text.
814 Text is counted so it can contain nulls. Return the length
815 of the replacement text."""
818 def ReplaceTargetRE(self
, text
):
819 """Replace the target text with the argument text after \d
822 Text is counted so it can contain nulls. Looks for \d where d
823 is between 1 and 9 and replaces these with the strings matched
824 in the last search operation which were surrounded by \(self,
825 and \). Return the length of the replacement text including
826 any change caused by processing the \d patterns."""
829 def ScrollToColumn(self
, column
):
830 """Scroll enough to make the given column visible."""
833 def ScrollToLine(self
, line
):
834 """Scroll enough to make the given line visible."""
837 def SearchAnchor(self
):
838 """Sets the current caret position to be the search anchor."""
841 def SearchInTarget(self
, text
):
842 """Search for a counted string in the target and set the
843 target to the found range.
845 Text is counted so it can contain nulls. Return length of
846 range or -1 for failure in which case target is not moved."""
849 def SearchNext(self
, flags
, text
):
850 """Find some text starting at the search anchor. Does not
851 ensure the selection is visible."""
854 def SearchPrev(self
, flags
, text
):
855 """Find some text starting at the search anchor and moving
856 backwards. Does not ensure the selection is visible."""
860 """Select all the text in the document."""
863 def SelectionIsRectangle(self
):
864 """Is the selection rectangular? The alternative is the more
865 common stream selection."""
868 def SendMsg(self
, msg
, wp
=0, lp
=0):
869 """Send a message to Scintilla."""
872 def SetAnchor(self
, posAnchor
):
873 """Set the selection anchor to a position. The anchor is the
874 opposite end of the selection from the caret."""
877 def SetBackSpaceUnIndents(self
, bsUnIndents
):
878 """Sets whether a backspace pressed when caret is within
879 indentation unindents."""
882 def SetBufferedDraw(self
, buffered
):
883 """If drawing is buffered then each line of text is drawn into
884 a bitmap buffer before drawing it to the screen to avoid
888 def SetCaretForeground(self
, fore
):
889 """Set the foreground colour of the caret."""
892 def SetCaretLineBack(self
, back
):
893 """Set the colour of the background of the line containing the
897 def SetCaretLineVisible(self
, show
):
898 """Display the background of the line containing the caret in
899 a different colour."""
902 def SetCaretPeriod(self
, periodMilliseconds
):
903 """Return the time in milliseconds that the caret is on and
904 off. 0 = steady on."""
907 def SetCaretWidth(self
, pixelWidth
):
908 """Set the width of the insert mode caret."""
911 def SetCodePage(self
, codePage
):
912 """Set the code page used to interpret the bytes of the
913 document as characters."""
916 def SetControlCharSymbol(self
, symbol
):
917 """Change the way control characters are displayed: If symbol
918 is < 32, keep the drawn way, else, use the given character."""
921 def SetCurrentPos(self
, pos
):
922 """Sets the position of the caret."""
925 def SetCursor(self
, cursorType
):
926 """Sets the cursor to one of the SC_CURSOR* values."""
929 def SetDocPointer(self
, docPointer
):
930 """Change the document object used."""
933 def SetEOLMode(self
, eolMode
):
934 """Set the current end of line mode."""
937 def SetEdgeColour(self
, edgeColour
):
938 """Change the colour used in edge indication."""
941 def SetEdgeColumn(self
, column
):
942 """Set the column number of the edge. If text goes past the
943 edge then it is highlighted."""
946 def SetEdgeMode(self
, mode
):
947 """The edge may be displayed by a line (self, EDGE_LINE) or by
948 highlighting text that goes beyond it (self, EDGE_BACKGROUND)
949 or not displayed at all (self, EDGE_NONE)."""
952 def SetEndAtLastLine(self
, endAtLastLine
):
953 """Sets the scroll range so that maximum scroll position has
954 the last line at the bottom of the view (self, default).
955 Setting this to false allows scrolling one page below the last
959 def SetFoldExpanded(self
, line
, expanded
):
960 """Show the children of a header line."""
963 def SetFoldFlags(self
, flags
):
964 """Set some debugging options for folding."""
967 def SetFoldLevel(self
, line
, level
):
968 """Set the fold level of a line. This encodes an integer
969 level along with flags indicating whether the line is a header
970 and whether it is effectively white space."""
973 def SetHScrollBar(self
, bar
):
974 """Set the horizontal scrollbar to use instead of the one
978 def SetHighlightGuide(self
, column
):
979 """Set the highlighted indentation guide column. 0 = no
980 highlighted guide."""
983 def SetIndent(self
, indentSize
):
984 """Set the number of spaces used for one level of indentation."""
987 def SetIndentationGuides(self
, show
):
988 """Show or hide indentation guides."""
991 def SetKeyWords(self
, keywordSet
, keyWords
):
992 """Set up the key words used by the lexer."""
995 def SetLastKeydownProcessed(self
, val
):
999 def SetLayoutCache(self
, mode
):
1000 """Sets the degree of caching of layout information."""
1003 def SetLexer(self
, lexer
):
1004 """Set the lexing language of the document."""
1007 def SetLexerLanguage(self
, language
):
1008 """Set the lexing language of the document based on string
1012 def SetLineIndentation(self
, line
, indentSize
):
1013 """Change the indentation of a line to a number of columns."""
1016 def SetLineState(self
, line
, state
):
1017 """Used to hold extra styling information for each line."""
1020 def SetMarginLeft(self
, pixelWidth
):
1021 """Sets the size in pixels of the left margin."""
1024 def SetMarginMask(self
, margin
, mask
):
1025 """Set a mask that determines which markers are displayed in a
1029 def SetMarginRight(self
, pixelWidth
):
1030 """Sets the size in pixels of the right margin."""
1033 def SetMarginSensitive(self
, margin
, sensitive
):
1034 """Make a margin sensitive or insensitive to mouse clicks."""
1037 def SetMarginType(self
, margin
, marginType
):
1038 """Set a margin to be either numeric or symbolic."""
1041 def SetMarginWidth(self
, margin
, pixelWidth
):
1042 """Set the width of a margin to a width expressed in pixels."""
1045 def SetMargins(self
, left
, right
):
1046 """Set the left and right margin in the edit area, measured in
1050 def SetModEventMask(self
, mask
):
1051 """Set which document modification events are sent to the
1055 def SetMouseDownCaptures(self
, captures
):
1056 """Set whether the mouse is captured when its button is
1060 def SetMouseDwellTime(self
, periodMilliseconds
):
1061 """Sets the time the mouse must sit still to generate a mouse
1065 def SetOvertype(self
, overtype
):
1066 """Set to overtype (self, true) or insert mode."""
1069 def SetPrintColourMode(self
, mode
):
1070 """Modify colours when printing for clearer printed text."""
1073 def SetPrintMagnification(self
, magnification
):
1074 """Sets the print magnification added to the point size of
1075 each style for printing."""
1078 def SetProperty(self
, key
, value
):
1079 """Set up a value that may be used by a lexer for some
1080 optional feature."""
1083 def SetReadOnly(self
, readOnly
):
1084 """Set to read only or read write."""
1087 def SetSTCFocus(self
, focus
):
1088 """Change internal focus flag."""
1091 def SetSavePoint(self
):
1092 """Remember the current position in the undo history as the
1093 position at which the document was saved."""
1096 def SetScrollWidth(self
, pixelWidth
):
1097 """Sets the document width assumed for scrolling."""
1100 def SetSearchFlags(self
, flags
):
1101 """Set the search flags used by SearchInTarget."""
1104 def SetSelBackground(self
, useSetting
, back
):
1105 """Set the background colour of the selection and whether to
1106 use this setting."""
1109 def SetSelForeground(self
, useSetting
, fore
):
1110 """Set the foreground colour of the selection and whether to
1111 use this setting."""
1114 def SetSelection(self
, start
, end
):
1115 """Select a range of text."""
1118 def SetSelectionEnd(self
, pos
):
1119 """Sets the position that ends the selection - this becomes
1120 the currentPosition."""
1123 def SetSelectionStart(self
, pos
):
1124 """Sets the position that starts the selection - this becomes
1128 def SetStatus(self
, statusCode
):
1129 """Change error status - 0 = OK."""
1132 def SetStyleBits(self
, bits
):
1133 """Divide each styling byte into lexical class bits (self,
1134 default: 5) and indicator bits (self, default: 3). If a lexer
1135 requires more than 32 lexical states, then this is used to
1136 expand the possible states."""
1139 def SetStyleBytes(self
, length
, styleBytes
):
1140 """Set the styles for a segment of the document."""
1143 def SetStyling(self
, length
, style
):
1144 """Change style from current styling position for length
1145 characters to a style and move the current styling position to
1146 after this newly styled segment."""
1149 def SetTabIndents(self
, tabIndents
):
1150 """Sets whether a tab pressed when caret is within indentation
1154 def SetTabWidth(self
, tabWidth
):
1155 """Change the visible size of a tab to be a multiple of the
1156 width of a space character."""
1159 def SetTargetEnd(self
, pos
):
1160 """Sets the position that ends the target which is used for
1161 updating the document without affecting the scroll position."""
1164 def SetTargetStart(self
, pos
):
1165 """Sets the position that starts the target which is used for
1166 updating the document without affecting the scroll position."""
1169 def SetText(self
, text
):
1170 """Replace the contents of the document with the argument
1174 def SetUndoCollection(self
, collectUndo
):
1175 """Choose between collecting actions into the undo history and
1179 def SetUseHorizontalScrollBar(self
, show
):
1180 """Show or hide the horizontal scroll bar."""
1183 def SetUseTabs(self
, useTabs
):
1184 """Indentation will only use space characters if useTabs is
1185 false, otherwise it will use a combination of tabs and spaces."""
1188 def SetVScrollBar(self
, bar
):
1189 """Set the vertical scrollbar to use instead of the one that's
1193 def SetViewEOL(self
, visible
):
1194 """Make the end of line characters visible or invisible."""
1197 def SetViewWhiteSpace(self
, viewWS
):
1198 """Make white space characters invisible, always visible or
1199 visible outside indentation."""
1202 def SetVisiblePolicy(self
, visiblePolicy
, visibleSlop
):
1203 """Set the way the display area is determined when a
1204 particular line is to be moved to by Find, FindNext, GotoLine,
1208 def SetWhitespaceBackground(self
, useSetting
, back
):
1209 """Set the background colour of all whitespace and whether to
1210 use this setting."""
1213 def SetWhitespaceForeground(self
, useSetting
, fore
):
1214 """Set the foreground colour of all whitespace and whether to
1215 use this setting."""
1218 def SetWordChars(self
, characters
):
1219 """Set the set of characters making up words for when moving
1220 or selecting by word."""
1223 def SetWrapMode(self
, mode
):
1224 """Sets whether text is word wrapped."""
1227 def SetXCaretPolicy(self
, caretPolicy
, caretSlop
):
1228 """Set the way the caret is kept visible when going sideway.
1229 The exclusion zone is given in pixels."""
1232 def SetXOffset(self
, newOffset
):
1233 """Set the xOffset (self, ie, horizonal scroll position)."""
1236 def SetYCaretPolicy(self
, caretPolicy
, caretSlop
):
1237 """Set the way the line the caret is on is kept visible. The
1238 exclusion zone is given in lines."""
1241 def SetZoom(self
, zoom
):
1242 """Set the zoom level. This number of points is added to the
1243 size of all fonts. It may be positive to magnify or negative
1247 def ShowLines(self
, lineStart
, lineEnd
):
1248 """Make a range of lines visible."""
1251 def StartRecord(self
):
1252 """Start notifying the container of all key presses and
1256 def StartStyling(self
, pos
, mask
):
1257 """Set the current styling position and mask.
1259 The styling mask can be used to protect some bits in each
1260 styling byte from modification."""
1263 def StopRecord(self
):
1264 """Stop notifying the container of all key presses and
1268 def StyleClearAll(self
):
1269 """Clear all the styles and make equivalent to the global
1273 def StyleResetDefault(self
):
1274 """Reset the default style to its state at startup."""
1277 def StyleSetBackground(self
, style
, back
):
1278 """Set the background colour of a style."""
1281 def StyleSetBold(self
, style
, bold
):
1282 """Set a style to be bold or not."""
1285 def StyleSetCase(self
, style
, caseForce
):
1286 """Set a style to be mixed case, or to force upper or lower
1290 def StyleSetChangeable(self
, style
, changeable
):
1291 """Set a style to be changeable or not (self, read only).
1292 Experimental feature, currently buggy."""
1295 def StyleSetCharacterSet(self
, style
, characterSet
):
1296 """Set the character set of the font in a style."""
1299 def StyleSetEOLFilled(self
, style
, filled
):
1300 """Set a style to have its end of line filled or not."""
1303 def StyleSetFaceName(self
, style
, fontName
):
1304 """Set the font of a style."""
1307 def StyleSetFont(self
, styleNum
, font
):
1308 """Set style size, face, bold, italic, and underline
1309 attributes from a Font's attributes."""
1312 def StyleSetFontAttr(self
, styleNum
, size
, faceName
,
1313 bold
, italic
, underline
):
1314 """Set all font style attributes at once."""
1317 def StyleSetForeground(self
, style
, fore
):
1318 """Set the foreground colour of a style."""
1321 def StyleSetItalic(self
, style
, italic
):
1322 """Set a style to be italic or not."""
1325 def StyleSetSize(self
, style
, sizePoints
):
1326 """Set the size of characters of a style."""
1329 def StyleSetSpec(self
, styleNum
, spec
):
1330 """Extract style settings from a spec-string which is composed
1331 of one or more of the following comma separated elements:
1334 italic turns on italics
1335 fore:#RRGGBB sets the foreground colour
1336 back:#RRGGBB sets the background colour
1337 face:[facename] sets the font face name to use
1338 size:[num] sets the font size in points
1339 eol turns on eol filling
1340 underline turns on underlining
1344 def StyleSetUnderline(self
, style
, underline
):
1345 """Set a style to be underlined or not."""
1348 def StyleSetVisible(self
, style
, visible
):
1349 """Set a style to be visible or not."""
1352 def TextHeight(self
, line
):
1353 """Return the height of a particular line of text in pixels."""
1356 def TextWidth(self
, style
, text
):
1357 """Measure the pixel width of some text in a particular style.
1358 Nul terminated text argument. Does not handle tab or control
1362 def ToggleFold(self
, line
):
1363 """Switch a header line between expanded and contracted."""
1367 """Undo one action in the undo history."""
1370 def UsePopUp(self
, allowPopUp
):
1371 """Set whether a pop up menu is displayed automatically when
1372 the user presses the wrong mouse button."""
1375 def UserListShow(self
, listType
, itemList
):
1376 """Display a list of strings and send notification when user
1380 def VisibleFromDocLine(self
, line
):
1381 """Find the display line of a document line taking hidden
1382 lines into account."""
1385 def WordEndPosition(self
, pos
, onlyWordCharacters
):
1386 """Return position of end of word."""
1389 def WordPartLeft(self
):
1390 """Move to the previous change in capitalisation."""
1393 def WordPartLeftExtend(self
):
1394 """Move to the previous change in capitalisation extending
1395 selection to new caret position."""
1398 def WordPartRight(self
):
1399 """Move to the change next in capitalisation."""
1402 def WordPartRightExtend(self
):
1403 """Move to the next change in capitalisation extending
1404 selection to new caret position."""
1407 def WordStartPosition(self
, pos
, onlyWordCharacters
):
1408 """Return position of start of word."""