document that not skipping left click event results in focus not being given to the...

[wxWidgets.git] / docs / tech / tn0014.txt

diff --git a/docs/tech/tn0014.txt b/docs/tech/tn0014.txt
index af38cf30fef0f98a9fc24f775095cccd01037393..29e4f027e1573aa8d33285afdf00d36f3dcb7dc2 100644 (file)
--- a/docs/tech/tn0014.txt
+++ b/docs/tech/tn0014.txt
@@ -21,6 +21,9 @@ is no DTD available since it is not possible to fully describe the format with
 the limited expressive power of DTDs.
 
 
 the limited expressive power of DTDs.
 
 

+Note: see also http://ldaptool.sourceforge.net/XRCGuide/XRCGuideSingle/
+
+

 
 1. Terminology
 ==============
 
 1. Terminology
 ==============


@@ -32,11 +35,11 @@ NODE, PROPERTY and VALUE in the XML sense:
 
 The term ATTRIBUTE is specific to XRC and refers to a subnode 
 of an <object> or <object_ref> node that is itself not <object> or <object_ref>. 
 
 The term ATTRIBUTE is specific to XRC and refers to a subnode 
 of an <object> or <object_ref> node that is itself not <object> or <object_ref>. 

-In the example bellow, <pos>, <label> and <style> are attributes, while neither 
+In the example below, <pos>, <label> and <style> are attributes, while neither 

 <resource> nor either of <object>s is:
 
     <?xml version="1.0" encoding="utf-8">
 <resource> nor either of <object>s is:
 
     <?xml version="1.0" encoding="utf-8">

-    <resource xmlns="http://www.wxwindows.org/wxxrc" version="2.3.0.1">
+    <resource xmlns="http://www.wxwidgets.org/wxxrc" version="2.5.3.0">

         <object class="wxPanel">
             <style>wxSUNKEN_BORDER</style>             <!-- attr -->
             <object class="wxStaticText">
         <object class="wxPanel">
             <style>wxSUNKEN_BORDER</style>             <!-- attr -->
             <object class="wxStaticText">


@@ -57,7 +60,7 @@ can think of it as attribute value syntax definition).
 =========================
 
 XRC resource file is a well-formed XML 1.0 document. All elements of XRC file
 =========================
 
 XRC resource file is a well-formed XML 1.0 document. All elements of XRC file

