1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/richtext/richtextctrl.h
3 // Purpose: A rich edit control
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
20 #define wxRE_READONLY 0x0010
21 #define wxRE_MULTILINE 0x0020
22 #define wxRE_CENTRE_CARET 0x8000
23 #define wxRE_CENTER_CARET wxRE_CENTRE_CARET
29 #define wxRICHTEXT_SHIFT_DOWN 0x01
30 #define wxRICHTEXT_CTRL_DOWN 0x02
31 #define wxRICHTEXT_ALT_DOWN 0x04
37 // Don't draw guide lines around boxes and tables
38 #define wxRICHTEXT_EX_NO_GUIDELINES 0x00000100
45 #define wxRICHTEXT_DEFAULT_OVERALL_SIZE wxSize(-1, -1)
46 #define wxRICHTEXT_DEFAULT_IMAGE_SIZE wxSize(80, 80)
47 #define wxRICHTEXT_DEFAULT_SPACING 3
48 #define wxRICHTEXT_DEFAULT_MARGIN 3
49 #define wxRICHTEXT_DEFAULT_UNFOCUSSED_BACKGROUND wxColour(175, 175, 175)
50 #define wxRICHTEXT_DEFAULT_FOCUSSED_BACKGROUND wxColour(140, 140, 140)
51 #define wxRICHTEXT_DEFAULT_UNSELECTED_BACKGROUND wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE)
52 #define wxRICHTEXT_DEFAULT_TYPE_COLOUR wxColour(0, 0, 200)
53 #define wxRICHTEXT_DEFAULT_FOCUS_RECT_COLOUR wxColour(100, 80, 80)
54 #define wxRICHTEXT_DEFAULT_CARET_WIDTH 2
55 // Minimum buffer size before delayed layout kicks in
56 #define wxRICHTEXT_DEFAULT_DELAYED_LAYOUT_THRESHOLD 20000
57 // Milliseconds before layout occurs after resize
58 #define wxRICHTEXT_DEFAULT_LAYOUT_INTERVAL 50
62 #define wxID_RICHTEXT_PROPERTIES1 (wxID_HIGHEST + 1)
63 #define wxID_RICHTEXT_PROPERTIES2 (wxID_HIGHEST + 2)
64 #define wxID_RICHTEXT_PROPERTIES3 (wxID_HIGHEST + 3)
67 Normal selection occurs initially and as user drags within one container.
68 Common ancestor selection occurs when the user starts dragging across containers
69 that have a common ancestor, for example the cells in a table.
72 enum wxRichTextCtrlSelectionState
74 wxRichTextCtrlSelectionState_Normal
,
75 wxRichTextCtrlSelectionState_CommonAncestor
79 @class wxRichTextContextMenuPropertiesInfo
81 wxRichTextContextMenuPropertiesInfo keeps track of objects that appear in the context menu,
82 whose properties are available to be edited.
85 class WXDLLIMPEXP_RICHTEXT wxRichTextContextMenuPropertiesInfo
91 wxRichTextContextMenuPropertiesInfo() { Init(); }
103 bool AddItem(const wxString
& label
, wxRichTextObject
* obj
);
106 Returns the number of menu items that were added.
108 int AddMenuItems(wxMenu
* menu
, int startCmd
= wxID_RICHTEXT_PROPERTIES1
) const;
111 Adds appropriate menu items for the current container and clicked on object
112 (and container's parent, if appropriate).
114 int AddItems(wxRichTextCtrl
* ctrl
, wxRichTextObject
* container
, wxRichTextObject
* obj
);
119 void Clear() { m_objects
.Clear(); m_labels
.Clear(); }
124 Returns the nth label.
126 wxString
GetLabel(int n
) const { return m_labels
[n
]; }
129 Returns the nth object.
131 wxRichTextObject
* GetObject(int n
) const { return m_objects
[n
]; }
134 Returns the array of objects.
136 wxRichTextObjectPtrArray
& GetObjects() { return m_objects
; }
139 Returns the array of objects.
141 const wxRichTextObjectPtrArray
& GetObjects() const { return m_objects
; }
144 Returns the array of labels.
146 wxArrayString
& GetLabels() { return m_labels
; }
149 Returns the array of labels.
151 const wxArrayString
& GetLabels() const { return m_labels
; }
154 Returns the number of items.
156 int GetCount() const { return m_objects
.GetCount(); }
158 wxRichTextObjectPtrArray m_objects
;
159 wxArrayString m_labels
;
163 @class wxRichTextCtrl
165 wxRichTextCtrl provides a generic, ground-up implementation of a text control
166 capable of showing multiple styles and images.
168 wxRichTextCtrl sends notification events: see wxRichTextEvent.
170 It also sends the standard wxTextCtrl events @c wxEVT_COMMAND_TEXT_ENTER and
171 @c wxEVT_COMMAND_TEXT_UPDATED, and wxTextUrlEvent when URL content is clicked.
173 For more information, see the @ref overview_richtextctrl.
176 @style{wxRE_CENTRE_CARET}
177 The control will try to keep the caret line centred vertically while editing.
178 wxRE_CENTER_CARET is a synonym for this style.
179 @style{wxRE_MULTILINE}
180 The control will be multiline (mandatory).
181 @style{wxRE_READONLY}
182 The control will not be editable.
187 @appearance{richtextctrl.png}
191 class WXDLLIMPEXP_RICHTEXT wxRichTextCtrl
: public wxControl
,
192 public wxTextCtrlIface
,
193 public wxScrollHelper
195 DECLARE_CLASS( wxRichTextCtrl
)
196 DECLARE_EVENT_TABLE()
207 Constructor, creating and showing a rich text control.
210 Parent window. Must not be @NULL.
212 Window identifier. The value @c wxID_ANY indicates a default value.
226 @see Create(), wxValidator
228 wxRichTextCtrl( wxWindow
* parent
, wxWindowID id
= -1, const wxString
& value
= wxEmptyString
, const wxPoint
& pos
= wxDefaultPosition
, const wxSize
& size
= wxDefaultSize
,
229 long style
= wxRE_MULTILINE
, const wxValidator
& validator
= wxDefaultValidator
, const wxString
& name
= wxTextCtrlNameStr
);
234 virtual ~wxRichTextCtrl( );
239 Creates the underlying window.
241 bool Create( wxWindow
* parent
, wxWindowID id
= -1, const wxString
& value
= wxEmptyString
, const wxPoint
& pos
= wxDefaultPosition
, const wxSize
& size
= wxDefaultSize
,
242 long style
= wxRE_MULTILINE
, const wxValidator
& validator
= wxDefaultValidator
, const wxString
& name
= wxTextCtrlNameStr
);
245 Initialises the members of the control.
252 Gets the text for the given range.
253 The end point of range is specified as the last character position of
254 the span of text, plus one.
256 virtual wxString
GetRange(long from
, long to
) const;
259 Returns the length of the specified line in characters.
261 virtual int GetLineLength(long lineNo
) const ;
264 Returns the text for the given line.
266 virtual wxString
GetLineText(long lineNo
) const ;
269 Returns the number of lines in the buffer.
271 virtual int GetNumberOfLines() const ;
274 Returns @true if the buffer has been modified.
276 virtual bool IsModified() const ;
279 Returns @true if the control is editable.
281 virtual bool IsEditable() const ;
284 Returns @true if the control is single-line.
285 Currently wxRichTextCtrl does not support single-line editing.
287 bool IsSingleLine() const { return !HasFlag(wxRE_MULTILINE
); }
290 Returns @true if the control is multiline.
292 bool IsMultiLine() const { return !IsSingleLine(); }
296 Returns the range of the current selection.
297 The end point of range is specified as the last character position of the span
299 If the return values @a from and @a to are the same, there is no selection.
301 virtual void GetSelection(long* from
, long* to
) const;
302 const wxRichTextSelection
& GetSelection() const { return m_selection
; }
303 wxRichTextSelection
& GetSelection() { return m_selection
; }
307 Returns the text within the current selection range, if any.
309 virtual wxString
GetStringSelection() const;
312 Gets the current filename associated with the control.
314 wxString
GetFilename() const { return m_filename
; }
317 Sets the current filename.
319 void SetFilename(const wxString
& filename
) { m_filename
= filename
; }
322 Sets the size of the buffer beyond which layout is delayed during resizing.
323 This optimizes sizing for large buffers. The default is 20000.
325 void SetDelayedLayoutThreshold(long threshold
) { m_delayedLayoutThreshold
= threshold
; }
328 Gets the size of the buffer beyond which layout is delayed during resizing.
329 This optimizes sizing for large buffers. The default is 20000.
331 long GetDelayedLayoutThreshold() const { return m_delayedLayoutThreshold
; }
335 bool GetFullLayoutRequired() const { return m_fullLayoutRequired
; }
339 void SetFullLayoutRequired(bool b
) { m_fullLayoutRequired
= b
; }
343 wxLongLong
GetFullLayoutTime() const { return m_fullLayoutTime
; }
347 void SetFullLayoutTime(wxLongLong t
) { m_fullLayoutTime
= t
; }
351 long GetFullLayoutSavedPosition() const { return m_fullLayoutSavedPosition
; }
355 void SetFullLayoutSavedPosition(long p
) { m_fullLayoutSavedPosition
= p
; }
357 // Force any pending layout due to large buffer
360 void ForceDelayedLayout();
363 Sets the text (normal) cursor.
365 void SetTextCursor(const wxCursor
& cursor
) { m_textCursor
= cursor
; }
368 Returns the text (normal) cursor.
370 wxCursor
GetTextCursor() const { return m_textCursor
; }
373 Sets the cursor to be used over URLs.
375 void SetURLCursor(const wxCursor
& cursor
) { m_urlCursor
= cursor
; }
378 Returns the cursor to be used over URLs.
380 wxCursor
GetURLCursor() const { return m_urlCursor
; }
383 Returns @true if we are showing the caret position at the start of a line
384 instead of at the end of the previous one.
386 bool GetCaretAtLineStart() const { return m_caretAtLineStart
; }
389 Sets a flag to remember that we are showing the caret position at the start of a line
390 instead of at the end of the previous one.
392 void SetCaretAtLineStart(bool atStart
) { m_caretAtLineStart
= atStart
; }
395 Returns @true if we are extending a selection.
397 bool GetDragging() const { return m_dragging
; }
400 Sets a flag to remember if we are extending a selection.
402 void SetDragging(bool dragging
) { m_dragging
= dragging
; }
405 Are we trying to start Drag'n'Drop?
407 bool GetPreDrag() const { return m_preDrag
; }
410 Set if we're trying to start Drag'n'Drop
412 void SetPreDrag(bool pd
) { m_preDrag
= pd
; }
415 Get the possible Drag'n'Drop start point
417 const wxPoint
GetDragStartPoint() const { return m_dragStartPoint
; }
420 Set the possible Drag'n'Drop start point
422 void SetDragStartPoint(wxPoint sp
) { m_dragStartPoint
= sp
; }
425 Get the possible Drag'n'Drop start time
427 const wxDateTime
GetDragStartTime() const { return m_dragStartTime
; }
430 Set the possible Drag'n'Drop start time
432 void SetDragStartTime(wxDateTime st
) { m_dragStartTime
= st
; }
434 #if wxRICHTEXT_BUFFERED_PAINTING
437 Returns the buffer bitmap if using buffered painting.
439 const wxBitmap
& GetBufferBitmap() const { return m_bufferBitmap
; }
440 wxBitmap
& GetBufferBitmap() { return m_bufferBitmap
; }
445 Returns the current context menu.
447 wxMenu
* GetContextMenu() const { return m_contextMenu
; }
450 Sets the current context menu.
452 void SetContextMenu(wxMenu
* menu
);
455 Returns an anchor so we know how to extend the selection.
456 It's a caret position since it's between two characters.
458 long GetSelectionAnchor() const { return m_selectionAnchor
; }
461 Sets an anchor so we know how to extend the selection.
462 It's a caret position since it's between two characters.
464 void SetSelectionAnchor(long anchor
) { m_selectionAnchor
= anchor
; }
467 Returns the anchor object if selecting multiple containers.
469 wxRichTextObject
* GetSelectionAnchorObject() const { return m_selectionAnchorObject
; }
472 Sets the anchor object if selecting multiple containers.
474 void SetSelectionAnchorObject(wxRichTextObject
* anchor
) { m_selectionAnchorObject
= anchor
; }
478 Returns an object that stores information about context menu property item(s),
479 in order to communicate between the context menu event handler and the code
480 that responds to it. The wxRichTextContextMenuPropertiesInfo stores one
481 item for each object that could respond to a property-editing event. If
482 objects are nested, several might be editable.
484 wxRichTextContextMenuPropertiesInfo
& GetContextMenuPropertiesInfo() { return m_contextMenuPropertiesInfo
; }
485 const wxRichTextContextMenuPropertiesInfo
& GetContextMenuPropertiesInfo() const { return m_contextMenuPropertiesInfo
; }
489 Returns the wxRichTextObject object that currently has the editing focus.
490 If there are no composite objects, this will be the top-level buffer.
492 wxRichTextParagraphLayoutBox
* GetFocusObject() const { return m_focusObject
; }
495 Setter for m_focusObject.
497 void StoreFocusObject(wxRichTextParagraphLayoutBox
* obj
);
500 Sets the wxRichTextObject object that currently has the editing focus.
501 @param setCaretPosition
502 Optionally set the caret position.
504 bool SetFocusObject(wxRichTextParagraphLayoutBox
* obj
, bool setCaretPosition
= true);
509 Invalidates the whole buffer to trigger painting later.
511 void Invalidate() { GetBuffer().Invalidate(wxRICHTEXT_ALL
); }
514 Clears the buffer content, leaving a single empty paragraph. Cannot be undone.
516 virtual void Clear();
519 Replaces the content in the specified range with the string specified by
522 virtual void Replace(long from
, long to
, const wxString
& value
);
525 Removes the content in the specified range.
527 virtual void Remove(long from
, long to
);
531 Loads content into the control's buffer using the given type.
533 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
534 the filename extension.
536 This function looks for a suitable wxRichTextFileHandler object.
538 bool LoadFile(const wxString
& file
,
539 int type
= wxRICHTEXT_TYPE_ANY
);
543 Helper function for LoadFile(). Loads content into the control's buffer using the given type.
545 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
546 the filename extension.
548 This function looks for a suitable wxRichTextFileHandler object.
550 virtual bool DoLoadFile(const wxString
& file
, int fileType
);
554 Saves the buffer content using the given type.
556 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
557 the filename extension.
559 This function looks for a suitable wxRichTextFileHandler object.
561 bool SaveFile(const wxString
& file
= wxEmptyString
,
562 int type
= wxRICHTEXT_TYPE_ANY
);
566 Helper function for SaveFile(). Saves the buffer content using the given type.
568 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
569 the filename extension.
571 This function looks for a suitable wxRichTextFileHandler object.
573 virtual bool DoSaveFile(const wxString
& file
= wxEmptyString
,
574 int fileType
= wxRICHTEXT_TYPE_ANY
);
577 Sets flags that change the behaviour of loading or saving.
579 See the documentation for each handler class to see what flags are
580 relevant for each handler.
582 void SetHandlerFlags(int flags
) { GetBuffer().SetHandlerFlags(flags
); }
585 Returns flags that change the behaviour of loading or saving.
586 See the documentation for each handler class to see what flags are
587 relevant for each handler.
589 int GetHandlerFlags() const { return GetBuffer().GetHandlerFlags(); }
592 Marks the buffer as modified.
594 virtual void MarkDirty();
597 Sets the buffer's modified status to @false, and clears the buffer's command
600 virtual void DiscardEdits();
603 Sets the maximum number of characters that may be entered in a single line
604 text control. For compatibility only; currently does nothing.
606 virtual void SetMaxLength(unsigned long WXUNUSED(len
)) { }
609 Writes text at the current position.
611 virtual void WriteText(const wxString
& text
);
614 Sets the insertion point to the end of the buffer and writes the text.
616 virtual void AppendText(const wxString
& text
);
620 Gets the attributes at the given position.
621 This function gets the combined style - that is, the style you see on the
622 screen as a result of combining base style, paragraph style and character
625 To get the character or paragraph style alone, use GetUncombinedStyle().
628 In wxPerl this method is implemented as GetStyle(@a position)
629 returning a 2-element list (ok, attr).
632 virtual bool GetStyle(long position
, wxTextAttr
& style
);
633 virtual bool GetStyle(long position
, wxRichTextAttr
& style
);
634 virtual bool GetStyle(long position
, wxRichTextAttr
& style
, wxRichTextParagraphLayoutBox
* container
);
639 Sets the attributes for the given range.
640 The end point of range is specified as the last character position of the span
643 So, for example, to set the style for a character at position 5, use the range
646 virtual bool SetStyle(long start
, long end
, const wxTextAttr
& style
);
647 virtual bool SetStyle(long start
, long end
, const wxRichTextAttr
& style
);
648 virtual bool SetStyle(const wxRichTextRange
& range
, const wxTextAttr
& style
);
649 virtual bool SetStyle(const wxRichTextRange
& range
, const wxRichTextAttr
& style
);
653 Sets the attributes for a single object
655 virtual void SetStyle(wxRichTextObject
*obj
, const wxRichTextAttr
& textAttr
);
659 Gets the attributes common to the specified range.
660 Attributes that differ in value within the range will not be included
664 In wxPerl this method is implemented as GetStyleForRange(@a position)
665 returning a 2-element list (ok, attr).
668 virtual bool GetStyleForRange(const wxRichTextRange
& range
, wxTextAttr
& style
);
669 virtual bool GetStyleForRange(const wxRichTextRange
& range
, wxRichTextAttr
& style
);
670 virtual bool GetStyleForRange(const wxRichTextRange
& range
, wxRichTextAttr
& style
, wxRichTextParagraphLayoutBox
* container
);
674 Sets the attributes for the given range, passing flags to determine how the
677 The end point of range is specified as the last character position of the span
678 of text, plus one. So, for example, to set the style for a character at
679 position 5, use the range (5,6).
681 @a flags may contain a bit list of the following values:
682 - wxRICHTEXT_SETSTYLE_NONE: no style flag.
683 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this operation should be
685 - wxRICHTEXT_SETSTYLE_OPTIMIZE: specifies that the style should not be applied
686 if the combined style at this point is already the style in question.
687 - wxRICHTEXT_SETSTYLE_PARAGRAPHS_ONLY: specifies that the style should only be
688 applied to paragraphs, and not the content.
689 This allows content styling to be preserved independently from that
690 of e.g. a named paragraph style.
691 - wxRICHTEXT_SETSTYLE_CHARACTERS_ONLY: specifies that the style should only be
692 applied to characters, and not the paragraph.
693 This allows content styling to be preserved independently from that
694 of e.g. a named paragraph style.
695 - wxRICHTEXT_SETSTYLE_RESET: resets (clears) the existing style before applying
697 - wxRICHTEXT_SETSTYLE_REMOVE: removes the specified style. Only the style flags
698 are used in this operation.
700 virtual bool SetStyleEx(const wxRichTextRange
& range
, const wxRichTextAttr
& style
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
);
704 Gets the attributes at the given position.
705 This function gets the @e uncombined style - that is, the attributes associated
706 with the paragraph or character content, and not necessarily the combined
707 attributes you see on the screen.
708 To get the combined attributes, use GetStyle().
710 If you specify (any) paragraph attribute in @e style's flags, this function
711 will fetch the paragraph attributes.
712 Otherwise, it will return the character attributes.
715 In wxPerl this method is implemented as GetUncombinedStyle(@a position)
716 returning a 2-element list (ok, attr).
719 virtual bool GetUncombinedStyle(long position
, wxRichTextAttr
& style
);
720 virtual bool GetUncombinedStyle(long position
, wxRichTextAttr
& style
, wxRichTextParagraphLayoutBox
* container
);
725 Sets the current default style, which can be used to change how subsequently
726 inserted text is displayed.
728 virtual bool SetDefaultStyle(const wxTextAttr
& style
);
729 virtual bool SetDefaultStyle(const wxRichTextAttr
& style
);
733 Returns the current default style, which can be used to change how subsequently
734 inserted text is displayed.
736 virtual const wxRichTextAttr
& GetDefaultStyleEx() const;
738 //virtual const wxTextAttr& GetDefaultStyle() const;
742 Sets the list attributes for the given range, passing flags to determine how
743 the attributes are set.
745 Either the style definition or the name of the style definition (in the current
746 sheet) can be passed.
747 @a flags is a bit list of the following:
748 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
749 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
750 @a startFrom, otherwise existing attributes are used.
751 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
752 as the level for all paragraphs, otherwise the current indentation will be used.
754 @see NumberList(), PromoteList(), ClearListStyle().
756 virtual bool SetListStyle(const wxRichTextRange
& range
, wxRichTextListStyleDefinition
* def
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int startFrom
= 1, int specifiedLevel
= -1);
757 virtual bool SetListStyle(const wxRichTextRange
& range
, const wxString
& defName
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int startFrom
= 1, int specifiedLevel
= -1);
761 Clears the list style from the given range, clearing list-related attributes
762 and applying any named paragraph style associated with each paragraph.
764 @a flags is a bit list of the following:
765 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
767 @see SetListStyle(), PromoteList(), NumberList().
769 virtual bool ClearListStyle(const wxRichTextRange
& range
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
);
773 Numbers the paragraphs in the given range.
774 Pass flags to determine how the attributes are set.
776 Either the style definition or the name of the style definition (in the current
777 sheet) can be passed.
779 @a flags is a bit list of the following:
780 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
781 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
782 @a startFrom, otherwise existing attributes are used.
783 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
784 as the level for all paragraphs, otherwise the current indentation will be used.
786 @see SetListStyle(), PromoteList(), ClearListStyle().
788 virtual bool NumberList(const wxRichTextRange
& range
, wxRichTextListStyleDefinition
* def
= NULL
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int startFrom
= 1, int specifiedLevel
= -1);
789 virtual bool NumberList(const wxRichTextRange
& range
, const wxString
& defName
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int startFrom
= 1, int specifiedLevel
= -1);
794 Promotes or demotes the paragraphs in the given range.
795 A positive @a promoteBy produces a smaller indent, and a negative number
796 produces a larger indent. Pass flags to determine how the attributes are set.
797 Either the style definition or the name of the style definition (in the current
798 sheet) can be passed.
800 @a flags is a bit list of the following:
801 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
802 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
803 @a startFrom, otherwise existing attributes are used.
804 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
805 as the level for all paragraphs, otherwise the current indentation will be used.
807 @see SetListStyle(), @see SetListStyle(), ClearListStyle().
809 virtual bool PromoteList(int promoteBy
, const wxRichTextRange
& range
, wxRichTextListStyleDefinition
* def
= NULL
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int specifiedLevel
= -1);
810 virtual bool PromoteList(int promoteBy
, const wxRichTextRange
& range
, const wxString
& defName
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int specifiedLevel
= -1);
814 Sets the properties for the given range, passing flags to determine how the
815 attributes are set. You can merge properties or replace them.
817 The end point of range is specified as the last character position of the span
818 of text, plus one. So, for example, to set the properties for a character at
819 position 5, use the range (5,6).
821 @a flags may contain a bit list of the following values:
822 - wxRICHTEXT_SETSPROPERTIES_NONE: no flag.
823 - wxRICHTEXT_SETPROPERTIES_WITH_UNDO: specifies that this operation should be
825 - wxRICHTEXT_SETPROPERTIES_PARAGRAPHS_ONLY: specifies that the properties should only be
826 applied to paragraphs, and not the content.
827 - wxRICHTEXT_SETPROPERTIES_CHARACTERS_ONLY: specifies that the properties should only be
828 applied to characters, and not the paragraph.
829 - wxRICHTEXT_SETPROPERTIES_RESET: resets (clears) the existing properties before applying
831 - wxRICHTEXT_SETPROPERTIES_REMOVE: removes the specified properties.
833 virtual bool SetProperties(const wxRichTextRange
& range
, const wxRichTextProperties
& properties
, int flags
= wxRICHTEXT_SETPROPERTIES_WITH_UNDO
);
836 Deletes the content within the given range.
838 virtual bool Delete(const wxRichTextRange
& range
);
841 Translates from column and line number to position.
843 virtual long XYToPosition(long x
, long y
) const;
846 Converts a text position to zero-based column and line numbers.
848 virtual bool PositionToXY(long pos
, long *x
, long *y
) const;
851 Scrolls the buffer so that the given position is in view.
853 virtual void ShowPosition(long pos
);
857 Finds the character at the given position in pixels.
858 @a pt is in device coords (not adjusted for the client area origin nor for
861 virtual wxTextCtrlHitTestResult
HitTest(const wxPoint
& pt
, long *pos
) const;
862 virtual wxTextCtrlHitTestResult
HitTest(const wxPoint
& pt
,
864 wxTextCoord
*row
) const;
867 Finds the container at the given point, which is assumed to be in client coordinates.
869 wxRichTextParagraphLayoutBox
* FindContainerAtPoint(const wxPoint pt
, long& position
, int& hit
, wxRichTextObject
* hitObj
, int flags
= 0);
872 // Clipboard operations
875 Copies the selected content (if any) to the clipboard.
880 Copies the selected content (if any) to the clipboard and deletes the selection.
886 Pastes content from the clipboard to the buffer.
888 virtual void Paste();
891 Deletes the content in the selection, if any. This is undoable.
893 virtual void DeleteSelection();
896 Returns @true if selected content can be copied to the clipboard.
898 virtual bool CanCopy() const;
901 Returns @true if selected content can be copied to the clipboard and deleted.
903 virtual bool CanCut() const;
906 Returns @true if the clipboard content can be pasted to the buffer.
908 virtual bool CanPaste() const;
911 Returns @true if selected content can be deleted.
913 virtual bool CanDeleteSelection() const;
916 Undoes the command at the top of the command history, if there is one.
921 Redoes the current command.
926 Returns @true if there is a command in the command history that can be undone.
928 virtual bool CanUndo() const;
931 Returns @true if there is a command in the command history that can be redone.
933 virtual bool CanRedo() const;
936 Sets the insertion point and causes the current editing style to be taken from
937 the new position (unlike wxRichTextCtrl::SetCaretPosition).
939 virtual void SetInsertionPoint(long pos
);
942 Sets the insertion point to the end of the text control.
944 virtual void SetInsertionPointEnd();
947 Returns the current insertion point.
949 virtual long GetInsertionPoint() const;
952 Returns the last position in the buffer.
954 virtual wxTextPos
GetLastPosition() const;
958 Sets the selection to the given range.
959 The end point of range is specified as the last character position of the span
962 So, for example, to set the selection for a character at position 5, use the
965 virtual void SetSelection(long from
, long to
);
966 void SetSelection(const wxRichTextSelection
& sel
) { m_selection
= sel
; }
971 Selects all the text in the buffer.
973 virtual void SelectAll();
976 Makes the control editable, or not.
978 virtual void SetEditable(bool editable
);
981 Returns @true if there is a selection and the object containing the selection
982 was the same as the current focus object.
984 virtual bool HasSelection() const;
987 Returns @true if there was a selection, whether or not the current focus object
988 is the same as the selection's container object.
990 virtual bool HasUnfocusedSelection() const;
994 Write a bitmap or image at the current insertion point.
995 Supply an optional type to use for internal and file storage of the raw data.
997 virtual bool WriteImage(const wxImage
& image
, wxBitmapType bitmapType
= wxBITMAP_TYPE_PNG
,
998 const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1000 virtual bool WriteImage(const wxBitmap
& bitmap
, wxBitmapType bitmapType
= wxBITMAP_TYPE_PNG
,
1001 const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1005 Loads an image from a file and writes it at the current insertion point.
1007 virtual bool WriteImage(const wxString
& filename
, wxBitmapType bitmapType
,
1008 const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1011 Writes an image block at the current insertion point.
1013 virtual bool WriteImage(const wxRichTextImageBlock
& imageBlock
,
1014 const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1017 Write a text box at the current insertion point, returning the text box.
1018 You can then call SetFocusObject() to set the focus to the new object.
1020 virtual wxRichTextBox
* WriteTextBox(const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1023 Write a table at the current insertion point, returning the table.
1024 You can then call SetFocusObject() to set the focus to the new object.
1026 virtual wxRichTextTable
* WriteTable(int rows
, int cols
, const wxRichTextAttr
& tableAttr
= wxRichTextAttr(), const wxRichTextAttr
& cellAttr
= wxRichTextAttr());
1029 Inserts a new paragraph at the current insertion point. @see LineBreak().
1031 virtual bool Newline();
1034 Inserts a line break at the current insertion point.
1036 A line break forces wrapping within a paragraph, and can be introduced by
1037 using this function, by appending the wxChar value @b wxRichTextLineBreakChar
1038 to text content, or by typing Shift-Return.
1040 virtual bool LineBreak();
1043 Sets the basic (overall) style.
1045 This is the style of the whole buffer before further styles are applied,
1046 unlike the default style, which only affects the style currently being
1047 applied (for example, setting the default style to bold will cause
1048 subsequently inserted text to be bold).
1050 virtual void SetBasicStyle(const wxRichTextAttr
& style
) { GetBuffer().SetBasicStyle(style
); }
1053 Gets the basic (overall) style.
1055 This is the style of the whole buffer before further styles are applied,
1056 unlike the default style, which only affects the style currently being
1057 applied (for example, setting the default style to bold will cause
1058 subsequently inserted text to be bold).
1060 virtual const wxRichTextAttr
& GetBasicStyle() const { return GetBuffer().GetBasicStyle(); }
1063 Begins applying a style.
1065 virtual bool BeginStyle(const wxRichTextAttr
& style
) { return GetBuffer().BeginStyle(style
); }
1068 Ends the current style.
1070 virtual bool EndStyle() { return GetBuffer().EndStyle(); }
1073 Ends application of all styles in the current style stack.
1075 virtual bool EndAllStyles() { return GetBuffer().EndAllStyles(); }
1080 bool BeginBold() { return GetBuffer().BeginBold(); }
1085 bool EndBold() { return GetBuffer().EndBold(); }
1088 Begins using italic.
1090 bool BeginItalic() { return GetBuffer().BeginItalic(); }
1095 bool EndItalic() { return GetBuffer().EndItalic(); }
1098 Begins using underlining.
1100 bool BeginUnderline() { return GetBuffer().BeginUnderline(); }
1103 End applying underlining.
1105 bool EndUnderline() { return GetBuffer().EndUnderline(); }
1108 Begins using the given point size.
1110 bool BeginFontSize(int pointSize
) { return GetBuffer().BeginFontSize(pointSize
); }
1113 Ends using a point size.
1115 bool EndFontSize() { return GetBuffer().EndFontSize(); }
1118 Begins using this font.
1120 bool BeginFont(const wxFont
& font
) { return GetBuffer().BeginFont(font
); }
1125 bool EndFont() { return GetBuffer().EndFont(); }
1128 Begins using this colour.
1130 bool BeginTextColour(const wxColour
& colour
) { return GetBuffer().BeginTextColour(colour
); }
1133 Ends applying a text colour.
1135 bool EndTextColour() { return GetBuffer().EndTextColour(); }
1138 Begins using alignment.
1139 For alignment values, see wxTextAttr.
1141 bool BeginAlignment(wxTextAttrAlignment alignment
) { return GetBuffer().BeginAlignment(alignment
); }
1146 bool EndAlignment() { return GetBuffer().EndAlignment(); }
1149 Begins applying a left indent and subindent in tenths of a millimetre.
1150 The subindent is an offset from the left edge of the paragraph, and is
1151 used for all but the first line in a paragraph. A positive value will
1152 cause the first line to appear to the left of the subsequent lines, and
1153 a negative value will cause the first line to be indented to the right
1154 of the subsequent lines.
1156 wxRichTextBuffer uses indentation to render a bulleted item. The
1157 content of the paragraph, including the first line, starts at the
1158 @a leftIndent plus the @a leftSubIndent.
1161 The distance between the margin and the bullet.
1162 @param leftSubIndent
1163 The distance between the left edge of the bullet and the left edge
1164 of the actual paragraph.
1166 bool BeginLeftIndent(int leftIndent
, int leftSubIndent
= 0) { return GetBuffer().BeginLeftIndent(leftIndent
, leftSubIndent
); }
1171 bool EndLeftIndent() { return GetBuffer().EndLeftIndent(); }
1174 Begins a right indent, specified in tenths of a millimetre.
1176 bool BeginRightIndent(int rightIndent
) { return GetBuffer().BeginRightIndent(rightIndent
); }
1181 bool EndRightIndent() { return GetBuffer().EndRightIndent(); }
1184 Begins paragraph spacing; pass the before-paragraph and after-paragraph spacing
1185 in tenths of a millimetre.
1187 bool BeginParagraphSpacing(int before
, int after
) { return GetBuffer().BeginParagraphSpacing(before
, after
); }
1190 Ends paragraph spacing.
1192 bool EndParagraphSpacing() { return GetBuffer().EndParagraphSpacing(); }
1195 Begins appling line spacing. @e spacing is a multiple, where 10 means
1196 single-spacing, 15 means 1.5 spacing, and 20 means double spacing.
1198 The ::wxTextAttrLineSpacing constants are defined for convenience.
1200 bool BeginLineSpacing(int lineSpacing
) { return GetBuffer().BeginLineSpacing(lineSpacing
); }
1205 bool EndLineSpacing() { return GetBuffer().EndLineSpacing(); }
1208 Begins a numbered bullet.
1210 This call will be needed for each item in the list, and the
1211 application should take care of incrementing the numbering.
1213 @a bulletNumber is a number, usually starting with 1.
1214 @a leftIndent and @a leftSubIndent are values in tenths of a millimetre.
1215 @a bulletStyle is a bitlist of the ::wxTextAttrBulletStyle values.
1217 wxRichTextBuffer uses indentation to render a bulleted item.
1218 The left indent is the distance between the margin and the bullet.
1219 The content of the paragraph, including the first line, starts
1220 at leftMargin + leftSubIndent.
1221 So the distance between the left edge of the bullet and the
1222 left of the actual paragraph is leftSubIndent.
1224 bool BeginNumberedBullet(int bulletNumber
, int leftIndent
, int leftSubIndent
, int bulletStyle
= wxTEXT_ATTR_BULLET_STYLE_ARABIC
|wxTEXT_ATTR_BULLET_STYLE_PERIOD
)
1225 { return GetBuffer().BeginNumberedBullet(bulletNumber
, leftIndent
, leftSubIndent
, bulletStyle
); }
1228 Ends application of a numbered bullet.
1230 bool EndNumberedBullet() { return GetBuffer().EndNumberedBullet(); }
1233 Begins applying a symbol bullet, using a character from the current font.
1234 See BeginNumberedBullet() for an explanation of how indentation is used
1235 to render the bulleted paragraph.
1237 bool BeginSymbolBullet(const wxString
& symbol
, int leftIndent
, int leftSubIndent
, int bulletStyle
= wxTEXT_ATTR_BULLET_STYLE_SYMBOL
)
1238 { return GetBuffer().BeginSymbolBullet(symbol
, leftIndent
, leftSubIndent
, bulletStyle
); }
1241 Ends applying a symbol bullet.
1243 bool EndSymbolBullet() { return GetBuffer().EndSymbolBullet(); }
1246 Begins applying a symbol bullet.
1248 bool BeginStandardBullet(const wxString
& bulletName
, int leftIndent
, int leftSubIndent
, int bulletStyle
= wxTEXT_ATTR_BULLET_STYLE_STANDARD
)
1249 { return GetBuffer().BeginStandardBullet(bulletName
, leftIndent
, leftSubIndent
, bulletStyle
); }
1252 Begins applying a standard bullet.
1254 bool EndStandardBullet() { return GetBuffer().EndStandardBullet(); }
1257 Begins using the named character style.
1259 bool BeginCharacterStyle(const wxString
& characterStyle
) { return GetBuffer().BeginCharacterStyle(characterStyle
); }
1262 Ends application of a named character style.
1264 bool EndCharacterStyle() { return GetBuffer().EndCharacterStyle(); }
1267 Begins applying the named paragraph style.
1269 bool BeginParagraphStyle(const wxString
& paragraphStyle
) { return GetBuffer().BeginParagraphStyle(paragraphStyle
); }
1272 Ends application of a named paragraph style.
1274 bool EndParagraphStyle() { return GetBuffer().EndParagraphStyle(); }
1277 Begins using a specified list style.
1278 Optionally, you can also pass a level and a number.
1280 bool BeginListStyle(const wxString
& listStyle
, int level
= 1, int number
= 1) { return GetBuffer().BeginListStyle(listStyle
, level
, number
); }
1283 Ends using a specified list style.
1285 bool EndListStyle() { return GetBuffer().EndListStyle(); }
1288 Begins applying wxTEXT_ATTR_URL to the content.
1290 Pass a URL and optionally, a character style to apply, since it is common
1291 to mark a URL with a familiar style such as blue text with underlining.
1293 bool BeginURL(const wxString
& url
, const wxString
& characterStyle
= wxEmptyString
) { return GetBuffer().BeginURL(url
, characterStyle
); }
1296 Ends applying a URL.
1298 bool EndURL() { return GetBuffer().EndURL(); }
1301 Sets the default style to the style under the cursor.
1303 bool SetDefaultStyleToCursorStyle();
1306 Cancels any selection.
1308 virtual void SelectNone();
1311 Selects the word at the given character position.
1313 virtual bool SelectWord(long position
);
1316 Returns the selection range in character positions. -1, -1 means no selection.
1318 The range is in API convention, i.e. a single character selection is denoted
1321 wxRichTextRange
GetSelectionRange() const;
1324 Sets the selection to the given range.
1325 The end point of range is specified as the last character position of the span
1328 So, for example, to set the selection for a character at position 5, use the
1331 void SetSelectionRange(const wxRichTextRange
& range
);
1334 Returns the selection range in character positions. -2, -2 means no selection
1335 -1, -1 means select everything.
1336 The range is in internal format, i.e. a single character selection is denoted
1339 wxRichTextRange
GetInternalSelectionRange() const { return m_selection
.GetRange(); }
1342 Sets the selection range in character positions. -2, -2 means no selection
1343 -1, -1 means select everything.
1344 The range is in internal format, i.e. a single character selection is denoted
1347 void SetInternalSelectionRange(const wxRichTextRange
& range
) { m_selection
.Set(range
, GetFocusObject()); }
1350 Adds a new paragraph of text to the end of the buffer.
1352 virtual wxRichTextRange
AddParagraph(const wxString
& text
);
1355 Adds an image to the control's buffer.
1357 virtual wxRichTextRange
AddImage(const wxImage
& image
);
1360 Lays out the buffer, which must be done before certain operations, such as
1361 setting the caret position.
1362 This function should not normally be required by the application.
1364 virtual bool LayoutContent(bool onlyVisibleRect
= false);
1367 Move the caret to the given character position.
1369 Please note that this does not update the current editing style
1370 from the new position; to do that, call wxRichTextCtrl::SetInsertionPoint instead.
1372 virtual bool MoveCaret(long pos
, bool showAtLineStart
= false, wxRichTextParagraphLayoutBox
* container
= NULL
);
1377 virtual bool MoveRight(int noPositions
= 1, int flags
= 0);
1382 virtual bool MoveLeft(int noPositions
= 1, int flags
= 0);
1385 Moves to the start of the paragraph.
1387 virtual bool MoveUp(int noLines
= 1, int flags
= 0);
1390 Moves the caret down.
1392 virtual bool MoveDown(int noLines
= 1, int flags
= 0);
1395 Moves to the end of the line.
1397 virtual bool MoveToLineEnd(int flags
= 0);
1400 Moves to the start of the line.
1402 virtual bool MoveToLineStart(int flags
= 0);
1405 Moves to the end of the paragraph.
1407 virtual bool MoveToParagraphEnd(int flags
= 0);
1410 Moves to the start of the paragraph.
1412 virtual bool MoveToParagraphStart(int flags
= 0);
1415 Moves to the start of the buffer.
1417 virtual bool MoveHome(int flags
= 0);
1420 Moves to the end of the buffer.
1422 virtual bool MoveEnd(int flags
= 0);
1425 Moves one or more pages up.
1427 virtual bool PageUp(int noPages
= 1, int flags
= 0);
1430 Moves one or more pages down.
1432 virtual bool PageDown(int noPages
= 1, int flags
= 0);
1435 Moves a number of words to the left.
1437 virtual bool WordLeft(int noPages
= 1, int flags
= 0);
1440 Move a nuber of words to the right.
1442 virtual bool WordRight(int noPages
= 1, int flags
= 0);
1446 Returns the buffer associated with the control.
1448 wxRichTextBuffer
& GetBuffer() { return m_buffer
; }
1449 const wxRichTextBuffer
& GetBuffer() const { return m_buffer
; }
1453 Starts batching undo history for commands.
1455 virtual bool BeginBatchUndo(const wxString
& cmdName
) { return m_buffer
.BeginBatchUndo(cmdName
); }
1458 Ends batching undo command history.
1460 virtual bool EndBatchUndo() { return m_buffer
.EndBatchUndo(); }
1463 Returns @true if undo commands are being batched.
1465 virtual bool BatchingUndo() const { return m_buffer
.BatchingUndo(); }
1468 Starts suppressing undo history for commands.
1470 virtual bool BeginSuppressUndo() { return m_buffer
.BeginSuppressUndo(); }
1473 Ends suppressing undo command history.
1475 virtual bool EndSuppressUndo() { return m_buffer
.EndSuppressUndo(); }
1478 Returns @true if undo history suppression is on.
1480 virtual bool SuppressingUndo() const { return m_buffer
.SuppressingUndo(); }
1483 Test if this whole range has character attributes of the specified kind.
1484 If any of the attributes are different within the range, the test fails.
1486 You can use this to implement, for example, bold button updating.
1487 @a style must have flags indicating which attributes are of interest.
1489 virtual bool HasCharacterAttributes(const wxRichTextRange
& range
, const wxRichTextAttr
& style
) const
1491 return GetBuffer().HasCharacterAttributes(range
.ToInternal(), style
);
1495 Test if this whole range has paragraph attributes of the specified kind.
1496 If any of the attributes are different within the range, the test fails.
1497 You can use this to implement, for example, centering button updating.
1498 @a style must have flags indicating which attributes are of interest.
1500 virtual bool HasParagraphAttributes(const wxRichTextRange
& range
, const wxRichTextAttr
& style
) const
1502 return GetBuffer().HasParagraphAttributes(range
.ToInternal(), style
);
1506 Returns @true if all of the selection, or the content at the caret position, is bold.
1508 virtual bool IsSelectionBold();
1511 Returns @true if all of the selection, or the content at the caret position, is italic.
1513 virtual bool IsSelectionItalics();
1516 Returns @true if all of the selection, or the content at the caret position, is underlined.
1518 virtual bool IsSelectionUnderlined();
1521 Returns @true if all of the selection, or the content at the current caret position, has the supplied wxTextAttrEffects flag(s).
1523 virtual bool DoesSelectionHaveTextEffectFlag(int flag
);
1526 Returns @true if all of the selection is aligned according to the specified flag.
1528 virtual bool IsSelectionAligned(wxTextAttrAlignment alignment
);
1531 Apples bold to the selection or the default style (undoable).
1533 virtual bool ApplyBoldToSelection();
1536 Applies italic to the selection or the default style (undoable).
1538 virtual bool ApplyItalicToSelection();
1541 Applies underline to the selection or the default style (undoable).
1543 virtual bool ApplyUnderlineToSelection();
1546 Applies one or more wxTextAttrEffects flags to the selection (undoable).
1547 If there is no selection, it is applied to the default style.
1549 virtual bool ApplyTextEffectToSelection(int flags
);
1552 Applies the given alignment to the selection or the default style (undoable).
1553 For alignment values, see wxTextAttr.
1555 virtual bool ApplyAlignmentToSelection(wxTextAttrAlignment alignment
);
1558 Applies the style sheet to the buffer, matching paragraph styles in the sheet
1559 against named styles in the buffer.
1561 This might be useful if the styles have changed.
1562 If @a sheet is @NULL, the sheet set with SetStyleSheet() is used.
1563 Currently this applies paragraph styles only.
1565 virtual bool ApplyStyle(wxRichTextStyleDefinition
* def
);
1568 Sets the style sheet associated with the control.
1569 A style sheet allows named character and paragraph styles to be applied.
1571 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
) { GetBuffer().SetStyleSheet(styleSheet
); }
1574 Returns the style sheet associated with the control, if any.
1575 A style sheet allows named character and paragraph styles to be applied.
1577 wxRichTextStyleSheet
* GetStyleSheet() const { return GetBuffer().GetStyleSheet(); }
1580 Push the style sheet to top of stack.
1582 bool PushStyleSheet(wxRichTextStyleSheet
* styleSheet
) { return GetBuffer().PushStyleSheet(styleSheet
); }
1585 Pops the style sheet from top of stack.
1587 wxRichTextStyleSheet
* PopStyleSheet() { return GetBuffer().PopStyleSheet(); }
1590 Applies the style sheet to the buffer, for example if the styles have changed.
1592 bool ApplyStyleSheet(wxRichTextStyleSheet
* styleSheet
= NULL
);
1595 Shows the given context menu, optionally adding appropriate property-editing commands for the current position in the object hierarchy.
1597 virtual bool ShowContextMenu(wxMenu
* menu
, const wxPoint
& pt
, bool addPropertyCommands
);
1600 Prepares the context menu, optionally adding appropriate property-editing commands.
1601 Returns the number of property commands added.
1603 virtual int PrepareContextMenu(wxMenu
* menu
, const wxPoint
& pt
, bool addPropertyCommands
);
1606 Returns @true if we can edit the object's properties via a GUI.
1608 virtual bool CanEditProperties(wxRichTextObject
* obj
) const;
1611 Edits the object's properties via a GUI.
1613 virtual bool EditProperties(wxRichTextObject
* obj
, wxWindow
* parent
);
1616 Gets the object's properties menu label.
1618 virtual wxString
GetPropertiesMenuLabel(wxRichTextObject
* obj
);
1621 Prepares the content just before insertion (or after buffer reset). Called by the same function in wxRichTextBuffer.
1622 Currently is only called if undo mode is on.
1624 virtual void PrepareContent(wxRichTextParagraphLayoutBox
& WXUNUSED(container
)) {}
1627 Can we delete this range?
1628 Sends an event to the control.
1630 virtual bool CanDeleteRange(wxRichTextParagraphLayoutBox
& container
, const wxRichTextRange
& range
) const;
1633 Can we insert content at this position?
1634 Sends an event to the control.
1636 virtual bool CanInsertContent(wxRichTextParagraphLayoutBox
& container
, long pos
) const;
1641 Sends the event to the control.
1643 void Command(wxCommandEvent
& event
);
1646 Loads the first dropped file.
1648 void OnDropFiles(wxDropFilesEvent
& event
);
1650 void OnCaptureLost(wxMouseCaptureLostEvent
& event
);
1651 void OnSysColourChanged(wxSysColourChangedEvent
& event
);
1654 Standard handler for the wxID_CUT command.
1656 void OnCut(wxCommandEvent
& event
);
1659 Standard handler for the wxID_COPY command.
1661 void OnCopy(wxCommandEvent
& event
);
1664 Standard handler for the wxID_PASTE command.
1666 void OnPaste(wxCommandEvent
& event
);
1669 Standard handler for the wxID_UNDO command.
1671 void OnUndo(wxCommandEvent
& event
);
1674 Standard handler for the wxID_REDO command.
1676 void OnRedo(wxCommandEvent
& event
);
1679 Standard handler for the wxID_SELECTALL command.
1681 void OnSelectAll(wxCommandEvent
& event
);
1684 Standard handler for property commands.
1686 void OnProperties(wxCommandEvent
& event
);
1689 Standard handler for the wxID_CLEAR command.
1691 void OnClear(wxCommandEvent
& event
);
1694 Standard update handler for the wxID_CUT command.
1696 void OnUpdateCut(wxUpdateUIEvent
& event
);
1699 Standard update handler for the wxID_COPY command.
1701 void OnUpdateCopy(wxUpdateUIEvent
& event
);
1704 Standard update handler for the wxID_PASTE command.
1706 void OnUpdatePaste(wxUpdateUIEvent
& event
);
1709 Standard update handler for the wxID_UNDO command.
1711 void OnUpdateUndo(wxUpdateUIEvent
& event
);
1714 Standard update handler for the wxID_REDO command.
1716 void OnUpdateRedo(wxUpdateUIEvent
& event
);
1719 Standard update handler for the wxID_SELECTALL command.
1721 void OnUpdateSelectAll(wxUpdateUIEvent
& event
);
1724 Standard update handler for property commands.
1727 void OnUpdateProperties(wxUpdateUIEvent
& event
);
1730 Standard update handler for the wxID_CLEAR command.
1732 void OnUpdateClear(wxUpdateUIEvent
& event
);
1735 Shows a standard context menu with undo, redo, cut, copy, paste, clear, and
1736 select all commands.
1738 void OnContextMenu(wxContextMenuEvent
& event
);
1743 void OnPaint(wxPaintEvent
& event
);
1744 void OnEraseBackground(wxEraseEvent
& event
);
1747 void OnLeftClick(wxMouseEvent
& event
);
1750 void OnLeftUp(wxMouseEvent
& event
);
1753 void OnMoveMouse(wxMouseEvent
& event
);
1755 // Left-double-click
1756 void OnLeftDClick(wxMouseEvent
& event
);
1759 void OnMiddleClick(wxMouseEvent
& event
);
1762 void OnRightClick(wxMouseEvent
& event
);
1765 void OnChar(wxKeyEvent
& event
);
1768 void OnSize(wxSizeEvent
& event
);
1770 // Setting/losing focus
1771 void OnSetFocus(wxFocusEvent
& event
);
1772 void OnKillFocus(wxFocusEvent
& event
);
1774 // Idle-time processing
1775 void OnIdle(wxIdleEvent
& event
);
1778 void OnScroll(wxScrollWinEvent
& event
);
1781 Sets the font, and also the basic and default attributes
1782 (see wxRichTextCtrl::SetDefaultStyle).
1784 virtual bool SetFont(const wxFont
& font
);
1787 A helper function setting up scrollbars, for example after a resize.
1789 virtual void SetupScrollbars(bool atTop
= false);
1792 Helper function implementing keyboard navigation.
1794 virtual bool KeyboardNavigate(int keyCode
, int flags
);
1797 Paints the background.
1799 virtual void PaintBackground(wxDC
& dc
);
1802 Other user defined painting after everything else (i.e. all text) is painted.
1806 virtual void PaintAboveContent(wxDC
& WXUNUSED(dc
)) {}
1808 #if wxRICHTEXT_BUFFERED_PAINTING
1810 Recreates the buffer bitmap if necessary.
1812 virtual bool RecreateBuffer(const wxSize
& size
= wxDefaultSize
);
1816 virtual void DoWriteText(const wxString
& value
, int flags
= 0);
1818 // Should we inherit colours?
1819 virtual bool ShouldInheritColours() const { return false; }
1822 Internal function to position the visible caret according to the current caret
1825 virtual void PositionCaret(wxRichTextParagraphLayoutBox
* container
= NULL
);
1828 Helper function for extending the selection, returning @true if the selection
1829 was changed. Selections are in caret positions.
1831 virtual bool ExtendSelection(long oldPosition
, long newPosition
, int flags
);
1834 Scrolls @a position into view. This function takes a caret position.
1836 virtual bool ScrollIntoView(long position
, int keyCode
);
1839 Refreshes the area affected by a selection change.
1841 bool RefreshForSelectionChange(const wxRichTextSelection
& oldSelection
, const wxRichTextSelection
& newSelection
);
1844 Sets the caret position.
1846 The caret position is the character position just before the caret.
1847 A value of -1 means the caret is at the start of the buffer.
1848 Please note that this does not update the current editing style
1849 from the new position or cause the actual caret to be refreshed; to do that,
1850 call wxRichTextCtrl::SetInsertionPoint instead.
1852 void SetCaretPosition(long position
, bool showAtLineStart
= false) ;
1855 Returns the current caret position.
1857 long GetCaretPosition() const { return m_caretPosition
; }
1860 The adjusted caret position is the character position adjusted to take
1861 into account whether we're at the start of a paragraph, in which case
1862 style information should be taken from the next position, not current one.
1864 long GetAdjustedCaretPosition(long caretPos
) const;
1867 Move the caret one visual step forward: this may mean setting a flag
1868 and keeping the same position if we're going from the end of one line
1869 to the start of the next, which may be the exact same caret position.
1871 void MoveCaretForward(long oldPosition
) ;
1874 Move the caret one visual step forward: this may mean setting a flag
1875 and keeping the same position if we're going from the end of one line
1876 to the start of the next, which may be the exact same caret position.
1878 void MoveCaretBack(long oldPosition
) ;
1881 Returns the caret height and position for the given character position.
1882 If container is null, the current focus object will be used.
1885 In wxPerl this method is implemented as
1886 GetCaretPositionForIndex(@a position) returning a
1887 2-element list (ok, rect).
1890 bool GetCaretPositionForIndex(long position
, wxRect
& rect
, wxRichTextParagraphLayoutBox
* container
= NULL
);
1893 Internal helper function returning the line for the visible caret position.
1894 If the caret is shown at the very end of the line, it means the next character
1895 is actually on the following line.
1896 So this function gets the line we're expecting to find if this is the case.
1898 wxRichTextLine
* GetVisibleLineForCaretPosition(long caretPosition
) const;
1901 Gets the command processor associated with the control's buffer.
1903 wxCommandProcessor
* GetCommandProcessor() const { return GetBuffer().GetCommandProcessor(); }
1906 Deletes content if there is a selection, e.g. when pressing a key.
1907 Returns the new caret position in @e newPos, or leaves it if there
1908 was no action. This is undoable.
1911 In wxPerl this method takes no arguments and returns a 2-element
1915 bool DeleteSelectedContent(long* newPos
= NULL
);
1918 Transforms logical (unscrolled) position to physical window position.
1920 wxPoint
GetPhysicalPoint(const wxPoint
& ptLogical
) const;
1923 Transforms physical window position to logical (unscrolled) position.
1925 wxPoint
GetLogicalPoint(const wxPoint
& ptPhysical
) const;
1928 Helper function for finding the caret position for the next word.
1929 Direction is 1 (forward) or -1 (backwards).
1931 virtual long FindNextWordPosition(int direction
= 1) const;
1934 Returns @true if the given position is visible on the screen.
1936 bool IsPositionVisible(long pos
) const;
1939 Returns the first visible position in the current view.
1941 long GetFirstVisiblePosition() const;
1944 Returns the caret position since the default formatting was changed. As
1945 soon as this position changes, we no longer reflect the default style
1946 in the UI. A value of -2 means that we should only reflect the style of the
1947 content under the caret.
1949 long GetCaretPositionForDefaultStyle() const { return m_caretPositionForDefaultStyle
; }
1952 Set the caret position for the default style that the user is selecting.
1954 void SetCaretPositionForDefaultStyle(long pos
) { m_caretPositionForDefaultStyle
= pos
; }
1957 Returns @true if the user has recently set the default style without moving
1958 the caret, and therefore the UI needs to reflect the default style and not
1959 the style at the caret.
1961 Below is an example of code that uses this function to determine whether the UI
1962 should show that the current style is bold.
1964 @see SetAndShowDefaultStyle().
1966 bool IsDefaultStyleShowing() const { return m_caretPositionForDefaultStyle
!= -2; }
1969 Sets @a attr as the default style and tells the control that the UI should
1970 reflect this attribute until the user moves the caret.
1972 @see IsDefaultStyleShowing().
1974 void SetAndShowDefaultStyle(const wxRichTextAttr
& attr
)
1976 SetDefaultStyle(attr
);
1977 SetCaretPositionForDefaultStyle(GetCaretPosition());
1981 Returns the first visible point in the window.
1983 wxPoint
GetFirstVisiblePoint() const;
1987 Returns the content of the entire control as a string.
1989 virtual wxString
GetValue() const;
1992 Replaces existing content with the given text.
1994 virtual void SetValue(const wxString
& value
);
1997 Call this function to prevent refresh and allow fast updates, and then Thaw() to
1998 refresh the control.
2003 Call this function to end a Freeze and refresh the display.
2008 Returns @true if Freeze has been called without a Thaw.
2010 bool IsFrozen() const;
2017 Sets up the caret for the given position and container, after a mouse click.
2019 bool SetCaretPositionAfterClick(wxRichTextParagraphLayoutBox
* container
, long position
, int hitTestFlags
, bool extendSelection
= false);
2022 Find the caret position for the combination of hit-test flags and character position.
2023 Returns the caret position and also an indication of where to place the caret (caretLineStart)
2024 since this is ambiguous (same position used for end of line and start of next).
2026 long FindCaretPositionForCharacterPosition(long position
, int hitTestFlags
, wxRichTextParagraphLayoutBox
* container
,
2027 bool& caretLineStart
);
2030 Processes mouse movement in order to change the cursor
2032 virtual bool ProcessMouseMovement(wxRichTextParagraphLayoutBox
* container
, wxRichTextObject
* obj
, long position
, const wxPoint
& pos
);
2035 Font names take a long time to retrieve, so cache them (on demand).
2037 static const wxArrayString
& GetAvailableFontNames();
2040 Clears the cache of available font names.
2042 static void ClearAvailableFontNames();
2044 WX_FORWARD_TO_SCROLL_HELPER()
2046 // implement wxTextEntry methods
2047 virtual wxString
DoGetValue() const;
2050 // implement the wxTextEntry pure virtual method
2051 virtual wxWindow
*GetEditableWindow() { return this; }
2053 // margins functions
2054 virtual bool DoSetMargins(const wxPoint
& pt
);
2055 virtual wxPoint
DoGetMargins() const;
2057 // FIXME: this does not work, it allows this code to compile but will fail
2059 #ifndef __WXUNIVERSAL__
2061 virtual WXHWND
GetEditHWND() const { return GetHWND(); }
2064 virtual WXWidget
GetTextWidget() const { return NULL
; }
2067 virtual GtkEditable
*GetEditable() const { return NULL
; }
2068 virtual GtkEntry
*GetEntry() const { return NULL
; }
2070 #endif // !__WXUNIVERSAL__
2076 Currently this simply returns @c wxSize(10, 10).
2078 virtual wxSize
DoGetBestSize() const ;
2080 virtual void DoSetValue(const wxString
& value
, int flags
= 0);
2082 virtual void DoThaw();
2087 #if wxRICHTEXT_BUFFERED_PAINTING
2089 wxBitmap m_bufferBitmap
;
2093 wxRichTextBuffer m_buffer
;
2095 wxMenu
* m_contextMenu
;
2097 /// Caret position (1 less than the character position, so -1 is the
2098 /// first caret position).
2099 long m_caretPosition
;
2101 /// Caret position when the default formatting has been changed. As
2102 /// soon as this position changes, we no longer reflect the default style
2104 long m_caretPositionForDefaultStyle
;
2106 /// Selection range in character positions. -2, -2 means no selection.
2107 wxRichTextSelection m_selection
;
2109 wxRichTextCtrlSelectionState m_selectionState
;
2111 /// Anchor so we know how to extend the selection
2112 /// It's a caret position since it's between two characters.
2113 long m_selectionAnchor
;
2115 /// Anchor object if selecting multiple container objects, such as grid cells.
2116 wxRichTextObject
* m_selectionAnchorObject
;
2118 /// Are we editable?
2121 /// Are we showing the caret position at the start of a line
2122 /// instead of at the end of the previous one?
2123 bool m_caretAtLineStart
;
2125 /// Are we dragging a selection?
2128 /// Do we need full layout in idle?
2129 bool m_fullLayoutRequired
;
2130 wxLongLong m_fullLayoutTime
;
2131 long m_fullLayoutSavedPosition
;
2133 /// Threshold for doing delayed layout
2134 long m_delayedLayoutThreshold
;
2137 wxCursor m_textCursor
;
2138 wxCursor m_urlCursor
;
2140 static wxArrayString sm_availableFontNames
;
2142 wxRichTextContextMenuPropertiesInfo m_contextMenuPropertiesInfo
;
2144 /// The object that currently has the editing focus
2145 wxRichTextParagraphLayoutBox
* m_focusObject
;
2149 @class wxRichTextEvent
2151 This is the event class for wxRichTextCtrl notifications.
2153 @beginEventTable{wxRichTextEvent}
2154 @event{EVT_RICHTEXT_LEFT_CLICK(id, func)}
2155 Process a @c wxEVT_COMMAND_RICHTEXT_LEFT_CLICK event, generated when the user
2156 releases the left mouse button over an object.
2157 @event{EVT_RICHTEXT_RIGHT_CLICK(id, func)}
2158 Process a @c wxEVT_COMMAND_RICHTEXT_RIGHT_CLICK event, generated when the user
2159 releases the right mouse button over an object.
2160 @event{EVT_RICHTEXT_MIDDLE_CLICK(id, func)}
2161 Process a @c wxEVT_COMMAND_RICHTEXT_MIDDLE_CLICK event, generated when the user
2162 releases the middle mouse button over an object.
2163 @event{EVT_RICHTEXT_LEFT_DCLICK(id, func)}
2164 Process a @c wxEVT_COMMAND_RICHTEXT_LEFT_DCLICK event, generated when the user
2165 double-clicks an object.
2166 @event{EVT_RICHTEXT_RETURN(id, func)}
2167 Process a @c wxEVT_COMMAND_RICHTEXT_RETURN event, generated when the user
2168 presses the return key. Valid event functions: GetFlags, GetPosition.
2169 @event{EVT_RICHTEXT_CHARACTER(id, func)}
2170 Process a @c wxEVT_COMMAND_RICHTEXT_CHARACTER event, generated when the user
2171 presses a character key. Valid event functions: GetFlags, GetPosition, GetCharacter.
2172 @event{EVT_RICHTEXT_DELETE(id, func)}
2173 Process a @c wxEVT_COMMAND_RICHTEXT_DELETE event, generated when the user
2174 presses the backspace or delete key. Valid event functions: GetFlags, GetPosition.
2175 @event{EVT_RICHTEXT_RETURN(id, func)}
2176 Process a @c wxEVT_COMMAND_RICHTEXT_RETURN event, generated when the user
2177 presses the return key. Valid event functions: GetFlags, GetPosition.
2178 @event{EVT_RICHTEXT_STYLE_CHANGED(id, func)}
2179 Process a @c wxEVT_COMMAND_RICHTEXT_STYLE_CHANGED event, generated when
2180 styling has been applied to the control. Valid event functions: GetPosition, GetRange.
2181 @event{EVT_RICHTEXT_STYLESHEET_CHANGED(id, func)}
2182 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING event, generated
2183 when the control's stylesheet has changed, for example the user added,
2184 edited or deleted a style. Valid event functions: GetRange, GetPosition.
2185 @event{EVT_RICHTEXT_STYLESHEET_REPLACING(id, func)}
2186 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACING event, generated
2187 when the control's stylesheet is about to be replaced, for example when
2188 a file is loaded into the control.
2189 Valid event functions: Veto, GetOldStyleSheet, GetNewStyleSheet.
2190 @event{EVT_RICHTEXT_STYLESHEET_REPLACED(id, func)}
2191 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACED event, generated
2192 when the control's stylesheet has been replaced, for example when a file
2193 is loaded into the control.
2194 Valid event functions: GetOldStyleSheet, GetNewStyleSheet.
2195 @event{EVT_RICHTEXT_PROPERTIES_CHANGED(id, func)}
2196 Process a @c wxEVT_COMMAND_RICHTEXT_PROPERTIES_CHANGED event, generated when
2197 properties have been applied to the control. Valid event functions: GetPosition, GetRange.
2198 @event{EVT_RICHTEXT_CONTENT_INSERTED(id, func)}
2199 Process a @c wxEVT_COMMAND_RICHTEXT_CONTENT_INSERTED event, generated when
2200 content has been inserted into the control.
2201 Valid event functions: GetPosition, GetRange.
2202 @event{EVT_RICHTEXT_CONTENT_DELETED(id, func)}
2203 Process a @c wxEVT_COMMAND_RICHTEXT_CONTENT_DELETED event, generated when
2204 content has been deleted from the control.
2205 Valid event functions: GetPosition, GetRange.
2206 @event{EVT_RICHTEXT_BUFFER_RESET(id, func)}
2207 Process a @c wxEVT_COMMAND_RICHTEXT_BUFFER_RESET event, generated when the
2208 buffer has been reset by deleting all content.
2209 You can use this to set a default style for the first new paragraph.
2210 @event{EVT_RICHTEXT_SELECTION_CHANGED(id, func)}
2211 Process a @c wxEVT_COMMAND_RICHTEXT_SELECTION_CHANGED event, generated when the
2212 selection range has changed.
2213 @event{EVT_RICHTEXT_FOCUS_OBJECT_CHANGED(id, func)}
2214 Process a @c wxEVT_COMMAND_RICHTEXT_FOCUS_OBJECT_CHANGED event, generated when the
2215 current focus object has changed.
2218 @library{wxrichtext}
2219 @category{events,richtext}
2222 class WXDLLIMPEXP_RICHTEXT wxRichTextEvent
: public wxNotifyEvent
2229 The type of the event.
2231 Window identifier. The value @c wxID_ANY indicates a default value.
2233 wxRichTextEvent(wxEventType commandType
= wxEVT_NULL
, int winid
= 0)
2234 : wxNotifyEvent(commandType
, winid
),
2235 m_flags(0), m_position(-1), m_oldStyleSheet(NULL
), m_newStyleSheet(NULL
),
2236 m_char((wxChar
) 0), m_container(NULL
), m_oldContainer(NULL
)
2242 wxRichTextEvent(const wxRichTextEvent
& event
)
2243 : wxNotifyEvent(event
),
2244 m_flags(event
.m_flags
), m_position(-1),
2245 m_oldStyleSheet(event
.m_oldStyleSheet
), m_newStyleSheet(event
.m_newStyleSheet
),
2246 m_char((wxChar
) 0), m_container(event
.m_container
), m_oldContainer(event
.m_oldContainer
)
2250 Returns the buffer position at which the event occured.
2252 long GetPosition() const { return m_position
; }
2255 Sets the buffer position variable.
2257 void SetPosition(long pos
) { m_position
= pos
; }
2260 Returns flags indicating modifier keys pressed.
2262 Possible values are @c wxRICHTEXT_CTRL_DOWN, @c wxRICHTEXT_SHIFT_DOWN, and @c wxRICHTEXT_ALT_DOWN.
2264 int GetFlags() const { return m_flags
; }
2267 Sets flags indicating modifier keys pressed.
2269 Possible values are @c wxRICHTEXT_CTRL_DOWN, @c wxRICHTEXT_SHIFT_DOWN, and @c wxRICHTEXT_ALT_DOWN.
2271 void SetFlags(int flags
) { m_flags
= flags
; }
2274 Returns the old style sheet.
2276 Can be used in a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING or
2277 @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED event handler.
2279 wxRichTextStyleSheet
* GetOldStyleSheet() const { return m_oldStyleSheet
; }
2282 Sets the old style sheet variable.
2284 void SetOldStyleSheet(wxRichTextStyleSheet
* sheet
) { m_oldStyleSheet
= sheet
; }
2287 Returns the new style sheet.
2289 Can be used in a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING or
2290 @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED event handler.
2292 wxRichTextStyleSheet
* GetNewStyleSheet() const { return m_newStyleSheet
; }
2295 Sets the new style sheet variable.
2297 void SetNewStyleSheet(wxRichTextStyleSheet
* sheet
) { m_newStyleSheet
= sheet
; }
2300 Gets the range for the current operation.
2302 const wxRichTextRange
& GetRange() const { return m_range
; }
2305 Sets the range variable.
2307 void SetRange(const wxRichTextRange
& range
) { m_range
= range
; }
2310 Returns the character pressed, within a @c wxEVT_COMMAND_RICHTEXT_CHARACTER event.
2312 wxChar
GetCharacter() const { return m_char
; }
2315 Sets the character variable.
2317 void SetCharacter(wxChar ch
) { m_char
= ch
; }
2320 Returns the container for which the event is relevant.
2322 wxRichTextParagraphLayoutBox
* GetContainer() const { return m_container
; }
2325 Sets the container for which the event is relevant.
2327 void SetContainer(wxRichTextParagraphLayoutBox
* container
) { m_container
= container
; }
2330 Returns the old container, for a focus change event.
2332 wxRichTextParagraphLayoutBox
* GetOldContainer() const { return m_oldContainer
; }
2335 Sets the old container, for a focus change event.
2337 void SetOldContainer(wxRichTextParagraphLayoutBox
* container
) { m_oldContainer
= container
; }
2339 virtual wxEvent
*Clone() const { return new wxRichTextEvent(*this); }
2344 wxRichTextStyleSheet
* m_oldStyleSheet
;
2345 wxRichTextStyleSheet
* m_newStyleSheet
;
2346 wxRichTextRange m_range
;
2348 wxRichTextParagraphLayoutBox
* m_container
;
2349 wxRichTextParagraphLayoutBox
* m_oldContainer
;
2352 DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxRichTextEvent
)