Generalized wxScrolledWindow into wxScrolled<T> that can derive from

[wxWidgets.git] / interface / richtext / richtextsymboldlg.h

diff --git a/interface/richtext/richtextsymboldlg.h b/interface/richtext/richtextsymboldlg.h
index 03a4a04e9fdf8587c5a31428a5832cca117176d3..f862372780f7674fc92b2bcf9f5e6469f9d06719 100644 (file)
--- a/interface/richtext/richtextsymboldlg.h
+++ b/interface/richtext/richtextsymboldlg.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        richtext/richtextsymboldlg.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        richtext/richtextsymboldlg.h

-// Purpose:     documentation for wxSymbolPickerDialog class
+// Purpose:     interface of wxSymbolPickerDialog

 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license


@@ -9,14 +9,14 @@
 /**
     @class wxSymbolPickerDialog
     @headerfile richtextsymboldlg.h wx/richtext/richtextsymboldlg.h
 /**
     @class wxSymbolPickerDialog
     @headerfile richtextsymboldlg.h wx/richtext/richtextsymboldlg.h

-    
+

     wxSymbolPickerDialog presents the user with a choice of fonts and a grid
     of available characters. This modal dialog provides the application with
     a selected symbol and optional font selection.
     wxSymbolPickerDialog presents the user with a choice of fonts and a grid
     of available characters. This modal dialog provides the application with
     a selected symbol and optional font selection.

-    
+

     Although this dialog is contained in the rich text library, the dialog
     is generic and can be used in other contexts.
     Although this dialog is contained in the rich text library, the dialog
     is generic and can be used in other contexts.

-    
+

     To use the dialog, pass a default symbol specified as a string, an initial font
     name,
     and a current font name. The difference between the initial font and
     To use the dialog, pass a default symbol specified as a string, an initial font
     name,
     and a current font name. The difference between the initial font and


@@ -28,39 +28,39 @@
     to display the characters in, even when no initial font is selected.
     This allows the user (and application) to distinguish between inserting a
     symbol in the current font, and inserting it with a specified font.
     to display the characters in, even when no initial font is selected.
     This allows the user (and application) to distinguish between inserting a
     symbol in the current font, and inserting it with a specified font.

-    
+

     When the dialog is dismissed, the application can get the selected symbol
     with GetSymbol and test whether a font was specified with UseNormalFont,
     fetching the specified font with GetFontName.
     When the dialog is dismissed, the application can get the selected symbol
     with GetSymbol and test whether a font was specified with UseNormalFont,
     fetching the specified font with GetFontName.

-    
+

     Here's a realistic example, inserting the supplied symbol into a
     rich text control in either the current font or specified font.
     Here's a realistic example, inserting the supplied symbol into a
     rich text control in either the current font or specified font.

-    
+

     @code
     wxRichTextCtrl* ctrl = (wxRichTextCtrl*) FindWindow(ID_RICHTEXT_CTRL);
     @code
     wxRichTextCtrl* ctrl = (wxRichTextCtrl*) FindWindow(ID_RICHTEXT_CTRL);

-    
+

         wxTextAttr attr;
         attr.SetFlags(wxTEXT_ATTR_FONT);
         ctrl-GetStyle(ctrl-GetInsertionPoint(), attr);
         wxTextAttr attr;
         attr.SetFlags(wxTEXT_ATTR_FONT);
         ctrl-GetStyle(ctrl-GetInsertionPoint(), attr);

-    
+

         wxString currentFontName;
         if (attr.HasFont() && attr.GetFont().Ok())
             currentFontName = attr.GetFont().GetFaceName();
         wxString currentFontName;
         if (attr.HasFont() && attr.GetFont().Ok())
             currentFontName = attr.GetFont().GetFaceName();

-    
+

         // Don't set the initial font in the dialog (so the user is choosing
         // 'normal text', i.e. the current font) but do tell the dialog
         // what 'normal text' is.
         // Don't set the initial font in the dialog (so the user is choosing
         // 'normal text', i.e. the current font) but do tell the dialog
         // what 'normal text' is.

-    
+

         wxSymbolPickerDialog dlg(wxT("*"), wxEmptyString, currentFontName, this);
         wxSymbolPickerDialog dlg(wxT("*"), wxEmptyString, currentFontName, this);

-    
+

         if (dlg.ShowModal() == wxID_OK)
         {
             if (dlg.HasSelection())
             {
                 long insertionPoint = ctrl-GetInsertionPoint();
         if (dlg.ShowModal() == wxID_OK)
         {
             if (dlg.HasSelection())
             {
                 long insertionPoint = ctrl-GetInsertionPoint();

-    
+

                 ctrl-WriteText(dlg.GetSymbol());
                 ctrl-WriteText(dlg.GetSymbol());

-    
+

                 if (!dlg.UseNormalFont())
                 {
                     wxFont font(attr.GetFont());
                 if (!dlg.UseNormalFont())
                 {
                     wxFont font(attr.GetFont());


@@ -71,7 +71,7 @@
             }
         }
     @endcode
             }
         }
     @endcode

-    
+

     @library{wxrichtext}
     @category{cmndlg}
 */
     @library{wxrichtext}
     @category{cmndlg}
 */


