added wxXmlResource::FindXRCIDById() (#10026)

[wxWidgets.git] / interface / wx / richtext / richtextxml.h

diff --git a/interface/wx/richtext/richtextxml.h b/interface/wx/richtext/richtextxml.h
index 1a0f881e0421d6a1cb92aa357f6b2c41f75d0ea1..309a5e0142314c5651ede7cd34dd411c613271a4 100644 (file)
--- a/interface/wx/richtext/richtextxml.h
+++ b/interface/wx/richtext/richtextxml.h
@@ -10,10 +10,21 @@
     @class wxRichTextXMLHandler
 
     A handler for loading and saving content in an XML format specific
-    to wxRichTextBuffer. You can either add the handler to the buffer
-    and load and save through the buffer or control API, or you can
-    create an instance of the handler on the stack and call its
-    functions directly.
+    to wxRichTextBuffer.
+
+    You can either add the handler to the buffer and load and save through
+    the buffer or control API, or you can create an instance of the handler
+    on the stack and call its functions directly.
+
+
+    @section richtextxmlhandler_flags Handler flags
+
+    The following flags can be used with this handler, via the handler's SetFlags()
+    function or the buffer or control's SetHandlerFlags() function:
+
+    - wxRICHTEXT_HANDLER_INCLUDE_STYLESHEET
+      Include the style sheet in loading and saving operations.
+
 
     @library{wxrichtext}
     @category{richtext}
@@ -22,20 +33,21 @@ class wxRichTextXMLHandler : public wxRichTextFileHandler
 {
 public:
     /**
-        ,  wxString&@e ext = wxT("xml"), @b int@e type = wxRICHTEXT_TYPE_XML)
         Constructor.
     */
-    wxRichTextXMLHandler() const;
+    wxRichTextXMLHandler(const wxString& name = wxT("XML"),
+                         const wxString& ext = wxT("xml"),
+                         int type = wxRICHTEXT_TYPE_XML);
 
     /**
         Returns @true.
     */
-    bool CanLoad() const;
+    virtual bool CanLoad() const;
 
     /**
         Returns @true.
     */
-    bool CanSave() const;
+    virtual bool CanSave() const;
 
     /**
         Creates XML code for a given character or paragraph style.
@@ -45,12 +57,12 @@ public:
     /**
         Loads buffer context from the given stream.
     */
-    bool DoLoadFile(wxRichTextBuffer* buffer, wxInputStream& stream);
+    virtual bool DoLoadFile(wxRichTextBuffer* buffer, wxInputStream& stream);
 
     /**
         Saves buffer context to the given stream.
     */
-    bool DoSaveFile(wxRichTextBuffer* buffer, wxOutputStream& stream);
+    virtual bool DoSaveFile(wxRichTextBuffer* buffer, wxOutputStream& stream);
 
     /**
         Recursively exports an object to the stream.