X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/dbd94b75015561fe527069c138ce43c44797fe35..41e9579283b7233c5c9f579dc52d3a70b9585929:/docs/tech/tn0014.txt?ds=sidebyside diff --git a/docs/tech/tn0014.txt b/docs/tech/tn0014.txt index 440a371d7e..a5cb351a59 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,16 +352,64 @@ Example: +wxDatePickerCtrl +---------------- +pos Position -1,-1 +size Size -1,-1 +style Style[wxDatePickerCtrl] + + +wxDialog +-------- +pos Position -1,-1 +size Size -1,-1 +style Style[wxDialog] wxDEFAULT_DIALOG_STYLE +title I18nString "" +icon Bitmap (empty) +centered Boolean false + +wxDialog may have children objects. + + +wxFrame +-------- +pos Position -1,-1 +size Size -1,-1 +style Style[wxDialog] wxDEFAULT_FRAME_STYLE +title I18nString "" +icon Bitmap (empty) +centered Boolean false + +wxFrame may have children objects. There can be at most one wxToolBar, +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 +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 @@ -325,14 +424,16 @@ and the splitter is created unsplit. If there are two children, the splitter is created split, either horizontally or vertically depending on the value of "orientation" attribute. + wxStatusBar ----------- fields Integer number of fields 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 @@ -340,6 +441,8 @@ bitmapsize Size -1,-1 margins Size -1,-1 packing Integer -1 separation Integer -1 +bg Background colour None +dontattachtoframe Boolean False wxToolBar node may have children and nodes. Their class may be either "tool", "separator" or any wxWidgets class derived from @@ -356,18 +459,19 @@ appear within wxToolBar node. Their attributes are as follows: bitmap2 Bitmap wxNullBitmap toggle Boolean 0 radio Boolean 0 + disabled Boolean 0 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.