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 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_RICHTEXTCTRL_H_
13 #define _WX_RICHTEXTCTRL_H_
15 #include "wx/richtext/richtextbuffer.h"
19 #include "wx/scrolwin.h"
22 #include "wx/textctrl.h"
24 #if wxUSE_DRAG_AND_DROP
28 #if !defined(__WXGTK__) && !defined(__WXMAC__)
29 #define wxRICHTEXT_BUFFERED_PAINTING 1
31 #define wxRICHTEXT_BUFFERED_PAINTING 0
34 class WXDLLIMPEXP_FWD_RICHTEXT wxRichTextStyleDefinition
;
44 #define wxRE_READONLY 0x0010
45 #define wxRE_MULTILINE 0x0020
46 #define wxRE_CENTRE_CARET 0x8000
47 #define wxRE_CENTER_CARET wxRE_CENTRE_CARET
53 #define wxRICHTEXT_SHIFT_DOWN 0x01
54 #define wxRICHTEXT_CTRL_DOWN 0x02
55 #define wxRICHTEXT_ALT_DOWN 0x04
61 // Don't draw guide lines around boxes and tables
62 #define wxRICHTEXT_EX_NO_GUIDELINES 0x00000100
69 #define wxRICHTEXT_DEFAULT_OVERALL_SIZE wxSize(-1, -1)
70 #define wxRICHTEXT_DEFAULT_IMAGE_SIZE wxSize(80, 80)
71 #define wxRICHTEXT_DEFAULT_SPACING 3
72 #define wxRICHTEXT_DEFAULT_MARGIN 3
73 #define wxRICHTEXT_DEFAULT_UNFOCUSSED_BACKGROUND wxColour(175, 175, 175)
74 #define wxRICHTEXT_DEFAULT_FOCUSSED_BACKGROUND wxColour(140, 140, 140)
75 #define wxRICHTEXT_DEFAULT_UNSELECTED_BACKGROUND wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE)
76 #define wxRICHTEXT_DEFAULT_TYPE_COLOUR wxColour(0, 0, 200)
77 #define wxRICHTEXT_DEFAULT_FOCUS_RECT_COLOUR wxColour(100, 80, 80)
78 #define wxRICHTEXT_DEFAULT_CARET_WIDTH 2
79 // Minimum buffer size before delayed layout kicks in
80 #define wxRICHTEXT_DEFAULT_DELAYED_LAYOUT_THRESHOLD 20000
81 // Milliseconds before layout occurs after resize
82 #define wxRICHTEXT_DEFAULT_LAYOUT_INTERVAL 50
86 #define wxID_RICHTEXT_PROPERTIES1 (wxID_HIGHEST + 1)
87 #define wxID_RICHTEXT_PROPERTIES2 (wxID_HIGHEST + 2)
88 #define wxID_RICHTEXT_PROPERTIES3 (wxID_HIGHEST + 3)
91 Normal selection occurs initially and as user drags within one container.
92 Common ancestor selection occurs when the user starts dragging across containers
93 that have a common ancestor, for example the cells in a table.
96 enum wxRichTextCtrlSelectionState
98 wxRichTextCtrlSelectionState_Normal
,
99 wxRichTextCtrlSelectionState_CommonAncestor
103 @class wxRichTextContextMenuPropertiesInfo
105 wxRichTextContextMenuPropertiesInfo keeps track of objects that appear in the context menu,
106 whose properties are available to be edited.
109 class WXDLLIMPEXP_RICHTEXT wxRichTextContextMenuPropertiesInfo
115 wxRichTextContextMenuPropertiesInfo() { Init(); }
127 bool AddItem(const wxString
& label
, wxRichTextObject
* obj
);
130 Returns the number of menu items that were added.
132 int AddMenuItems(wxMenu
* menu
, int startCmd
= wxID_RICHTEXT_PROPERTIES1
) const;
135 Adds appropriate menu items for the current container and clicked on object
136 (and container's parent, if appropriate).
138 int AddItems(wxRichTextCtrl
* ctrl
, wxRichTextObject
* container
, wxRichTextObject
* obj
);
143 void Clear() { m_objects
.Clear(); m_labels
.Clear(); }
148 Returns the nth label.
150 wxString
GetLabel(int n
) const { return m_labels
[n
]; }
153 Returns the nth object.
155 wxRichTextObject
* GetObject(int n
) const { return m_objects
[n
]; }
158 Returns the array of objects.
160 wxRichTextObjectPtrArray
& GetObjects() { return m_objects
; }
163 Returns the array of objects.
165 const wxRichTextObjectPtrArray
& GetObjects() const { return m_objects
; }
168 Returns the array of labels.
170 wxArrayString
& GetLabels() { return m_labels
; }
173 Returns the array of labels.
175 const wxArrayString
& GetLabels() const { return m_labels
; }
178 Returns the number of items.
180 int GetCount() const { return m_objects
.GetCount(); }
182 wxRichTextObjectPtrArray m_objects
;
183 wxArrayString m_labels
;
187 @class wxRichTextCtrl
189 wxRichTextCtrl provides a generic, ground-up implementation of a text control
190 capable of showing multiple styles and images.
192 wxRichTextCtrl sends notification events: see wxRichTextEvent.
194 It also sends the standard wxTextCtrl events @c wxEVT_COMMAND_TEXT_ENTER and
195 @c wxEVT_COMMAND_TEXT_UPDATED, and wxTextUrlEvent when URL content is clicked.
197 For more information, see the @ref overview_richtextctrl.
200 @style{wxRE_CENTRE_CARET}
201 The control will try to keep the caret line centred vertically while editing.
202 wxRE_CENTER_CARET is a synonym for this style.
203 @style{wxRE_MULTILINE}
204 The control will be multiline (mandatory).
205 @style{wxRE_READONLY}
206 The control will not be editable.
211 @appearance{richtextctrl.png}
215 class WXDLLIMPEXP_RICHTEXT wxRichTextCtrl
: public wxControl
,
216 public wxTextCtrlIface
,
217 public wxScrollHelper
219 DECLARE_DYNAMIC_CLASS( wxRichTextCtrl
)
220 DECLARE_EVENT_TABLE()
231 Constructor, creating and showing a rich text control.
234 Parent window. Must not be @NULL.
236 Window identifier. The value @c wxID_ANY indicates a default value.
250 @see Create(), wxValidator
252 wxRichTextCtrl( wxWindow
* parent
, wxWindowID id
= -1, const wxString
& value
= wxEmptyString
, const wxPoint
& pos
= wxDefaultPosition
, const wxSize
& size
= wxDefaultSize
,
253 long style
= wxRE_MULTILINE
, const wxValidator
& validator
= wxDefaultValidator
, const wxString
& name
= wxTextCtrlNameStr
);
258 virtual ~wxRichTextCtrl( );
263 Creates the underlying window.
265 bool Create( wxWindow
* parent
, wxWindowID id
= -1, const wxString
& value
= wxEmptyString
, const wxPoint
& pos
= wxDefaultPosition
, const wxSize
& size
= wxDefaultSize
,
266 long style
= wxRE_MULTILINE
, const wxValidator
& validator
= wxDefaultValidator
, const wxString
& name
= wxTextCtrlNameStr
);
269 Initialises the members of the control.
276 Gets the text for the given range.
277 The end point of range is specified as the last character position of
278 the span of text, plus one.
280 virtual wxString
GetRange(long from
, long to
) const;
283 Returns the length of the specified line in characters.
285 virtual int GetLineLength(long lineNo
) const ;
288 Returns the text for the given line.
290 virtual wxString
GetLineText(long lineNo
) const ;
293 Returns the number of lines in the buffer.
295 virtual int GetNumberOfLines() const ;
298 Returns @true if the buffer has been modified.
300 virtual bool IsModified() const ;
303 Returns @true if the control is editable.
305 virtual bool IsEditable() const ;
308 Returns @true if the control is single-line.
309 Currently wxRichTextCtrl does not support single-line editing.
311 bool IsSingleLine() const { return !HasFlag(wxRE_MULTILINE
); }
314 Returns @true if the control is multiline.
316 bool IsMultiLine() const { return !IsSingleLine(); }
320 Returns the range of the current selection.
321 The end point of range is specified as the last character position of the span
323 If the return values @a from and @a to are the same, there is no selection.
325 virtual void GetSelection(long* from
, long* to
) const;
326 const wxRichTextSelection
& GetSelection() const { return m_selection
; }
327 wxRichTextSelection
& GetSelection() { return m_selection
; }
331 Returns the text within the current selection range, if any.
333 virtual wxString
GetStringSelection() const;
336 Gets the current filename associated with the control.
338 wxString
GetFilename() const { return m_filename
; }
341 Sets the current filename.
343 void SetFilename(const wxString
& filename
) { m_filename
= filename
; }
346 Sets the size of the buffer beyond which layout is delayed during resizing.
347 This optimizes sizing for large buffers. The default is 20000.
349 void SetDelayedLayoutThreshold(long threshold
) { m_delayedLayoutThreshold
= threshold
; }
352 Gets the size of the buffer beyond which layout is delayed during resizing.
353 This optimizes sizing for large buffers. The default is 20000.
355 long GetDelayedLayoutThreshold() const { return m_delayedLayoutThreshold
; }
358 Gets the flag indicating that full layout is required.
360 bool GetFullLayoutRequired() const { return m_fullLayoutRequired
; }
363 Sets the flag indicating that full layout is required.
365 void SetFullLayoutRequired(bool b
) { m_fullLayoutRequired
= b
; }
368 Returns the last time full layout was performed.
370 wxLongLong
GetFullLayoutTime() const { return m_fullLayoutTime
; }
373 Sets the last time full layout was performed.
375 void SetFullLayoutTime(wxLongLong t
) { m_fullLayoutTime
= t
; }
378 Returns the position that should be shown when full (delayed) layout is performed.
380 long GetFullLayoutSavedPosition() const { return m_fullLayoutSavedPosition
; }
383 Sets the position that should be shown when full (delayed) layout is performed.
385 void SetFullLayoutSavedPosition(long p
) { m_fullLayoutSavedPosition
= p
; }
388 Forces any pending layout due to delayed, partial layout when the control
391 void ForceDelayedLayout();
394 Sets the text (normal) cursor.
396 void SetTextCursor(const wxCursor
& cursor
) { m_textCursor
= cursor
; }
399 Returns the text (normal) cursor.
401 wxCursor
GetTextCursor() const { return m_textCursor
; }
404 Sets the cursor to be used over URLs.
406 void SetURLCursor(const wxCursor
& cursor
) { m_urlCursor
= cursor
; }
409 Returns the cursor to be used over URLs.
411 wxCursor
GetURLCursor() const { return m_urlCursor
; }
414 Returns @true if we are showing the caret position at the start of a line
415 instead of at the end of the previous one.
417 bool GetCaretAtLineStart() const { return m_caretAtLineStart
; }
420 Sets a flag to remember that we are showing the caret position at the start of a line
421 instead of at the end of the previous one.
423 void SetCaretAtLineStart(bool atStart
) { m_caretAtLineStart
= atStart
; }
426 Returns @true if we are dragging a selection.
428 bool GetDragging() const { return m_dragging
; }
431 Sets a flag to remember if we are dragging a selection.
433 void SetDragging(bool dragging
) { m_dragging
= dragging
; }
435 #if wxUSE_DRAG_AND_DROP
437 Are we trying to start Drag'n'Drop?
439 bool GetPreDrag() const { return m_preDrag
; }
442 Set if we're trying to start Drag'n'Drop
444 void SetPreDrag(bool pd
) { m_preDrag
= pd
; }
447 Get the possible Drag'n'Drop start point
449 const wxPoint
GetDragStartPoint() const { return m_dragStartPoint
; }
452 Set the possible Drag'n'Drop start point
454 void SetDragStartPoint(wxPoint sp
) { m_dragStartPoint
= sp
; }
458 Get the possible Drag'n'Drop start time
460 const wxDateTime
GetDragStartTime() const { return m_dragStartTime
; }
463 Set the possible Drag'n'Drop start time
465 void SetDragStartTime(wxDateTime st
) { m_dragStartTime
= st
; }
466 #endif // wxUSE_DATETIME
468 #endif // wxUSE_DRAG_AND_DROP
470 #if wxRICHTEXT_BUFFERED_PAINTING
473 Returns the buffer bitmap if using buffered painting.
475 const wxBitmap
& GetBufferBitmap() const { return m_bufferBitmap
; }
476 wxBitmap
& GetBufferBitmap() { return m_bufferBitmap
; }
481 Returns the current context menu.
483 wxMenu
* GetContextMenu() const { return m_contextMenu
; }
486 Sets the current context menu.
488 void SetContextMenu(wxMenu
* menu
);
491 Returns an anchor so we know how to extend the selection.
492 It's a caret position since it's between two characters.
494 long GetSelectionAnchor() const { return m_selectionAnchor
; }
497 Sets an anchor so we know how to extend the selection.
498 It's a caret position since it's between two characters.
500 void SetSelectionAnchor(long anchor
) { m_selectionAnchor
= anchor
; }
503 Returns the anchor object if selecting multiple containers.
505 wxRichTextObject
* GetSelectionAnchorObject() const { return m_selectionAnchorObject
; }
508 Sets the anchor object if selecting multiple containers.
510 void SetSelectionAnchorObject(wxRichTextObject
* anchor
) { m_selectionAnchorObject
= anchor
; }
514 Returns an object that stores information about context menu property item(s),
515 in order to communicate between the context menu event handler and the code
516 that responds to it. The wxRichTextContextMenuPropertiesInfo stores one
517 item for each object that could respond to a property-editing event. If
518 objects are nested, several might be editable.
520 wxRichTextContextMenuPropertiesInfo
& GetContextMenuPropertiesInfo() { return m_contextMenuPropertiesInfo
; }
521 const wxRichTextContextMenuPropertiesInfo
& GetContextMenuPropertiesInfo() const { return m_contextMenuPropertiesInfo
; }
525 Returns the wxRichTextObject object that currently has the editing focus.
526 If there are no composite objects, this will be the top-level buffer.
528 wxRichTextParagraphLayoutBox
* GetFocusObject() const { return m_focusObject
; }
531 Sets m_focusObject without making any alterations.
533 void StoreFocusObject(wxRichTextParagraphLayoutBox
* obj
) { m_focusObject
= obj
; }
536 Sets the wxRichTextObject object that currently has the editing focus.
538 bool SetFocusObject(wxRichTextParagraphLayoutBox
* obj
, bool setCaretPosition
= true);
543 Invalidates the whole buffer to trigger painting later.
545 void Invalidate() { GetBuffer().Invalidate(wxRICHTEXT_ALL
); }
548 Clears the buffer content, leaving a single empty paragraph. Cannot be undone.
550 virtual void Clear();
553 Replaces the content in the specified range with the string specified by
556 virtual void Replace(long from
, long to
, const wxString
& value
);
559 Removes the content in the specified range.
561 virtual void Remove(long from
, long to
);
565 Loads content into the control's buffer using the given type.
567 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
568 the filename extension.
570 This function looks for a suitable wxRichTextFileHandler object.
572 bool LoadFile(const wxString
& file
,
573 int type
= wxRICHTEXT_TYPE_ANY
);
577 Helper function for LoadFile(). Loads content into the control's buffer using the given type.
579 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
580 the filename extension.
582 This function looks for a suitable wxRichTextFileHandler object.
584 virtual bool DoLoadFile(const wxString
& file
, int fileType
);
588 Saves the buffer content using the given type.
590 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
591 the filename extension.
593 This function looks for a suitable wxRichTextFileHandler object.
595 bool SaveFile(const wxString
& file
= wxEmptyString
,
596 int type
= wxRICHTEXT_TYPE_ANY
);
600 Helper function for SaveFile(). Saves the buffer content using the given type.
602 If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from
603 the filename extension.
605 This function looks for a suitable wxRichTextFileHandler object.
607 virtual bool DoSaveFile(const wxString
& file
= wxEmptyString
,
608 int fileType
= wxRICHTEXT_TYPE_ANY
);
611 Sets flags that change the behaviour of loading or saving.
613 See the documentation for each handler class to see what flags are
614 relevant for each handler.
616 void SetHandlerFlags(int flags
) { GetBuffer().SetHandlerFlags(flags
); }
619 Returns flags that change the behaviour of loading or saving.
620 See the documentation for each handler class to see what flags are
621 relevant for each handler.
623 int GetHandlerFlags() const { return GetBuffer().GetHandlerFlags(); }
626 Marks the buffer as modified.
628 virtual void MarkDirty();
631 Sets the buffer's modified status to @false, and clears the buffer's command
634 virtual void DiscardEdits();
637 Sets the maximum number of characters that may be entered in a single line
638 text control. For compatibility only; currently does nothing.
640 virtual void SetMaxLength(unsigned long WXUNUSED(len
)) { }
643 Writes text at the current position.
645 virtual void WriteText(const wxString
& text
);
648 Sets the insertion point to the end of the buffer and writes the text.
650 virtual void AppendText(const wxString
& text
);
654 Gets the attributes at the given position.
655 This function gets the combined style - that is, the style you see on the
656 screen as a result of combining base style, paragraph style and character
659 To get the character or paragraph style alone, use GetUncombinedStyle().
662 In wxPerl this method is implemented as GetStyle(@a position)
663 returning a 2-element list (ok, attr).
666 virtual bool GetStyle(long position
, wxTextAttr
& style
);
667 virtual bool GetStyle(long position
, wxRichTextAttr
& style
);
668 virtual bool GetStyle(long position
, wxRichTextAttr
& style
, wxRichTextParagraphLayoutBox
* container
);
673 Sets the attributes for the given range.
674 The end point of range is specified as the last character position of the span
677 So, for example, to set the style for a character at position 5, use the range
680 virtual bool SetStyle(long start
, long end
, const wxTextAttr
& style
);
681 virtual bool SetStyle(long start
, long end
, const wxRichTextAttr
& style
);
682 virtual bool SetStyle(const wxRichTextRange
& range
, const wxTextAttr
& style
);
683 virtual bool SetStyle(const wxRichTextRange
& range
, const wxRichTextAttr
& style
);
687 Sets the attributes for a single object
689 virtual void SetStyle(wxRichTextObject
*obj
, const wxRichTextAttr
& textAttr
);
693 Gets the attributes common to the specified range.
694 Attributes that differ in value within the range will not be included
698 In wxPerl this method is implemented as GetStyleForRange(@a position)
699 returning a 2-element list (ok, attr).
702 virtual bool GetStyleForRange(const wxRichTextRange
& range
, wxTextAttr
& style
);
703 virtual bool GetStyleForRange(const wxRichTextRange
& range
, wxRichTextAttr
& style
);
704 virtual bool GetStyleForRange(const wxRichTextRange
& range
, wxRichTextAttr
& style
, wxRichTextParagraphLayoutBox
* container
);
708 Sets the attributes for the given range, passing flags to determine how the
711 The end point of range is specified as the last character position of the span
712 of text, plus one. So, for example, to set the style for a character at
713 position 5, use the range (5,6).
715 @a flags may contain a bit list of the following values:
716 - wxRICHTEXT_SETSTYLE_NONE: no style flag.
717 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this operation should be
719 - wxRICHTEXT_SETSTYLE_OPTIMIZE: specifies that the style should not be applied
720 if the combined style at this point is already the style in question.
721 - wxRICHTEXT_SETSTYLE_PARAGRAPHS_ONLY: specifies that the style should only be
722 applied to paragraphs, and not the content.
723 This allows content styling to be preserved independently from that
724 of e.g. a named paragraph style.
725 - wxRICHTEXT_SETSTYLE_CHARACTERS_ONLY: specifies that the style should only be
726 applied to characters, and not the paragraph.
727 This allows content styling to be preserved independently from that
728 of e.g. a named paragraph style.
729 - wxRICHTEXT_SETSTYLE_RESET: resets (clears) the existing style before applying
731 - wxRICHTEXT_SETSTYLE_REMOVE: removes the specified style. Only the style flags
732 are used in this operation.
734 virtual bool SetStyleEx(const wxRichTextRange
& range
, const wxRichTextAttr
& style
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
);
738 Gets the attributes at the given position.
739 This function gets the @e uncombined style - that is, the attributes associated
740 with the paragraph or character content, and not necessarily the combined
741 attributes you see on the screen.
742 To get the combined attributes, use GetStyle().
744 If you specify (any) paragraph attribute in @e style's flags, this function
745 will fetch the paragraph attributes.
746 Otherwise, it will return the character attributes.
749 In wxPerl this method is implemented as GetUncombinedStyle(@a position)
750 returning a 2-element list (ok, attr).
753 virtual bool GetUncombinedStyle(long position
, wxRichTextAttr
& style
);
754 virtual bool GetUncombinedStyle(long position
, wxRichTextAttr
& style
, wxRichTextParagraphLayoutBox
* container
);
759 Sets the current default style, which can be used to change how subsequently
760 inserted text is displayed.
762 virtual bool SetDefaultStyle(const wxTextAttr
& style
);
763 virtual bool SetDefaultStyle(const wxRichTextAttr
& style
);
767 Returns the current default style, which can be used to change how subsequently
768 inserted text is displayed.
770 virtual const wxRichTextAttr
& GetDefaultStyleEx() const;
772 //virtual const wxTextAttr& GetDefaultStyle() const;
776 Sets the list attributes for the given range, passing flags to determine how
777 the attributes are set.
779 Either the style definition or the name of the style definition (in the current
780 sheet) can be passed.
781 @a flags is a bit list of the following:
782 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
783 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
784 @a startFrom, otherwise existing attributes are used.
785 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
786 as the level for all paragraphs, otherwise the current indentation will be used.
788 @see NumberList(), PromoteList(), ClearListStyle().
790 virtual bool SetListStyle(const wxRichTextRange
& range
, wxRichTextListStyleDefinition
* def
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int startFrom
= 1, int specifiedLevel
= -1);
791 virtual bool SetListStyle(const wxRichTextRange
& range
, const wxString
& defName
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int startFrom
= 1, int specifiedLevel
= -1);
795 Clears the list style from the given range, clearing list-related attributes
796 and applying any named paragraph style associated with each paragraph.
798 @a flags is a bit list of the following:
799 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
801 @see SetListStyle(), PromoteList(), NumberList().
803 virtual bool ClearListStyle(const wxRichTextRange
& range
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
);
807 Numbers the paragraphs in the given range.
808 Pass flags to determine how the attributes are set.
810 Either the style definition or the name of the style definition (in the current
811 sheet) can be passed.
813 @a flags is a bit list of the following:
814 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
815 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
816 @a startFrom, otherwise existing attributes are used.
817 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
818 as the level for all paragraphs, otherwise the current indentation will be used.
820 @see SetListStyle(), PromoteList(), ClearListStyle().
822 virtual bool NumberList(const wxRichTextRange
& range
, wxRichTextListStyleDefinition
* def
= NULL
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int startFrom
= 1, int specifiedLevel
= -1);
823 virtual bool NumberList(const wxRichTextRange
& range
, const wxString
& defName
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int startFrom
= 1, int specifiedLevel
= -1);
828 Promotes or demotes the paragraphs in the given range.
829 A positive @a promoteBy produces a smaller indent, and a negative number
830 produces a larger indent. Pass flags to determine how the attributes are set.
831 Either the style definition or the name of the style definition (in the current
832 sheet) can be passed.
834 @a flags is a bit list of the following:
835 - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable.
836 - wxRICHTEXT_SETSTYLE_RENUMBER: specifies that numbering should start from
837 @a startFrom, otherwise existing attributes are used.
838 - wxRICHTEXT_SETSTYLE_SPECIFY_LEVEL: specifies that @a listLevel should be used
839 as the level for all paragraphs, otherwise the current indentation will be used.
841 @see SetListStyle(), @see SetListStyle(), ClearListStyle().
843 virtual bool PromoteList(int promoteBy
, const wxRichTextRange
& range
, wxRichTextListStyleDefinition
* def
= NULL
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int specifiedLevel
= -1);
844 virtual bool PromoteList(int promoteBy
, const wxRichTextRange
& range
, const wxString
& defName
, int flags
= wxRICHTEXT_SETSTYLE_WITH_UNDO
, int specifiedLevel
= -1);
848 Sets the properties for the given range, passing flags to determine how the
849 attributes are set. You can merge properties or replace them.
851 The end point of range is specified as the last character position of the span
852 of text, plus one. So, for example, to set the properties for a character at
853 position 5, use the range (5,6).
855 @a flags may contain a bit list of the following values:
856 - wxRICHTEXT_SETSPROPERTIES_NONE: no flag.
857 - wxRICHTEXT_SETPROPERTIES_WITH_UNDO: specifies that this operation should be
859 - wxRICHTEXT_SETPROPERTIES_PARAGRAPHS_ONLY: specifies that the properties should only be
860 applied to paragraphs, and not the content.
861 - wxRICHTEXT_SETPROPERTIES_CHARACTERS_ONLY: specifies that the properties should only be
862 applied to characters, and not the paragraph.
863 - wxRICHTEXT_SETPROPERTIES_RESET: resets (clears) the existing properties before applying
865 - wxRICHTEXT_SETPROPERTIES_REMOVE: removes the specified properties.
867 virtual bool SetProperties(const wxRichTextRange
& range
, const wxRichTextProperties
& properties
, int flags
= wxRICHTEXT_SETPROPERTIES_WITH_UNDO
);
870 Deletes the content within the given range.
872 virtual bool Delete(const wxRichTextRange
& range
);
875 Translates from column and line number to position.
877 virtual long XYToPosition(long x
, long y
) const;
880 Converts a text position to zero-based column and line numbers.
882 virtual bool PositionToXY(long pos
, long *x
, long *y
) const;
885 Scrolls the buffer so that the given position is in view.
887 virtual void ShowPosition(long pos
);
891 Finds the character at the given position in pixels.
892 @a pt is in device coords (not adjusted for the client area origin nor for
895 virtual wxTextCtrlHitTestResult
HitTest(const wxPoint
& pt
, long *pos
) const;
896 virtual wxTextCtrlHitTestResult
HitTest(const wxPoint
& pt
,
898 wxTextCoord
*row
) const;
901 Finds the container at the given point, which is in screen coordinates.
903 wxRichTextParagraphLayoutBox
* FindContainerAtPoint(const wxPoint pt
, long& position
, int& hit
, wxRichTextObject
* hitObj
, int flags
= 0);
906 #if wxUSE_DRAG_AND_DROP
908 Does the 'drop' of Drag'n'Drop.
910 void OnDrop(wxCoord
WXUNUSED(x
), wxCoord
WXUNUSED(y
), wxDragResult def
, wxDataObject
* DataObj
);
913 // Clipboard operations
916 Copies the selected content (if any) to the clipboard.
921 Copies the selected content (if any) to the clipboard and deletes the selection.
927 Pastes content from the clipboard to the buffer.
929 virtual void Paste();
932 Deletes the content in the selection, if any. This is undoable.
934 virtual void DeleteSelection();
937 Returns @true if selected content can be copied to the clipboard.
939 virtual bool CanCopy() const;
942 Returns @true if selected content can be copied to the clipboard and deleted.
944 virtual bool CanCut() const;
947 Returns @true if the clipboard content can be pasted to the buffer.
949 virtual bool CanPaste() const;
952 Returns @true if selected content can be deleted.
954 virtual bool CanDeleteSelection() const;
957 Undoes the command at the top of the command history, if there is one.
962 Redoes the current command.
967 Returns @true if there is a command in the command history that can be undone.
969 virtual bool CanUndo() const;
972 Returns @true if there is a command in the command history that can be redone.
974 virtual bool CanRedo() const;
977 Sets the insertion point and causes the current editing style to be taken from
978 the new position (unlike wxRichTextCtrl::SetCaretPosition).
980 virtual void SetInsertionPoint(long pos
);
983 Sets the insertion point to the end of the text control.
985 virtual void SetInsertionPointEnd();
988 Returns the current insertion point.
990 virtual long GetInsertionPoint() const;
993 Returns the last position in the buffer.
995 virtual wxTextPos
GetLastPosition() const;
999 Sets the selection to the given range.
1000 The end point of range is specified as the last character position of the span
1003 So, for example, to set the selection for a character at position 5, use the
1006 virtual void SetSelection(long from
, long to
);
1007 void SetSelection(const wxRichTextSelection
& sel
) { m_selection
= sel
; }
1012 Selects all the text in the buffer.
1014 virtual void SelectAll();
1017 Makes the control editable, or not.
1019 virtual void SetEditable(bool editable
);
1022 Returns @true if there is a selection and the object containing the selection
1023 was the same as the current focus object.
1025 virtual bool HasSelection() const;
1028 Returns @true if there was a selection, whether or not the current focus object
1029 is the same as the selection's container object.
1031 virtual bool HasUnfocusedSelection() const;
1035 Write a bitmap or image at the current insertion point.
1036 Supply an optional type to use for internal and file storage of the raw data.
1038 virtual bool WriteImage(const wxImage
& image
, wxBitmapType bitmapType
= wxBITMAP_TYPE_PNG
,
1039 const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1041 virtual bool WriteImage(const wxBitmap
& bitmap
, wxBitmapType bitmapType
= wxBITMAP_TYPE_PNG
,
1042 const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1046 Loads an image from a file and writes it at the current insertion point.
1048 virtual bool WriteImage(const wxString
& filename
, wxBitmapType bitmapType
,
1049 const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1052 Writes an image block at the current insertion point.
1054 virtual bool WriteImage(const wxRichTextImageBlock
& imageBlock
,
1055 const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1058 Write a text box at the current insertion point, returning the text box.
1059 You can then call SetFocusObject() to set the focus to the new object.
1061 virtual wxRichTextBox
* WriteTextBox(const wxRichTextAttr
& textAttr
= wxRichTextAttr());
1064 Write a table at the current insertion point, returning the table.
1065 You can then call SetFocusObject() to set the focus to the new object.
1067 virtual wxRichTextTable
* WriteTable(int rows
, int cols
, const wxRichTextAttr
& tableAttr
= wxRichTextAttr(), const wxRichTextAttr
& cellAttr
= wxRichTextAttr());
1070 Inserts a new paragraph at the current insertion point. @see LineBreak().
1072 virtual bool Newline();
1075 Inserts a line break at the current insertion point.
1077 A line break forces wrapping within a paragraph, and can be introduced by
1078 using this function, by appending the wxChar value @b wxRichTextLineBreakChar
1079 to text content, or by typing Shift-Return.
1081 virtual bool LineBreak();
1084 Sets the basic (overall) style.
1086 This is the style of the whole buffer before further styles are applied,
1087 unlike the default style, which only affects the style currently being
1088 applied (for example, setting the default style to bold will cause
1089 subsequently inserted text to be bold).
1091 virtual void SetBasicStyle(const wxRichTextAttr
& style
) { GetBuffer().SetBasicStyle(style
); }
1094 Gets the basic (overall) style.
1096 This is the style of the whole buffer before further styles are applied,
1097 unlike the default style, which only affects the style currently being
1098 applied (for example, setting the default style to bold will cause
1099 subsequently inserted text to be bold).
1101 virtual const wxRichTextAttr
& GetBasicStyle() const { return GetBuffer().GetBasicStyle(); }
1104 Begins applying a style.
1106 virtual bool BeginStyle(const wxRichTextAttr
& style
) { return GetBuffer().BeginStyle(style
); }
1109 Ends the current style.
1111 virtual bool EndStyle() { return GetBuffer().EndStyle(); }
1114 Ends application of all styles in the current style stack.
1116 virtual bool EndAllStyles() { return GetBuffer().EndAllStyles(); }
1121 bool BeginBold() { return GetBuffer().BeginBold(); }
1126 bool EndBold() { return GetBuffer().EndBold(); }
1129 Begins using italic.
1131 bool BeginItalic() { return GetBuffer().BeginItalic(); }
1136 bool EndItalic() { return GetBuffer().EndItalic(); }
1139 Begins using underlining.
1141 bool BeginUnderline() { return GetBuffer().BeginUnderline(); }
1144 End applying underlining.
1146 bool EndUnderline() { return GetBuffer().EndUnderline(); }
1149 Begins using the given point size.
1151 bool BeginFontSize(int pointSize
) { return GetBuffer().BeginFontSize(pointSize
); }
1154 Ends using a point size.
1156 bool EndFontSize() { return GetBuffer().EndFontSize(); }
1159 Begins using this font.
1161 bool BeginFont(const wxFont
& font
) { return GetBuffer().BeginFont(font
); }
1166 bool EndFont() { return GetBuffer().EndFont(); }
1169 Begins using this colour.
1171 bool BeginTextColour(const wxColour
& colour
) { return GetBuffer().BeginTextColour(colour
); }
1174 Ends applying a text colour.
1176 bool EndTextColour() { return GetBuffer().EndTextColour(); }
1179 Begins using alignment.
1180 For alignment values, see wxTextAttr.
1182 bool BeginAlignment(wxTextAttrAlignment alignment
) { return GetBuffer().BeginAlignment(alignment
); }
1187 bool EndAlignment() { return GetBuffer().EndAlignment(); }
1190 Begins applying a left indent and subindent in tenths of a millimetre.
1191 The subindent is an offset from the left edge of the paragraph, and is
1192 used for all but the first line in a paragraph. A positive value will
1193 cause the first line to appear to the left of the subsequent lines, and
1194 a negative value will cause the first line to be indented to the right
1195 of the subsequent lines.
1197 wxRichTextBuffer uses indentation to render a bulleted item. The
1198 content of the paragraph, including the first line, starts at the
1199 @a leftIndent plus the @a leftSubIndent.
1202 The distance between the margin and the bullet.
1203 @param leftSubIndent
1204 The distance between the left edge of the bullet and the left edge
1205 of the actual paragraph.
1207 bool BeginLeftIndent(int leftIndent
, int leftSubIndent
= 0) { return GetBuffer().BeginLeftIndent(leftIndent
, leftSubIndent
); }
1212 bool EndLeftIndent() { return GetBuffer().EndLeftIndent(); }
1215 Begins a right indent, specified in tenths of a millimetre.
1217 bool BeginRightIndent(int rightIndent
) { return GetBuffer().BeginRightIndent(rightIndent
); }
1222 bool EndRightIndent() { return GetBuffer().EndRightIndent(); }
1225 Begins paragraph spacing; pass the before-paragraph and after-paragraph spacing
1226 in tenths of a millimetre.
1228 bool BeginParagraphSpacing(int before
, int after
) { return GetBuffer().BeginParagraphSpacing(before
, after
); }
1231 Ends paragraph spacing.
1233 bool EndParagraphSpacing() { return GetBuffer().EndParagraphSpacing(); }
1236 Begins appling line spacing. @e spacing is a multiple, where 10 means
1237 single-spacing, 15 means 1.5 spacing, and 20 means double spacing.
1239 The ::wxTextAttrLineSpacing constants are defined for convenience.
1241 bool BeginLineSpacing(int lineSpacing
) { return GetBuffer().BeginLineSpacing(lineSpacing
); }
1246 bool EndLineSpacing() { return GetBuffer().EndLineSpacing(); }
1249 Begins a numbered bullet.
1251 This call will be needed for each item in the list, and the
1252 application should take care of incrementing the numbering.
1254 @a bulletNumber is a number, usually starting with 1.
1255 @a leftIndent and @a leftSubIndent are values in tenths of a millimetre.
1256 @a bulletStyle is a bitlist of the ::wxTextAttrBulletStyle values.
1258 wxRichTextBuffer uses indentation to render a bulleted item.
1259 The left indent is the distance between the margin and the bullet.
1260 The content of the paragraph, including the first line, starts
1261 at leftMargin + leftSubIndent.
1262 So the distance between the left edge of the bullet and the
1263 left of the actual paragraph is leftSubIndent.
1265 bool BeginNumberedBullet(int bulletNumber
, int leftIndent
, int leftSubIndent
, int bulletStyle
= wxTEXT_ATTR_BULLET_STYLE_ARABIC
|wxTEXT_ATTR_BULLET_STYLE_PERIOD
)
1266 { return GetBuffer().BeginNumberedBullet(bulletNumber
, leftIndent
, leftSubIndent
, bulletStyle
); }
1269 Ends application of a numbered bullet.
1271 bool EndNumberedBullet() { return GetBuffer().EndNumberedBullet(); }
1274 Begins applying a symbol bullet, using a character from the current font.
1275 See BeginNumberedBullet() for an explanation of how indentation is used
1276 to render the bulleted paragraph.
1278 bool BeginSymbolBullet(const wxString
& symbol
, int leftIndent
, int leftSubIndent
, int bulletStyle
= wxTEXT_ATTR_BULLET_STYLE_SYMBOL
)
1279 { return GetBuffer().BeginSymbolBullet(symbol
, leftIndent
, leftSubIndent
, bulletStyle
); }
1282 Ends applying a symbol bullet.
1284 bool EndSymbolBullet() { return GetBuffer().EndSymbolBullet(); }
1287 Begins applying a symbol bullet.
1289 bool BeginStandardBullet(const wxString
& bulletName
, int leftIndent
, int leftSubIndent
, int bulletStyle
= wxTEXT_ATTR_BULLET_STYLE_STANDARD
)
1290 { return GetBuffer().BeginStandardBullet(bulletName
, leftIndent
, leftSubIndent
, bulletStyle
); }
1293 Begins applying a standard bullet.
1295 bool EndStandardBullet() { return GetBuffer().EndStandardBullet(); }
1298 Begins using the named character style.
1300 bool BeginCharacterStyle(const wxString
& characterStyle
) { return GetBuffer().BeginCharacterStyle(characterStyle
); }
1303 Ends application of a named character style.
1305 bool EndCharacterStyle() { return GetBuffer().EndCharacterStyle(); }
1308 Begins applying the named paragraph style.
1310 bool BeginParagraphStyle(const wxString
& paragraphStyle
) { return GetBuffer().BeginParagraphStyle(paragraphStyle
); }
1313 Ends application of a named paragraph style.
1315 bool EndParagraphStyle() { return GetBuffer().EndParagraphStyle(); }
1318 Begins using a specified list style.
1319 Optionally, you can also pass a level and a number.
1321 bool BeginListStyle(const wxString
& listStyle
, int level
= 1, int number
= 1) { return GetBuffer().BeginListStyle(listStyle
, level
, number
); }
1324 Ends using a specified list style.
1326 bool EndListStyle() { return GetBuffer().EndListStyle(); }
1329 Begins applying wxTEXT_ATTR_URL to the content.
1331 Pass a URL and optionally, a character style to apply, since it is common
1332 to mark a URL with a familiar style such as blue text with underlining.
1334 bool BeginURL(const wxString
& url
, const wxString
& characterStyle
= wxEmptyString
) { return GetBuffer().BeginURL(url
, characterStyle
); }
1337 Ends applying a URL.
1339 bool EndURL() { return GetBuffer().EndURL(); }
1342 Sets the default style to the style under the cursor.
1344 bool SetDefaultStyleToCursorStyle();
1347 Cancels any selection.
1349 virtual void SelectNone();
1352 Selects the word at the given character position.
1354 virtual bool SelectWord(long position
);
1357 Returns the selection range in character positions. -1, -1 means no selection.
1359 The range is in API convention, i.e. a single character selection is denoted
1362 wxRichTextRange
GetSelectionRange() const;
1365 Sets the selection to the given range.
1366 The end point of range is specified as the last character position of the span
1369 So, for example, to set the selection for a character at position 5, use the
1372 void SetSelectionRange(const wxRichTextRange
& range
);
1375 Returns the selection range in character positions. -2, -2 means no selection
1376 -1, -1 means select everything.
1377 The range is in internal format, i.e. a single character selection is denoted
1380 wxRichTextRange
GetInternalSelectionRange() const { return m_selection
.GetRange(); }
1383 Sets the selection range in character positions. -2, -2 means no selection
1384 -1, -1 means select everything.
1385 The range is in internal format, i.e. a single character selection is denoted
1388 void SetInternalSelectionRange(const wxRichTextRange
& range
) { m_selection
.Set(range
, GetFocusObject()); }
1391 Adds a new paragraph of text to the end of the buffer.
1393 virtual wxRichTextRange
AddParagraph(const wxString
& text
);
1396 Adds an image to the control's buffer.
1398 virtual wxRichTextRange
AddImage(const wxImage
& image
);
1401 Lays out the buffer, which must be done before certain operations, such as
1402 setting the caret position.
1403 This function should not normally be required by the application.
1405 virtual bool LayoutContent(bool onlyVisibleRect
= false);
1408 Move the caret to the given character position.
1410 Please note that this does not update the current editing style
1411 from the new position; to do that, call wxRichTextCtrl::SetInsertionPoint instead.
1413 virtual bool MoveCaret(long pos
, bool showAtLineStart
= false, wxRichTextParagraphLayoutBox
* container
= NULL
);
1418 virtual bool MoveRight(int noPositions
= 1, int flags
= 0);
1423 virtual bool MoveLeft(int noPositions
= 1, int flags
= 0);
1426 Moves to the start of the paragraph.
1428 virtual bool MoveUp(int noLines
= 1, int flags
= 0);
1431 Moves the caret down.
1433 virtual bool MoveDown(int noLines
= 1, int flags
= 0);
1436 Moves to the end of the line.
1438 virtual bool MoveToLineEnd(int flags
= 0);
1441 Moves to the start of the line.
1443 virtual bool MoveToLineStart(int flags
= 0);
1446 Moves to the end of the paragraph.
1448 virtual bool MoveToParagraphEnd(int flags
= 0);
1451 Moves to the start of the paragraph.
1453 virtual bool MoveToParagraphStart(int flags
= 0);
1456 Moves to the start of the buffer.
1458 virtual bool MoveHome(int flags
= 0);
1461 Moves to the end of the buffer.
1463 virtual bool MoveEnd(int flags
= 0);
1466 Moves one or more pages up.
1468 virtual bool PageUp(int noPages
= 1, int flags
= 0);
1471 Moves one or more pages down.
1473 virtual bool PageDown(int noPages
= 1, int flags
= 0);
1476 Moves a number of words to the left.
1478 virtual bool WordLeft(int noPages
= 1, int flags
= 0);
1481 Move a nuber of words to the right.
1483 virtual bool WordRight(int noPages
= 1, int flags
= 0);
1487 Returns the buffer associated with the control.
1489 wxRichTextBuffer
& GetBuffer() { return m_buffer
; }
1490 const wxRichTextBuffer
& GetBuffer() const { return m_buffer
; }
1494 Starts batching undo history for commands.
1496 virtual bool BeginBatchUndo(const wxString
& cmdName
) { return m_buffer
.BeginBatchUndo(cmdName
); }
1499 Ends batching undo command history.
1501 virtual bool EndBatchUndo() { return m_buffer
.EndBatchUndo(); }
1504 Returns @true if undo commands are being batched.
1506 virtual bool BatchingUndo() const { return m_buffer
.BatchingUndo(); }
1509 Starts suppressing undo history for commands.
1511 virtual bool BeginSuppressUndo() { return m_buffer
.BeginSuppressUndo(); }
1514 Ends suppressing undo command history.
1516 virtual bool EndSuppressUndo() { return m_buffer
.EndSuppressUndo(); }
1519 Returns @true if undo history suppression is on.
1521 virtual bool SuppressingUndo() const { return m_buffer
.SuppressingUndo(); }
1524 Test if this whole range has character attributes of the specified kind.
1525 If any of the attributes are different within the range, the test fails.
1527 You can use this to implement, for example, bold button updating.
1528 @a style must have flags indicating which attributes are of interest.
1530 virtual bool HasCharacterAttributes(const wxRichTextRange
& range
, const wxRichTextAttr
& style
) const
1532 return GetBuffer().HasCharacterAttributes(range
.ToInternal(), style
);
1536 Test if this whole range has paragraph attributes of the specified kind.
1537 If any of the attributes are different within the range, the test fails.
1538 You can use this to implement, for example, centering button updating.
1539 @a style must have flags indicating which attributes are of interest.
1541 virtual bool HasParagraphAttributes(const wxRichTextRange
& range
, const wxRichTextAttr
& style
) const
1543 return GetBuffer().HasParagraphAttributes(range
.ToInternal(), style
);
1547 Returns @true if all of the selection, or the content at the caret position, is bold.
1549 virtual bool IsSelectionBold();
1552 Returns @true if all of the selection, or the content at the caret position, is italic.
1554 virtual bool IsSelectionItalics();
1557 Returns @true if all of the selection, or the content at the caret position, is underlined.
1559 virtual bool IsSelectionUnderlined();
1562 Returns @true if all of the selection, or the content at the current caret position, has the supplied wxTextAttrEffects flag(s).
1564 virtual bool DoesSelectionHaveTextEffectFlag(int flag
);
1567 Returns @true if all of the selection, or the content at the caret position, is aligned according to the specified flag.
1569 virtual bool IsSelectionAligned(wxTextAttrAlignment alignment
);
1572 Apples bold to the selection or default style (undoable).
1574 virtual bool ApplyBoldToSelection();
1577 Applies italic to the selection or default style (undoable).
1579 virtual bool ApplyItalicToSelection();
1582 Applies underline to the selection or default style (undoable).
1584 virtual bool ApplyUnderlineToSelection();
1587 Applies one or more wxTextAttrEffects flags to the selection (undoable).
1588 If there is no selection, it is applied to the default style.
1590 virtual bool ApplyTextEffectToSelection(int flags
);
1593 Applies the given alignment to the selection or the default style (undoable).
1594 For alignment values, see wxTextAttr.
1596 virtual bool ApplyAlignmentToSelection(wxTextAttrAlignment alignment
);
1599 Applies the style sheet to the buffer, matching paragraph styles in the sheet
1600 against named styles in the buffer.
1602 This might be useful if the styles have changed.
1603 If @a sheet is @NULL, the sheet set with SetStyleSheet() is used.
1604 Currently this applies paragraph styles only.
1606 virtual bool ApplyStyle(wxRichTextStyleDefinition
* def
);
1609 Sets the style sheet associated with the control.
1610 A style sheet allows named character and paragraph styles to be applied.
1612 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
) { GetBuffer().SetStyleSheet(styleSheet
); }
1615 Returns the style sheet associated with the control, if any.
1616 A style sheet allows named character and paragraph styles to be applied.
1618 wxRichTextStyleSheet
* GetStyleSheet() const { return GetBuffer().GetStyleSheet(); }
1621 Push the style sheet to top of stack.
1623 bool PushStyleSheet(wxRichTextStyleSheet
* styleSheet
) { return GetBuffer().PushStyleSheet(styleSheet
); }
1626 Pops the style sheet from top of stack.
1628 wxRichTextStyleSheet
* PopStyleSheet() { return GetBuffer().PopStyleSheet(); }
1631 Applies the style sheet to the buffer, for example if the styles have changed.
1633 bool ApplyStyleSheet(wxRichTextStyleSheet
* styleSheet
= NULL
);
1636 Shows the given context menu, optionally adding appropriate property-editing commands for the current position in the object hierarchy.
1638 virtual bool ShowContextMenu(wxMenu
* menu
, const wxPoint
& pt
, bool addPropertyCommands
= true);
1641 Prepares the context menu, optionally adding appropriate property-editing commands.
1642 Returns the number of property commands added.
1644 virtual int PrepareContextMenu(wxMenu
* menu
, const wxPoint
& pt
, bool addPropertyCommands
= true);
1647 Returns @true if we can edit the object's properties via a GUI.
1649 virtual bool CanEditProperties(wxRichTextObject
* obj
) const { return obj
->CanEditProperties(); }
1652 Edits the object's properties via a GUI.
1654 virtual bool EditProperties(wxRichTextObject
* obj
, wxWindow
* parent
) { return obj
->EditProperties(parent
, & GetBuffer()); }
1657 Gets the object's properties menu label.
1659 virtual wxString
GetPropertiesMenuLabel(wxRichTextObject
* obj
) { return obj
->GetPropertiesMenuLabel(); }
1662 Prepares the content just before insertion (or after buffer reset). Called by the same function in wxRichTextBuffer.
1663 Currently is only called if undo mode is on.
1665 virtual void PrepareContent(wxRichTextParagraphLayoutBox
& WXUNUSED(container
)) {}
1668 Can we delete this range?
1669 Sends an event to the control.
1671 virtual bool CanDeleteRange(wxRichTextParagraphLayoutBox
& container
, const wxRichTextRange
& range
) const;
1674 Can we insert content at this position?
1675 Sends an event to the control.
1677 virtual bool CanInsertContent(wxRichTextParagraphLayoutBox
& container
, long pos
) const;
1682 Sends the event to the control.
1684 void Command(wxCommandEvent
& event
);
1687 Loads the first dropped file.
1689 void OnDropFiles(wxDropFilesEvent
& event
);
1691 void OnCaptureLost(wxMouseCaptureLostEvent
& event
);
1692 void OnSysColourChanged(wxSysColourChangedEvent
& event
);
1695 Standard handler for the wxID_CUT command.
1697 void OnCut(wxCommandEvent
& event
);
1700 Standard handler for the wxID_COPY command.
1702 void OnCopy(wxCommandEvent
& event
);
1705 Standard handler for the wxID_PASTE command.
1707 void OnPaste(wxCommandEvent
& event
);
1710 Standard handler for the wxID_UNDO command.
1712 void OnUndo(wxCommandEvent
& event
);
1715 Standard handler for the wxID_REDO command.
1717 void OnRedo(wxCommandEvent
& event
);
1720 Standard handler for the wxID_SELECTALL command.
1722 void OnSelectAll(wxCommandEvent
& event
);
1725 Standard handler for property commands.
1727 void OnProperties(wxCommandEvent
& event
);
1730 Standard handler for the wxID_CLEAR command.
1732 void OnClear(wxCommandEvent
& event
);
1735 Standard update handler for the wxID_CUT command.
1737 void OnUpdateCut(wxUpdateUIEvent
& event
);
1740 Standard update handler for the wxID_COPY command.
1742 void OnUpdateCopy(wxUpdateUIEvent
& event
);
1745 Standard update handler for the wxID_PASTE command.
1747 void OnUpdatePaste(wxUpdateUIEvent
& event
);
1750 Standard update handler for the wxID_UNDO command.
1752 void OnUpdateUndo(wxUpdateUIEvent
& event
);
1755 Standard update handler for the wxID_REDO command.
1757 void OnUpdateRedo(wxUpdateUIEvent
& event
);
1760 Standard update handler for the wxID_SELECTALL command.
1762 void OnUpdateSelectAll(wxUpdateUIEvent
& event
);
1765 Standard update handler for property commands.
1768 void OnUpdateProperties(wxUpdateUIEvent
& event
);
1771 Standard update handler for the wxID_CLEAR command.
1773 void OnUpdateClear(wxUpdateUIEvent
& event
);
1776 Shows a standard context menu with undo, redo, cut, copy, paste, clear, and
1777 select all commands.
1779 void OnContextMenu(wxContextMenuEvent
& event
);
1784 void OnPaint(wxPaintEvent
& event
);
1785 void OnEraseBackground(wxEraseEvent
& event
);
1788 void OnLeftClick(wxMouseEvent
& event
);
1791 void OnLeftUp(wxMouseEvent
& event
);
1794 void OnMoveMouse(wxMouseEvent
& event
);
1796 // Left-double-click
1797 void OnLeftDClick(wxMouseEvent
& event
);
1800 void OnMiddleClick(wxMouseEvent
& event
);
1803 void OnRightClick(wxMouseEvent
& event
);
1806 void OnChar(wxKeyEvent
& event
);
1809 void OnSize(wxSizeEvent
& event
);
1811 // Setting/losing focus
1812 void OnSetFocus(wxFocusEvent
& event
);
1813 void OnKillFocus(wxFocusEvent
& event
);
1815 // Idle-time processing
1816 void OnIdle(wxIdleEvent
& event
);
1819 void OnScroll(wxScrollWinEvent
& event
);
1822 Sets the font, and also the basic and default attributes
1823 (see wxRichTextCtrl::SetDefaultStyle).
1825 virtual bool SetFont(const wxFont
& font
);
1828 A helper function setting up scrollbars, for example after a resize.
1830 virtual void SetupScrollbars(bool atTop
= false);
1833 Helper function implementing keyboard navigation.
1835 virtual bool KeyboardNavigate(int keyCode
, int flags
);
1838 Paints the background.
1840 virtual void PaintBackground(wxDC
& dc
);
1843 Other user defined painting after everything else (i.e. all text) is painted.
1847 virtual void PaintAboveContent(wxDC
& WXUNUSED(dc
)) {}
1849 #if wxRICHTEXT_BUFFERED_PAINTING
1851 Recreates the buffer bitmap if necessary.
1853 virtual bool RecreateBuffer(const wxSize
& size
= wxDefaultSize
);
1857 virtual void DoWriteText(const wxString
& value
, int flags
= 0);
1859 // Should we inherit colours?
1860 virtual bool ShouldInheritColours() const { return false; }
1863 Internal function to position the visible caret according to the current caret
1866 virtual void PositionCaret(wxRichTextParagraphLayoutBox
* container
= NULL
);
1869 Helper function for extending the selection, returning @true if the selection
1870 was changed. Selections are in caret positions.
1872 virtual bool ExtendSelection(long oldPosition
, long newPosition
, int flags
);
1875 Scrolls @a position into view. This function takes a caret position.
1877 virtual bool ScrollIntoView(long position
, int keyCode
);
1880 Refreshes the area affected by a selection change.
1882 bool RefreshForSelectionChange(const wxRichTextSelection
& oldSelection
, const wxRichTextSelection
& newSelection
);
1885 Sets the caret position.
1887 The caret position is the character position just before the caret.
1888 A value of -1 means the caret is at the start of the buffer.
1889 Please note that this does not update the current editing style
1890 from the new position or cause the actual caret to be refreshed; to do that,
1891 call wxRichTextCtrl::SetInsertionPoint instead.
1893 void SetCaretPosition(long position
, bool showAtLineStart
= false) ;
1896 Returns the current caret position.
1898 long GetCaretPosition() const { return m_caretPosition
; }
1901 The adjusted caret position is the character position adjusted to take
1902 into account whether we're at the start of a paragraph, in which case
1903 style information should be taken from the next position, not current one.
1905 long GetAdjustedCaretPosition(long caretPos
) const;
1908 Move the caret one visual step forward: this may mean setting a flag
1909 and keeping the same position if we're going from the end of one line
1910 to the start of the next, which may be the exact same caret position.
1912 void MoveCaretForward(long oldPosition
) ;
1915 Move the caret one visual step forward: this may mean setting a flag
1916 and keeping the same position if we're going from the end of one line
1917 to the start of the next, which may be the exact same caret position.
1919 void MoveCaretBack(long oldPosition
) ;
1922 Returns the caret height and position for the given character position.
1923 If container is null, the current focus object will be used.
1926 In wxPerl this method is implemented as
1927 GetCaretPositionForIndex(@a position) returning a
1928 2-element list (ok, rect).
1931 bool GetCaretPositionForIndex(long position
, wxRect
& rect
, wxRichTextParagraphLayoutBox
* container
= NULL
);
1934 Internal helper function returning the line for the visible caret position.
1935 If the caret is shown at the very end of the line, it means the next character
1936 is actually on the following line.
1937 So this function gets the line we're expecting to find if this is the case.
1939 wxRichTextLine
* GetVisibleLineForCaretPosition(long caretPosition
) const;
1942 Gets the command processor associated with the control's buffer.
1944 wxCommandProcessor
* GetCommandProcessor() const { return GetBuffer().GetCommandProcessor(); }
1947 Deletes content if there is a selection, e.g. when pressing a key.
1948 Returns the new caret position in @e newPos, or leaves it if there
1949 was no action. This is undoable.
1952 In wxPerl this method takes no arguments and returns a 2-element
1956 bool DeleteSelectedContent(long* newPos
= NULL
);
1959 Transforms logical (unscrolled) position to physical window position.
1961 wxPoint
GetPhysicalPoint(const wxPoint
& ptLogical
) const;
1964 Transforms physical window position to logical (unscrolled) position.
1966 wxPoint
GetLogicalPoint(const wxPoint
& ptPhysical
) const;
1969 Helper function for finding the caret position for the next word.
1970 Direction is 1 (forward) or -1 (backwards).
1972 virtual long FindNextWordPosition(int direction
= 1) const;
1975 Returns @true if the given position is visible on the screen.
1977 bool IsPositionVisible(long pos
) const;
1980 Returns the first visible position in the current view.
1982 long GetFirstVisiblePosition() const;
1985 Returns the caret position since the default formatting was changed. As
1986 soon as this position changes, we no longer reflect the default style
1987 in the UI. A value of -2 means that we should only reflect the style of the
1988 content under the caret.
1990 long GetCaretPositionForDefaultStyle() const { return m_caretPositionForDefaultStyle
; }
1993 Set the caret position for the default style that the user is selecting.
1995 void SetCaretPositionForDefaultStyle(long pos
) { m_caretPositionForDefaultStyle
= pos
; }
1998 Returns @true if the user has recently set the default style without moving
1999 the caret, and therefore the UI needs to reflect the default style and not
2000 the style at the caret.
2002 Below is an example of code that uses this function to determine whether the UI
2003 should show that the current style is bold.
2005 @see SetAndShowDefaultStyle().
2007 bool IsDefaultStyleShowing() const { return m_caretPositionForDefaultStyle
!= -2; }
2010 Sets @a attr as the default style and tells the control that the UI should
2011 reflect this attribute until the user moves the caret.
2013 @see IsDefaultStyleShowing().
2015 void SetAndShowDefaultStyle(const wxRichTextAttr
& attr
)
2017 SetDefaultStyle(attr
);
2018 SetCaretPositionForDefaultStyle(GetCaretPosition());
2022 Returns the first visible point in the window.
2024 wxPoint
GetFirstVisiblePoint() const;
2028 Returns the content of the entire control as a string.
2030 virtual wxString
GetValue() const;
2033 Replaces existing content with the given text.
2035 virtual void SetValue(const wxString
& value
);
2038 Call this function to prevent refresh and allow fast updates, and then Thaw() to
2039 refresh the control.
2044 Call this function to end a Freeze and refresh the display.
2049 Returns @true if Freeze has been called without a Thaw.
2051 bool IsFrozen() const;
2058 Sets up the caret for the given position and container, after a mouse click.
2060 bool SetCaretPositionAfterClick(wxRichTextParagraphLayoutBox
* container
, long position
, int hitTestFlags
, bool extendSelection
= false);
2063 Find the caret position for the combination of hit-test flags and character position.
2064 Returns the caret position and also an indication of where to place the caret (caretLineStart)
2065 since this is ambiguous (same position used for end of line and start of next).
2067 long FindCaretPositionForCharacterPosition(long position
, int hitTestFlags
, wxRichTextParagraphLayoutBox
* container
,
2068 bool& caretLineStart
);
2071 Processes mouse movement in order to change the cursor
2073 virtual bool ProcessMouseMovement(wxRichTextParagraphLayoutBox
* container
, wxRichTextObject
* obj
, long position
, const wxPoint
& pos
);
2076 Font names take a long time to retrieve, so cache them (on demand).
2078 static const wxArrayString
& GetAvailableFontNames();
2081 Clears the cache of available font names.
2083 static void ClearAvailableFontNames();
2085 WX_FORWARD_TO_SCROLL_HELPER()
2087 // implement wxTextEntry methods
2088 virtual wxString
DoGetValue() const;
2091 // implement the wxTextEntry pure virtual method
2092 virtual wxWindow
*GetEditableWindow() { return this; }
2094 // margins functions
2095 virtual bool DoSetMargins(const wxPoint
& pt
);
2096 virtual wxPoint
DoGetMargins() const;
2098 // FIXME: this does not work, it allows this code to compile but will fail
2100 #ifndef __WXUNIVERSAL__
2102 virtual WXHWND
GetEditHWND() const { return GetHWND(); }
2105 virtual WXWidget
GetTextWidget() const { return NULL
; }
2108 virtual GtkEditable
*GetEditable() const { return NULL
; }
2109 virtual GtkEntry
*GetEntry() const { return NULL
; }
2111 #endif // !__WXUNIVERSAL__
2117 Currently this simply returns @c wxSize(10, 10).
2119 virtual wxSize
DoGetBestSize() const ;
2121 virtual void DoSetValue(const wxString
& value
, int flags
= 0);
2123 virtual void DoThaw();
2128 #if wxRICHTEXT_BUFFERED_PAINTING
2130 wxBitmap m_bufferBitmap
;
2134 wxRichTextBuffer m_buffer
;
2136 wxMenu
* m_contextMenu
;
2138 /// Caret position (1 less than the character position, so -1 is the
2139 /// first caret position).
2140 long m_caretPosition
;
2142 /// Caret position when the default formatting has been changed. As
2143 /// soon as this position changes, we no longer reflect the default style
2145 long m_caretPositionForDefaultStyle
;
2147 /// Selection range in character positions. -2, -2 means no selection.
2148 wxRichTextSelection m_selection
;
2150 wxRichTextCtrlSelectionState m_selectionState
;
2152 /// Anchor so we know how to extend the selection
2153 /// It's a caret position since it's between two characters.
2154 long m_selectionAnchor
;
2156 /// Anchor object if selecting multiple container objects, such as grid cells.
2157 wxRichTextObject
* m_selectionAnchorObject
;
2159 /// Are we editable?
2162 /// Are we showing the caret position at the start of a line
2163 /// instead of at the end of the previous one?
2164 bool m_caretAtLineStart
;
2166 /// Are we dragging (i.e. extending) a selection?
2169 #if wxUSE_DRAG_AND_DROP
2170 /// Are we trying to start Drag'n'Drop?
2173 /// Initial position when starting Drag'n'Drop
2174 wxPoint m_dragStartPoint
;
2177 /// Initial time when starting Drag'n'Drop
2178 wxDateTime m_dragStartTime
;
2179 #endif // wxUSE_DATETIME
2180 #endif // wxUSE_DRAG_AND_DROP
2182 /// Do we need full layout in idle?
2183 bool m_fullLayoutRequired
;
2184 wxLongLong m_fullLayoutTime
;
2185 long m_fullLayoutSavedPosition
;
2187 /// Threshold for doing delayed layout
2188 long m_delayedLayoutThreshold
;
2191 wxCursor m_textCursor
;
2192 wxCursor m_urlCursor
;
2194 static wxArrayString sm_availableFontNames
;
2196 wxRichTextContextMenuPropertiesInfo m_contextMenuPropertiesInfo
;
2198 /// The object that currently has the editing focus
2199 wxRichTextParagraphLayoutBox
* m_focusObject
;
2202 #if wxUSE_DRAG_AND_DROP
2203 class WXDLLIMPEXP_RICHTEXT wxRichTextDropSource
: public wxDropSource
2206 wxRichTextDropSource(wxDataObject
& data
, wxRichTextCtrl
* tc
)
2207 : wxDropSource(data
, tc
), m_rtc(tc
) {}
2210 bool GiveFeedback(wxDragResult effect
);
2212 wxRichTextCtrl
* m_rtc
;
2215 class WXDLLIMPEXP_RICHTEXT wxRichTextDropTarget
: public wxDropTarget
2218 wxRichTextDropTarget(wxRichTextCtrl
* tc
)
2219 : wxDropTarget(new wxRichTextBufferDataObject(new wxRichTextBuffer
)), m_rtc(tc
) {}
2221 virtual wxDragResult
OnData(wxCoord x
, wxCoord y
, wxDragResult def
)
2225 m_rtc
->OnDrop(x
, y
, def
, m_dataObject
);
2230 wxRichTextCtrl
* m_rtc
;
2232 #endif // wxUSE_DRAG_AND_DROP
2235 @class wxRichTextEvent
2237 This is the event class for wxRichTextCtrl notifications.
2239 @beginEventTable{wxRichTextEvent}
2240 @event{EVT_RICHTEXT_LEFT_CLICK(id, func)}
2241 Process a @c wxEVT_COMMAND_RICHTEXT_LEFT_CLICK event, generated when the user
2242 releases the left mouse button over an object.
2243 @event{EVT_RICHTEXT_RIGHT_CLICK(id, func)}
2244 Process a @c wxEVT_COMMAND_RICHTEXT_RIGHT_CLICK event, generated when the user
2245 releases the right mouse button over an object.
2246 @event{EVT_RICHTEXT_MIDDLE_CLICK(id, func)}
2247 Process a @c wxEVT_COMMAND_RICHTEXT_MIDDLE_CLICK event, generated when the user
2248 releases the middle mouse button over an object.
2249 @event{EVT_RICHTEXT_LEFT_DCLICK(id, func)}
2250 Process a @c wxEVT_COMMAND_RICHTEXT_LEFT_DCLICK event, generated when the user
2251 double-clicks an object.
2252 @event{EVT_RICHTEXT_RETURN(id, func)}
2253 Process a @c wxEVT_COMMAND_RICHTEXT_RETURN event, generated when the user
2254 presses the return key. Valid event functions: GetFlags, GetPosition.
2255 @event{EVT_RICHTEXT_CHARACTER(id, func)}
2256 Process a @c wxEVT_COMMAND_RICHTEXT_CHARACTER event, generated when the user
2257 presses a character key. Valid event functions: GetFlags, GetPosition, GetCharacter.
2258 @event{EVT_RICHTEXT_DELETE(id, func)}
2259 Process a @c wxEVT_COMMAND_RICHTEXT_DELETE event, generated when the user
2260 presses the backspace or delete key. Valid event functions: GetFlags, GetPosition.
2261 @event{EVT_RICHTEXT_RETURN(id, func)}
2262 Process a @c wxEVT_COMMAND_RICHTEXT_RETURN event, generated when the user
2263 presses the return key. Valid event functions: GetFlags, GetPosition.
2264 @event{EVT_RICHTEXT_STYLE_CHANGED(id, func)}
2265 Process a @c wxEVT_COMMAND_RICHTEXT_STYLE_CHANGED event, generated when
2266 styling has been applied to the control. Valid event functions: GetPosition, GetRange.
2267 @event{EVT_RICHTEXT_STYLESHEET_CHANGED(id, func)}
2268 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING event, generated
2269 when the control's stylesheet has changed, for example the user added,
2270 edited or deleted a style. Valid event functions: GetRange, GetPosition.
2271 @event{EVT_RICHTEXT_STYLESHEET_REPLACING(id, func)}
2272 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACING event, generated
2273 when the control's stylesheet is about to be replaced, for example when
2274 a file is loaded into the control.
2275 Valid event functions: Veto, GetOldStyleSheet, GetNewStyleSheet.
2276 @event{EVT_RICHTEXT_STYLESHEET_REPLACED(id, func)}
2277 Process a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACED event, generated
2278 when the control's stylesheet has been replaced, for example when a file
2279 is loaded into the control.
2280 Valid event functions: GetOldStyleSheet, GetNewStyleSheet.
2281 @event{EVT_RICHTEXT_CONTENT_INSERTED(id, func)}
2282 Process a @c wxEVT_COMMAND_RICHTEXT_CONTENT_INSERTED event, generated when
2283 content has been inserted into the control.
2284 Valid event functions: GetPosition, GetRange.
2285 @event{EVT_RICHTEXT_CONTENT_DELETED(id, func)}
2286 Process a @c wxEVT_COMMAND_RICHTEXT_CONTENT_DELETED event, generated when
2287 content has been deleted from the control.
2288 Valid event functions: GetPosition, GetRange.
2289 @event{EVT_RICHTEXT_BUFFER_RESET(id, func)}
2290 Process a @c wxEVT_COMMAND_RICHTEXT_BUFFER_RESET event, generated when the
2291 buffer has been reset by deleting all content.
2292 You can use this to set a default style for the first new paragraph.
2293 @event{EVT_RICHTEXT_SELECTION_CHANGED(id, func)}
2294 Process a @c wxEVT_COMMAND_RICHTEXT_SELECTION_CHANGED event, generated when the
2295 selection range has changed.
2296 @event{EVT_RICHTEXT_FOCUS_OBJECT_CHANGED(id, func)}
2297 Process a @c wxEVT_COMMAND_RICHTEXT_FOCUS_OBJECT_CHANGED event, generated when the
2298 current focus object has changed.
2301 @library{wxrichtext}
2302 @category{events,richtext}
2305 class WXDLLIMPEXP_RICHTEXT wxRichTextEvent
: public wxNotifyEvent
2312 The type of the event.
2314 Window identifier. The value @c wxID_ANY indicates a default value.
2316 wxRichTextEvent(wxEventType commandType
= wxEVT_NULL
, int winid
= 0)
2317 : wxNotifyEvent(commandType
, winid
),
2318 m_flags(0), m_position(-1), m_oldStyleSheet(NULL
), m_newStyleSheet(NULL
),
2319 m_char((wxChar
) 0), m_container(NULL
), m_oldContainer(NULL
)
2325 wxRichTextEvent(const wxRichTextEvent
& event
)
2326 : wxNotifyEvent(event
),
2327 m_flags(event
.m_flags
), m_position(-1),
2328 m_oldStyleSheet(event
.m_oldStyleSheet
), m_newStyleSheet(event
.m_newStyleSheet
),
2329 m_char((wxChar
) 0), m_container(event
.m_container
), m_oldContainer(event
.m_oldContainer
)
2333 Returns the buffer position at which the event occured.
2335 long GetPosition() const { return m_position
; }
2338 Sets the buffer position variable.
2340 void SetPosition(long pos
) { m_position
= pos
; }
2343 Returns flags indicating modifier keys pressed.
2345 Possible values are @c wxRICHTEXT_CTRL_DOWN, @c wxRICHTEXT_SHIFT_DOWN, and @c wxRICHTEXT_ALT_DOWN.
2347 int GetFlags() const { return m_flags
; }
2350 Sets flags indicating modifier keys pressed.
2352 Possible values are @c wxRICHTEXT_CTRL_DOWN, @c wxRICHTEXT_SHIFT_DOWN, and @c wxRICHTEXT_ALT_DOWN.
2354 void SetFlags(int flags
) { m_flags
= flags
; }
2357 Returns the old style sheet.
2359 Can be used in a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING or
2360 @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED event handler.
2362 wxRichTextStyleSheet
* GetOldStyleSheet() const { return m_oldStyleSheet
; }
2365 Sets the old style sheet variable.
2367 void SetOldStyleSheet(wxRichTextStyleSheet
* sheet
) { m_oldStyleSheet
= sheet
; }
2370 Returns the new style sheet.
2372 Can be used in a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING or
2373 @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED event handler.
2375 wxRichTextStyleSheet
* GetNewStyleSheet() const { return m_newStyleSheet
; }
2378 Sets the new style sheet variable.
2380 void SetNewStyleSheet(wxRichTextStyleSheet
* sheet
) { m_newStyleSheet
= sheet
; }
2383 Gets the range for the current operation.
2385 const wxRichTextRange
& GetRange() const { return m_range
; }
2388 Sets the range variable.
2390 void SetRange(const wxRichTextRange
& range
) { m_range
= range
; }
2393 Returns the character pressed, within a @c wxEVT_COMMAND_RICHTEXT_CHARACTER event.
2395 wxChar
GetCharacter() const { return m_char
; }
2398 Sets the character variable.
2400 void SetCharacter(wxChar ch
) { m_char
= ch
; }
2403 Returns the container for which the event is relevant.
2405 wxRichTextParagraphLayoutBox
* GetContainer() const { return m_container
; }
2408 Sets the container for which the event is relevant.
2410 void SetContainer(wxRichTextParagraphLayoutBox
* container
) { m_container
= container
; }
2413 Returns the old container, for a focus change event.
2415 wxRichTextParagraphLayoutBox
* GetOldContainer() const { return m_oldContainer
; }
2418 Sets the old container, for a focus change event.
2420 void SetOldContainer(wxRichTextParagraphLayoutBox
* container
) { m_oldContainer
= container
; }
2422 virtual wxEvent
*Clone() const { return new wxRichTextEvent(*this); }
2427 wxRichTextStyleSheet
* m_oldStyleSheet
;
2428 wxRichTextStyleSheet
* m_newStyleSheet
;
2429 wxRichTextRange m_range
;
2431 wxRichTextParagraphLayoutBox
* m_container
;
2432 wxRichTextParagraphLayoutBox
* m_oldContainer
;
2435 DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxRichTextEvent
)
2439 * wxRichTextCtrl events
2441 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_LEFT_CLICK
, wxRichTextEvent
);
2442 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_RIGHT_CLICK
, wxRichTextEvent
);
2443 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_MIDDLE_CLICK
, wxRichTextEvent
);
2444 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_LEFT_DCLICK
, wxRichTextEvent
);
2445 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_RETURN
, wxRichTextEvent
);
2446 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_CHARACTER
, wxRichTextEvent
);
2447 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_DELETE
, wxRichTextEvent
);
2449 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING
, wxRichTextEvent
);
2450 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED
, wxRichTextEvent
);
2451 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACING
, wxRichTextEvent
);
2452 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACED
, wxRichTextEvent
);
2454 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_CONTENT_INSERTED
, wxRichTextEvent
);
2455 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_CONTENT_DELETED
, wxRichTextEvent
);
2456 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_STYLE_CHANGED
, wxRichTextEvent
);
2457 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_PROPERTIES_CHANGED
, wxRichTextEvent
);
2458 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_SELECTION_CHANGED
, wxRichTextEvent
);
2459 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_BUFFER_RESET
, wxRichTextEvent
);
2460 wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_RICHTEXT
, wxEVT_COMMAND_RICHTEXT_FOCUS_OBJECT_CHANGED
, wxRichTextEvent
);
2462 typedef void (wxEvtHandler::*wxRichTextEventFunction
)(wxRichTextEvent
&);
2464 #define wxRichTextEventHandler(func) \
2465 wxEVENT_HANDLER_CAST(wxRichTextEventFunction, func)
2467 #define EVT_RICHTEXT_LEFT_CLICK(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_LEFT_CLICK, id, -1, wxRichTextEventHandler( fn ), NULL ),
2468 #define EVT_RICHTEXT_RIGHT_CLICK(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_RIGHT_CLICK, id, -1, wxRichTextEventHandler( fn ), NULL ),
2469 #define EVT_RICHTEXT_MIDDLE_CLICK(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_MIDDLE_CLICK, id, -1, wxRichTextEventHandler( fn ), NULL ),
2470 #define EVT_RICHTEXT_LEFT_DCLICK(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_LEFT_DCLICK, id, -1, wxRichTextEventHandler( fn ), NULL ),
2471 #define EVT_RICHTEXT_RETURN(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_RETURN, id, -1, wxRichTextEventHandler( fn ), NULL ),
2472 #define EVT_RICHTEXT_CHARACTER(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_CHARACTER, id, -1, wxRichTextEventHandler( fn ), NULL ),
2473 #define EVT_RICHTEXT_DELETE(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_DELETE, id, -1, wxRichTextEventHandler( fn ), NULL ),
2475 #define EVT_RICHTEXT_STYLESHEET_CHANGING(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING, id, -1, wxRichTextEventHandler( fn ), NULL ),
2476 #define EVT_RICHTEXT_STYLESHEET_CHANGED(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED, id, -1, wxRichTextEventHandler( fn ), NULL ),
2477 #define EVT_RICHTEXT_STYLESHEET_REPLACING(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACING, id, -1, wxRichTextEventHandler( fn ), NULL ),
2478 #define EVT_RICHTEXT_STYLESHEET_REPLACED(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_STYLESHEET_REPLACED, id, -1, wxRichTextEventHandler( fn ), NULL ),
2480 #define EVT_RICHTEXT_CONTENT_INSERTED(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_CONTENT_INSERTED, id, -1, wxRichTextEventHandler( fn ), NULL ),
2481 #define EVT_RICHTEXT_CONTENT_DELETED(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_CONTENT_DELETED, id, -1, wxRichTextEventHandler( fn ), NULL ),
2482 #define EVT_RICHTEXT_STYLE_CHANGED(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_STYLE_CHANGED, id, -1, wxRichTextEventHandler( fn ), NULL ),
2483 #define EVT_RICHTEXT_PROPERTIES_CHANGED(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_PROPERTIES_CHANGED, id, -1, wxRichTextEventHandler( fn ), NULL ),
2484 #define EVT_RICHTEXT_SELECTION_CHANGED(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_SELECTION_CHANGED, id, -1, wxRichTextEventHandler( fn ), NULL ),
2485 #define EVT_RICHTEXT_BUFFER_RESET(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_BUFFER_RESET, id, -1, wxRichTextEventHandler( fn ), NULL ),
2486 #define EVT_RICHTEXT_FOCUS_OBJECT_CHANGED(id, fn) wxDECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RICHTEXT_FOCUS_OBJECT_CHANGED, id, -1, wxRichTextEventHandler( fn ), NULL ),
2492 // _WX_RICHTEXTCTRL_H_