]>
Commit | Line | Data |
---|---|---|
1 | ///////////////////////////////////////////////////////////////////////////// | |
2 | // Name: wx/richtext/richtextctrl.h | |
3 | // Purpose: A rich edit control | |
4 | // Author: Julian Smart | |
5 | // Modified by: | |
6 | // Created: 2005-09-30 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) Julian Smart | |
9 | // Licence: wxWindows licence | |
10 | ///////////////////////////////////////////////////////////////////////////// | |
11 | ||
12 | /* | |
13 | * Styles and flags | |
14 | */ | |
15 | ||
16 | /** | |
17 | Styles | |
18 | */ | |
19 | ||
20 | #define wxRE_READONLY 0x0010 | |
21 | #define wxRE_MULTILINE 0x0020 | |
22 | #define wxRE_CENTRE_CARET 0x8000 | |
23 | #define wxRE_CENTER_CARET wxRE_CENTRE_CARET | |
24 | ||
25 | /** | |
26 | Flags | |
27 | */ | |
28 | ||
29 | #define wxRICHTEXT_SHIFT_DOWN 0x01 | |
30 | #define wxRICHTEXT_CTRL_DOWN 0x02 | |
31 | #define wxRICHTEXT_ALT_DOWN 0x04 | |
32 | ||
33 | /** | |
34 | Extra flags | |
35 | */ | |
36 | ||
37 | // Don't draw guide lines around boxes and tables | |
38 | #define wxRICHTEXT_EX_NO_GUIDELINES 0x00000100 | |
39 | ||
40 | ||
41 | /* | |
42 | Defaults | |
43 | */ | |
44 | ||
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 | |
59 | ||
60 | /* Identifiers | |
61 | */ | |
62 | #define wxID_RICHTEXT_PROPERTIES1 (wxID_HIGHEST + 1) | |
63 | #define wxID_RICHTEXT_PROPERTIES2 (wxID_HIGHEST + 2) | |
64 | #define wxID_RICHTEXT_PROPERTIES3 (wxID_HIGHEST + 3) | |
65 | ||
66 | /* | |
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. | |
70 | */ | |
71 | ||
72 | enum wxRichTextCtrlSelectionState | |
73 | { | |
74 | wxRichTextCtrlSelectionState_Normal, | |
75 | wxRichTextCtrlSelectionState_CommonAncestor | |
76 | }; | |
77 | ||
78 | /** | |
79 | @class wxRichTextContextMenuPropertiesInfo | |
80 | ||
81 | wxRichTextContextMenuPropertiesInfo keeps track of objects that appear in the context menu, | |
82 | whose properties are available to be edited. | |
83 | */ | |
84 | ||
85 | class WXDLLIMPEXP_RICHTEXT wxRichTextContextMenuPropertiesInfo | |
86 | { | |
87 | public: | |
88 | /** | |
89 | Constructor. | |
90 | */ | |
91 | wxRichTextContextMenuPropertiesInfo() { Init(); } | |
92 | ||
93 | // Operations | |
94 | ||
95 | /** | |
96 | Initialisation. | |
97 | */ | |
98 | void Init() {} | |
99 | ||
100 | /** | |
101 | Adds an item. | |
102 | */ | |
103 | bool AddItem(const wxString& label, wxRichTextObject* obj); | |
104 | ||
105 | /** | |
106 | Returns the number of menu items that were added. | |
107 | */ | |
108 | int AddMenuItems(wxMenu* menu, int startCmd = wxID_RICHTEXT_PROPERTIES1) const; | |
109 | ||
110 | /** | |
111 | Adds appropriate menu items for the current container and clicked on object | |
112 | (and container's parent, if appropriate). | |
113 | */ | |
114 | int AddItems(wxRichTextCtrl* ctrl, wxRichTextObject* container, wxRichTextObject* obj); | |
115 | ||
116 | /** | |
117 | Clears the items. | |
118 | */ | |
119 | void Clear() { m_objects.Clear(); m_labels.Clear(); } | |
120 | ||
121 | // Accessors | |
122 | ||
123 | /** | |
124 | Returns the nth label. | |
125 | */ | |
126 | wxString GetLabel(int n) const { return m_labels[n]; } | |
127 | ||
128 | /** | |
129 | Returns the nth object. | |
130 | */ | |
131 | wxRichTextObject* GetObject(int n) const { return m_objects[n]; } | |
132 | ||
133 | /** | |
134 | Returns the array of objects. | |
135 | */ | |
136 | wxRichTextObjectPtrArray& GetObjects() { return m_objects; } | |
137 | ||
138 | /** | |
139 | Returns the array of objects. | |
140 | */ | |
141 | const wxRichTextObjectPtrArray& GetObjects() const { return m_objects; } | |
142 | ||
143 | /** | |
144 | Returns the array of labels. | |
145 | */ | |
146 | wxArrayString& GetLabels() { return m_labels; } | |
147 | ||
148 | /** | |
149 | Returns the array of labels. | |
150 | */ | |
151 | const wxArrayString& GetLabels() const { return m_labels; } | |
152 | ||
153 | /** | |
154 | Returns the number of items. | |
155 | */ | |
156 | int GetCount() const { return m_objects.GetCount(); } | |
157 | ||
158 | wxRichTextObjectPtrArray m_objects; | |
159 | wxArrayString m_labels; | |
160 | }; | |
161 | ||
162 | /** | |
163 | @class wxRichTextCtrl | |
164 | ||
165 | wxRichTextCtrl provides a generic, ground-up implementation of a text control | |
166 | capable of showing multiple styles and images. | |
167 | ||
168 | wxRichTextCtrl sends notification events: see wxRichTextEvent. | |
169 | ||
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. | |
172 | ||
173 | For more information, see the @ref overview_richtextctrl. | |
174 | ||
175 | @beginStyleTable | |
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. | |
183 | @endStyleTable | |
184 | ||
185 | @library{wxrichtext} | |
186 | @category{richtext} | |
187 | @appearance{richtextctrl.png} | |
188 | ||
189 | */ | |
190 | ||
191 | class WXDLLIMPEXP_RICHTEXT wxRichTextCtrl : public wxControl, | |
192 | public wxTextCtrlIface, | |
193 | public wxScrollHelper | |
194 | { | |
195 | DECLARE_CLASS( wxRichTextCtrl ) | |
196 | DECLARE_EVENT_TABLE() | |
197 | ||
198 | public: | |
199 | // Constructors | |
200 | ||
201 | /** | |
202 | Default constructor. | |
203 | */ | |
204 | wxRichTextCtrl( ); | |
205 | ||
206 | /** | |
207 | Constructor, creating and showing a rich text control. | |
208 | ||
209 | @param parent | |
210 | Parent window. Must not be @NULL. | |
211 | @param id | |
212 | Window identifier. The value @c wxID_ANY indicates a default value. | |
213 | @param value | |
214 | Default string. | |
215 | @param pos | |
216 | Window position. | |
217 | @param size | |
218 | Window size. | |
219 | @param style | |
220 | Window style. | |
221 | @param validator | |
222 | Window validator. | |
223 | @param name | |
224 | Window name. | |
225 | ||
226 | @see Create(), wxValidator | |
227 | */ | |
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); | |
230 | ||
231 | /** | |
232 | Destructor. | |
233 | */ | |
234 | virtual ~wxRichTextCtrl( ); | |
235 | ||
236 | // Operations | |
237 | ||
238 | /** | |
239 | Creates the underlying window. | |
240 | */ | |
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 ); | |
243 | ||
244 | /** | |
245 | Initialises the members of the control. | |
246 | */ | |
247 | void Init(); | |
248 | ||
249 | // Accessors | |
250 | ||
251 | /** | |
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. | |
255 | */ | |
256 | virtual wxString GetRange(long from, long to) const; | |
257 | ||
258 | /** | |
259 | Returns the length of the specified line in characters. | |
260 | */ | |
261 | virtual int GetLineLength(long lineNo) const ; | |
262 | ||
263 | /** | |
264 | Returns the text for the given line. | |
265 | */ | |
266 | virtual wxString GetLineText(long lineNo) const ; | |
267 | ||
268 | /** | |
269 | Returns the number of lines in the buffer. | |
270 | */ | |
271 | virtual int GetNumberOfLines() const ; | |
272 | ||
273 | /** | |
274 | Returns @true if the buffer has been modified. | |
275 | */ | |
276 | virtual bool IsModified() const ; | |
277 | ||
278 | /** | |
279 | Returns @true if the control is editable. | |
280 | */ | |
281 | virtual bool IsEditable() const ; | |
282 | ||
283 | /** | |
284 | Returns @true if the control is single-line. | |
285 | Currently wxRichTextCtrl does not support single-line editing. | |
286 | */ | |
287 | bool IsSingleLine() const { return !HasFlag(wxRE_MULTILINE); } | |
288 | ||
289 | /** | |
290 | Returns @true if the control is multiline. | |
291 | */ | |
292 | bool IsMultiLine() const { return !IsSingleLine(); } | |
293 | ||
294 | //@{ | |
295 | /** | |
296 | Returns the range of the current selection. | |
297 | The end point of range is specified as the last character position of the span | |
298 | of text, plus one. | |
299 | If the return values @a from and @a to are the same, there is no selection. | |
300 | */ | |
301 | virtual void GetSelection(long* from, long* to) const; | |
302 | const wxRichTextSelection& GetSelection() const { return m_selection; } | |
303 | wxRichTextSelection& GetSelection() { return m_selection; } | |
304 | //@} | |
305 | ||
306 | /** | |
307 | Returns the text within the current selection range, if any. | |
308 | */ | |
309 | virtual wxString GetStringSelection() const; | |
310 | ||
311 | /** | |
312 | Gets the current filename associated with the control. | |
313 | */ | |
314 | wxString GetFilename() const { return m_filename; } | |
315 | ||
316 | /** | |
317 | Sets the current filename. | |
318 | */ | |
319 | void SetFilename(const wxString& filename) { m_filename = filename; } | |
320 | ||
321 | /** | |
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. | |
324 | */ | |
325 | void SetDelayedLayoutThreshold(long threshold) { m_delayedLayoutThreshold = threshold; } | |
326 | ||
327 | /** | |
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. | |
330 | */ | |
331 | long GetDelayedLayoutThreshold() const { return m_delayedLayoutThreshold; } | |
332 | ||
333 | /** | |
334 | */ | |
335 | bool GetFullLayoutRequired() const { return m_fullLayoutRequired; } | |
336 | ||
337 | /** | |
338 | */ | |
339 | void SetFullLayoutRequired(bool b) { m_fullLayoutRequired = b; } | |
340 | ||
341 | /** | |
342 | */ | |
343 | wxLongLong GetFullLayoutTime() const { return m_fullLayoutTime; } | |
344 | ||
345 | /** | |
346 | */ | |
347 | void SetFullLayoutTime(wxLongLong t) { m_fullLayoutTime = t; } | |
348 | ||
349 | /** | |
350 | */ | |
351 | long GetFullLayoutSavedPosition() const { return m_fullLayoutSavedPosition; } | |
352 | ||
353 | /** | |
354 | */ | |
355 | void SetFullLayoutSavedPosition(long p) { m_fullLayoutSavedPosition = p; } | |
356 | ||
357 | // Force any pending layout due to large buffer | |
358 | /** | |
359 | */ | |
360 | void ForceDelayedLayout(); | |
361 | ||
362 | /** | |
363 | Sets the text (normal) cursor. | |
364 | */ | |
365 | void SetTextCursor(const wxCursor& cursor ) { m_textCursor = cursor; } | |
366 | ||
367 | /** | |
368 | Returns the text (normal) cursor. | |
369 | */ | |
370 | wxCursor GetTextCursor() const { return m_textCursor; } | |
371 | ||
372 | /** | |
373 | Sets the cursor to be used over URLs. | |
374 | */ | |
375 | void SetURLCursor(const wxCursor& cursor ) { m_urlCursor = cursor; } | |
376 | ||
377 | /** | |
378 | Returns the cursor to be used over URLs. | |
379 | */ | |
380 | wxCursor GetURLCursor() const { return m_urlCursor; } | |
381 | ||
382 | /** | |
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. | |
385 | */ | |
386 | bool GetCaretAtLineStart() const { return m_caretAtLineStart; } | |
387 | ||
388 | /** | |
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. | |
391 | */ | |
392 | void SetCaretAtLineStart(bool atStart) { m_caretAtLineStart = atStart; } | |
393 | ||
394 | /** | |
395 | Returns @true if we are extending a selection. | |
396 | */ | |
397 | bool GetDragging() const { return m_dragging; } | |
398 | ||
399 | /** | |
400 | Sets a flag to remember if we are extending a selection. | |
401 | */ | |
402 | void SetDragging(bool dragging) { m_dragging = dragging; } | |
403 | ||
404 | /** | |
405 | Are we trying to start Drag'n'Drop? | |
406 | */ | |
407 | bool GetPreDrag() const { return m_preDrag; } | |
408 | ||
409 | /** | |
410 | Set if we're trying to start Drag'n'Drop | |
411 | */ | |
412 | void SetPreDrag(bool pd) { m_preDrag = pd; } | |
413 | ||
414 | /** | |
415 | Get the possible Drag'n'Drop start point | |
416 | */ | |
417 | const wxPoint GetDragStartPoint() const { return m_dragStartPoint; } | |
418 | ||
419 | /** | |
420 | Set the possible Drag'n'Drop start point | |
421 | */ | |
422 | void SetDragStartPoint(wxPoint sp) { m_dragStartPoint = sp; } | |
423 | ||
424 | /** | |
425 | Get the possible Drag'n'Drop start time | |
426 | */ | |
427 | const wxDateTime GetDragStartTime() const { return m_dragStartTime; } | |
428 | ||
429 | /** | |
430 | Set the possible Drag'n'Drop start time | |
431 | */ | |
432 | void SetDragStartTime(wxDateTime st) { m_dragStartTime = st; } | |
433 | ||
434 | #if wxRICHTEXT_BUFFERED_PAINTING | |
435 | //@{ | |
436 | /** | |
437 | Returns the buffer bitmap if using buffered painting. | |
438 | */ | |
439 | const wxBitmap& GetBufferBitmap() const { return m_bufferBitmap; } | |
440 | wxBitmap& GetBufferBitmap() { return m_bufferBitmap; } | |
441 | //@} | |
442 | #endif | |
443 | ||
444 | /** | |
445 | Returns the current context menu. | |
446 | */ | |
447 | wxMenu* GetContextMenu() const { return m_contextMenu; } | |
448 | ||
449 | /** | |
450 | Sets the current context menu. | |
451 | */ | |
452 | void SetContextMenu(wxMenu* menu); | |
453 | ||
454 | /** | |
455 | Returns an anchor so we know how to extend the selection. | |
456 | It's a caret position since it's between two characters. | |
457 | */ | |
458 | long GetSelectionAnchor() const { return m_selectionAnchor; } | |
459 | ||
460 | /** | |
461 | Sets an anchor so we know how to extend the selection. | |
462 | It's a caret position since it's between two characters. | |
463 | */ | |
464 | void SetSelectionAnchor(long anchor) { m_selectionAnchor = anchor; } | |
465 | ||
466 | /** | |
467 | Returns the anchor object if selecting multiple containers. | |
468 | */ | |
469 | wxRichTextObject* GetSelectionAnchorObject() const { return m_selectionAnchorObject; } | |
470 | ||
471 | /** | |
472 | Sets the anchor object if selecting multiple containers. | |
473 | */ | |
474 | void SetSelectionAnchorObject(wxRichTextObject* anchor) { m_selectionAnchorObject = anchor; } | |
475 | ||
476 | //@{ | |
477 | /** | |
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. | |
483 | */ | |
484 | wxRichTextContextMenuPropertiesInfo& GetContextMenuPropertiesInfo() { return m_contextMenuPropertiesInfo; } | |
485 | const wxRichTextContextMenuPropertiesInfo& GetContextMenuPropertiesInfo() const { return m_contextMenuPropertiesInfo; } | |
486 | //@} | |
487 | ||
488 | /** | |
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. | |
491 | */ | |
492 | wxRichTextParagraphLayoutBox* GetFocusObject() const { return m_focusObject; } | |
493 | ||
494 | /** | |
495 | Setter for m_focusObject. | |
496 | */ | |
497 | void StoreFocusObject(wxRichTextParagraphLayoutBox* obj); | |
498 | ||
499 | /** | |
500 | Sets the wxRichTextObject object that currently has the editing focus. | |
501 | @param setCaretPosition | |
502 | Optionally set the caret position. | |
503 | */ | |
504 | bool SetFocusObject(wxRichTextParagraphLayoutBox* obj, bool setCaretPosition = true); | |
505 | ||
506 | // Operations | |
507 | ||
508 | /** | |
509 | Invalidates the whole buffer to trigger painting later. | |
510 | */ | |
511 | void Invalidate() { GetBuffer().Invalidate(wxRICHTEXT_ALL); } | |
512 | ||
513 | /** | |
514 | Clears the buffer content, leaving a single empty paragraph. Cannot be undone. | |
515 | */ | |
516 | virtual void Clear(); | |
517 | ||
518 | /** | |
519 | Replaces the content in the specified range with the string specified by | |
520 | @a value. | |
521 | */ | |
522 | virtual void Replace(long from, long to, const wxString& value); | |
523 | ||
524 | /** | |
525 | Removes the content in the specified range. | |
526 | */ | |
527 | virtual void Remove(long from, long to); | |
528 | ||
529 | #ifdef DOXYGEN | |
530 | /** | |
531 | Loads content into the control's buffer using the given type. | |
532 | ||
533 | If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from | |
534 | the filename extension. | |
535 | ||
536 | This function looks for a suitable wxRichTextFileHandler object. | |
537 | */ | |
538 | bool LoadFile(const wxString& file, | |
539 | int type = wxRICHTEXT_TYPE_ANY); | |
540 | #endif | |
541 | ||
542 | /** | |
543 | Helper function for LoadFile(). Loads content into the control's buffer using the given type. | |
544 | ||
545 | If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from | |
546 | the filename extension. | |
547 | ||
548 | This function looks for a suitable wxRichTextFileHandler object. | |
549 | */ | |
550 | virtual bool DoLoadFile(const wxString& file, int fileType); | |
551 | ||
552 | #ifdef DOXYGEN | |
553 | /** | |
554 | Saves the buffer content using the given type. | |
555 | ||
556 | If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from | |
557 | the filename extension. | |
558 | ||
559 | This function looks for a suitable wxRichTextFileHandler object. | |
560 | */ | |
561 | bool SaveFile(const wxString& file = wxEmptyString, | |
562 | int type = wxRICHTEXT_TYPE_ANY); | |
563 | #endif | |
564 | ||
565 | /** | |
566 | Helper function for SaveFile(). Saves the buffer content using the given type. | |
567 | ||
568 | If the specified type is wxRICHTEXT_TYPE_ANY, the type is deduced from | |
569 | the filename extension. | |
570 | ||
571 | This function looks for a suitable wxRichTextFileHandler object. | |
572 | */ | |
573 | virtual bool DoSaveFile(const wxString& file = wxEmptyString, | |
574 | int fileType = wxRICHTEXT_TYPE_ANY); | |
575 | ||
576 | /** | |
577 | Sets flags that change the behaviour of loading or saving. | |
578 | ||
579 | See the documentation for each handler class to see what flags are | |
580 | relevant for each handler. | |
581 | */ | |
582 | void SetHandlerFlags(int flags) { GetBuffer().SetHandlerFlags(flags); } | |
583 | ||
584 | /** | |
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. | |
588 | */ | |
589 | int GetHandlerFlags() const { return GetBuffer().GetHandlerFlags(); } | |
590 | ||
591 | /** | |
592 | Marks the buffer as modified. | |
593 | */ | |
594 | virtual void MarkDirty(); | |
595 | ||
596 | /** | |
597 | Sets the buffer's modified status to @false, and clears the buffer's command | |
598 | history. | |
599 | */ | |
600 | virtual void DiscardEdits(); | |
601 | ||
602 | /** | |
603 | Sets the maximum number of characters that may be entered in a single line | |
604 | text control. For compatibility only; currently does nothing. | |
605 | */ | |
606 | virtual void SetMaxLength(unsigned long WXUNUSED(len)) { } | |
607 | ||
608 | /** | |
609 | Writes text at the current position. | |
610 | */ | |
611 | virtual void WriteText(const wxString& text); | |
612 | ||
613 | /** | |
614 | Sets the insertion point to the end of the buffer and writes the text. | |
615 | */ | |
616 | virtual void AppendText(const wxString& text); | |
617 | ||
618 | //@{ | |
619 | /** | |
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 | |
623 | style attributes. | |
624 | ||
625 | To get the character or paragraph style alone, use GetUncombinedStyle(). | |
626 | ||
627 | @beginWxPerlOnly | |
628 | In wxPerl this method is implemented as GetStyle(@a position) | |
629 | returning a 2-element list (ok, attr). | |
630 | @endWxPerlOnly | |
631 | */ | |
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); | |
635 | //@} | |
636 | ||
637 | //@{ | |
638 | /** | |
639 | Sets the attributes for the given range. | |
640 | The end point of range is specified as the last character position of the span | |
641 | of text, plus one. | |
642 | ||
643 | So, for example, to set the style for a character at position 5, use the range | |
644 | (5,6). | |
645 | */ | |
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); | |
650 | //@} | |
651 | ||
652 | /** | |
653 | Sets the attributes for a single object | |
654 | */ | |
655 | virtual void SetStyle(wxRichTextObject *obj, const wxRichTextAttr& textAttr); | |
656 | ||
657 | //@{ | |
658 | /** | |
659 | Gets the attributes common to the specified range. | |
660 | Attributes that differ in value within the range will not be included | |
661 | in @a style flags. | |
662 | ||
663 | @beginWxPerlOnly | |
664 | In wxPerl this method is implemented as GetStyleForRange(@a position) | |
665 | returning a 2-element list (ok, attr). | |
666 | @endWxPerlOnly | |
667 | */ | |
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); | |
671 | //@} | |
672 | ||
673 | /** | |
674 | Sets the attributes for the given range, passing flags to determine how the | |
675 | attributes are set. | |
676 | ||
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). | |
680 | ||
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 | |
684 | undoable. | |
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 | |
696 | the new style. | |
697 | - wxRICHTEXT_SETSTYLE_REMOVE: removes the specified style. Only the style flags | |
698 | are used in this operation. | |
699 | */ | |
700 | virtual bool SetStyleEx(const wxRichTextRange& range, const wxRichTextAttr& style, int flags = wxRICHTEXT_SETSTYLE_WITH_UNDO); | |
701 | ||
702 | //@{ | |
703 | /** | |
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(). | |
709 | ||
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. | |
713 | ||
714 | @beginWxPerlOnly | |
715 | In wxPerl this method is implemented as GetUncombinedStyle(@a position) | |
716 | returning a 2-element list (ok, attr). | |
717 | @endWxPerlOnly | |
718 | */ | |
719 | virtual bool GetUncombinedStyle(long position, wxRichTextAttr& style); | |
720 | virtual bool GetUncombinedStyle(long position, wxRichTextAttr& style, wxRichTextParagraphLayoutBox* container); | |
721 | //@} | |
722 | ||
723 | //@{ | |
724 | /** | |
725 | Sets the current default style, which can be used to change how subsequently | |
726 | inserted text is displayed. | |
727 | */ | |
728 | virtual bool SetDefaultStyle(const wxTextAttr& style); | |
729 | virtual bool SetDefaultStyle(const wxRichTextAttr& style); | |
730 | //@} | |
731 | ||
732 | /** | |
733 | Returns the current default style, which can be used to change how subsequently | |
734 | inserted text is displayed. | |
735 | */ | |
736 | virtual const wxRichTextAttr& GetDefaultStyleEx() const; | |
737 | ||
738 | //virtual const wxTextAttr& GetDefaultStyle() const; | |
739 | ||
740 | //@{ | |
741 | /** | |
742 | Sets the list attributes for the given range, passing flags to determine how | |
743 | the attributes are set. | |
744 | ||
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. | |
753 | ||
754 | @see NumberList(), PromoteList(), ClearListStyle(). | |
755 | */ | |
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); | |
758 | //@} | |
759 | ||
760 | /** | |
761 | Clears the list style from the given range, clearing list-related attributes | |
762 | and applying any named paragraph style associated with each paragraph. | |
763 | ||
764 | @a flags is a bit list of the following: | |
765 | - wxRICHTEXT_SETSTYLE_WITH_UNDO: specifies that this command will be undoable. | |
766 | ||
767 | @see SetListStyle(), PromoteList(), NumberList(). | |
768 | */ | |
769 | virtual bool ClearListStyle(const wxRichTextRange& range, int flags = wxRICHTEXT_SETSTYLE_WITH_UNDO); | |
770 | ||
771 | //@{ | |
772 | /** | |
773 | Numbers the paragraphs in the given range. | |
774 | Pass flags to determine how the attributes are set. | |
775 | ||
776 | Either the style definition or the name of the style definition (in the current | |
777 | sheet) can be passed. | |
778 | ||
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. | |
785 | ||
786 | @see SetListStyle(), PromoteList(), ClearListStyle(). | |
787 | */ | |
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); | |
790 | //@} | |
791 | ||
792 | //@{ | |
793 | /** | |
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. | |
799 | ||
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. | |
806 | ||
807 | @see SetListStyle(), @see SetListStyle(), ClearListStyle(). | |
808 | */ | |
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); | |
811 | //@} | |
812 | ||
813 | /** | |
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. | |
816 | ||
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). | |
820 | ||
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 | |
824 | undoable. | |
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 | |
830 | the new properties. | |
831 | - wxRICHTEXT_SETPROPERTIES_REMOVE: removes the specified properties. | |
832 | */ | |
833 | virtual bool SetProperties(const wxRichTextRange& range, const wxRichTextProperties& properties, int flags = wxRICHTEXT_SETPROPERTIES_WITH_UNDO); | |
834 | ||
835 | /** | |
836 | Deletes the content within the given range. | |
837 | */ | |
838 | virtual bool Delete(const wxRichTextRange& range); | |
839 | ||
840 | /** | |
841 | Translates from column and line number to position. | |
842 | */ | |
843 | virtual long XYToPosition(long x, long y) const; | |
844 | ||
845 | /** | |
846 | Converts a text position to zero-based column and line numbers. | |
847 | */ | |
848 | virtual bool PositionToXY(long pos, long *x, long *y) const; | |
849 | ||
850 | /** | |
851 | Scrolls the buffer so that the given position is in view. | |
852 | */ | |
853 | virtual void ShowPosition(long pos); | |
854 | ||
855 | //@{ | |
856 | /** | |
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 | |
859 | scrolling). | |
860 | */ | |
861 | virtual wxTextCtrlHitTestResult HitTest(const wxPoint& pt, long *pos) const; | |
862 | virtual wxTextCtrlHitTestResult HitTest(const wxPoint& pt, | |
863 | wxTextCoord *col, | |
864 | wxTextCoord *row) const; | |
865 | ||
866 | /** | |
867 | Finds the container at the given point, which is assumed to be in client coordinates. | |
868 | */ | |
869 | wxRichTextParagraphLayoutBox* FindContainerAtPoint(const wxPoint pt, long& position, int& hit, wxRichTextObject* hitObj, int flags = 0); | |
870 | //@} | |
871 | ||
872 | // Clipboard operations | |
873 | ||
874 | /** | |
875 | Copies the selected content (if any) to the clipboard. | |
876 | */ | |
877 | virtual void Copy(); | |
878 | ||
879 | /** | |
880 | Copies the selected content (if any) to the clipboard and deletes the selection. | |
881 | This is undoable. | |
882 | */ | |
883 | virtual void Cut(); | |
884 | ||
885 | /** | |
886 | Pastes content from the clipboard to the buffer. | |
887 | */ | |
888 | virtual void Paste(); | |
889 | ||
890 | /** | |
891 | Deletes the content in the selection, if any. This is undoable. | |
892 | */ | |
893 | virtual void DeleteSelection(); | |
894 | ||
895 | /** | |
896 | Returns @true if selected content can be copied to the clipboard. | |
897 | */ | |
898 | virtual bool CanCopy() const; | |
899 | ||
900 | /** | |
901 | Returns @true if selected content can be copied to the clipboard and deleted. | |
902 | */ | |
903 | virtual bool CanCut() const; | |
904 | ||
905 | /** | |
906 | Returns @true if the clipboard content can be pasted to the buffer. | |
907 | */ | |
908 | virtual bool CanPaste() const; | |
909 | ||
910 | /** | |
911 | Returns @true if selected content can be deleted. | |
912 | */ | |
913 | virtual bool CanDeleteSelection() const; | |
914 | ||
915 | /** | |
916 | Undoes the command at the top of the command history, if there is one. | |
917 | */ | |
918 | virtual void Undo(); | |
919 | ||
920 | /** | |
921 | Redoes the current command. | |
922 | */ | |
923 | virtual void Redo(); | |
924 | ||
925 | /** | |
926 | Returns @true if there is a command in the command history that can be undone. | |
927 | */ | |
928 | virtual bool CanUndo() const; | |
929 | ||
930 | /** | |
931 | Returns @true if there is a command in the command history that can be redone. | |
932 | */ | |
933 | virtual bool CanRedo() const; | |
934 | ||
935 | /** | |
936 | Sets the insertion point and causes the current editing style to be taken from | |
937 | the new position (unlike wxRichTextCtrl::SetCaretPosition). | |
938 | */ | |
939 | virtual void SetInsertionPoint(long pos); | |
940 | ||
941 | /** | |
942 | Sets the insertion point to the end of the text control. | |
943 | */ | |
944 | virtual void SetInsertionPointEnd(); | |
945 | ||
946 | /** | |
947 | Returns the current insertion point. | |
948 | */ | |
949 | virtual long GetInsertionPoint() const; | |
950 | ||
951 | /** | |
952 | Returns the last position in the buffer. | |
953 | */ | |
954 | virtual wxTextPos GetLastPosition() const; | |
955 | ||
956 | //@{ | |
957 | /** | |
958 | Sets the selection to the given range. | |
959 | The end point of range is specified as the last character position of the span | |
960 | of text, plus one. | |
961 | ||
962 | So, for example, to set the selection for a character at position 5, use the | |
963 | range (5,6). | |
964 | */ | |
965 | virtual void SetSelection(long from, long to); | |
966 | void SetSelection(const wxRichTextSelection& sel) { m_selection = sel; } | |
967 | //@} | |
968 | ||
969 | ||
970 | /** | |
971 | Selects all the text in the buffer. | |
972 | */ | |
973 | virtual void SelectAll(); | |
974 | ||
975 | /** | |
976 | Makes the control editable, or not. | |
977 | */ | |
978 | virtual void SetEditable(bool editable); | |
979 | ||
980 | /** | |
981 | Returns @true if there is a selection and the object containing the selection | |
982 | was the same as the current focus object. | |
983 | */ | |
984 | virtual bool HasSelection() const; | |
985 | ||
986 | /** | |
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. | |
989 | */ | |
990 | virtual bool HasUnfocusedSelection() const; | |
991 | ||
992 | //@{ | |
993 | /** | |
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. | |
996 | */ | |
997 | virtual bool WriteImage(const wxImage& image, wxBitmapType bitmapType = wxBITMAP_TYPE_PNG, | |
998 | const wxRichTextAttr& textAttr = wxRichTextAttr()); | |
999 | ||
1000 | virtual bool WriteImage(const wxBitmap& bitmap, wxBitmapType bitmapType = wxBITMAP_TYPE_PNG, | |
1001 | const wxRichTextAttr& textAttr = wxRichTextAttr()); | |
1002 | //@} | |
1003 | ||
1004 | /** | |
1005 | Loads an image from a file and writes it at the current insertion point. | |
1006 | */ | |
1007 | virtual bool WriteImage(const wxString& filename, wxBitmapType bitmapType, | |
1008 | const wxRichTextAttr& textAttr = wxRichTextAttr()); | |
1009 | ||
1010 | /** | |
1011 | Writes an image block at the current insertion point. | |
1012 | */ | |
1013 | virtual bool WriteImage(const wxRichTextImageBlock& imageBlock, | |
1014 | const wxRichTextAttr& textAttr = wxRichTextAttr()); | |
1015 | ||
1016 | /** | |
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. | |
1019 | */ | |
1020 | virtual wxRichTextBox* WriteTextBox(const wxRichTextAttr& textAttr = wxRichTextAttr()); | |
1021 | ||
1022 | /** | |
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. | |
1025 | */ | |
1026 | virtual wxRichTextTable* WriteTable(int rows, int cols, const wxRichTextAttr& tableAttr = wxRichTextAttr(), const wxRichTextAttr& cellAttr = wxRichTextAttr()); | |
1027 | ||
1028 | /** | |
1029 | Inserts a new paragraph at the current insertion point. @see LineBreak(). | |
1030 | */ | |
1031 | virtual bool Newline(); | |
1032 | ||
1033 | /** | |
1034 | Inserts a line break at the current insertion point. | |
1035 | ||
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. | |
1039 | */ | |
1040 | virtual bool LineBreak(); | |
1041 | ||
1042 | /** | |
1043 | Sets the basic (overall) style. | |
1044 | ||
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). | |
1049 | */ | |
1050 | virtual void SetBasicStyle(const wxRichTextAttr& style) { GetBuffer().SetBasicStyle(style); } | |
1051 | ||
1052 | /** | |
1053 | Gets the basic (overall) style. | |
1054 | ||
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). | |
1059 | */ | |
1060 | virtual const wxRichTextAttr& GetBasicStyle() const { return GetBuffer().GetBasicStyle(); } | |
1061 | ||
1062 | /** | |
1063 | Begins applying a style. | |
1064 | */ | |
1065 | virtual bool BeginStyle(const wxRichTextAttr& style) { return GetBuffer().BeginStyle(style); } | |
1066 | ||
1067 | /** | |
1068 | Ends the current style. | |
1069 | */ | |
1070 | virtual bool EndStyle() { return GetBuffer().EndStyle(); } | |
1071 | ||
1072 | /** | |
1073 | Ends application of all styles in the current style stack. | |
1074 | */ | |
1075 | virtual bool EndAllStyles() { return GetBuffer().EndAllStyles(); } | |
1076 | ||
1077 | /** | |
1078 | Begins using bold. | |
1079 | */ | |
1080 | bool BeginBold() { return GetBuffer().BeginBold(); } | |
1081 | ||
1082 | /** | |
1083 | Ends using bold. | |
1084 | */ | |
1085 | bool EndBold() { return GetBuffer().EndBold(); } | |
1086 | ||
1087 | /** | |
1088 | Begins using italic. | |
1089 | */ | |
1090 | bool BeginItalic() { return GetBuffer().BeginItalic(); } | |
1091 | ||
1092 | /** | |
1093 | Ends using italic. | |
1094 | */ | |
1095 | bool EndItalic() { return GetBuffer().EndItalic(); } | |
1096 | ||
1097 | /** | |
1098 | Begins using underlining. | |
1099 | */ | |
1100 | bool BeginUnderline() { return GetBuffer().BeginUnderline(); } | |
1101 | ||
1102 | /** | |
1103 | End applying underlining. | |
1104 | */ | |
1105 | bool EndUnderline() { return GetBuffer().EndUnderline(); } | |
1106 | ||
1107 | /** | |
1108 | Begins using the given point size. | |
1109 | */ | |
1110 | bool BeginFontSize(int pointSize) { return GetBuffer().BeginFontSize(pointSize); } | |
1111 | ||
1112 | /** | |
1113 | Ends using a point size. | |
1114 | */ | |
1115 | bool EndFontSize() { return GetBuffer().EndFontSize(); } | |
1116 | ||
1117 | /** | |
1118 | Begins using this font. | |
1119 | */ | |
1120 | bool BeginFont(const wxFont& font) { return GetBuffer().BeginFont(font); } | |
1121 | ||
1122 | /** | |
1123 | Ends using a font. | |
1124 | */ | |
1125 | bool EndFont() { return GetBuffer().EndFont(); } | |
1126 | ||
1127 | /** | |
1128 | Begins using this colour. | |
1129 | */ | |
1130 | bool BeginTextColour(const wxColour& colour) { return GetBuffer().BeginTextColour(colour); } | |
1131 | ||
1132 | /** | |
1133 | Ends applying a text colour. | |
1134 | */ | |
1135 | bool EndTextColour() { return GetBuffer().EndTextColour(); } | |
1136 | ||
1137 | /** | |
1138 | Begins using alignment. | |
1139 | For alignment values, see wxTextAttr. | |
1140 | */ | |
1141 | bool BeginAlignment(wxTextAttrAlignment alignment) { return GetBuffer().BeginAlignment(alignment); } | |
1142 | ||
1143 | /** | |
1144 | Ends alignment. | |
1145 | */ | |
1146 | bool EndAlignment() { return GetBuffer().EndAlignment(); } | |
1147 | ||
1148 | /** | |
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. | |
1155 | ||
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. | |
1159 | ||
1160 | @param leftIndent | |
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. | |
1165 | */ | |
1166 | bool BeginLeftIndent(int leftIndent, int leftSubIndent = 0) { return GetBuffer().BeginLeftIndent(leftIndent, leftSubIndent); } | |
1167 | ||
1168 | /** | |
1169 | Ends left indent. | |
1170 | */ | |
1171 | bool EndLeftIndent() { return GetBuffer().EndLeftIndent(); } | |
1172 | ||
1173 | /** | |
1174 | Begins a right indent, specified in tenths of a millimetre. | |
1175 | */ | |
1176 | bool BeginRightIndent(int rightIndent) { return GetBuffer().BeginRightIndent(rightIndent); } | |
1177 | ||
1178 | /** | |
1179 | Ends right indent. | |
1180 | */ | |
1181 | bool EndRightIndent() { return GetBuffer().EndRightIndent(); } | |
1182 | ||
1183 | /** | |
1184 | Begins paragraph spacing; pass the before-paragraph and after-paragraph spacing | |
1185 | in tenths of a millimetre. | |
1186 | */ | |
1187 | bool BeginParagraphSpacing(int before, int after) { return GetBuffer().BeginParagraphSpacing(before, after); } | |
1188 | ||
1189 | /** | |
1190 | Ends paragraph spacing. | |
1191 | */ | |
1192 | bool EndParagraphSpacing() { return GetBuffer().EndParagraphSpacing(); } | |
1193 | ||
1194 | /** | |
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. | |
1197 | ||
1198 | The ::wxTextAttrLineSpacing constants are defined for convenience. | |
1199 | */ | |
1200 | bool BeginLineSpacing(int lineSpacing) { return GetBuffer().BeginLineSpacing(lineSpacing); } | |
1201 | ||
1202 | /** | |
1203 | Ends line spacing. | |
1204 | */ | |
1205 | bool EndLineSpacing() { return GetBuffer().EndLineSpacing(); } | |
1206 | ||
1207 | /** | |
1208 | Begins a numbered bullet. | |
1209 | ||
1210 | This call will be needed for each item in the list, and the | |
1211 | application should take care of incrementing the numbering. | |
1212 | ||
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. | |
1216 | ||
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. | |
1223 | */ | |
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); } | |
1226 | ||
1227 | /** | |
1228 | Ends application of a numbered bullet. | |
1229 | */ | |
1230 | bool EndNumberedBullet() { return GetBuffer().EndNumberedBullet(); } | |
1231 | ||
1232 | /** | |
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. | |
1236 | */ | |
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); } | |
1239 | ||
1240 | /** | |
1241 | Ends applying a symbol bullet. | |
1242 | */ | |
1243 | bool EndSymbolBullet() { return GetBuffer().EndSymbolBullet(); } | |
1244 | ||
1245 | /** | |
1246 | Begins applying a symbol bullet. | |
1247 | */ | |
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); } | |
1250 | ||
1251 | /** | |
1252 | Begins applying a standard bullet. | |
1253 | */ | |
1254 | bool EndStandardBullet() { return GetBuffer().EndStandardBullet(); } | |
1255 | ||
1256 | /** | |
1257 | Begins using the named character style. | |
1258 | */ | |
1259 | bool BeginCharacterStyle(const wxString& characterStyle) { return GetBuffer().BeginCharacterStyle(characterStyle); } | |
1260 | ||
1261 | /** | |
1262 | Ends application of a named character style. | |
1263 | */ | |
1264 | bool EndCharacterStyle() { return GetBuffer().EndCharacterStyle(); } | |
1265 | ||
1266 | /** | |
1267 | Begins applying the named paragraph style. | |
1268 | */ | |
1269 | bool BeginParagraphStyle(const wxString& paragraphStyle) { return GetBuffer().BeginParagraphStyle(paragraphStyle); } | |
1270 | ||
1271 | /** | |
1272 | Ends application of a named paragraph style. | |
1273 | */ | |
1274 | bool EndParagraphStyle() { return GetBuffer().EndParagraphStyle(); } | |
1275 | ||
1276 | /** | |
1277 | Begins using a specified list style. | |
1278 | Optionally, you can also pass a level and a number. | |
1279 | */ | |
1280 | bool BeginListStyle(const wxString& listStyle, int level = 1, int number = 1) { return GetBuffer().BeginListStyle(listStyle, level, number); } | |
1281 | ||
1282 | /** | |
1283 | Ends using a specified list style. | |
1284 | */ | |
1285 | bool EndListStyle() { return GetBuffer().EndListStyle(); } | |
1286 | ||
1287 | /** | |
1288 | Begins applying wxTEXT_ATTR_URL to the content. | |
1289 | ||
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. | |
1292 | */ | |
1293 | bool BeginURL(const wxString& url, const wxString& characterStyle = wxEmptyString) { return GetBuffer().BeginURL(url, characterStyle); } | |
1294 | ||
1295 | /** | |
1296 | Ends applying a URL. | |
1297 | */ | |
1298 | bool EndURL() { return GetBuffer().EndURL(); } | |
1299 | ||
1300 | /** | |
1301 | Sets the default style to the style under the cursor. | |
1302 | */ | |
1303 | bool SetDefaultStyleToCursorStyle(); | |
1304 | ||
1305 | /** | |
1306 | Cancels any selection. | |
1307 | */ | |
1308 | virtual void SelectNone(); | |
1309 | ||
1310 | /** | |
1311 | Selects the word at the given character position. | |
1312 | */ | |
1313 | virtual bool SelectWord(long position); | |
1314 | ||
1315 | /** | |
1316 | Returns the selection range in character positions. -1, -1 means no selection. | |
1317 | ||
1318 | The range is in API convention, i.e. a single character selection is denoted | |
1319 | by (n, n+1) | |
1320 | */ | |
1321 | wxRichTextRange GetSelectionRange() const; | |
1322 | ||
1323 | /** | |
1324 | Sets the selection to the given range. | |
1325 | The end point of range is specified as the last character position of the span | |
1326 | of text, plus one. | |
1327 | ||
1328 | So, for example, to set the selection for a character at position 5, use the | |
1329 | range (5,6). | |
1330 | */ | |
1331 | void SetSelectionRange(const wxRichTextRange& range); | |
1332 | ||
1333 | /** | |
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 | |
1337 | by (n, n) | |
1338 | */ | |
1339 | wxRichTextRange GetInternalSelectionRange() const { return m_selection.GetRange(); } | |
1340 | ||
1341 | /** | |
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 | |
1345 | by (n, n) | |
1346 | */ | |
1347 | void SetInternalSelectionRange(const wxRichTextRange& range) { m_selection.Set(range, GetFocusObject()); } | |
1348 | ||
1349 | /** | |
1350 | Adds a new paragraph of text to the end of the buffer. | |
1351 | */ | |
1352 | virtual wxRichTextRange AddParagraph(const wxString& text); | |
1353 | ||
1354 | /** | |
1355 | Adds an image to the control's buffer. | |
1356 | */ | |
1357 | virtual wxRichTextRange AddImage(const wxImage& image); | |
1358 | ||
1359 | /** | |
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. | |
1363 | */ | |
1364 | virtual bool LayoutContent(bool onlyVisibleRect = false); | |
1365 | ||
1366 | /** | |
1367 | Move the caret to the given character position. | |
1368 | ||
1369 | Please note that this does not update the current editing style | |
1370 | from the new position; to do that, call wxRichTextCtrl::SetInsertionPoint instead. | |
1371 | */ | |
1372 | virtual bool MoveCaret(long pos, bool showAtLineStart = false, wxRichTextParagraphLayoutBox* container = NULL); | |
1373 | ||
1374 | /** | |
1375 | Moves right. | |
1376 | */ | |
1377 | virtual bool MoveRight(int noPositions = 1, int flags = 0); | |
1378 | ||
1379 | /** | |
1380 | Moves left. | |
1381 | */ | |
1382 | virtual bool MoveLeft(int noPositions = 1, int flags = 0); | |
1383 | ||
1384 | /** | |
1385 | Moves to the start of the paragraph. | |
1386 | */ | |
1387 | virtual bool MoveUp(int noLines = 1, int flags = 0); | |
1388 | ||
1389 | /** | |
1390 | Moves the caret down. | |
1391 | */ | |
1392 | virtual bool MoveDown(int noLines = 1, int flags = 0); | |
1393 | ||
1394 | /** | |
1395 | Moves to the end of the line. | |
1396 | */ | |
1397 | virtual bool MoveToLineEnd(int flags = 0); | |
1398 | ||
1399 | /** | |
1400 | Moves to the start of the line. | |
1401 | */ | |
1402 | virtual bool MoveToLineStart(int flags = 0); | |
1403 | ||
1404 | /** | |
1405 | Moves to the end of the paragraph. | |
1406 | */ | |
1407 | virtual bool MoveToParagraphEnd(int flags = 0); | |
1408 | ||
1409 | /** | |
1410 | Moves to the start of the paragraph. | |
1411 | */ | |
1412 | virtual bool MoveToParagraphStart(int flags = 0); | |
1413 | ||
1414 | /** | |
1415 | Moves to the start of the buffer. | |
1416 | */ | |
1417 | virtual bool MoveHome(int flags = 0); | |
1418 | ||
1419 | /** | |
1420 | Moves to the end of the buffer. | |
1421 | */ | |
1422 | virtual bool MoveEnd(int flags = 0); | |
1423 | ||
1424 | /** | |
1425 | Moves one or more pages up. | |
1426 | */ | |
1427 | virtual bool PageUp(int noPages = 1, int flags = 0); | |
1428 | ||
1429 | /** | |
1430 | Moves one or more pages down. | |
1431 | */ | |
1432 | virtual bool PageDown(int noPages = 1, int flags = 0); | |
1433 | ||
1434 | /** | |
1435 | Moves a number of words to the left. | |
1436 | */ | |
1437 | virtual bool WordLeft(int noPages = 1, int flags = 0); | |
1438 | ||
1439 | /** | |
1440 | Move a nuber of words to the right. | |
1441 | */ | |
1442 | virtual bool WordRight(int noPages = 1, int flags = 0); | |
1443 | ||
1444 | //@{ | |
1445 | /** | |
1446 | Returns the buffer associated with the control. | |
1447 | */ | |
1448 | wxRichTextBuffer& GetBuffer() { return m_buffer; } | |
1449 | const wxRichTextBuffer& GetBuffer() const { return m_buffer; } | |
1450 | //@} | |
1451 | ||
1452 | /** | |
1453 | Starts batching undo history for commands. | |
1454 | */ | |
1455 | virtual bool BeginBatchUndo(const wxString& cmdName) { return m_buffer.BeginBatchUndo(cmdName); } | |
1456 | ||
1457 | /** | |
1458 | Ends batching undo command history. | |
1459 | */ | |
1460 | virtual bool EndBatchUndo() { return m_buffer.EndBatchUndo(); } | |
1461 | ||
1462 | /** | |
1463 | Returns @true if undo commands are being batched. | |
1464 | */ | |
1465 | virtual bool BatchingUndo() const { return m_buffer.BatchingUndo(); } | |
1466 | ||
1467 | /** | |
1468 | Starts suppressing undo history for commands. | |
1469 | */ | |
1470 | virtual bool BeginSuppressUndo() { return m_buffer.BeginSuppressUndo(); } | |
1471 | ||
1472 | /** | |
1473 | Ends suppressing undo command history. | |
1474 | */ | |
1475 | virtual bool EndSuppressUndo() { return m_buffer.EndSuppressUndo(); } | |
1476 | ||
1477 | /** | |
1478 | Returns @true if undo history suppression is on. | |
1479 | */ | |
1480 | virtual bool SuppressingUndo() const { return m_buffer.SuppressingUndo(); } | |
1481 | ||
1482 | /** | |
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. | |
1485 | ||
1486 | You can use this to implement, for example, bold button updating. | |
1487 | @a style must have flags indicating which attributes are of interest. | |
1488 | */ | |
1489 | virtual bool HasCharacterAttributes(const wxRichTextRange& range, const wxRichTextAttr& style) const | |
1490 | { | |
1491 | return GetBuffer().HasCharacterAttributes(range.ToInternal(), style); | |
1492 | } | |
1493 | ||
1494 | /** | |
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. | |
1499 | */ | |
1500 | virtual bool HasParagraphAttributes(const wxRichTextRange& range, const wxRichTextAttr& style) const | |
1501 | { | |
1502 | return GetBuffer().HasParagraphAttributes(range.ToInternal(), style); | |
1503 | } | |
1504 | ||
1505 | /** | |
1506 | Returns @true if all of the selection, or the content at the caret position, is bold. | |
1507 | */ | |
1508 | virtual bool IsSelectionBold(); | |
1509 | ||
1510 | /** | |
1511 | Returns @true if all of the selection, or the content at the caret position, is italic. | |
1512 | */ | |
1513 | virtual bool IsSelectionItalics(); | |
1514 | ||
1515 | /** | |
1516 | Returns @true if all of the selection, or the content at the caret position, is underlined. | |
1517 | */ | |
1518 | virtual bool IsSelectionUnderlined(); | |
1519 | ||
1520 | /** | |
1521 | Returns @true if all of the selection, or the content at the current caret position, has the supplied wxTextAttrEffects flag(s). | |
1522 | */ | |
1523 | virtual bool DoesSelectionHaveTextEffectFlag(int flag); | |
1524 | ||
1525 | /** | |
1526 | Returns @true if all of the selection is aligned according to the specified flag. | |
1527 | */ | |
1528 | virtual bool IsSelectionAligned(wxTextAttrAlignment alignment); | |
1529 | ||
1530 | /** | |
1531 | Apples bold to the selection or the default style (undoable). | |
1532 | */ | |
1533 | virtual bool ApplyBoldToSelection(); | |
1534 | ||
1535 | /** | |
1536 | Applies italic to the selection or the default style (undoable). | |
1537 | */ | |
1538 | virtual bool ApplyItalicToSelection(); | |
1539 | ||
1540 | /** | |
1541 | Applies underline to the selection or the default style (undoable). | |
1542 | */ | |
1543 | virtual bool ApplyUnderlineToSelection(); | |
1544 | ||
1545 | /** | |
1546 | Applies one or more wxTextAttrEffects flags to the selection (undoable). | |
1547 | If there is no selection, it is applied to the default style. | |
1548 | */ | |
1549 | virtual bool ApplyTextEffectToSelection(int flags); | |
1550 | ||
1551 | /** | |
1552 | Applies the given alignment to the selection or the default style (undoable). | |
1553 | For alignment values, see wxTextAttr. | |
1554 | */ | |
1555 | virtual bool ApplyAlignmentToSelection(wxTextAttrAlignment alignment); | |
1556 | ||
1557 | /** | |
1558 | Applies the style sheet to the buffer, matching paragraph styles in the sheet | |
1559 | against named styles in the buffer. | |
1560 | ||
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. | |
1564 | */ | |
1565 | virtual bool ApplyStyle(wxRichTextStyleDefinition* def); | |
1566 | ||
1567 | /** | |
1568 | Sets the style sheet associated with the control. | |
1569 | A style sheet allows named character and paragraph styles to be applied. | |
1570 | */ | |
1571 | void SetStyleSheet(wxRichTextStyleSheet* styleSheet) { GetBuffer().SetStyleSheet(styleSheet); } | |
1572 | ||
1573 | /** | |
1574 | Returns the style sheet associated with the control, if any. | |
1575 | A style sheet allows named character and paragraph styles to be applied. | |
1576 | */ | |
1577 | wxRichTextStyleSheet* GetStyleSheet() const { return GetBuffer().GetStyleSheet(); } | |
1578 | ||
1579 | /** | |
1580 | Push the style sheet to top of stack. | |
1581 | */ | |
1582 | bool PushStyleSheet(wxRichTextStyleSheet* styleSheet) { return GetBuffer().PushStyleSheet(styleSheet); } | |
1583 | ||
1584 | /** | |
1585 | Pops the style sheet from top of stack. | |
1586 | */ | |
1587 | wxRichTextStyleSheet* PopStyleSheet() { return GetBuffer().PopStyleSheet(); } | |
1588 | ||
1589 | /** | |
1590 | Applies the style sheet to the buffer, for example if the styles have changed. | |
1591 | */ | |
1592 | bool ApplyStyleSheet(wxRichTextStyleSheet* styleSheet = NULL); | |
1593 | ||
1594 | /** | |
1595 | Shows the given context menu, optionally adding appropriate property-editing commands for the current position in the object hierarchy. | |
1596 | */ | |
1597 | virtual bool ShowContextMenu(wxMenu* menu, const wxPoint& pt, bool addPropertyCommands); | |
1598 | ||
1599 | /** | |
1600 | Prepares the context menu, optionally adding appropriate property-editing commands. | |
1601 | Returns the number of property commands added. | |
1602 | */ | |
1603 | virtual int PrepareContextMenu(wxMenu* menu, const wxPoint& pt, bool addPropertyCommands); | |
1604 | ||
1605 | /** | |
1606 | Returns @true if we can edit the object's properties via a GUI. | |
1607 | */ | |
1608 | virtual bool CanEditProperties(wxRichTextObject* obj) const; | |
1609 | ||
1610 | /** | |
1611 | Edits the object's properties via a GUI. | |
1612 | */ | |
1613 | virtual bool EditProperties(wxRichTextObject* obj, wxWindow* parent); | |
1614 | ||
1615 | /** | |
1616 | Gets the object's properties menu label. | |
1617 | */ | |
1618 | virtual wxString GetPropertiesMenuLabel(wxRichTextObject* obj); | |
1619 | ||
1620 | /** | |
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. | |
1623 | */ | |
1624 | virtual void PrepareContent(wxRichTextParagraphLayoutBox& WXUNUSED(container)) {} | |
1625 | ||
1626 | /** | |
1627 | Can we delete this range? | |
1628 | Sends an event to the control. | |
1629 | */ | |
1630 | virtual bool CanDeleteRange(wxRichTextParagraphLayoutBox& container, const wxRichTextRange& range) const; | |
1631 | ||
1632 | /** | |
1633 | Can we insert content at this position? | |
1634 | Sends an event to the control. | |
1635 | */ | |
1636 | virtual bool CanInsertContent(wxRichTextParagraphLayoutBox& container, long pos) const; | |
1637 | ||
1638 | // Command handlers | |
1639 | ||
1640 | /** | |
1641 | Sends the event to the control. | |
1642 | */ | |
1643 | void Command(wxCommandEvent& event); | |
1644 | ||
1645 | /** | |
1646 | Loads the first dropped file. | |
1647 | */ | |
1648 | void OnDropFiles(wxDropFilesEvent& event); | |
1649 | ||
1650 | void OnCaptureLost(wxMouseCaptureLostEvent& event); | |
1651 | void OnSysColourChanged(wxSysColourChangedEvent& event); | |
1652 | ||
1653 | /** | |
1654 | Standard handler for the wxID_CUT command. | |
1655 | */ | |
1656 | void OnCut(wxCommandEvent& event); | |
1657 | ||
1658 | /** | |
1659 | Standard handler for the wxID_COPY command. | |
1660 | */ | |
1661 | void OnCopy(wxCommandEvent& event); | |
1662 | ||
1663 | /** | |
1664 | Standard handler for the wxID_PASTE command. | |
1665 | */ | |
1666 | void OnPaste(wxCommandEvent& event); | |
1667 | ||
1668 | /** | |
1669 | Standard handler for the wxID_UNDO command. | |
1670 | */ | |
1671 | void OnUndo(wxCommandEvent& event); | |
1672 | ||
1673 | /** | |
1674 | Standard handler for the wxID_REDO command. | |
1675 | */ | |
1676 | void OnRedo(wxCommandEvent& event); | |
1677 | ||
1678 | /** | |
1679 | Standard handler for the wxID_SELECTALL command. | |
1680 | */ | |
1681 | void OnSelectAll(wxCommandEvent& event); | |
1682 | ||
1683 | /** | |
1684 | Standard handler for property commands. | |
1685 | */ | |
1686 | void OnProperties(wxCommandEvent& event); | |
1687 | ||
1688 | /** | |
1689 | Standard handler for the wxID_CLEAR command. | |
1690 | */ | |
1691 | void OnClear(wxCommandEvent& event); | |
1692 | ||
1693 | /** | |
1694 | Standard update handler for the wxID_CUT command. | |
1695 | */ | |
1696 | void OnUpdateCut(wxUpdateUIEvent& event); | |
1697 | ||
1698 | /** | |
1699 | Standard update handler for the wxID_COPY command. | |
1700 | */ | |
1701 | void OnUpdateCopy(wxUpdateUIEvent& event); | |
1702 | ||
1703 | /** | |
1704 | Standard update handler for the wxID_PASTE command. | |
1705 | */ | |
1706 | void OnUpdatePaste(wxUpdateUIEvent& event); | |
1707 | ||
1708 | /** | |
1709 | Standard update handler for the wxID_UNDO command. | |
1710 | */ | |
1711 | void OnUpdateUndo(wxUpdateUIEvent& event); | |
1712 | ||
1713 | /** | |
1714 | Standard update handler for the wxID_REDO command. | |
1715 | */ | |
1716 | void OnUpdateRedo(wxUpdateUIEvent& event); | |
1717 | ||
1718 | /** | |
1719 | Standard update handler for the wxID_SELECTALL command. | |
1720 | */ | |
1721 | void OnUpdateSelectAll(wxUpdateUIEvent& event); | |
1722 | ||
1723 | /** | |
1724 | Standard update handler for property commands. | |
1725 | */ | |
1726 | ||
1727 | void OnUpdateProperties(wxUpdateUIEvent& event); | |
1728 | ||
1729 | /** | |
1730 | Standard update handler for the wxID_CLEAR command. | |
1731 | */ | |
1732 | void OnUpdateClear(wxUpdateUIEvent& event); | |
1733 | ||
1734 | /** | |
1735 | Shows a standard context menu with undo, redo, cut, copy, paste, clear, and | |
1736 | select all commands. | |
1737 | */ | |
1738 | void OnContextMenu(wxContextMenuEvent& event); | |
1739 | ||
1740 | // Event handlers | |
1741 | ||
1742 | // Painting | |
1743 | void OnPaint(wxPaintEvent& event); | |
1744 | void OnEraseBackground(wxEraseEvent& event); | |
1745 | ||
1746 | // Left-click | |
1747 | void OnLeftClick(wxMouseEvent& event); | |
1748 | ||
1749 | // Left-up | |
1750 | void OnLeftUp(wxMouseEvent& event); | |
1751 | ||
1752 | // Motion | |
1753 | void OnMoveMouse(wxMouseEvent& event); | |
1754 | ||
1755 | // Left-double-click | |
1756 | void OnLeftDClick(wxMouseEvent& event); | |
1757 | ||
1758 | // Middle-click | |
1759 | void OnMiddleClick(wxMouseEvent& event); | |
1760 | ||
1761 | // Right-click | |
1762 | void OnRightClick(wxMouseEvent& event); | |
1763 | ||
1764 | // Key press | |
1765 | void OnChar(wxKeyEvent& event); | |
1766 | ||
1767 | // Sizing | |
1768 | void OnSize(wxSizeEvent& event); | |
1769 | ||
1770 | // Setting/losing focus | |
1771 | void OnSetFocus(wxFocusEvent& event); | |
1772 | void OnKillFocus(wxFocusEvent& event); | |
1773 | ||
1774 | // Idle-time processing | |
1775 | void OnIdle(wxIdleEvent& event); | |
1776 | ||
1777 | // Scrolling | |
1778 | void OnScroll(wxScrollWinEvent& event); | |
1779 | ||
1780 | /** | |
1781 | Sets the font, and also the basic and default attributes | |
1782 | (see wxRichTextCtrl::SetDefaultStyle). | |
1783 | */ | |
1784 | virtual bool SetFont(const wxFont& font); | |
1785 | ||
1786 | /** | |
1787 | A helper function setting up scrollbars, for example after a resize. | |
1788 | */ | |
1789 | virtual void SetupScrollbars(bool atTop = false); | |
1790 | ||
1791 | /** | |
1792 | Helper function implementing keyboard navigation. | |
1793 | */ | |
1794 | virtual bool KeyboardNavigate(int keyCode, int flags); | |
1795 | ||
1796 | /** | |
1797 | Paints the background. | |
1798 | */ | |
1799 | virtual void PaintBackground(wxDC& dc); | |
1800 | ||
1801 | /** | |
1802 | Other user defined painting after everything else (i.e. all text) is painted. | |
1803 | ||
1804 | @since 2.9.1 | |
1805 | */ | |
1806 | virtual void PaintAboveContent(wxDC& WXUNUSED(dc)) {} | |
1807 | ||
1808 | #if wxRICHTEXT_BUFFERED_PAINTING | |
1809 | /** | |
1810 | Recreates the buffer bitmap if necessary. | |
1811 | */ | |
1812 | virtual bool RecreateBuffer(const wxSize& size = wxDefaultSize); | |
1813 | #endif | |
1814 | ||
1815 | // Write text | |
1816 | virtual void DoWriteText(const wxString& value, int flags = 0); | |
1817 | ||
1818 | // Should we inherit colours? | |
1819 | virtual bool ShouldInheritColours() const { return false; } | |
1820 | ||
1821 | /** | |
1822 | Internal function to position the visible caret according to the current caret | |
1823 | position. | |
1824 | */ | |
1825 | virtual void PositionCaret(wxRichTextParagraphLayoutBox* container = NULL); | |
1826 | ||
1827 | /** | |
1828 | Helper function for extending the selection, returning @true if the selection | |
1829 | was changed. Selections are in caret positions. | |
1830 | */ | |
1831 | virtual bool ExtendSelection(long oldPosition, long newPosition, int flags); | |
1832 | ||
1833 | /** | |
1834 | Scrolls @a position into view. This function takes a caret position. | |
1835 | */ | |
1836 | virtual bool ScrollIntoView(long position, int keyCode); | |
1837 | ||
1838 | /** | |
1839 | Refreshes the area affected by a selection change. | |
1840 | */ | |
1841 | bool RefreshForSelectionChange(const wxRichTextSelection& oldSelection, const wxRichTextSelection& newSelection); | |
1842 | ||
1843 | /** | |
1844 | Sets the caret position. | |
1845 | ||
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. | |
1851 | */ | |
1852 | void SetCaretPosition(long position, bool showAtLineStart = false) ; | |
1853 | ||
1854 | /** | |
1855 | Returns the current caret position. | |
1856 | */ | |
1857 | long GetCaretPosition() const { return m_caretPosition; } | |
1858 | ||
1859 | /** | |
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. | |
1863 | */ | |
1864 | long GetAdjustedCaretPosition(long caretPos) const; | |
1865 | ||
1866 | /** | |
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. | |
1870 | */ | |
1871 | void MoveCaretForward(long oldPosition) ; | |
1872 | ||
1873 | /** | |
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. | |
1877 | */ | |
1878 | void MoveCaretBack(long oldPosition) ; | |
1879 | ||
1880 | /** | |
1881 | Returns the caret height and position for the given character position. | |
1882 | If container is null, the current focus object will be used. | |
1883 | ||
1884 | @beginWxPerlOnly | |
1885 | In wxPerl this method is implemented as | |
1886 | GetCaretPositionForIndex(@a position) returning a | |
1887 | 2-element list (ok, rect). | |
1888 | @endWxPerlOnly | |
1889 | */ | |
1890 | bool GetCaretPositionForIndex(long position, wxRect& rect, wxRichTextParagraphLayoutBox* container = NULL); | |
1891 | ||
1892 | /** | |
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. | |
1897 | */ | |
1898 | wxRichTextLine* GetVisibleLineForCaretPosition(long caretPosition) const; | |
1899 | ||
1900 | /** | |
1901 | Gets the command processor associated with the control's buffer. | |
1902 | */ | |
1903 | wxCommandProcessor* GetCommandProcessor() const { return GetBuffer().GetCommandProcessor(); } | |
1904 | ||
1905 | /** | |
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. | |
1909 | ||
1910 | @beginWxPerlOnly | |
1911 | In wxPerl this method takes no arguments and returns a 2-element | |
1912 | list (ok, newPos). | |
1913 | @endWxPerlOnly | |
1914 | */ | |
1915 | bool DeleteSelectedContent(long* newPos= NULL); | |
1916 | ||
1917 | /** | |
1918 | Transforms logical (unscrolled) position to physical window position. | |
1919 | */ | |
1920 | wxPoint GetPhysicalPoint(const wxPoint& ptLogical) const; | |
1921 | ||
1922 | /** | |
1923 | Transforms physical window position to logical (unscrolled) position. | |
1924 | */ | |
1925 | wxPoint GetLogicalPoint(const wxPoint& ptPhysical) const; | |
1926 | ||
1927 | /** | |
1928 | Helper function for finding the caret position for the next word. | |
1929 | Direction is 1 (forward) or -1 (backwards). | |
1930 | */ | |
1931 | virtual long FindNextWordPosition(int direction = 1) const; | |
1932 | ||
1933 | /** | |
1934 | Returns @true if the given position is visible on the screen. | |
1935 | */ | |
1936 | bool IsPositionVisible(long pos) const; | |
1937 | ||
1938 | /** | |
1939 | Returns the first visible position in the current view. | |
1940 | */ | |
1941 | long GetFirstVisiblePosition() const; | |
1942 | ||
1943 | /** | |
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. | |
1948 | */ | |
1949 | long GetCaretPositionForDefaultStyle() const { return m_caretPositionForDefaultStyle; } | |
1950 | ||
1951 | /** | |
1952 | Set the caret position for the default style that the user is selecting. | |
1953 | */ | |
1954 | void SetCaretPositionForDefaultStyle(long pos) { m_caretPositionForDefaultStyle = pos; } | |
1955 | ||
1956 | /** | |
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. | |
1960 | ||
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. | |
1963 | ||
1964 | @see SetAndShowDefaultStyle(). | |
1965 | */ | |
1966 | bool IsDefaultStyleShowing() const { return m_caretPositionForDefaultStyle != -2; } | |
1967 | ||
1968 | /** | |
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. | |
1971 | ||
1972 | @see IsDefaultStyleShowing(). | |
1973 | */ | |
1974 | void SetAndShowDefaultStyle(const wxRichTextAttr& attr) | |
1975 | { | |
1976 | SetDefaultStyle(attr); | |
1977 | SetCaretPositionForDefaultStyle(GetCaretPosition()); | |
1978 | } | |
1979 | ||
1980 | /** | |
1981 | Returns the first visible point in the window. | |
1982 | */ | |
1983 | wxPoint GetFirstVisiblePoint() const; | |
1984 | ||
1985 | #ifdef DOXYGEN | |
1986 | /** | |
1987 | Returns the content of the entire control as a string. | |
1988 | */ | |
1989 | virtual wxString GetValue() const; | |
1990 | ||
1991 | /** | |
1992 | Replaces existing content with the given text. | |
1993 | */ | |
1994 | virtual void SetValue(const wxString& value); | |
1995 | ||
1996 | /** | |
1997 | Call this function to prevent refresh and allow fast updates, and then Thaw() to | |
1998 | refresh the control. | |
1999 | */ | |
2000 | void Freeze(); | |
2001 | ||
2002 | /** | |
2003 | Call this function to end a Freeze and refresh the display. | |
2004 | */ | |
2005 | void Thaw(); | |
2006 | ||
2007 | /** | |
2008 | Returns @true if Freeze has been called without a Thaw. | |
2009 | */ | |
2010 | bool IsFrozen() const; | |
2011 | ||
2012 | #endif | |
2013 | ||
2014 | // Implementation | |
2015 | ||
2016 | /** | |
2017 | Sets up the caret for the given position and container, after a mouse click. | |
2018 | */ | |
2019 | bool SetCaretPositionAfterClick(wxRichTextParagraphLayoutBox* container, long position, int hitTestFlags, bool extendSelection = false); | |
2020 | ||
2021 | /** | |
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). | |
2025 | */ | |
2026 | long FindCaretPositionForCharacterPosition(long position, int hitTestFlags, wxRichTextParagraphLayoutBox* container, | |
2027 | bool& caretLineStart); | |
2028 | ||
2029 | /** | |
2030 | Processes mouse movement in order to change the cursor | |
2031 | */ | |
2032 | virtual bool ProcessMouseMovement(wxRichTextParagraphLayoutBox* container, wxRichTextObject* obj, long position, const wxPoint& pos); | |
2033 | ||
2034 | /** | |
2035 | Font names take a long time to retrieve, so cache them (on demand). | |
2036 | */ | |
2037 | static const wxArrayString& GetAvailableFontNames(); | |
2038 | ||
2039 | /** | |
2040 | Clears the cache of available font names. | |
2041 | */ | |
2042 | static void ClearAvailableFontNames(); | |
2043 | ||
2044 | WX_FORWARD_TO_SCROLL_HELPER() | |
2045 | ||
2046 | // implement wxTextEntry methods | |
2047 | virtual wxString DoGetValue() const; | |
2048 | ||
2049 | protected: | |
2050 | // implement the wxTextEntry pure virtual method | |
2051 | virtual wxWindow *GetEditableWindow() { return this; } | |
2052 | ||
2053 | // margins functions | |
2054 | virtual bool DoSetMargins(const wxPoint& pt); | |
2055 | virtual wxPoint DoGetMargins() const; | |
2056 | ||
2057 | // FIXME: this does not work, it allows this code to compile but will fail | |
2058 | // during run-time | |
2059 | #ifndef __WXUNIVERSAL__ | |
2060 | #ifdef __WXMSW__ | |
2061 | virtual WXHWND GetEditHWND() const { return GetHWND(); } | |
2062 | #endif | |
2063 | #ifdef __WXMOTIF__ | |
2064 | virtual WXWidget GetTextWidget() const { return NULL; } | |
2065 | #endif | |
2066 | #ifdef __WXGTK20__ | |
2067 | virtual GtkEditable *GetEditable() const { return NULL; } | |
2068 | virtual GtkEntry *GetEntry() const { return NULL; } | |
2069 | #endif | |
2070 | #endif // !__WXUNIVERSAL__ | |
2071 | ||
2072 | // Overrides | |
2073 | protected: | |
2074 | ||
2075 | /** | |
2076 | Currently this simply returns @c wxSize(10, 10). | |
2077 | */ | |
2078 | virtual wxSize DoGetBestSize() const ; | |
2079 | ||
2080 | virtual void DoSetValue(const wxString& value, int flags = 0); | |
2081 | ||
2082 | virtual void DoThaw(); | |
2083 | ||
2084 | ||
2085 | // Data members | |
2086 | protected: | |
2087 | #if wxRICHTEXT_BUFFERED_PAINTING | |
2088 | /// Buffer bitmap | |
2089 | wxBitmap m_bufferBitmap; | |
2090 | #endif | |
2091 | ||
2092 | /// Text buffer | |
2093 | wxRichTextBuffer m_buffer; | |
2094 | ||
2095 | wxMenu* m_contextMenu; | |
2096 | ||
2097 | /// Caret position (1 less than the character position, so -1 is the | |
2098 | /// first caret position). | |
2099 | long m_caretPosition; | |
2100 | ||
2101 | /// Caret position when the default formatting has been changed. As | |
2102 | /// soon as this position changes, we no longer reflect the default style | |
2103 | /// in the UI. | |
2104 | long m_caretPositionForDefaultStyle; | |
2105 | ||
2106 | /// Selection range in character positions. -2, -2 means no selection. | |
2107 | wxRichTextSelection m_selection; | |
2108 | ||
2109 | wxRichTextCtrlSelectionState m_selectionState; | |
2110 | ||
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; | |
2114 | ||
2115 | /// Anchor object if selecting multiple container objects, such as grid cells. | |
2116 | wxRichTextObject* m_selectionAnchorObject; | |
2117 | ||
2118 | /// Are we editable? | |
2119 | bool m_editable; | |
2120 | ||
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; | |
2124 | ||
2125 | /// Are we dragging a selection? | |
2126 | bool m_dragging; | |
2127 | ||
2128 | /// Do we need full layout in idle? | |
2129 | bool m_fullLayoutRequired; | |
2130 | wxLongLong m_fullLayoutTime; | |
2131 | long m_fullLayoutSavedPosition; | |
2132 | ||
2133 | /// Threshold for doing delayed layout | |
2134 | long m_delayedLayoutThreshold; | |
2135 | ||
2136 | /// Cursors | |
2137 | wxCursor m_textCursor; | |
2138 | wxCursor m_urlCursor; | |
2139 | ||
2140 | static wxArrayString sm_availableFontNames; | |
2141 | ||
2142 | wxRichTextContextMenuPropertiesInfo m_contextMenuPropertiesInfo; | |
2143 | ||
2144 | /// The object that currently has the editing focus | |
2145 | wxRichTextParagraphLayoutBox* m_focusObject; | |
2146 | }; | |
2147 | ||
2148 | /** | |
2149 | @class wxRichTextEvent | |
2150 | ||
2151 | This is the event class for wxRichTextCtrl notifications. | |
2152 | ||
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. | |
2216 | @endEventTable | |
2217 | ||
2218 | @library{wxrichtext} | |
2219 | @category{events,richtext} | |
2220 | */ | |
2221 | ||
2222 | class WXDLLIMPEXP_RICHTEXT wxRichTextEvent : public wxNotifyEvent | |
2223 | { | |
2224 | public: | |
2225 | /** | |
2226 | Constructor. | |
2227 | ||
2228 | @param commandType | |
2229 | The type of the event. | |
2230 | @param id | |
2231 | Window identifier. The value @c wxID_ANY indicates a default value. | |
2232 | */ | |
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) | |
2237 | { } | |
2238 | ||
2239 | /** | |
2240 | Copy constructor. | |
2241 | */ | |
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) | |
2247 | { } | |
2248 | ||
2249 | /** | |
2250 | Returns the buffer position at which the event occured. | |
2251 | */ | |
2252 | long GetPosition() const { return m_position; } | |
2253 | ||
2254 | /** | |
2255 | Sets the buffer position variable. | |
2256 | */ | |
2257 | void SetPosition(long pos) { m_position = pos; } | |
2258 | ||
2259 | /** | |
2260 | Returns flags indicating modifier keys pressed. | |
2261 | ||
2262 | Possible values are @c wxRICHTEXT_CTRL_DOWN, @c wxRICHTEXT_SHIFT_DOWN, and @c wxRICHTEXT_ALT_DOWN. | |
2263 | */ | |
2264 | int GetFlags() const { return m_flags; } | |
2265 | ||
2266 | /** | |
2267 | Sets flags indicating modifier keys pressed. | |
2268 | ||
2269 | Possible values are @c wxRICHTEXT_CTRL_DOWN, @c wxRICHTEXT_SHIFT_DOWN, and @c wxRICHTEXT_ALT_DOWN. | |
2270 | */ | |
2271 | void SetFlags(int flags) { m_flags = flags; } | |
2272 | ||
2273 | /** | |
2274 | Returns the old style sheet. | |
2275 | ||
2276 | Can be used in a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING or | |
2277 | @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED event handler. | |
2278 | */ | |
2279 | wxRichTextStyleSheet* GetOldStyleSheet() const { return m_oldStyleSheet; } | |
2280 | ||
2281 | /** | |
2282 | Sets the old style sheet variable. | |
2283 | */ | |
2284 | void SetOldStyleSheet(wxRichTextStyleSheet* sheet) { m_oldStyleSheet = sheet; } | |
2285 | ||
2286 | /** | |
2287 | Returns the new style sheet. | |
2288 | ||
2289 | Can be used in a @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGING or | |
2290 | @c wxEVT_COMMAND_RICHTEXT_STYLESHEET_CHANGED event handler. | |
2291 | */ | |
2292 | wxRichTextStyleSheet* GetNewStyleSheet() const { return m_newStyleSheet; } | |
2293 | ||
2294 | /** | |
2295 | Sets the new style sheet variable. | |
2296 | */ | |
2297 | void SetNewStyleSheet(wxRichTextStyleSheet* sheet) { m_newStyleSheet = sheet; } | |
2298 | ||
2299 | /** | |
2300 | Gets the range for the current operation. | |
2301 | */ | |
2302 | const wxRichTextRange& GetRange() const { return m_range; } | |
2303 | ||
2304 | /** | |
2305 | Sets the range variable. | |
2306 | */ | |
2307 | void SetRange(const wxRichTextRange& range) { m_range = range; } | |
2308 | ||
2309 | /** | |
2310 | Returns the character pressed, within a @c wxEVT_COMMAND_RICHTEXT_CHARACTER event. | |
2311 | */ | |
2312 | wxChar GetCharacter() const { return m_char; } | |
2313 | ||
2314 | /** | |
2315 | Sets the character variable. | |
2316 | */ | |
2317 | void SetCharacter(wxChar ch) { m_char = ch; } | |
2318 | ||
2319 | /** | |
2320 | Returns the container for which the event is relevant. | |
2321 | */ | |
2322 | wxRichTextParagraphLayoutBox* GetContainer() const { return m_container; } | |
2323 | ||
2324 | /** | |
2325 | Sets the container for which the event is relevant. | |
2326 | */ | |
2327 | void SetContainer(wxRichTextParagraphLayoutBox* container) { m_container = container; } | |
2328 | ||
2329 | /** | |
2330 | Returns the old container, for a focus change event. | |
2331 | */ | |
2332 | wxRichTextParagraphLayoutBox* GetOldContainer() const { return m_oldContainer; } | |
2333 | ||
2334 | /** | |
2335 | Sets the old container, for a focus change event. | |
2336 | */ | |
2337 | void SetOldContainer(wxRichTextParagraphLayoutBox* container) { m_oldContainer = container; } | |
2338 | ||
2339 | virtual wxEvent *Clone() const { return new wxRichTextEvent(*this); } | |
2340 | ||
2341 | protected: | |
2342 | int m_flags; | |
2343 | long m_position; | |
2344 | wxRichTextStyleSheet* m_oldStyleSheet; | |
2345 | wxRichTextStyleSheet* m_newStyleSheet; | |
2346 | wxRichTextRange m_range; | |
2347 | wxChar m_char; | |
2348 | wxRichTextParagraphLayoutBox* m_container; | |
2349 | wxRichTextParagraphLayoutBox* m_oldContainer; | |
2350 | ||
2351 | private: | |
2352 | DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxRichTextEvent) | |
2353 | }; |