]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/tech/tn0014.txt
Docstring fixes
[wxWidgets.git] / docs / tech / tn0014.txt
index 85525ddb92de419e2618696170aadc61fc6a6a12..467371a0bed151bb56eb1dd8209392567c24722f 100644 (file)
@@ -226,6 +226,55 @@ Boolean
 Boolean value, either "0" (false) or "1" (true).
 
 
+Font
+----
+Font value. A font can be described either in terms of its elementary
+properties, or it can be derived from one of system fonts. The font node
+may contain following subnodes (the table lists subnode name on the left and
+variable type as per the definitions above on the right side):
+
+size            UnsignedInteger
+style           normal | italic | slant
+weight          normal | bold | light
+family          roman | script | decorative | swiss | modern | teletype
+underlined      Boolean
+face            comma-separated list of faces
+encoding        charset of the font (meaningless in Unicode build), as string
+sysfont         symbolic name of system standard font
+                (one of wxSYS_*_FONT constants)
+relativesize    Float, font size relative to choosen system font's size;
+                can only be used when 'sysfont' is used and when 'size' is not
+                used
+
+All of them are optional, if they are missing, wxFont default is used.
+
+Examples:
+    
+    <font>
+        <face>arial,helvetica</face>
+        <size>12</size>
+    </font>
+    
+    <font>
+        <sysfont>wxSYS_DEFAULT_GUI_FONT</sysfont>
+        <weight>bold</weight>
+        <relativesize>1.5</relativesize>
+    </font>
+
+
+Colour
+------
+A colour value is either explicit RGB value in the standard #rrggbb format
+where rr, gg and bb are hexadecimal case-insensitive values in the 00..FF
+range, or a symbolic name. Symbolic names are wxSYS_COLOUR_* constants defined
+by wxWidgets, written as strings.
+
+Example:
+
+    <bg>wxSYS_COLOUR_SCROLLBAR</bg>
+    <fg>#FF0000</fg>
+
+
 
 4. Supported classes
 ====================
@@ -252,7 +301,7 @@ Identical to wxBitmap class, except that it creates wxIcon instead of wxBitmap.
 
 wxButton
 --------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxButton]    
 
@@ -263,14 +312,14 @@ default                    Boolean                 false
 
 wxCalendarCtrl
 --------------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxCalendarCtrl]
 
 
 wxCheckBox
 ----------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxCheckBox]
 checked                    Boolean                 false
@@ -278,7 +327,7 @@ checked                    Boolean                 false
 
 wxCheckList
 -----------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxCheckList]
 content                    (see below)             (empty)
@@ -303,7 +352,7 @@ Example:
 
 wxDialog
 --------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxDialog]         wxDEFAULT_DIALOG_STYLE
 title                      I18nString              ""
@@ -315,7 +364,7 @@ wxDialog may have children objects.
 
 wxFrame
 --------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxDialog]         wxDEFAULT_FRAME_STYLE
 title                      I18nString              ""
@@ -329,7 +378,7 @@ set as frame's tool-, menu- and statusbar respectively.
 
 wxScrolledWindow
 ----------------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxScrolledWindow] wxHSCROLL | wxVSCROLL
 
@@ -338,7 +387,7 @@ wxScolledWindow may have children objects.
 
 wxSplitterWindow
 ----------------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxSplitterWindow] wxSP_3D
 sashpos                    Integer                 0
@@ -362,7 +411,7 @@ widths                     Width1, Width2, Width3, ...
 
 wxToolBar
 ---------
-position                   Position                -1,-1
+pos                        Position                -1,-1
 size                       Size                    -1,-1
 style                      Style[wxToolBar]        wxNO_BORDER|wxTB_HORIZONTAL
 bitmapsize                 Size                    -1,-1
@@ -389,15 +438,15 @@ appear within wxToolBar node. Their attributes are as follows:
     label                  I18nString              ""
     tooltip                I18nString              ""
     longhelp               I18nString              ""
-    position               Position                -1,-1
+    pos                    Position                -1,-1
 
     Constraints:
       At most one of "toggle" and "radio" attributes may be 1.
-      Attribute "position" may not appear if "label" or "radio" attributes
+      Attribute "pos" may not appear if "label" or "radio" attributes
       are used or if parent wxToolBar's style contains wxTB_TEXT.
     
     Note:
-      Use of "position" attribute is strongly discouraged, it is deprecated
+      Use of "pos" attribute is strongly discouraged, it is deprecated
       usage of wxToolBar and it is not supported by MSW and GTK
       implementations.