1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/richtext/richtextstyles.h
3 // Purpose: Style management for wxRichTextCtrl
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_RICHTEXTSTYLES_H_
13 #define _WX_RICHTEXTSTYLES_H_
23 #include "wx/richtext/richtextbuffer.h"
26 #include "wx/htmllbox.h"
33 #include "wx/choice.h"
36 * Forward declarations
39 class WXDLLIMPEXP_RICHTEXT wxRichTextCtrl
;
40 class WXDLLIMPEXP_RICHTEXT wxRichTextBuffer
;
43 * wxRichTextStyleDefinition class declaration
44 * A base class for paragraph and character styles.
47 class WXDLLIMPEXP_RICHTEXT wxRichTextStyleDefinition
: public wxObject
49 DECLARE_CLASS(wxRichTextStyleDefinition
)
53 wxRichTextStyleDefinition(const wxRichTextStyleDefinition
& def
)
60 /// Default constructor
61 wxRichTextStyleDefinition(const wxString
& name
= wxEmptyString
) { Init(); m_name
= name
; }
64 virtual ~wxRichTextStyleDefinition() {}
66 /// Initialises members
70 void Copy(const wxRichTextStyleDefinition
& def
);
73 bool Eq(const wxRichTextStyleDefinition
& def
) const;
75 /// Assignment operator
76 void operator =(const wxRichTextStyleDefinition
& def
) { Copy(def
); }
79 bool operator ==(const wxRichTextStyleDefinition
& def
) const { return Eq(def
); }
81 /// Override to clone the object
82 virtual wxRichTextStyleDefinition
* Clone() const = 0;
84 /// Sets and gets the name of the style
85 void SetName(const wxString
& name
) { m_name
= name
; }
86 const wxString
& GetName() const { return m_name
; }
88 /// Sets and gets the style description
89 void SetDescription(const wxString
& descr
) { m_description
= descr
; }
90 const wxString
& GetDescription() const { return m_description
; }
92 /// Sets and gets the name of the style that this style is based on
93 void SetBaseStyle(const wxString
& name
) { m_baseStyle
= name
; }
94 const wxString
& GetBaseStyle() const { return m_baseStyle
; }
96 /// Sets and gets the style
97 void SetStyle(const wxRichTextAttr
& style
) { m_style
= style
; }
98 const wxRichTextAttr
& GetStyle() const { return m_style
; }
99 wxRichTextAttr
& GetStyle() { return m_style
; }
101 /// Gets the style combined with the base style
102 virtual wxRichTextAttr
GetStyleMergedWithBase(const wxRichTextStyleSheet
* sheet
) const;
106 wxString m_baseStyle
;
107 wxString m_description
;
108 wxRichTextAttr m_style
;
112 * wxRichTextCharacterStyleDefinition class declaration
115 class WXDLLIMPEXP_RICHTEXT wxRichTextCharacterStyleDefinition
: public wxRichTextStyleDefinition
117 DECLARE_DYNAMIC_CLASS(wxRichTextCharacterStyleDefinition
)
121 wxRichTextCharacterStyleDefinition(const wxRichTextCharacterStyleDefinition
& def
): wxRichTextStyleDefinition(def
) {}
123 /// Default constructor
124 wxRichTextCharacterStyleDefinition(const wxString
& name
= wxEmptyString
):
125 wxRichTextStyleDefinition(name
) {}
128 virtual ~wxRichTextCharacterStyleDefinition() {}
130 /// Clones the object
131 virtual wxRichTextStyleDefinition
* Clone() const { return new wxRichTextCharacterStyleDefinition(*this); }
137 * wxRichTextParagraphStyleDefinition class declaration
140 class WXDLLIMPEXP_RICHTEXT wxRichTextParagraphStyleDefinition
: public wxRichTextStyleDefinition
142 DECLARE_DYNAMIC_CLASS(wxRichTextParagraphStyleDefinition
)
146 wxRichTextParagraphStyleDefinition(const wxRichTextParagraphStyleDefinition
& def
): wxRichTextStyleDefinition(def
) { m_nextStyle
= def
.m_nextStyle
; }
148 /// Default constructor
149 wxRichTextParagraphStyleDefinition(const wxString
& name
= wxEmptyString
):
150 wxRichTextStyleDefinition(name
) {}
153 virtual ~wxRichTextParagraphStyleDefinition() {}
155 /// Sets and gets the next style
156 void SetNextStyle(const wxString
& name
) { m_nextStyle
= name
; }
157 const wxString
& GetNextStyle() const { return m_nextStyle
; }
160 void Copy(const wxRichTextParagraphStyleDefinition
& def
);
162 /// Assignment operator
163 void operator =(const wxRichTextParagraphStyleDefinition
& def
) { Copy(def
); }
165 /// Equality operator
166 bool operator ==(const wxRichTextParagraphStyleDefinition
& def
) const;
168 /// Clones the object
169 virtual wxRichTextStyleDefinition
* Clone() const { return new wxRichTextParagraphStyleDefinition(*this); }
173 /// The next style to use when adding a paragraph after this style.
174 wxString m_nextStyle
;
178 * wxRichTextListStyleDefinition class declaration
181 class WXDLLIMPEXP_RICHTEXT wxRichTextListStyleDefinition
: public wxRichTextParagraphStyleDefinition
183 DECLARE_DYNAMIC_CLASS(wxRichTextListStyleDefinition
)
187 wxRichTextListStyleDefinition(const wxRichTextListStyleDefinition
& def
): wxRichTextParagraphStyleDefinition(def
) { Init(); Copy(def
); }
189 /// Default constructor
190 wxRichTextListStyleDefinition(const wxString
& name
= wxEmptyString
):
191 wxRichTextParagraphStyleDefinition(name
) { Init(); }
194 virtual ~wxRichTextListStyleDefinition() {}
197 void Copy(const wxRichTextListStyleDefinition
& def
);
199 /// Assignment operator
200 void operator =(const wxRichTextListStyleDefinition
& def
) { Copy(def
); }
202 /// Equality operator
203 bool operator ==(const wxRichTextListStyleDefinition
& def
) const;
205 /// Clones the object
206 virtual wxRichTextStyleDefinition
* Clone() const { return new wxRichTextListStyleDefinition(*this); }
208 /// Sets/gets the attributes for the given level
209 void SetLevelAttributes(int i
, const wxRichTextAttr
& attr
);
210 wxRichTextAttr
* GetLevelAttributes(int i
);
211 const wxRichTextAttr
* GetLevelAttributes(int i
) const;
213 /// Convenience function for setting the major attributes for a list level specification
214 void SetAttributes(int i
, int leftIndent
, int leftSubIndent
, int bulletStyle
, const wxString
& bulletSymbol
= wxEmptyString
);
216 /// Finds the level corresponding to the given indentation
217 int FindLevelForIndent(int indent
) const;
219 /// Combine the base and list style with a paragraph style, using the given indent (from which
220 /// an appropriate level is found)
221 wxRichTextAttr
CombineWithParagraphStyle(int indent
, const wxRichTextAttr
& paraStyle
, wxRichTextStyleSheet
* styleSheet
= NULL
);
223 /// Combine the base and list style, using the given indent (from which
224 /// an appropriate level is found)
225 wxRichTextAttr
GetCombinedStyle(int indent
, wxRichTextStyleSheet
* styleSheet
= NULL
);
227 /// Combine the base and list style, using the given level from which
228 /// an appropriate level is found)
229 wxRichTextAttr
GetCombinedStyleForLevel(int level
, wxRichTextStyleSheet
* styleSheet
= NULL
);
231 /// Gets the number of available levels
232 int GetLevelCount() const { return 10; }
234 /// Is this a numbered list?
235 bool IsNumbered(int i
) const;
239 /// The styles for each level (up to 10)
240 wxRichTextAttr m_levelStyles
[10];
247 class WXDLLIMPEXP_RICHTEXT wxRichTextStyleSheet
: public wxObject
249 DECLARE_CLASS( wxRichTextStyleSheet
)
253 wxRichTextStyleSheet(const wxRichTextStyleSheet
& sheet
)
258 wxRichTextStyleSheet() { Init(); }
259 virtual ~wxRichTextStyleSheet();
265 void Copy(const wxRichTextStyleSheet
& sheet
);
268 void operator=(const wxRichTextStyleSheet
& sheet
) { Copy(sheet
); }
271 bool operator==(const wxRichTextStyleSheet
& sheet
) const;
273 /// Add a definition to the character style list
274 bool AddCharacterStyle(wxRichTextCharacterStyleDefinition
* def
);
276 /// Add a definition to the paragraph style list
277 bool AddParagraphStyle(wxRichTextParagraphStyleDefinition
* def
);
279 /// Add a definition to the list style list
280 bool AddListStyle(wxRichTextListStyleDefinition
* def
);
282 /// Add a definition to the appropriate style list
283 bool AddStyle(wxRichTextStyleDefinition
* def
);
285 /// Remove a character style
286 bool RemoveCharacterStyle(wxRichTextStyleDefinition
* def
, bool deleteStyle
= false) { return RemoveStyle(m_characterStyleDefinitions
, def
, deleteStyle
); }
288 /// Remove a paragraph style
289 bool RemoveParagraphStyle(wxRichTextStyleDefinition
* def
, bool deleteStyle
= false) { return RemoveStyle(m_paragraphStyleDefinitions
, def
, deleteStyle
); }
291 /// Remove a list style
292 bool RemoveListStyle(wxRichTextStyleDefinition
* def
, bool deleteStyle
= false) { return RemoveStyle(m_listStyleDefinitions
, def
, deleteStyle
); }
295 bool RemoveStyle(wxRichTextStyleDefinition
* def
, bool deleteStyle
= false);
297 /// Find a character definition by name
298 wxRichTextCharacterStyleDefinition
* FindCharacterStyle(const wxString
& name
, bool recurse
= true) const { return (wxRichTextCharacterStyleDefinition
*) FindStyle(m_characterStyleDefinitions
, name
, recurse
); }
300 /// Find a paragraph definition by name
301 wxRichTextParagraphStyleDefinition
* FindParagraphStyle(const wxString
& name
, bool recurse
= true) const { return (wxRichTextParagraphStyleDefinition
*) FindStyle(m_paragraphStyleDefinitions
, name
, recurse
); }
303 /// Find a list definition by name
304 wxRichTextListStyleDefinition
* FindListStyle(const wxString
& name
, bool recurse
= true) const { return (wxRichTextListStyleDefinition
*) FindStyle(m_listStyleDefinitions
, name
, recurse
); }
306 /// Find any definition by name
307 wxRichTextStyleDefinition
* FindStyle(const wxString
& name
, bool recurse
= true) const;
309 /// Return the number of character styles
310 size_t GetCharacterStyleCount() const { return m_characterStyleDefinitions
.GetCount(); }
312 /// Return the number of paragraph styles
313 size_t GetParagraphStyleCount() const { return m_paragraphStyleDefinitions
.GetCount(); }
315 /// Return the number of list styles
316 size_t GetListStyleCount() const { return m_listStyleDefinitions
.GetCount(); }
318 /// Return the nth character style
319 wxRichTextCharacterStyleDefinition
* GetCharacterStyle(size_t n
) const { return (wxRichTextCharacterStyleDefinition
*) m_characterStyleDefinitions
.Item(n
)->GetData(); }
321 /// Return the nth paragraph style
322 wxRichTextParagraphStyleDefinition
* GetParagraphStyle(size_t n
) const { return (wxRichTextParagraphStyleDefinition
*) m_paragraphStyleDefinitions
.Item(n
)->GetData(); }
324 /// Return the nth list style
325 wxRichTextListStyleDefinition
* GetListStyle(size_t n
) const { return (wxRichTextListStyleDefinition
*) m_listStyleDefinitions
.Item(n
)->GetData(); }
327 /// Delete all styles
330 /// Insert into list of style sheets
331 bool InsertSheet(wxRichTextStyleSheet
* before
);
333 /// Append to list of style sheets
334 bool AppendSheet(wxRichTextStyleSheet
* after
);
336 /// Unlink from the list of style sheets
339 /// Get/set next sheet
340 wxRichTextStyleSheet
* GetNextSheet() const { return m_nextSheet
; }
341 void SetNextSheet(wxRichTextStyleSheet
* sheet
) { m_nextSheet
= sheet
; }
343 /// Get/set previous sheet
344 wxRichTextStyleSheet
* GetPreviousSheet() const { return m_previousSheet
; }
345 void SetPreviousSheet(wxRichTextStyleSheet
* sheet
) { m_previousSheet
= sheet
; }
347 /// Sets and gets the name of the style sheet
348 void SetName(const wxString
& name
) { m_name
= name
; }
349 const wxString
& GetName() const { return m_name
; }
351 /// Sets and gets the style description
352 void SetDescription(const wxString
& descr
) { m_description
= descr
; }
353 const wxString
& GetDescription() const { return m_description
; }
357 /// Add a definition to one of the style lists
358 bool AddStyle(wxList
& list
, wxRichTextStyleDefinition
* def
);
361 bool RemoveStyle(wxList
& list
, wxRichTextStyleDefinition
* def
, bool deleteStyle
);
363 /// Find a definition by name
364 wxRichTextStyleDefinition
* FindStyle(const wxList
& list
, const wxString
& name
, bool recurse
= true) const;
368 wxString m_description
;
371 wxList m_characterStyleDefinitions
;
372 wxList m_paragraphStyleDefinitions
;
373 wxList m_listStyleDefinitions
;
375 wxRichTextStyleSheet
* m_previousSheet
;
376 wxRichTextStyleSheet
* m_nextSheet
;
381 * wxRichTextStyleListBox class declaration
382 * A listbox to display styles.
385 class WXDLLIMPEXP_RICHTEXT wxRichTextStyleListBox
: public wxHtmlListBox
387 DECLARE_CLASS(wxRichTextStyleListBox
)
388 DECLARE_EVENT_TABLE()
391 /// Which type of style definition is currently showing?
392 enum wxRichTextStyleType
394 wxRICHTEXT_STYLE_ALL
,
395 wxRICHTEXT_STYLE_PARAGRAPH
,
396 wxRICHTEXT_STYLE_CHARACTER
,
397 wxRICHTEXT_STYLE_LIST
400 wxRichTextStyleListBox()
404 wxRichTextStyleListBox(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
405 const wxSize
& size
= wxDefaultSize
, long style
= 0);
406 virtual ~wxRichTextStyleListBox();
411 m_richTextCtrl
= NULL
;
412 m_applyOnSelection
= false;
413 m_styleType
= wxRICHTEXT_STYLE_PARAGRAPH
;
414 m_autoSetSelection
= true;
417 bool Create(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
418 const wxSize
& size
= wxDefaultSize
, long style
= 0);
420 /// Creates a suitable HTML fragment for a definition
421 wxString
CreateHTML(wxRichTextStyleDefinition
* def
) const;
423 /// Associates the control with a style sheet
424 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
) { m_styleSheet
= styleSheet
; }
425 wxRichTextStyleSheet
* GetStyleSheet() const { return m_styleSheet
; }
427 /// Associates the control with a wxRichTextCtrl
428 void SetRichTextCtrl(wxRichTextCtrl
* ctrl
) { m_richTextCtrl
= ctrl
; }
429 wxRichTextCtrl
* GetRichTextCtrl() const { return m_richTextCtrl
; }
431 /// Get style for index
432 wxRichTextStyleDefinition
* GetStyle(size_t i
) const ;
434 /// Get index for style name
435 int GetIndexForStyle(const wxString
& name
) const ;
437 /// Set selection for string, returning the index.
438 int SetStyleSelection(const wxString
& name
);
444 void ApplyStyle(int i
);
447 void OnLeftDown(wxMouseEvent
& event
);
449 /// Left double-click
450 void OnLeftDoubleClick(wxMouseEvent
& event
);
452 /// Auto-select from style under caret in idle time
453 void OnIdle(wxIdleEvent
& event
);
455 /// Convert units in tends of a millimetre to device units
456 int ConvertTenthsMMToPixels(wxDC
& dc
, int units
) const;
458 /// Can we set the selection based on the editor caret position?
459 /// Need to override this if being used in a combobox popup
460 virtual bool CanAutoSetSelection() { return m_autoSetSelection
; }
461 virtual void SetAutoSetSelection(bool autoSet
) { m_autoSetSelection
= autoSet
; }
463 /// Set whether the style should be applied as soon as the item is selected (the default)
464 void SetApplyOnSelection(bool applyOnSel
) { m_applyOnSelection
= applyOnSel
; }
465 bool GetApplyOnSelection() const { return m_applyOnSelection
; }
467 /// Set the style type to display
468 void SetStyleType(wxRichTextStyleType styleType
) { m_styleType
= styleType
; UpdateStyles(); }
469 wxRichTextStyleType
GetStyleType() const { return m_styleType
; }
471 /// Helper for listbox and combo control
472 static wxString
GetStyleToShowInIdleTime(wxRichTextCtrl
* ctrl
, wxRichTextStyleType styleType
);
475 /// Returns the HTML for this item
476 virtual wxString
OnGetItem(size_t n
) const;
480 wxRichTextStyleSheet
* m_styleSheet
;
481 wxRichTextCtrl
* m_richTextCtrl
;
482 bool m_applyOnSelection
; // if true, applies style on selection
483 wxRichTextStyleType m_styleType
; // style type to display
484 bool m_autoSetSelection
;
485 wxArrayString m_styleNames
;
489 * wxRichTextStyleListCtrl class declaration
490 * This is a container for the list control plus a combobox to switch between
494 #define wxRICHTEXTSTYLELIST_HIDE_TYPE_SELECTOR 0x1000
496 class WXDLLIMPEXP_RICHTEXT wxRichTextStyleListCtrl
: public wxControl
498 DECLARE_CLASS(wxRichTextStyleListCtrl
)
499 DECLARE_EVENT_TABLE()
504 wxRichTextStyleListCtrl()
509 wxRichTextStyleListCtrl(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
510 const wxSize
& size
= wxDefaultSize
, long style
= 0);
513 virtual ~wxRichTextStyleListCtrl();
515 /// Member initialisation
518 m_styleListBox
= NULL
;
519 m_styleChoice
= NULL
;
520 m_dontUpdate
= false;
523 /// Creates the windows
524 bool Create(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
525 const wxSize
& size
= wxDefaultSize
, long style
= 0);
527 /// Updates the style list box
530 /// Associates the control with a style sheet
531 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
);
532 wxRichTextStyleSheet
* GetStyleSheet() const;
534 /// Associates the control with a wxRichTextCtrl
535 void SetRichTextCtrl(wxRichTextCtrl
* ctrl
);
536 wxRichTextCtrl
* GetRichTextCtrl() const;
538 /// Set/get the style type to display
539 void SetStyleType(wxRichTextStyleListBox::wxRichTextStyleType styleType
);
540 wxRichTextStyleListBox::wxRichTextStyleType
GetStyleType() const;
542 /// Get the choice index for style type
543 int StyleTypeToIndex(wxRichTextStyleListBox::wxRichTextStyleType styleType
);
545 /// Get the style type for choice index
546 wxRichTextStyleListBox::wxRichTextStyleType
StyleIndexToType(int i
);
549 wxRichTextStyleListBox
* GetStyleListBox() const { return m_styleListBox
; }
552 wxChoice
* GetStyleChoice() const { return m_styleChoice
; }
554 /// React to style type choice
555 void OnChooseType(wxCommandEvent
& event
);
557 /// Lay out the controls
558 void OnSize(wxSizeEvent
& event
);
562 wxRichTextStyleListBox
* m_styleListBox
;
563 wxChoice
* m_styleChoice
;
570 * Style drop-down for a wxComboCtrl
573 class wxRichTextStyleComboPopup
: public wxRichTextStyleListBox
, public wxComboPopup
578 m_itemHere
= -1; // hot item in list
582 virtual bool Create( wxWindow
* parent
)
584 return wxRichTextStyleListBox::Create(parent
, wxID_ANY
,
585 wxPoint(0,0), wxDefaultSize
,
589 virtual wxWindow
*GetControl() { return this; }
591 virtual void SetStringValue( const wxString
& s
);
593 virtual wxString
GetStringValue() const;
595 /// Can we set the selection based on the editor caret position?
596 // virtual bool CanAutoSetSelection() { return ((m_combo == NULL) || !m_combo->IsPopupShown()); }
597 virtual bool CanAutoSetSelection() { return false; }
600 // Popup event handlers
603 // Mouse hot-tracking
604 void OnMouseMove(wxMouseEvent
& event
);
606 // On mouse left, set the value and close the popup
607 void OnMouseClick(wxMouseEvent
& WXUNUSED(event
));
611 int m_itemHere
; // hot item in popup
615 DECLARE_EVENT_TABLE()
619 * wxRichTextStyleComboCtrl
620 * A combo for applying styles.
623 class WXDLLIMPEXP_RICHTEXT wxRichTextStyleComboCtrl
: public wxComboCtrl
625 DECLARE_CLASS(wxRichTextStyleComboCtrl
)
626 DECLARE_EVENT_TABLE()
629 wxRichTextStyleComboCtrl()
634 wxRichTextStyleComboCtrl(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
635 const wxSize
& size
= wxDefaultSize
, long style
= wxCB_READONLY
)
638 Create(parent
, id
, pos
, size
, style
);
641 virtual ~wxRichTextStyleComboCtrl() {}
648 bool Create(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
649 const wxSize
& size
= wxDefaultSize
, long style
= 0);
652 void UpdateStyles() { m_stylePopup
->UpdateStyles(); }
654 /// Associates the control with a style sheet
655 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
) { m_stylePopup
->SetStyleSheet(styleSheet
); }
656 wxRichTextStyleSheet
* GetStyleSheet() const { return m_stylePopup
->GetStyleSheet(); }
658 /// Associates the control with a wxRichTextCtrl
659 void SetRichTextCtrl(wxRichTextCtrl
* ctrl
) { m_stylePopup
->SetRichTextCtrl(ctrl
); }
660 wxRichTextCtrl
* GetRichTextCtrl() const { return m_stylePopup
->GetRichTextCtrl(); }
662 /// Gets the style popup
663 wxRichTextStyleComboPopup
* GetStylePopup() const { return m_stylePopup
; }
665 /// Auto-select from style under caret in idle time
666 void OnIdle(wxIdleEvent
& event
);
669 wxRichTextStyleComboPopup
* m_stylePopup
;
682 // _WX_RICHTEXTSTYLES_H_