X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/12f5e1e78fe906050ff2fee9529476db332633f0..b19b28c8fca9815949753ed0c68097efe8943b18:/interface/wx/richtext/richtextstyledlg.h diff --git a/interface/wx/richtext/richtextstyledlg.h b/interface/wx/richtext/richtextstyledlg.h index 15210bc6ad..9b8787377b 100644 --- a/interface/wx/richtext/richtextstyledlg.h +++ b/interface/wx/richtext/richtextstyledlg.h @@ -9,8 +9,8 @@ /** @class wxRichTextStyleOrganiserDialog - This class shows a style sheet and allows the user to edit, add and remove - styles. + This class shows a style sheet and allows the user to edit, add and remove styles. + It can also be used as a style browser, for example if the application is not using a permanent wxRichTextStyleComboCtrl or wxRichTextStyleListCtrl to present styles. @@ -21,85 +21,58 @@ class wxRichTextStyleOrganiserDialog : public wxDialog { public: - //@{ /** - Constructors. + Default ctor. + */ + wxRichTextStyleOrganiserDialog(); + + /** + Constructor. + To create a dialog, pass a bitlist of @a flags (see below), a style sheet, a - text control to apply a selected style to (or @NULL), followed by the usual window parameters. + text control to apply a selected style to (or @NULL), followed by the usual + window parameters. + To specify the operations available to the user, pass a combination of these values to @e flags: - - @b wxRICHTEXT_ORGANISER_DELETE_STYLES - - Provides a button for deleting styles. - - @b wxRICHTEXT_ORGANISER_CREATE_STYLES - - Provides buttons for creating styles. - - @b wxRICHTEXT_ORGANISER_APPLY_STYLES - - Provides a button for applying the currently selected style to the selection. - - @b wxRICHTEXT_ORGANISER_EDIT_STYLES - - Provides a button for editing styles. - - @b wxRICHTEXT_ORGANISER_RENAME_STYLES - - Provides a button for renaming styles. - - @b wxRICHTEXT_ORGANISER_OK_CANCEL - - Provides OK and Cancel buttons. - - @b wxRICHTEXT_ORGANISER_RENUMBER - - Provides a checkbox for specifying that the selection should be renumbered. - + + - @b wxRICHTEXT_ORGANISER_DELETE_STYLES: Provides a button for deleting styles. + - @b wxRICHTEXT_ORGANISER_CREATE_STYLES: Provides buttons for creating styles. + - @b wxRICHTEXT_ORGANISER_APPLY_STYLES: Provides a button for applying the + currently selected style to the selection. + - @b wxRICHTEXT_ORGANISER_EDIT_STYLES: Provides a button for editing styles. + - @b wxRICHTEXT_ORGANISER_RENAME_STYLES: Provides a button for renaming styles. + - @b wxRICHTEXT_ORGANISER_OK_CANCEL: Provides OK and Cancel buttons. + - @b wxRICHTEXT_ORGANISER_RENUMBER: Provides a checkbox for specifying that + the selection should be renumbered. + The following flags determine what will be displayed in the style list: - - @b wxRICHTEXT_ORGANISER_SHOW_CHARACTER - - Displays character styles only. - - @b wxRICHTEXT_ORGANISER_SHOW_PARAGRAPH - - Displays paragraph styles only. - - @b wxRICHTEXT_ORGANISER_SHOW_LIST - - Displays list styles only. - - @b wxRICHTEXT_ORGANISER_SHOW_ALL - - Displays all styles. - + + - @b wxRICHTEXT_ORGANISER_SHOW_CHARACTER: Displays character styles only. + - @b wxRICHTEXT_ORGANISER_SHOW_PARAGRAPH: Displays paragraph styles only. + - @b wxRICHTEXT_ORGANISER_SHOW_LIST: Displays list styles only. + - @b wxRICHTEXT_ORGANISER_SHOW_ALL: Displays all styles. + The following symbols define commonly-used combinations of flags: - - @b wxRICHTEXT_ORGANISER_ORGANISE - - Enable all style editing operations so the dialog behaves as a style organiser. - - @b wxRICHTEXT_ORGANISER_BROWSE - - Show a list of all styles and their previews, but only allow application of a - style or - cancellation of the dialog. This makes the dialog behave as a style browser. - - @b wxRICHTEXT_ORGANISER_BROWSE_NUMBERING - - Enables only list style browsing, plus a control to specify renumbering. This - allows the dialog to be used for applying list styles to the selection. + + - @b wxRICHTEXT_ORGANISER_ORGANISE: + Enable all style editing operations so the dialog behaves as a style organiser. + - @b wxRICHTEXT_ORGANISER_BROWSE: + Show a list of all styles and their previews, but only allow application of a + style or cancellation of the dialog. This makes the dialog behave as a style browser. + - @b wxRICHTEXT_ORGANISER_BROWSE_NUMBERING: + Enables only list style browsing, plus a control to specify renumbering. + This allows the dialog to be used for applying list styles to the selection. */ wxRichTextStyleOrganiserDialog(int flags, wxRichTextStyleSheet* sheet, wxRichTextCtrl* ctrl, wxWindow* parent, - wxWindowID id = wxID_ANY); - const wxSize& size = wxDefaultSize, long style = wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxSYSTEM_MENU|wxCLOSE_BOX) - wxRichTextStyleOrganiserDialog(); - //@} + wxWindowID id = wxID_ANY, + const wxString& caption = _("Style Organiser"), + const wxPoint& pos = wxDefaultPosition, + const wxSize& size = wxDefaultSize, + long style = wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxSYSTEM_MENU|wxCLOSE_BOX); /** Applies the selected style to selection in the given control or the control @@ -108,14 +81,11 @@ public: bool ApplyStyle(wxRichTextCtrl* ctrl = NULL); /** - , wxPoint&@e pos = wxDefaultPosition, wxSize&@e size = wxDefaultSize, @b - long@e style = wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxSYSTEM_MENU|wxCLOSE_BOX) - Creates the dialog. See + Creates the dialog. See the ctor. */ - bool Create(int flags, wxRichTextStyleSheet* sheet, - wxRichTextCtrl* ctrl, - wxWindow* parent, - wxWindowID id = wxID_ANY) const; + bool Create(int flags, wxRichTextStyleSheet* sheet, wxRichTextCtrl* ctrl, + wxWindow* parent, wxWindowID id = wxID_ANY, + const wxString& caption = wxGetTranslation("Style Organiser"), const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxSize(400, 300), long style = wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxSYSTEM_MENU|wxCLOSE_BOX); /** Returns @true if the user has opted to restart numbering. @@ -161,7 +131,7 @@ public: /** Determines whether tooltips will be shown. */ - void SetShowToolTips(bool show); + static void SetShowToolTips(bool show); /** Sets the associated style sheet.