// Purpose: interface of wxRichTextStyleListCtrl
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
/**
Returns the style on which this style is based.
*/
- const wxString GetBaseStyle() const;
+ const wxString& GetBaseStyle() const;
/**
Returns the style's description.
*/
- const wxString GetDescription() const;
+ const wxString& GetDescription() const;
/**
Returns the style name.
*/
- const wxString GetName() const;
+ const wxString& GetName() const;
//@{
/**
Returns the style attributes combined with the attributes of the specified base
style, if any. This function works recursively.
*/
- wxTextAttr GetStyleMergedWithBase(wxRichTextStyleSheet* sheet) const;
+ virtual wxTextAttr GetStyleMergedWithBase(const wxRichTextStyleSheet* sheet) const;
/**
Sets the name of the style that this style is based on.
Sets the attributes for this style.
*/
void SetStyle(const wxTextAttr& style);
+
+ /**
+ Returns the definition's properties.
+ */
+ wxRichTextProperties& GetProperties();
+
+ /**
+ Returns the definition's properties.
+ */
+ const wxRichTextProperties& GetProperties() const;
+
+ /**
+ Sets the definition's properties.
+ */
+ void SetProperties(const wxRichTextProperties& props);
};
/**
Returns the style that should normally follow this style.
*/
- const wxString GetNextStyle() const;
+ const wxString& GetNextStyle() const;
/**
Sets the style that should normally follow this style.
*/
wxRichTextStyleListBox::wxRichTextStyleType GetStyleType() const;
- /**
- Returns the HTML for this item.
- */
- virtual wxString OnGetItem(size_t n) const;
-
/**
Implements left click behaviour, applying the clicked style to the
wxRichTextCtrl.
*/
void OnLeftDown(wxMouseEvent& event);
- /**
- Reacts to selection.
- */
- void OnSelect(wxCommandEvent& event);
-
/**
If @a applyOnSelection is @true, clicking on a style name in the list will
immediately apply the style to the associated rich text control.
Updates the list from the associated style sheet.
*/
void UpdateStyles();
+
+protected:
+
+ /**
+ Returns the HTML for this item.
+ */
+ virtual wxString OnGetItem(size_t n) const;
};
If @a styleSheet is specified, the base style for this definition will also be
included in the result.
*/
- wxTextAttr GetCombinedStyleLevel(int level,
+
+ wxTextAttr GetCombinedStyleForLevel(int level,
wxRichTextStyleSheet* styleSheet = NULL) const;
/**
/**
Returns @true if the given level has numbered list attributes.
*/
- int IsNumbered(int level) const;
+ bool IsNumbered(int level) const;
- //@{
/**
Sets the style for the given level. @a level is a number between 0 and 9.
The first and most flexible form uses a wxTextAttr object, while the second
form is for convenient setting of the most commonly-used attributes.
*/
void SetLevelAttributes(int level, const wxTextAttr& attr);
- void SetLevelAttributes(int level, int leftIndent,
- int leftSubIndent,
- int bulletStyle,
- const wxString& bulletSymbol = wxEmptyString);
- //@}
};
/**
Finds a character definition by name.
*/
- wxRichTextCharacterStyleDefinition* FindCharacterStyle(const wxString& name) const;
+ wxRichTextCharacterStyleDefinition* FindCharacterStyle(const wxString& name,
+ bool recurse = true) const;
/**
Finds a list definition by name.
*/
- wxRichTextListStyleDefinition* FindListStyle(const wxString& name) const;
+ wxRichTextListStyleDefinition* FindListStyle(const wxString& name,
+ bool recurse = true) const;
/**
Finds a paragraph definition by name.
*/
- wxRichTextParagraphStyleDefinition* FindParagraphStyle(const wxString& name) const;
+ wxRichTextParagraphStyleDefinition* FindParagraphStyle(const wxString& name,
+ bool recurse = true) const;
/**
Finds a style definition by name.
/**
Returns the style sheet's description.
*/
- const wxString GetDescription() const;
+ const wxString& GetDescription() const;
/**
Returns the @e nth list style.
/**
Returns the style sheet's name.
*/
- const wxString GetName() const;
+ const wxString& GetName() const;
/**
Returns the @e nth paragraph style.
Sets the style sheet's name.
*/
void SetName(const wxString& name);
+
+ /**
+ Returns the sheet's properties.
+ */
+ wxRichTextProperties& GetProperties();
+
+ /**
+ Returns the sheet's properties.
+ */
+ const wxRichTextProperties& GetProperties() const;
+
+ /**
+ Sets the sheet's properties.
+ */
+ void SetProperties(const wxRichTextProperties& props);
};