1 /////////////////////////////////////////////////////////////////////////////
2 // Name: richtext/richtextctrl.h
3 // Purpose: interface of wxRichTextCtrl and wxRichTextEvent
4 // Author: wxWidgets team
6 // Licence: wxWindows licence
7 /////////////////////////////////////////////////////////////////////////////
10 @class wxRichTextEvent
12 This is the event class for wxRichTextCtrl notifications.
14 @beginEventTable{wxRichTextEvent}
15 @event{EVT_RICHTEXT_CHARACTER(id, func)}
16 Process a @c wxEVT_COMMAND_RICHTEXT_CHARACTER event, generated when the user
17 presses a character key. Valid event functions: GetFlags, GetPosition, GetCharacter.
18 @event{EVT_RICHTEXT_DELETE(id, func)}
19 Process a @c wxEVT_COMMAND_RICHTEXT_DELETE event, generated when the user
20 presses the backspace or delete key. Valid event functions: GetFlags, GetPosition.
21 @event{EVT_RICHTEXT_RETURN(id, func)}
22 Process a @c wxEVT_COMMAND_RICHTEXT_RETURN event, generated when the user
23 presses the return key. Valid event functions: GetFlags, GetPosition.
24 @event{EVT_RICHTEXT_STYLE_CHANGED(id, func)}
25 Process a @c wxEVT_COMMAND_RICHTEXT_STYLE_CHANGED event, generated when
26 styling has been applied to the control. Valid event functions: GetPosition, GetRange.
27 @event{EVT_RICHTEXT_STYLESHEET_CHANGED(id, func)}
28 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING event, generated
29 when the control's stylesheet has changed, for example the user added,
30 edited or deleted a style. Valid event functions: GetRange, GetPosition.
31 @event{EVT_RICHTEXT_STYLESHEET_REPLACING(id, func)}
32 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACING event, generated
33 when the control's stylesheet is about to be replaced, for example when
34 a file is loaded into the control.
35 Valid event functions: Veto, GetOldStyleSheet, GetNewStyleSheet.
36 @event{EVT_RICHTEXT_STYLESHEET_REPLACED(id, func)}
37 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACED event, generated
38 when the control's stylesheet has been replaced, for example when a file
39 is loaded into the control.
40 Valid event functions: GetOldStyleSheet, GetNewStyleSheet.
41 @event{EVT_RICHTEXT_CONTENT_INSERTED(id, func)}
42 Process a @c wxEVT_COMMAND_RICHTEXT_CONTENT_INSERTED event, generated when
43 content has been inserted into the control.
44 Valid event functions: GetPosition, GetRange.
45 @event{EVT_RICHTEXT_CONTENT_DELETED(id, func)}
46 Process a @c wxEVT_COMMAND_RICHTEXT_CONTENT_DELETED event, generated when
47 content has been deleted from the control.
48 Valid event functions: GetPosition, GetRange.
49 @event{EVT_RICHTEXT_BUFFER_RESET(id, func)}
50 Process a @c wxEVT_COMMAND_RICHTEXT_BUFFER_RESET event, generated when the
51 buffer has been reset by deleting all content.
52 You can use this to set a default style for the first new paragraph.
56 @category{events,richtext}
58 class wxRichTextEvent
: public wxNotifyEvent
64 wxRichTextEvent(const wxRichTextEvent
& event
);
70 The type of the event.
72 Window identifier. The value @c wxID_ANY indicates a default value.
74 wxRichTextEvent(wxEventType commandType
= wxEVT_NULL
, int id
= 0);
77 Returns the character pressed, within a @c wxEVT_COMMAND_RICHTEXT_CHARACTER event.
79 wxChar
GetCharacter() const;
82 Returns flags indicating modifier keys pressed.
84 Possible values are @c wxRICHTEXT_CTRL_DOWN, @c wxRICHTEXT_SHIFT_DOWN, and @c wxRICHTEXT_ALT_DOWN.
89 Returns the new style sheet.
91 Can be used in a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING or
92 @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED event handler.
94 wxRichTextStyleSheet
* GetNewStyleSheet() const;
97 Returns the old style sheet.
99 Can be used in a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING or
100 @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED event handler.
102 wxRichTextStyleSheet
* GetOldStyleSheet() const;
105 Returns the buffer position at which the event occured.
107 long GetPosition() const;
110 Gets the range for the current operation.
112 const wxRichTextRange
& GetRange() const;
115 Sets the character variable.
117 void SetCharacter(wxChar ch
);
120 Sets flags indicating modifier keys pressed.
122 Possible values are @c wxRICHTEXT_CTRL_DOWN, @c wxRICHTEXT_SHIFT_DOWN, and @c wxRICHTEXT_ALT_DOWN.
124 void SetFlags(int flags
);
127 Sets the new style sheet variable.
129 void SetNewStyleSheet(wxRichTextStyleSheet
* sheet
);
132 Sets the old style sheet variable.
134 void SetOldStyleSheet(wxRichTextStyleSheet
* sheet
);
137 Sets the buffer position variable.
139 void SetPosition(long pos
);
142 Sets the range variable.
144 void SetRange(const wxRichTextRange
& range
);
150 @class wxRichTextCtrl
152 wxRichTextCtrl provides a generic, ground-up implementation of a text control
153 capable of showing multiple styles and images.
155 wxRichTextCtrl sends notification events: see wxRichTextEvent.
157 It also sends the standard wxTextCtrl events wxEVT_COMMAND_TEXT_ENTER and
158 wxEVT_COMMAND_TEXT_UPDATED, and wxTextUrlEvent when URL content is clicked.
160 For more information, see the @ref overview_richtextctrl.
163 @style{wxRE_CENTRE_CARET}
164 The control will try to keep the caret line centred vertically while editing.
165 wxRE_CENTER_CARET is a synonym for this style.
166 @style{wxRE_MULTILINE}
167 The control will be multiline (mandatory).
168 @style{wxRE_READONLY}
169 The control will not be editable.
174 @appearance{richtextctrl.png}
185 Constructor, creating and showing a rich text control.
188 Parent window. Must not be @NULL.
190 Window identifier. The value @c wxID_ANY indicates a default value.
204 @see Create(), wxValidator
206 wxRichTextCtrl(wxWindow
* parent
, wxWindowID id
= wxID_ANY
,
207 const wxString
& value
= wxEmptyString
,
208 const wxPoint
& pos
= wxDefaultPosition
,
209 const wxSize
& size
= wxDefaultSize
,
210 long style
= wxRE_MULTILINE
,
211 const wxValidator
& validator
= wxDefaultValidator
,
212 const wxString
& name
= wxTextCtrlNameStr
);
217 virtual ~wxRichTextCtrl();
220 Adds an image to the control's buffer.
222 virtual wxRichTextRange
AddImage(const wxImage
& image
);
225 Adds a new paragraph of text to the end of the buffer.
227 virtual wxRichTextRange
AddParagraph(const wxString
& text
);
230 Sets the insertion point to the end of the buffer and writes the text.
232 virtual void AppendText(const wxString
& text
);
235 Applies the given alignment to the selection (undoable).
236 For alignment values, see wxTextAttr.
238 virtual bool ApplyAlignmentToSelection(wxTextAttrAlignment alignment
);
241 Apples bold to the selection (undoable).
243 virtual bool ApplyBoldToSelection();
246 Applies italic to the selection (undoable).
248 virtual bool ApplyItalicToSelection();
251 Applies the given style to the selection.
253 virtual bool ApplyStyle(wxRichTextStyleDefinition
* def
);
256 Applies the style sheet to the buffer, matching paragraph styles in the sheet
257 against named styles in the buffer.
259 This might be useful if the styles have changed.
260 If @a sheet is @NULL, the sheet set with SetStyleSheet() is used.
261 Currently this applies paragraph styles only.
263 bool ApplyStyleSheet(wxRichTextStyleSheet
* sheet
= NULL
);
266 Applies underline to the selection (undoable).
268 virtual bool ApplyUnderlineToSelection();
271 Returns @true if undo commands are being batched.
273 virtual bool BatchingUndo() const;
276 Begins using alignment.
277 For alignment values, see wxTextAttr.
279 bool BeginAlignment(wxTextAttrAlignment alignment
);
282 Starts batching undo history for commands.
284 virtual bool BeginBatchUndo(const wxString
& cmdName
);
292 Begins using the named character style.
294 bool BeginCharacterStyle(const wxString
& characterStyle
);
297 Begins using this font.
299 bool BeginFont(const wxFont
& font
);
302 Begins using the given point size.
304 bool BeginFontSize(int pointSize
);
312 Begins applying a left indent and subindent in tenths of a millimetre.
313 The subindent is an offset from the left edge of the paragraph, and is
314 used for all but the first line in a paragraph. A positive value will
315 cause the first line to appear to the left of the subsequent lines, and
316 a negative value will cause the first line to be indented to the right
317 of the subsequent lines.
319 wxRichTextBuffer uses indentation to render a bulleted item. The
320 content of the paragraph, including the first line, starts at the
321 @a leftIndent plus the @a leftSubIndent.
324 The distance between the margin and the bullet.
326 The distance between the left edge of the bullet and the left edge
327 of the actual paragraph.
329 bool BeginLeftIndent(int leftIndent
, int leftSubIndent
= 0);
332 Begins appling line spacing. @e spacing is a multiple, where 10 means
333 single-spacing, 15 means 1.5 spacing, and 20 means double spacing.
335 The ::wxTextAttrLineSpacing constants are defined for convenience.
337 bool BeginLineSpacing(int lineSpacing
);
340 Begins using a specified list style.
341 Optionally, you can also pass a level and a number.
343 bool BeginListStyle(const wxString
& listStyle
, int level
= 1,
347 Begins a numbered bullet.
349 This call will be needed for each item in the list, and the
350 application should take care of incrementing the numbering.
352 @a bulletNumber is a number, usually starting with 1.
353 @a leftIndent and @a leftSubIndent are values in tenths of a millimetre.
354 @a bulletStyle is a bitlist of the ::wxTextAttrBulletStyle values.
356 wxRichTextBuffer uses indentation to render a bulleted item.
357 The left indent is the distance between the margin and the bullet.
358 The content of the paragraph, including the first line, starts
359 at leftMargin + leftSubIndent.
360 So the distance between the left edge of the bullet and the
361 left of the actual paragraph is leftSubIndent.
363 bool BeginNumberedBullet(int bulletNumber
, int leftIndent
,
365 int bulletStyle
= wxTEXT_ATTR_BULLET_STYLE_ARABIC
|wxTEXT_ATTR_BULLET_STYLE_PERIOD
);
368 Begins paragraph spacing; pass the before-paragraph and after-paragraph spacing
369 in tenths of a millimetre.
371 bool BeginParagraphSpacing(int before
, int after
);
374 Begins applying the named paragraph style.
376 bool BeginParagraphStyle(const wxString
& paragraphStyle
);
379 Begins a right indent, specified in tenths of a millimetre.
381 bool BeginRightIndent(int rightIndent
);
384 Begins applying a style.
386 virtual bool BeginStyle(const wxTextAttr
& style
);
389 Starts suppressing undo history for commands.
391 virtual bool BeginSuppressUndo();
394 Begins applying a symbol bullet, using a character from the current font.
395 See BeginNumberedBullet() for an explanation of how indentation is used
396 to render the bulleted paragraph.
398 bool BeginSymbolBullet(const wxString
& symbol
, int leftIndent
,
400 int bulletStyle
= wxTEXT_ATTR_BULLET_STYLE_SYMBOL
);
403 Begins using this colour.
405 bool BeginTextColour(const wxColour
& colour
);
408 Begins applying wxTEXT_ATTR_URL to the content.
410 Pass a URL and optionally, a character style to apply, since it is common
411 to mark a URL with a familiar style such as blue text with underlining.
413 bool BeginURL(const wxString
& url
,
414 const wxString
& characterStyle
= wxEmptyString
);
417 Begins using underlining.
419 bool BeginUnderline();
422 Returns @true if selected content can be copied to the clipboard.
424 virtual bool CanCopy() const;
427 Returns @true if selected content can be copied to the clipboard and deleted.
429 virtual bool CanCut() const;
432 Returns @true if selected content can be deleted.
434 virtual bool CanDeleteSelection() const;
437 Returns @true if the clipboard content can be pasted to the buffer.
439 virtual bool CanPaste() const;
442 Returns @true if there is a command in the command history that can be redone.
444 virtual bool CanRedo() const;
447 Returns @true if there is a command in the command history that can be undone.
449 virtual bool CanUndo() const;
452 Clears the buffer content, leaving a single empty paragraph. Cannot be undone.
454 virtual void Clear();
457 Clears the list style from the given range, clearing list-related attributes
458 and applying any named paragraph style associated with each paragraph.
460 @a flags is a bit list of the following:
461 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
463 @see SetListStyle(), PromoteList(), NumberList().
465 virtual bool ClearListStyle(const wxRichTextRange
& range
,
466 int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
);
469 Sends the event to the control.
471 virtual void Command(wxCommandEvent
& event
);
474 Copies the selected content (if any) to the clipboard.
479 Creates the underlying window.
481 bool Create(wxWindow
* parent
, wxWindowID id
= wxID_ANY
,
482 const wxString
& value
= wxEmptyString
,
483 const wxPoint
& pos
= wxDefaultPosition
,
484 const wxSize
& size
= wxDefaultSize
,
485 long style
= wxRE_MULTILINE
,
486 const wxValidator
& validator
= wxDefaultValidator
,
487 const wxString
& name
= wxTextCtrlNameStr
);
490 Copies the selected content (if any) to the clipboard and deletes the selection.
496 Deletes the content within the given range.
498 virtual bool Delete(const wxRichTextRange
& range
);
501 Deletes content if there is a selection, e.g. when pressing a key.
502 Returns the new caret position in @e newPos, or leaves it if there
503 was no action. This is undoable.
506 In wxPerl this method takes no arguments and returns a 2-element
510 bool DeleteSelectedContent(long* newPos
= NULL
);
513 Deletes the content in the selection, if any. This is undoable.
515 virtual void DeleteSelection();
518 Sets the buffer's modified status to @false, and clears the buffer's command
521 virtual void DiscardEdits();
529 Ends application of all styles in the current style stack.
531 virtual bool EndAllStyles();
534 Ends batching undo command history.
536 virtual bool EndBatchUndo();
544 Ends application of a named character style.
546 bool EndCharacterStyle();
554 Ends using a point size.
566 bool EndLeftIndent();
571 bool EndLineSpacing();
574 Ends using a specified list style.
579 Ends application of a numbered bullet.
581 bool EndNumberedBullet();
584 Ends paragraph spacing.
586 bool EndParagraphSpacing();
589 Ends application of a named character style.
591 bool EndParagraphStyle();
596 bool EndRightIndent();
599 Ends the current style.
601 virtual bool EndStyle();
604 Ends suppressing undo command history.
606 virtual bool EndSuppressUndo();
609 Ends applying a symbol bullet.
611 bool EndSymbolBullet();
614 Ends applying a text colour.
616 bool EndTextColour();
624 End applying underlining.
629 Helper function for extending the selection, returning @true if the selection
630 was changed. Selections are in caret positions.
632 virtual bool ExtendSelection(long oldPosition
, long newPosition
, int flags
);
635 Helper function for finding the caret position for the next word.
636 Direction is 1 (forward) or -1 (backwards).
638 virtual long FindNextWordPosition(int direction
= 1) const;
641 Call this function to prevent refresh and allow fast updates, and then Thaw() to
647 Gets the basic (overall) style.
649 This is the style of the whole buffer before further styles are applied,
650 unlike the default style, which only affects the style currently being
651 applied (for example, setting the default style to bold will cause
652 subsequently inserted text to be bold).
654 virtual const wxTextAttr
& GetBasicStyle() const;
658 Returns the buffer associated with the control.
660 const wxRichTextBuffer
GetBuffer();
661 const wxRichTextBuffer
& GetBuffer();
665 Returns the current caret position.
667 long GetCaretPosition() const;
670 Returns the caret height and position for the given character position.
673 In wxPerl this method is implemented as
674 GetCaretPositionForIndex(@a position) returning a
675 2-element list (ok, rect).
678 bool GetCaretPositionForIndex(long position
, wxRect
& rect
);
681 Gets the command processor associated with the control's buffer.
683 wxCommandProcessor
* GetCommandProcessor() const;
686 Returns the current default style, which can be used to change how subsequently
687 inserted text is displayed.
689 virtual const wxTextAttr
& GetDefaultStyle() const;
692 Gets the size of the buffer beyond which layout is delayed during resizing.
693 This optimizes sizing for large buffers. The default is 20000.
695 long GetDelayedLayoutThreshold() const;
698 Gets the current filename associated with the control.
700 wxString
GetFilename() const;
703 Returns the first visible position in the current view.
705 long GetFirstVisiblePosition() const;
708 Returns flags that change the behaviour of loading or saving.
709 See the documentation for each handler class to see what flags are
710 relevant for each handler.
712 int GetHandlerFlags() const;
715 Returns the current insertion point.
717 virtual long GetInsertionPoint() const;
720 Returns the last position in the buffer.
722 virtual wxTextPos
GetLastPosition() const;
725 Returns the length of the specified line in characters.
727 virtual int GetLineLength(long lineNo
) const;
730 Returns the text for the given line.
732 virtual wxString
GetLineText(long lineNo
) const;
735 Transforms physical window position to logical (unscrolled) position.
737 wxPoint
GetLogicalPoint(const wxPoint
& ptPhysical
) const;
740 Returns the number of lines in the buffer.
742 virtual int GetNumberOfLines() const;
745 Transforms logical (unscrolled) position to physical window position.
747 wxPoint
GetPhysicalPoint(const wxPoint
& ptLogical
) const;
750 Gets the text for the given range.
751 The end point of range is specified as the last character position of
752 the span of text, plus one.
754 virtual wxString
GetRange(long from
, long to
) const;
757 Returns the range of the current selection.
758 The end point of range is specified as the last character position of the span
760 If the return values @a from and @a to are the same, there is no selection.
762 virtual void GetSelection(long* from
, long* to
) const;
765 Returns the selection range in character positions. -1, -1 means no selection.
767 wxRichTextRange
GetSelectionRange() const;
770 Returns the text within the current selection range, if any.
772 virtual wxString
GetStringSelection() const;
775 Gets the attributes at the given position.
776 This function gets the combined style - that is, the style you see on the
777 screen as a result of combining base style, paragraph style and character
780 To get the character or paragraph style alone, use GetUncombinedStyle().
783 In wxPerl this method is implemented as GetStyle(@a position)
784 returning a 2-element list (ok, attr).
787 virtual bool GetStyle(long position
, wxTextAttr
& style
);
790 Gets the attributes common to the specified range.
791 Attributes that differ in value within the range will not be included
795 In wxPerl this method is implemented as GetStyleForRange(@a position)
796 returning a 2-element list (ok, attr).
799 virtual bool GetStyleForRange(const wxRichTextRange
& range
,
803 Returns the style sheet associated with the control, if any.
804 A style sheet allows named character and paragraph styles to be applied.
806 wxRichTextStyleSheet
* GetStyleSheet() const;
809 Gets the attributes at the given position.
810 This function gets the @e uncombined style - that is, the attributes associated
811 with the paragraph or character content, and not necessarily the combined
812 attributes you see on the screen.
813 To get the combined attributes, use GetStyle().
815 If you specify (any) paragraph attribute in @e style's flags, this function
816 will fetch the paragraph attributes.
817 Otherwise, it will return the character attributes.
820 In wxPerl this method is implemented as GetUncombinedStyle(@a position)
821 returning a 2-element list (ok, attr).
824 virtual bool GetUncombinedStyle(long position
, wxTextAttr
& style
);
827 Returns the content of the entire control as a string.
829 virtual wxString
GetValue() const;
832 Internal helper function returning the line for the visible caret position.
833 If the caret is shown at the very end of the line, it means the next character
834 is actually on the following line.
835 So this function gets the line we're expecting to find if this is the case.
837 wxRichTextLine
* GetVisibleLineForCaretPosition(long caretPosition
) const;
840 Test if this whole range has character attributes of the specified kind.
841 If any of the attributes are different within the range, the test fails.
843 You can use this to implement, for example, bold button updating.
844 @a style must have flags indicating which attributes are of interest.
846 virtual bool HasCharacterAttributes(const wxRichTextRange
& range
,
847 const wxTextAttr
& style
) const;
850 Test if this whole range has paragraph attributes of the specified kind.
851 If any of the attributes are different within the range, the test fails.
852 You can use this to implement, for example, centering button updating.
853 @a style must have flags indicating which attributes are of interest.
855 virtual bool HasParagraphAttributes(const wxRichTextRange
& range
,
856 const wxTextAttr
& style
) const;
859 Returns @true if there is a selection.
861 virtual bool HasSelection() const;
865 Finds the character at the given position in pixels.
866 @a pt is in device coords (not adjusted for the client area origin nor for
869 wxTextCtrlHitTestResult
HitTest(const wxPoint
& pt
, long* pos
) const;
870 const wxTextCtrlHitTestResult
HitTest(const wxPoint
& pt
,
872 wxTextCoord
* row
) const;
876 Initialises the members of the control.
881 Returns @true if the user has recently set the default style without moving
882 the caret, and therefore the UI needs to reflect the default style and not
883 the style at the caret.
885 Below is an example of code that uses this function to determine whether the UI
886 should show that the current style is bold.
888 @see SetAndShowDefaultStyle().
890 bool IsDefaultStyleShowing() const;
893 Returns @true if the control is editable.
895 virtual bool IsEditable() const;
898 Returns @true if Freeze has been called without a Thaw.
900 bool IsFrozen() const;
903 Returns @true if the buffer has been modified.
905 virtual bool IsModified() const;
908 Returns @true if the control is multiline.
910 bool IsMultiLine() const;
913 Returns @true if the given position is visible on the screen.
915 bool IsPositionVisible(long pos
) const;
918 Returns @true if all of the selection is aligned according to the specified flag.
920 virtual bool IsSelectionAligned(wxTextAttrAlignment alignment
);
923 Returns @true if all of the selection is bold.
925 virtual bool IsSelectionBold();
928 Returns @true if all of the selection is italic.
930 virtual bool IsSelectionItalics();
933 Returns @true if all of the selection is underlined.
935 virtual bool IsSelectionUnderlined();
938 Returns @true if the control is single-line.
939 Currently wxRichTextCtrl does not support single-line editing.
941 bool IsSingleLine() const;
944 Helper function implementing keyboard navigation.
946 virtual bool KeyboardNavigate(int keyCode
, int flags
);
949 Lays out the buffer, which must be done before certain operations, such as
950 setting the caret position.
951 This function should not normally be required by the application.
953 virtual bool LayoutContent(bool onlyVisibleRect
= false);
956 Inserts a line break at the current insertion point.
958 A line break forces wrapping within a paragraph, and can be introduced by
959 using this function, by appending the wxChar value @b wxRichTextLineBreakChar
960 to text content, or by typing Shift-Return.
962 virtual bool LineBreak();
965 Loads content into the control's buffer using the given type.
967 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
968 the filename extension.
970 This function looks for a suitable wxRichTextFileHandler object.
972 bool LoadFile(const wxString
& file
,
973 int type
= wxRICHTEXT_TYPE_ANY
);
976 Marks the buffer as modified.
978 virtual void MarkDirty();
981 Move the caret to the given character position.
983 Please note that this does not update the current editing style
984 from the new position; to do that, call wxRichTextCtrl::SetInsertionPoint instead.
986 virtual bool MoveCaret(long pos
, bool showAtLineStart
= false);
989 Move the caret one visual step forward: this may mean setting a flag
990 and keeping the same position if we're going from the end of one line
991 to the start of the next, which may be the exact same caret position.
993 void MoveCaretBack(long oldPosition
);
996 Move the caret one visual step forward: this may mean setting a flag
997 and keeping the same position if we're going from the end of one line
998 to the start of the next, which may be the exact same caret position.
1000 void MoveCaretForward(long oldPosition
);
1003 Moves the caret down.
1005 virtual bool MoveDown(int noLines
= 1, int flags
= 0);
1008 Moves to the end of the buffer.
1010 virtual bool MoveEnd(int flags
= 0);
1013 Moves to the start of the buffer.
1015 virtual bool MoveHome(int flags
= 0);
1020 virtual bool MoveLeft(int noPositions
= 1, int flags
= 0);
1025 virtual bool MoveRight(int noPositions
= 1, int flags
= 0);
1028 Moves to the end of the line.
1030 virtual bool MoveToLineEnd(int flags
= 0);
1033 Moves to the start of the line.
1035 virtual bool MoveToLineStart(int flags
= 0);
1038 Moves to the end of the paragraph.
1040 virtual bool MoveToParagraphEnd(int flags
= 0);
1043 Moves to the start of the paragraph.
1045 virtual bool MoveToParagraphStart(int flags
= 0);
1050 virtual bool MoveUp(int noLines
= 1, int flags
= 0);
1053 Inserts a new paragraph at the current insertion point. @see LineBreak().
1055 virtual bool Newline();
1059 Numbers the paragraphs in the given range.
1060 Pass flags to determine how the attributes are set.
1062 Either the style definition or the name of the style definition (in the current
1063 sheet) can be passed.
1065 @a flags is a bit list of the following:
1066 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
1067 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
1068 @a startFrom, otherwise existing attributes are used.
1069 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
1070 as the level for all paragraphs, otherwise the current indentation will be used.
1072 @see SetListStyle(), PromoteList(), ClearListStyle().
1074 bool NumberList(const wxRichTextRange
& range
,
1075 const wxRichTextListStyleDefinition
* style
,
1076 int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
,
1078 int listLevel
= -1);
1079 bool Number(const wxRichTextRange
& range
,
1080 const wxString
& styleName
,
1081 int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
,
1083 int listLevel
= -1);
1087 Standard handler for the wxID_CLEAR command.
1089 void OnClear(wxCommandEvent
& event
);
1092 Shows a standard context menu with undo, redo, cut, copy, paste, clear, and
1093 select all commands.
1095 void OnContextMenu(wxContextMenuEvent
& event
);
1098 Standard handler for the wxID_COPY command.
1100 void OnCopy(wxCommandEvent
& event
);
1103 Standard handler for the wxID_CUT command.
1105 void OnCut(wxCommandEvent
& event
);
1108 Loads the first dropped file.
1110 void OnDropFiles(wxDropFilesEvent
& event
);
1113 Standard handler for the wxID_PASTE command.
1115 void OnPaste(wxCommandEvent
& event
);
1118 Standard handler for the wxID_REDO command.
1120 void OnRedo(wxCommandEvent
& event
);
1123 Standard handler for the wxID_SELECTALL command.
1125 void OnSelectAll(wxCommandEvent
& event
);
1128 Standard handler for the wxID_UNDO command.
1130 void OnUndo(wxCommandEvent
& event
);
1133 Standard update handler for the wxID_CLEAR command.
1135 void OnUpdateClear(wxUpdateUIEvent
& event
);
1138 Standard update handler for the wxID_COPY command.
1140 void OnUpdateCopy(wxUpdateUIEvent
& event
);
1143 Standard update handler for the wxID_CUT command.
1145 void OnUpdateCut(wxUpdateUIEvent
& event
);
1148 Standard update handler for the wxID_PASTE command.
1150 void OnUpdatePaste(wxUpdateUIEvent
& event
);
1153 Standard update handler for the wxID_REDO command.
1155 void OnUpdateRedo(wxUpdateUIEvent
& event
);
1158 Standard update handler for the wxID_SELECTALL command.
1160 void OnUpdateSelectAll(wxUpdateUIEvent
& event
);
1163 Standard update handler for the wxID_UNDO command.
1165 void OnUpdateUndo(wxUpdateUIEvent
& event
);
1168 Moves one or more pages down.
1170 virtual bool PageDown(int noPages
= 1, int flags
= 0);
1173 Moves one or more pages up.
1175 virtual bool PageUp(int noPages
= 1, int flags
= 0);
1178 Paints the background.
1180 virtual void PaintBackground(wxDC
& dc
);
1183 Other user defined painting after everything else (i.e. all text) is painted.
1187 virtual void PaintAboveContent(wxDC
& dc
);
1190 Pastes content from the clipboard to the buffer.
1192 virtual void Paste();
1195 Internal function to position the visible caret according to the current caret
1198 virtual void PositionCaret();
1201 Converts a text position to zero-based column and line numbers.
1203 virtual bool PositionToXY(long pos
, long* x
, long* y
) const;
1207 Promotes or demotes the paragraphs in the given range.
1208 A positive @a promoteBy produces a smaller indent, and a negative number
1209 produces a larger indent. Pass flags to determine how the attributes are set.
1210 Either the style definition or the name of the style definition (in the current
1211 sheet) can be passed.
1213 @a flags is a bit list of the following:
1214 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
1215 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
1216 @a startFrom, otherwise existing attributes are used.
1217 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
1218 as the level for all paragraphs, otherwise the current indentation will be used.
1220 @see SetListStyle(), @see SetListStyle(), ClearListStyle().
1222 bool PromoteList(int promoteBy
, const wxRichTextRange
& range
,
1223 const wxRichTextListStyleDefinition
* style
,
1224 int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
,
1225 int listLevel
= -1);
1226 bool PromoteList(int promoteBy
, const wxRichTextRange
& range
,
1227 const wxString
& styleName
,
1228 int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
,
1229 int listLevel
= -1);
1233 Redoes the current command.
1235 virtual void Redo();
1238 Removes the content in the specified range.
1240 virtual void Remove(long from
, long to
);
1243 Replaces the content in the specified range with the string specified by
1246 virtual void Replace(long from
, long to
, const wxString
& value
);
1249 Saves the buffer content using the given type.
1251 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
1252 the filename extension.
1254 This function looks for a suitable wxRichTextFileHandler object.
1256 bool SaveFile(const wxString
& file
= wxEmptyString
,
1257 int type
= wxRICHTEXT_TYPE_ANY
);
1260 Scrolls @a position into view. This function takes a caret position.
1262 virtual bool ScrollIntoView(long position
, int keyCode
);
1265 Selects all the text in the buffer.
1267 virtual void SelectAll();
1270 Cancels any selection.
1272 virtual void SelectNone();
1275 Sets @a attr as the default style and tells the control that the UI should
1276 reflect this attribute until the user moves the caret.
1278 @see IsDefaultStyleShowing().
1280 void SetAndShowDefaultStyle(const wxTextAttr
& attr
);
1283 Sets the basic (overall) style.
1285 This is the style of the whole buffer before further styles are applied,
1286 unlike the default style, which only affects the style currently being
1287 applied (for example, setting the default style to bold will cause
1288 subsequently inserted text to be bold).
1290 virtual void SetBasicStyle(const wxTextAttr
& style
);
1293 Sets the caret position.
1295 The caret position is the character position just before the caret.
1296 A value of -1 means the caret is at the start of the buffer.
1297 Please note that this does not update the current editing style
1298 from the new position or cause the actual caret to be refreshed; to do that,
1299 call wxRichTextCtrl::SetInsertionPoint instead.
1301 void SetCaretPosition(long position
,
1302 bool showAtLineStart
= false);
1305 Sets the current default style, which can be used to change how subsequently
1306 inserted text is displayed.
1308 virtual bool SetDefaultStyle(const wxTextAttr
& style
);
1311 Sets the default style to the style under the cursor.
1313 bool SetDefaultStyleToCursorStyle();
1316 Sets the size of the buffer beyond which layout is delayed during resizing.
1317 This optimizes sizing for large buffers. The default is 20000.
1319 void SetDelayedLayoutThreshold(long threshold
);
1322 Makes the control editable, or not.
1324 virtual void SetEditable(bool editable
);
1327 Sets the current filename.
1329 void SetFilename(const wxString
& filename
);
1332 Sets the font, and also the basic and default attributes
1333 (see wxRichTextCtrl::SetDefaultStyle).
1335 virtual bool SetFont(const wxFont
& font
);
1338 Sets flags that change the behaviour of loading or saving.
1340 See the documentation for each handler class to see what flags are
1341 relevant for each handler.
1343 void SetHandlerFlags(int flags
);
1346 Sets the insertion point and causes the current editing style to be taken from
1347 the new position (unlike wxRichTextCtrl::SetCaretPosition).
1349 virtual void SetInsertionPoint(long pos
);
1352 Sets the insertion point to the end of the text control.
1354 virtual void SetInsertionPointEnd();
1358 Sets the list attributes for the given range, passing flags to determine how
1359 the attributes are set.
1361 Either the style definition or the name of the style definition (in the current
1362 sheet) can be passed.
1363 @a flags is a bit list of the following:
1364 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
1365 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
1366 @a startFrom, otherwise existing attributes are used.
1367 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
1368 as the level for all paragraphs, otherwise the current indentation will be used.
1370 @see NumberList(), PromoteList(), ClearListStyle().
1372 bool SetListStyle(const wxRichTextRange
& range
,
1373 const wxRichTextListStyleDefinition
* style
,
1374 int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
,
1376 int listLevel
= -1);
1377 bool SetListStyle(const wxRichTextRange
& range
,
1378 const wxString
& styleName
,
1379 int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
,
1381 int listLevel
= -1);
1385 Sets the selection to the given range.
1386 The end point of range is specified as the last character position of the span
1389 So, for example, to set the selection for a character at position 5, use the
1392 virtual void SetSelection(long from
, long to
);
1395 Sets the selection to the given range.
1396 The end point of range is specified as the last character position of the span
1399 So, for example, to set the selection for a character at position 5, use the
1402 void SetSelectionRange(const wxRichTextRange
& range
);
1406 Sets the attributes for the given range.
1407 The end point of range is specified as the last character position of the span
1410 So, for example, to set the style for a character at position 5, use the range
1413 bool SetStyle(const wxRichTextRange
& range
,
1414 const wxTextAttr
& style
);
1415 bool SetStyle(long start
, long end
, const wxTextAttr
& style
);
1419 Sets the attributes for the given range, passing flags to determine how the
1422 The end point of range is specified as the last character position of the span
1423 of text, plus one. So, for example, to set the style for a character at
1424 position 5, use the range (5,6).
1426 @a flags may contain a bit list of the following values:
1427 - wxRICHTEXT_SETSTYLE_NONE: no style flag.
1428 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this operation should be
1430 - wxRICHTEXT_SETSTYLE_OPTIMIZE: specifies that the style should not be applied
1431 if the combined style at this point is already the style in question.
1432 - wxRICHTEXT_SETSTYLE_PARAGRAPHS_ONLY: specifies that the style should only be
1433 applied to paragraphs, and not the content.
1434 This allows content styling to be preserved independently from that
1435 of e.g. a named paragraph style.
1436 - wxRICHTEXT_SETSTYLE_CHARACTERS_ONLY: specifies that the style should only be
1437 applied to characters, and not the paragraph.
1438 This allows content styling to be preserved independently from that
1439 of e.g. a named paragraph style.
1440 - wxRICHTEXT_SETSTYLE_RESET: resets (clears) the existing style before applying
1442 - wxRICHTEXT_SETSTYLE_REMOVE: removes the specified style. Only the style flags
1443 are used in this operation.
1445 virtual bool SetStyleEx(const wxRichTextRange
& range
,
1446 const wxTextAttr
& style
,
1447 int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
);
1450 Sets the style sheet associated with the control.
1451 A style sheet allows named character and paragraph styles to be applied.
1453 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
);
1456 Replaces existing content with the given text.
1458 virtual void SetValue(const wxString
& value
);
1461 A helper function setting up scrollbars, for example after a resize.
1463 virtual void SetupScrollbars(bool atTop
= false);
1466 Scrolls the buffer so that the given position is in view.
1468 virtual void ShowPosition(long pos
);
1471 Returns @true if undo history suppression is on.
1473 virtual bool SuppressingUndo() const;
1476 Call this function to end a Freeze and refresh the display.
1481 Undoes the command at the top of the command history, if there is one.
1483 virtual void Undo();
1486 Moves a number of words to the left.
1488 virtual bool WordLeft(int noWords
= 1, int flags
= 0);
1491 Move a nuber of words to the right.
1493 virtual bool WordRight(int noWords
= 1, int flags
= 0);
1496 Loads an image from a file and writes it at the current insertion point.
1498 virtual bool WriteImage(const wxString
& filename
, wxBitmapType bitmapType
);
1501 Writes an image block at the current insertion point.
1503 virtual bool WriteImage(const wxRichTextImageBlock
& imageBlock
);
1507 Write a bitmap or image at the current insertion point.
1508 Supply an optional type to use for internal and file storage of the raw data.
1510 bool WriteImage(const wxBitmap
& bitmap
,
1511 int bitmapType
= wxBITMAP_TYPE_PNG
);
1512 bool WriteImage(const wxImage
& image
,
1513 int bitmapType
= wxBITMAP_TYPE_PNG
);
1517 Writes text at the current position.
1519 virtual void WriteText(const wxString
& text
);
1522 Translates from column and line number to position.
1524 virtual long XYToPosition(long x
, long y
) const;
1529 Currently this simply returns @c wxSize(10, 10).
1531 virtual wxSize
DoGetBestSize() const;
1534 Initialises the command event.
1536 void InitCommandEvent(wxCommandEvent
& event
) const;