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_FWD_RICHTEXT wxRichTextCtrl
;
40 class WXDLLIMPEXP_FWD_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
)
259 wxRichTextStyleSheet() { Init(); }
260 virtual ~wxRichTextStyleSheet();
266 void Copy(const wxRichTextStyleSheet
& sheet
);
269 void operator=(const wxRichTextStyleSheet
& sheet
) { Copy(sheet
); }
272 bool operator==(const wxRichTextStyleSheet
& sheet
) const;
274 /// Add a definition to the character style list
275 bool AddCharacterStyle(wxRichTextCharacterStyleDefinition
* def
);
277 /// Add a definition to the paragraph style list
278 bool AddParagraphStyle(wxRichTextParagraphStyleDefinition
* def
);
280 /// Add a definition to the list style list
281 bool AddListStyle(wxRichTextListStyleDefinition
* def
);
283 /// Add a definition to the appropriate style list
284 bool AddStyle(wxRichTextStyleDefinition
* def
);
286 /// Remove a character style
287 bool RemoveCharacterStyle(wxRichTextStyleDefinition
* def
, bool deleteStyle
= false) { return RemoveStyle(m_characterStyleDefinitions
, def
, deleteStyle
); }
289 /// Remove a paragraph style
290 bool RemoveParagraphStyle(wxRichTextStyleDefinition
* def
, bool deleteStyle
= false) { return RemoveStyle(m_paragraphStyleDefinitions
, def
, deleteStyle
); }
292 /// Remove a list style
293 bool RemoveListStyle(wxRichTextStyleDefinition
* def
, bool deleteStyle
= false) { return RemoveStyle(m_listStyleDefinitions
, def
, deleteStyle
); }
296 bool RemoveStyle(wxRichTextStyleDefinition
* def
, bool deleteStyle
= false);
298 /// Find a character definition by name
299 wxRichTextCharacterStyleDefinition
* FindCharacterStyle(const wxString
& name
, bool recurse
= true) const { return (wxRichTextCharacterStyleDefinition
*) FindStyle(m_characterStyleDefinitions
, name
, recurse
); }
301 /// Find a paragraph definition by name
302 wxRichTextParagraphStyleDefinition
* FindParagraphStyle(const wxString
& name
, bool recurse
= true) const { return (wxRichTextParagraphStyleDefinition
*) FindStyle(m_paragraphStyleDefinitions
, name
, recurse
); }
304 /// Find a list definition by name
305 wxRichTextListStyleDefinition
* FindListStyle(const wxString
& name
, bool recurse
= true) const { return (wxRichTextListStyleDefinition
*) FindStyle(m_listStyleDefinitions
, name
, recurse
); }
307 /// Find any definition by name
308 wxRichTextStyleDefinition
* FindStyle(const wxString
& name
, bool recurse
= true) const;
310 /// Return the number of character styles
311 size_t GetCharacterStyleCount() const { return m_characterStyleDefinitions
.GetCount(); }
313 /// Return the number of paragraph styles
314 size_t GetParagraphStyleCount() const { return m_paragraphStyleDefinitions
.GetCount(); }
316 /// Return the number of list styles
317 size_t GetListStyleCount() const { return m_listStyleDefinitions
.GetCount(); }
319 /// Return the nth character style
320 wxRichTextCharacterStyleDefinition
* GetCharacterStyle(size_t n
) const { return (wxRichTextCharacterStyleDefinition
*) m_characterStyleDefinitions
.Item(n
)->GetData(); }
322 /// Return the nth paragraph style
323 wxRichTextParagraphStyleDefinition
* GetParagraphStyle(size_t n
) const { return (wxRichTextParagraphStyleDefinition
*) m_paragraphStyleDefinitions
.Item(n
)->GetData(); }
325 /// Return the nth list style
326 wxRichTextListStyleDefinition
* GetListStyle(size_t n
) const { return (wxRichTextListStyleDefinition
*) m_listStyleDefinitions
.Item(n
)->GetData(); }
328 /// Delete all styles
331 /// Insert into list of style sheets
332 bool InsertSheet(wxRichTextStyleSheet
* before
);
334 /// Append to list of style sheets
335 bool AppendSheet(wxRichTextStyleSheet
* after
);
337 /// Unlink from the list of style sheets
340 /// Get/set next sheet
341 wxRichTextStyleSheet
* GetNextSheet() const { return m_nextSheet
; }
342 void SetNextSheet(wxRichTextStyleSheet
* sheet
) { m_nextSheet
= sheet
; }
344 /// Get/set previous sheet
345 wxRichTextStyleSheet
* GetPreviousSheet() const { return m_previousSheet
; }
346 void SetPreviousSheet(wxRichTextStyleSheet
* sheet
) { m_previousSheet
= sheet
; }
348 /// Sets and gets the name of the style sheet
349 void SetName(const wxString
& name
) { m_name
= name
; }
350 const wxString
& GetName() const { return m_name
; }
352 /// Sets and gets the style description
353 void SetDescription(const wxString
& descr
) { m_description
= descr
; }
354 const wxString
& GetDescription() const { return m_description
; }
358 /// Add a definition to one of the style lists
359 bool AddStyle(wxList
& list
, wxRichTextStyleDefinition
* def
);
362 bool RemoveStyle(wxList
& list
, wxRichTextStyleDefinition
* def
, bool deleteStyle
);
364 /// Find a definition by name
365 wxRichTextStyleDefinition
* FindStyle(const wxList
& list
, const wxString
& name
, bool recurse
= true) const;
369 wxString m_description
;
372 wxList m_characterStyleDefinitions
;
373 wxList m_paragraphStyleDefinitions
;
374 wxList m_listStyleDefinitions
;
376 wxRichTextStyleSheet
* m_previousSheet
;
377 wxRichTextStyleSheet
* m_nextSheet
;
382 * wxRichTextStyleListBox class declaration
383 * A listbox to display styles.
386 class WXDLLIMPEXP_RICHTEXT wxRichTextStyleListBox
: public wxHtmlListBox
388 DECLARE_CLASS(wxRichTextStyleListBox
)
389 DECLARE_EVENT_TABLE()
392 /// Which type of style definition is currently showing?
393 enum wxRichTextStyleType
395 wxRICHTEXT_STYLE_ALL
,
396 wxRICHTEXT_STYLE_PARAGRAPH
,
397 wxRICHTEXT_STYLE_CHARACTER
,
398 wxRICHTEXT_STYLE_LIST
401 wxRichTextStyleListBox()
405 wxRichTextStyleListBox(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
406 const wxSize
& size
= wxDefaultSize
, long style
= 0);
407 virtual ~wxRichTextStyleListBox();
412 m_richTextCtrl
= NULL
;
413 m_applyOnSelection
= false;
414 m_styleType
= wxRICHTEXT_STYLE_PARAGRAPH
;
415 m_autoSetSelection
= true;
418 bool Create(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
419 const wxSize
& size
= wxDefaultSize
, long style
= 0);
421 /// Creates a suitable HTML fragment for a definition
422 wxString
CreateHTML(wxRichTextStyleDefinition
* def
) const;
424 /// Associates the control with a style sheet
425 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
) { m_styleSheet
= styleSheet
; }
426 wxRichTextStyleSheet
* GetStyleSheet() const { return m_styleSheet
; }
428 /// Associates the control with a wxRichTextCtrl
429 void SetRichTextCtrl(wxRichTextCtrl
* ctrl
) { m_richTextCtrl
= ctrl
; }
430 wxRichTextCtrl
* GetRichTextCtrl() const { return m_richTextCtrl
; }
432 /// Get style for index
433 wxRichTextStyleDefinition
* GetStyle(size_t i
) const ;
435 /// Get index for style name
436 int GetIndexForStyle(const wxString
& name
) const ;
438 /// Set selection for string, returning the index.
439 int SetStyleSelection(const wxString
& name
);
445 void ApplyStyle(int i
);
448 void OnLeftDown(wxMouseEvent
& event
);
450 /// Left double-click
451 void OnLeftDoubleClick(wxMouseEvent
& event
);
453 /// Auto-select from style under caret in idle time
454 void OnIdle(wxIdleEvent
& event
);
456 /// Convert units in tends of a millimetre to device units
457 int ConvertTenthsMMToPixels(wxDC
& dc
, int units
) const;
459 /// Can we set the selection based on the editor caret position?
460 /// Need to override this if being used in a combobox popup
461 virtual bool CanAutoSetSelection() { return m_autoSetSelection
; }
462 virtual void SetAutoSetSelection(bool autoSet
) { m_autoSetSelection
= autoSet
; }
464 /// Set whether the style should be applied as soon as the item is selected (the default)
465 void SetApplyOnSelection(bool applyOnSel
) { m_applyOnSelection
= applyOnSel
; }
466 bool GetApplyOnSelection() const { return m_applyOnSelection
; }
468 /// Set the style type to display
469 void SetStyleType(wxRichTextStyleType styleType
) { m_styleType
= styleType
; UpdateStyles(); }
470 wxRichTextStyleType
GetStyleType() const { return m_styleType
; }
472 /// Helper for listbox and combo control
473 static wxString
GetStyleToShowInIdleTime(wxRichTextCtrl
* ctrl
, wxRichTextStyleType styleType
);
476 /// Returns the HTML for this item
477 virtual wxString
OnGetItem(size_t n
) const;
481 wxRichTextStyleSheet
* m_styleSheet
;
482 wxRichTextCtrl
* m_richTextCtrl
;
483 bool m_applyOnSelection
; // if true, applies style on selection
484 wxRichTextStyleType m_styleType
; // style type to display
485 bool m_autoSetSelection
;
486 wxArrayString m_styleNames
;
490 * wxRichTextStyleListCtrl class declaration
491 * This is a container for the list control plus a combobox to switch between
495 #define wxRICHTEXTSTYLELIST_HIDE_TYPE_SELECTOR 0x1000
497 class WXDLLIMPEXP_RICHTEXT wxRichTextStyleListCtrl
: public wxControl
499 DECLARE_CLASS(wxRichTextStyleListCtrl
)
500 DECLARE_EVENT_TABLE()
505 wxRichTextStyleListCtrl()
510 wxRichTextStyleListCtrl(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
511 const wxSize
& size
= wxDefaultSize
, long style
= 0);
514 virtual ~wxRichTextStyleListCtrl();
516 /// Member initialisation
519 m_styleListBox
= NULL
;
520 m_styleChoice
= NULL
;
521 m_dontUpdate
= false;
524 /// Creates the windows
525 bool Create(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
526 const wxSize
& size
= wxDefaultSize
, long style
= 0);
528 /// Updates the style list box
531 /// Associates the control with a style sheet
532 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
);
533 wxRichTextStyleSheet
* GetStyleSheet() const;
535 /// Associates the control with a wxRichTextCtrl
536 void SetRichTextCtrl(wxRichTextCtrl
* ctrl
);
537 wxRichTextCtrl
* GetRichTextCtrl() const;
539 /// Set/get the style type to display
540 void SetStyleType(wxRichTextStyleListBox::wxRichTextStyleType styleType
);
541 wxRichTextStyleListBox::wxRichTextStyleType
GetStyleType() const;
543 /// Get the choice index for style type
544 int StyleTypeToIndex(wxRichTextStyleListBox::wxRichTextStyleType styleType
);
546 /// Get the style type for choice index
547 wxRichTextStyleListBox::wxRichTextStyleType
StyleIndexToType(int i
);
550 wxRichTextStyleListBox
* GetStyleListBox() const { return m_styleListBox
; }
553 wxChoice
* GetStyleChoice() const { return m_styleChoice
; }
555 /// React to style type choice
556 void OnChooseType(wxCommandEvent
& event
);
558 /// Lay out the controls
559 void OnSize(wxSizeEvent
& event
);
563 wxRichTextStyleListBox
* m_styleListBox
;
564 wxChoice
* m_styleChoice
;
571 * Style drop-down for a wxComboCtrl
574 class wxRichTextStyleComboPopup
: public wxRichTextStyleListBox
, public wxComboPopup
579 m_itemHere
= -1; // hot item in list
583 virtual bool Create( wxWindow
* parent
);
585 virtual wxWindow
*GetControl() { return this; }
587 virtual void SetStringValue( const wxString
& s
);
589 virtual wxString
GetStringValue() const;
591 /// Can we set the selection based on the editor caret position?
592 // virtual bool CanAutoSetSelection() { return ((m_combo == NULL) || !m_combo->IsPopupShown()); }
593 virtual bool CanAutoSetSelection() { return false; }
596 // Popup event handlers
599 // Mouse hot-tracking
600 void OnMouseMove(wxMouseEvent
& event
);
602 // On mouse left, set the value and close the popup
603 void OnMouseClick(wxMouseEvent
& WXUNUSED(event
));
607 int m_itemHere
; // hot item in popup
611 DECLARE_EVENT_TABLE()
615 * wxRichTextStyleComboCtrl
616 * A combo for applying styles.
619 class WXDLLIMPEXP_RICHTEXT wxRichTextStyleComboCtrl
: public wxComboCtrl
621 DECLARE_CLASS(wxRichTextStyleComboCtrl
)
622 DECLARE_EVENT_TABLE()
625 wxRichTextStyleComboCtrl()
630 wxRichTextStyleComboCtrl(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
631 const wxSize
& size
= wxDefaultSize
, long style
= wxCB_READONLY
)
634 Create(parent
, id
, pos
, size
, style
);
637 virtual ~wxRichTextStyleComboCtrl() {}
644 bool Create(wxWindow
* parent
, wxWindowID id
= wxID_ANY
, const wxPoint
& pos
= wxDefaultPosition
,
645 const wxSize
& size
= wxDefaultSize
, long style
= 0);
648 void UpdateStyles() { m_stylePopup
->UpdateStyles(); }
650 /// Associates the control with a style sheet
651 void SetStyleSheet(wxRichTextStyleSheet
* styleSheet
) { m_stylePopup
->SetStyleSheet(styleSheet
); }
652 wxRichTextStyleSheet
* GetStyleSheet() const { return m_stylePopup
->GetStyleSheet(); }
654 /// Associates the control with a wxRichTextCtrl
655 void SetRichTextCtrl(wxRichTextCtrl
* ctrl
) { m_stylePopup
->SetRichTextCtrl(ctrl
); }
656 wxRichTextCtrl
* GetRichTextCtrl() const { return m_stylePopup
->GetRichTextCtrl(); }
658 /// Gets the style popup
659 wxRichTextStyleComboPopup
* GetStylePopup() const { return m_stylePopup
; }
661 /// Auto-select from style under caret in idle time
662 void OnIdle(wxIdleEvent
& event
);
665 wxRichTextStyleComboPopup
* m_stylePopup
;
678 // _WX_RICHTEXTSTYLES_H_