-are from the http://www.wxwindows.org/wxxrc namespace. 
+are from the http://www.wxwidgets.org/wxxrc namespace. 

 
 The root node of XRC document must be <resource>. The <resource> node has 
 optional "version" property. Default version  (in absence of the version 
 
 The root node of XRC document must be <resource>. The <resource> node has 
 optional "version" property. Default version  (in absence of the version 


@@ -65,9 +68,9 @@ property) is "0.0.0.0". The version consists of four integers separated by
 periods. Version of XRC format changes only if there was an incompatible 
 change introduced (i.e. either the library cannot understand old resource 
 files or older versions of the library wouldn't understand the new format).
 periods. Version of XRC format changes only if there was an incompatible 
 change introduced (i.e. either the library cannot understand old resource 
 files or older versions of the library wouldn't understand the new format).

-The first three integers are major, minor and release number of the wxWindows 
+The first three integers are major, minor and release number of the wxWidgets 

 release when the change was introduced, the last one is revision number and 
 release when the change was introduced, the last one is revision number and 

-is 0 for the first incompatible change in given wxWindows release, 1 for 
+is 0 for the first incompatible change in given wxWidgets release, 1 for 

 the second etc.
 
 Differences between versions are described within this document in paragraphs
 the second etc.
 
 Differences between versions are described within this document in paragraphs


@@ -75,14 +78,14 @@ entitled "Version Note".
 
 The <resource> node contains namespace declaration, too:
 
 
 The <resource> node contains namespace declaration, too:
 

-    <resource xmlns="http://www.wxwindows.org/wxxrc" version="2.3.0.1">
+    <resource xmlns="http://www.wxwidgets.org/wxxrc" version="2.5.3.0">

 
 The <resource> node is only allowed to have <object> and <object_ref>
 subnodes, all of which must have the "name" property.
 
 The <object> node represents a single object (GUI element) and it usually maps
 
 The <resource> node is only allowed to have <object> and <object_ref>
 subnodes, all of which must have the "name" property.
 
 The <object> node represents a single object (GUI element) and it usually maps

-directly to a wxWindows class instance. It three properties: "name", "class"
-and "subclass". "class" must always be present, it tells XRC what wxWindows
+directly to a wxWidgets class instance. It three properties: "name", "class"
+and "subclass". "class" must always be present, it tells XRC what wxWidgets

 object should be created in this place. The other two are optional.  "name" is
 ID used to identify the object. It is the value passed to the XRCID() macro and
 is also used to construct wxWindow's id and name attributes and must be unique
 object should be created in this place. The other two are optional.  "name" is
 ID used to identify the object. It is the value passed to the XRCID() macro and
 is also used to construct wxWindow's id and name attributes and must be unique


@@ -92,7 +95,7 @@ containers may contain objects with same "name", though). "subclass" is
 optional name of class whose constructor will be called instead of the
 constructor for "class". Subclass must be available in the program that loads
 the resource, must be derived from "class" and must be registered within
 optional name of class whose constructor will be called instead of the
 constructor for "class". Subclass must be available in the program that loads
 the resource, must be derived from "class" and must be registered within

-wxWindows' RTTI system.
+wxWidgets' RTTI system.

 
 Example:
 
 
 Example:
 


@@ -147,11 +150,13 @@ String
 ------
 Any text. Some characters have special interpretation and are translated
 by XRC parser according to this table:
 ------
 Any text. Some characters have special interpretation and are translated
 by XRC parser according to this table:

-    "_"    -> "&"  ('&' is used to underline e.g. menu items in wxWindows)
+    "_"    -> "&"  ('&' is used to underline e.g. menu items in wxWidgets)

     "__"   -> "_"
     "\n"   -> line break (C character '\n')
     "\r"   -> carriage return (C character '\r')
     "\t"   -> tabelator (C character '\t')
     "__"   -> "_"
     "\n"   -> line break (C character '\n')
     "\r"   -> carriage return (C character '\r')
     "\t"   -> tabelator (C character '\t')

+    "\\"   -> "\"
+              (introduced in version 2.5.3.0, not done in earlier versions)

 
 Version Note:
     '$' was used instead of '_' prior to version 2.3.0.1.
 
 Version Note:
     '$' was used instead of '_' prior to version 2.3.0.1.


@@ -193,8 +198,8 @@ List of style flags that can be passed to wxSomeClass' constructor. Flags are
 written in same way as in C++ code (e.g. "wxSUNKEN_BORDER",
 "wxHW_SCROLLBAR_NEVER") and are delimined with any combination of whitespaces
 and '|'. Possible flags are class-dependent and are not described in this
 written in same way as in C++ code (e.g. "wxSUNKEN_BORDER",
 "wxHW_SCROLLBAR_NEVER") and are delimined with any combination of whitespaces
 and '|'. Possible flags are class-dependent and are not described in this

-technote. Please refer to wxWindows manual for all styles that given class can
-accept; if XRC does not accept a flag listed in wxWindows documentation, it is
+technote. Please refer to wxWidgets manual for all styles that given class can
+accept; if XRC does not accept a flag listed in wxWidgets documentation, it is

 a bug.
 
 
 a bug.
 
 


@@ -211,7 +216,7 @@ Any of "stock_id" or "stock_client" properties or the filename may be omitted.
 XRC determines the bitmap to use according to this algorithm: 
   1. If there is non-empty "stock_id" property, query wxArtProvider for the
      bitmap (if there is no "stock_client", use default one, which is usually
 XRC determines the bitmap to use according to this algorithm: 
   1. If there is non-empty "stock_id" property, query wxArtProvider for the
      bitmap (if there is no "stock_client", use default one, which is usually

-     wxART_OTHER; exceptions are noted in class-specific sections bellow). If
+     wxART_OTHER; exceptions are noted in class-specific sections below). If

      the query fails, continue to 2.
   2. Load the bitmap from the file in attribute value.
 
      the query fails, continue to 2.
   2. Load the bitmap from the file in attribute value.
 


@@ -276,7 +281,7 @@ wxCheckList
 position                   Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxCheckList]
 position                   Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxCheckList]

-content                    (see bellow)            (empty)
+content                    (see below)             (empty)

 
 Optional "content" attribute does not have attribute value. Instead,
 arbitrary number of <item> nodes may be rooted under it (the control
 
 Optional "content" attribute does not have attribute value. Instead,
 arbitrary number of <item> nodes may be rooted under it (the control


@@ -320,6 +325,10 @@ and the splitter is created unsplitted. If there are two children, the
 splitter is created splitted, either horizontally or vertically depending
 on the value of "orientation" attribute.
 
 splitter is created splitted, either horizontally or vertically depending
 on the value of "orientation" attribute.
 

+wxStatusBar
+-----------
+fields                     Integer number of fields
+widths                     Width1, Width2, Width3, ...

 
 wxToolBar
 ---------
 
 wxToolBar
 ---------


@@ -333,7 +342,7 @@ packing                    Integer                 -1
 separation                 Integer                 -1
 
 wxToolBar node may have children <object> and <object_ref> nodes. Their class
 separation                 Integer                 -1
 
 wxToolBar node may have children <object> and <object_ref> nodes. Their class

-may be either "tool", "separator" or any wxWindows class derived from
+may be either "tool", "separator" or any wxWidgets class derived from

 wxControl. "tool" and "separator" are special pseudo-classes that may only
 appear within wxToolBar node. Their attributes are as follows:
 
 wxControl. "tool" and "separator" are special pseudo-classes that may only
 appear within wxToolBar node. Their attributes are as follows: