X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/8b34993daa0cef2a4c2b5a49236c3dcd70737c26..6ba5438dda164146bf36ca729f8328332fae36b7:/docs/tech/tn0014.txt diff --git a/docs/tech/tn0014.txt b/docs/tech/tn0014.txt index 85525ddb92..ad482a4f9e 100644 --- a/docs/tech/tn0014.txt +++ b/docs/tech/tn0014.txt @@ -13,8 +13,10 @@ dialog editors with XRC support. If you only want to use the resources, you can choose from a number of editors: a) wxDesigner (http://www.roebling.de) b) XRCed (wxPython/tools) - c) wxWorkshop (http://wxworkshop.sf.net) - b) wxrcedit (contrib/utils/wxrcedit) + c) DialogBlocks (wxPython/tools) + +and others listed on the Resources section of the wxWidgets web +site. The XRC format is based on XML 1.0 (please consult W3C's specification). There is no DTD available since it is not possible to fully describe the format with @@ -109,7 +111,7 @@ is allowed to register new object handlers within XRC and extend it to accept new classes (and therefore different 's child nodes). node is identical to , except that it does _not_ have -"class" property and has additional required property "ref". It's concept is +"class" property and has additional required property "ref". Its concept is similar to Unix symlinks: value of the "ref" property is equal to the value of "name" property of some existing node (called referred node) in the resources (not necessary top-level). Referred node's "class" property and all subnodes @@ -226,6 +228,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: + + + arial,helvetica + 12 + + + + wxSYS_DEFAULT_GUI_FONT + bold + 1.5 + + + +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: + + wxSYS_COLOUR_SCROLLBAR + #FF0000 + + 4. Supported classes ==================== @@ -252,7 +303,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 +314,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 +329,7 @@ checked Boolean false wxCheckList ----------- -position Position -1,-1 +pos Position -1,-1 size Size -1,-1 style Style[wxCheckList] content (see below) (empty) @@ -301,9 +352,16 @@ Example: +wxDatePickerCtrl +---------------- +pos Position -1,-1 +size Size -1,-1 +style Style[wxDatePickerCtrl] + + wxDialog -------- -position Position -1,-1 +pos Position -1,-1 size Size -1,-1 style Style[wxDialog] wxDEFAULT_DIALOG_STYLE title I18nString "" @@ -315,7 +373,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 "" @@ -327,9 +385,22 @@ wxMenuBar and wxStatusBar children; objects of these types are automatically set as frame's tool-, menu- and statusbar respectively. +wxMDIParentFrame +---------------- + +Supports same attributes and children nodes as wxFrame. Additionally, children +may be of the wxMDIChildFrame type. + + +wxMDIChildFrame +--------------- + +Supports same attributes and children nodes as wxFrame. + + wxScrolledWindow ---------------- -position Position -1,-1 +pos Position -1,-1 size Size -1,-1 style Style[wxScrolledWindow] wxHSCROLL | wxVSCROLL @@ -338,7 +409,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 +433,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 +460,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.