docs/latex/wx/richtextstyleorganiserdialog.tex

   1 \section{\class{wxRichTextStyleOrganiserDialog}}\label{wxrichtextstyleorganiserdialog}
   2
   3 This class shows a style sheet and allows the user to edit, add and remove styles.
   4 It can also be used as a style browser, for example if the application is not
   5 using a permanent \helpref{wxRichTextStyleComboCtrl}{wxrichtextstylecomboctrl} or \helpref{wxRichTextStyleListCtrl}{wxrichtextstylelistctrl} to
   6 present styles.
   7
   8 \wxheading{Derived from}
   9
  10 \helpref{wxDialog}{wxdialog}
  11
  12 \wxheading{Include files}
  13
  14 <wx/richtext/richtextstyledlg.h>
  15
  16 \wxheading{Library}
  17
  18 \helpref{wxRichtext}{librarieslist}
  19
  20 \latexignore{\rtfignore{\wxheading{Members}}}
  21
  22 \membersection{wxRichTextStyleOrganiserDialog::wxRichTextStyleOrganiserDialog}\label{wxrichtextstyleorganiserdialogwxrichtextstyleorganiserdialog}
  23
  24 \func{}{wxRichTextStyleOrganiserDialog}{\param{int }{flags}, \param{wxRichTextStyleSheet* }{sheet}, \param{wxRichTextCtrl* }{ctrl}, \param{wxWindow* }{parent}, \param{wxWindowID }{id = wxID\_ANY}, \param{const wxString\& }{caption = \_("Style Organiser")}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{size = wxDefaultSize}, \param{long }{style = wxDEFAULT\_DIALOG\_STYLE|wxRESIZE\_BORDER|wxSYSTEM\_MENU|wxCLOSE\_BOX}}
  25
  26 \func{}{wxRichTextStyleOrganiserDialog}{\void}
  27
  28 Constructors.
  29
  30 To create a dialog, pass a bitlist of {\it flags} (see below), a style sheet, a text control to apply a selected style to (or NULL), followed by the usual window parameters.
  31
  32 To specify the operations available to the user, pass a combination of these values to {\it flags}:
  33
  34 \twocolwidtha{7cm}
  35 \begin{twocollist}\itemsep=0pt
  36 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_DELETE\_STYLES}}{Provides a button for deleting styles.}
  37 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_CREATE\_STYLES}}{Provides buttons for creating styles.}
  38 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_APPLY\_STYLES}}{Provides a button for applying the currently selected style to the selection.}
  39 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_EDIT\_STYLES}}{Provides a button for editing styles.}
  40 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_RENAME\_STYLES}}{Provides a button for renaming styles.}
  41 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_OK\_CANCEL}}{Provides OK and Cancel buttons.}
  42 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_RENUMBER}}{Provides a checkbox for specifying that the selection should be renumbered.}
  43 \end{twocollist}
  44
  45 The following flags determine what will be displayed in the style list:
  46
  47 \twocolwidtha{7cm}
  48 \begin{twocollist}\itemsep=0pt
  49 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_SHOW\_CHARACTER}}{Displays character styles only.}
  50 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_SHOW\_PARAGRAPH}}{Displays paragraph styles only.}
  51 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_SHOW\_LIST}}{Displays list styles only.}
  52 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_SHOW\_ALL}}{Displays all styles.}
  53 \end{twocollist}
  54
  55 The following symbols define commonly-used combinations of flags:
  56
  57 \twocolwidtha{7cm}
  58 \begin{twocollist}\itemsep=0pt
  59 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_ORGANISE}}{Enable all style editing operations so the dialog behaves as a style organiser.}
  60 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_BROWSE}}{Show a list of all styles and their previews, but only allow application of a style or
  61 cancellation of the dialog. This makes the dialog behave as a style browser.}
  62 \twocolitem{\windowstyle{wxRICHTEXT\_ORGANISER\_BROWSE\_NUMBERING}}{Enables only list style browsing, plus a control to specify renumbering. This
  63 allows the dialog to be used for applying list styles to the selection.}
  64 \end{twocollist}
  65
  66 \membersection{wxRichTextStyleOrganiserDialog::ApplyStyle}\label{wxrichtextstyleorganiserdialogapplystyle}
  67
  68 \func{bool}{ApplyStyle}{\param{wxRichTextCtrl* }{ctrl = NULL}}
  69
  70 Applies the selected style to selection in the given control or the control passed to the constructor.
  71
  72 \membersection{wxRichTextStyleOrganiserDialog::Create}\label{wxrichtextstyleorganiserdialogcreate}
  73
  74 \func{bool}{Create}{\param{int }{flags}, \param{wxRichTextStyleSheet* }{sheet}, \param{wxRichTextCtrl* }{ctrl}, \param{wxWindow* }{parent}, \param{wxWindowID }{id = wxID\_ANY}, \param{const wxString\& }{caption = \_("Style Organiser")}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{size = wxDefaultSize}, \param{long }{style = wxDEFAULT\_DIALOG\_STYLE|wxRESIZE\_BORDER|wxSYSTEM\_MENU|wxCLOSE\_BOX}}
  75
  76 Creates the dialog. See \membersection{wxRichTextStyleOrganiserDialog::wxRichTextStyleOrganiserDialog}{wxrichtextstyleorganiserdialogwxrichtextstyleorganiserdialog} for details.
  77
  78 \membersection{wxRichTextStyleOrganiserDialog::GetFlags}\label{wxrichtextstyleorganiserdialoggetflags}
  79
  80 \constfunc{int}{GetFlags}{\void}
  81
  82 Returns the flags used to control the interface presented to the user.
  83
  84 \membersection{wxRichTextStyleOrganiserDialog::GetRestartNumbering}\label{wxrichtextstyleorganiserdialoggetrestartnumbering}
  85
  86 \constfunc{bool}{GetRestartNumbering}{\void}
  87
  88 Returns \true if the user has opted to restart numbering.
  89
  90 \membersection{wxRichTextStyleOrganiserDialog::GetRichTextCtrl}\label{wxrichtextstyleorganiserdialoggetrichtextctrl}
  91
  92 \constfunc{wxRichTextCtrl*}{GetRichTextCtrl}{\void}
  93
  94 Returns the associated rich text control (if any).
  95
  96 \membersection{wxRichTextStyleOrganiserDialog::GetSelectedStyle}\label{wxrichtextstyleorganiserdialoggetselectedstyle}
  97
  98 \constfunc{wxString}{GetSelectedStyle}{\void}
  99
 100 Returns selected style name.
 101
 102 \membersection{wxRichTextStyleOrganiserDialog::GetSelectedStyleDefinition}\label{wxrichtextstyleorganiserdialoggetselectedstyledefinition}
 103
 104 \constfunc{wxRichTextStyleDefinition*}{GetSelectedStyleDefinition}{\void}
 105
 106 Returns selected style definition.
 107
 108 \membersection{wxRichTextStyleOrganiserDialog::GetStyleSheet}\label{wxrichtextstyleorganiserdialoggetstylesheet}
 109
 110 \constfunc{wxRichTextStyleSheet*}{GetStyleSheet}{\void}
 111
 112 Returns the associated style sheet.
 113
 114 \membersection{wxRichTextStyleOrganiserDialog::SetFlags}\label{wxrichtextstyleorganiserdialogsetflags}
 115
 116 \func{void}{SetFlags}{\param{int }{flags}}
 117
 118 Sets the flags used to control the interface presented to the user.
 119
 120 \membersection{wxRichTextStyleOrganiserDialog::SetRestartNumbering}\label{wxrichtextstyleorganiserdialogsetrestartnumbering}
 121
 122 \func{void}{SetRestartNumbering}{\param{bool }{restartNumbering}}
 123
 124 Checks or unchecks the restart numbering checkbox.
 125
 126 \membersection{wxRichTextStyleOrganiserDialog::SetRichTextCtrl}\label{wxrichtextstyleorganiserdialogsetrichtextctrl}
 127
 128 \func{void}{SetRichTextCtrl}{\param{wxRichTextCtrl* }{ctrl}}
 129
 130 Sets the control to be associated with the dialog, for the purposes of applying a style to the selection.
 131
 132 \membersection{wxRichTextStyleOrganiserDialog::SetShowToolTips}\label{wxrichtextstyleorganiserdialogsetshowtooltips}
 133
 134 \func{void}{SetShowToolTips}{\param{bool }{show}}
 135
 136 Determines whether tooltips will be shown.
 137
 138 \membersection{wxRichTextStyleOrganiserDialog::SetStyleSheet}\label{wxrichtextstyleorganiserdialogsetstylesheet}
 139
 140 \func{void}{SetStyleSheet}{\param{wxRichTextStyleSheet* }{sheet}}
 141
 142 Sets the associated style sheet.
 143