@@ -82,87 +82,78 @@ public:
     /**
         Constructors.
         
     /**
         Constructors.
         

-        @param symbol 
-        The initial symbol to show. Specify a single character in a string, or an empty
-        string.
-        
-        @param initialFont 
-        The initial font to be displayed in the font list. If empty, the item normal
-        text will be selected.
-        
-        @param normalTextFont 
-        The font the dialog will use to display the symbols if the initial font is
+        @param symbol
+            The initial symbol to show. Specify a single character in a string, or an
+        empty string.
+        @param initialFont
+            The initial font to be displayed in the font list. If empty, the item
+        normal text will be selected.
+        @param normalTextFont
+            The font the dialog will use to display the symbols if the initial font is

         empty.
         empty.

-        
-        @param parent 
-        The dialog's parent.
-        
-        @param id 
-        The dialog's identifier.
-        
-        @param title 
-        The dialog's caption.
-        
-        @param pos 
-        The dialog's position.
-        
-        @param size 
-        The dialog's size.
-        
-        @param style 
-        The dialog's window style.
+        @param parent
+            The dialog's parent.
+        @param id
+            The dialog's identifier.
+        @param title
+            The dialog's caption.
+        @param pos
+            The dialog's position.
+        @param size
+            The dialog's size.
+        @param style
+            The dialog's window style.

     */
     wxSymbolPickerDialog(const wxString& symbol,
                          const wxString& initialFont,
                          const wxString& normalTextFont,
                          wxWindow* parent,
                          wxWindowID id = wxID_ANY);
     */
     wxSymbolPickerDialog(const wxString& symbol,
                          const wxString& initialFont,
                          const wxString& normalTextFont,
                          wxWindow* parent,
                          wxWindowID id = wxID_ANY);

-        const wxSize& size = wxDefaultSize, long style = wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxCLOSE_BOX)
- wxSymbolPickerDialog();
+    const wxSize& size = wxDefaultSize, long style = wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxCLOSE_BOX)
+    wxSymbolPickerDialog();

     //@}
 
     /**
     //@}
 
     /**

-        , @b const wxPoint&@e pos = wxDefaultPosition, @b const wxSize&@e size =
-        wxDefaultSize, @b long@e style = wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxCLOSE_BOX)
-        
+        ,  wxPoint&@e pos = wxDefaultPosition,  wxSize&@e size = wxDefaultSize, @b
+        long@e style = wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxCLOSE_BOX)

         Creation: see @ref wxsymbolpickerdialog() "the constructor" for details about
         the parameters.
     */
     bool Create(const wxString& symbol, const wxString& initialFont,
                 const wxString& normalTextFont,
                 wxWindow* parent,
         Creation: see @ref wxsymbolpickerdialog() "the constructor" for details about
         the parameters.
     */
     bool Create(const wxString& symbol, const wxString& initialFont,
                 const wxString& normalTextFont,
                 wxWindow* parent,

-                wxWindowID id = wxID_ANY);
+                wxWindowID id = wxID_ANY) const;

 
     /**
         Returns the font name (the font reflected in the font list).
     */
 
     /**
         Returns the font name (the font reflected in the font list).
     */

-    wxString GetFontName();
+    wxString GetFontName() const;

 
     /**
         Returns @true if the dialog is showing the full range of Unicode characters.
     */
 
     /**
         Returns @true if the dialog is showing the full range of Unicode characters.
     */

-    bool GetFromUnicode();
+    bool GetFromUnicode() const;

 
     /**
         Gets the font name used for displaying symbols in the absence of a selected
         font.
     */
 
     /**
         Gets the font name used for displaying symbols in the absence of a selected
         font.
     */

-    wxString GetNormalTextFontName();
+    wxString GetNormalTextFontName() const;

 
     /**
         Gets the current or initial symbol as a string.
     */
 
     /**
         Gets the current or initial symbol as a string.
     */

-    wxString GetSymbol();
+    wxString GetSymbol() const;

 
     /**
         Gets the selected symbol character as an integer.
     */
 
     /**
         Gets the selected symbol character as an integer.
     */

-    int GetSymbolChar();
+    int GetSymbolChar() const;

 
     /**
         Returns @true if a symbol is selected.
     */
 
     /**
         Returns @true if a symbol is selected.
     */

-    bool HasSelection();
+    bool HasSelection() const;

 
     /**
         Sets the initial/selected font name.
 
     /**
         Sets the initial/selected font name.


@@ -194,5 +185,6 @@ public:
         Returns @true if the has specified normal text - that is, there is no selected
         font.
     */
         Returns @true if the has specified normal text - that is, there is no selected
         font.
     */

-    bool UseNormalFont();
+    bool UseNormalFont() const;

 };
 };

+