+
+@beginTable
+@hdr3col{property, type, description}
+@row3col{bitmapsize, @ref overview_xrcformat_type_size,
+ Size of toolbar bitmaps (default: not set).}
+@row3col{margins, @ref overview_xrcformat_type_size,
+ Margins (default: platform default).}
+@row3col{packing, integer,
+ Packing, see wxToolBar::SetToolPacking() (default: not set).}
+@row3col{separation, integer,
+ Default separator size, see wxToolBar::SetToolSeparation() (default: not set).}
+@row3col{dontattachtoframe, @ref overview_xrcformat_type_bool,
+ If set to 0 and the toolbar object is child of a wxFrame,
+ wxFrame::SetToolBar() is called; otherwise, you have to add it to a frame
+ manually. The toolbar is attached by default, you have to set this property
+ to 1 to disable this behaviour (default: 0).}
+@endTable
+
+A toolbar can have one or more child objects of any wxControl-derived class or
+one of two pseudo-classes: @c separator or @c tool.
+
+The @c separator pseudo-class is used to insert separators into the toolbar and
+has neither properties nor children. Similarly, the @c space pseudo-class is
+used for stretchable spaces (see wxToolBar::AddStretchableSpace(), new since
+wxWidgets 2.9.1).
+
+The @c tool pseudo-class objects specify toolbar buttons and have the following
+properties:
+
+@beginTable
+@hdr3col{property, type, description}
+@row3col{bitmap, @ref overview_xrcformat_type_bitmap,
+ Tool's bitmap (required).}
+@row3col{bitmap2, @ref overview_xrcformat_type_bitmap,
+ Bitmap for disabled tool (default: derived from @c bitmap).}
+@row3col{label, @ref overview_xrcformat_type_text,
+ Label to display on the tool (default: no label).}
+@row3col{radio, @ref overview_xrcformat_type_bool,
+ Item's kind is wxITEM_RADIO (default: 0)?}
+@row3col{toggle, @ref overview_xrcformat_type_bool,
+ Item's kind is wxITEM_CHECK (default: 0)?}
+@row3col{dropdown, see below,
+ Item's kind is wxITEM_DROPDOWN (default: 0)? (only available since wxWidgets 2.9.0)}
+@row3col{tooltip, @ref overview_xrcformat_type_text,
+ Tooltip to use for the tool (default: none).}
+@row3col{longhelp, @ref overview_xrcformat_type_text,
+ Help text shown in statusbar when the mouse is on the tool (default: none).}
+@row3col{disabled, @ref overview_xrcformat_type_bool,
+ Is the tool initially disabled (default: 0)?}
+@row3col{checked, @ref overview_xrcformat_type_bool,
+ Is the tool initially checked (default: 0)? (only available since wxWidgets 2.9.3)}
+@endTable
+
+The presence of a @c dropdown property indicates that the tool is of type
+wxITEM_DROPDOWN. It must be either empty or contain exactly one @ref
+xrc_wxmenu child object defining the drop-down button associated menu.
+
+Notice that @c radio, @c toggle and @c dropdown are mutually exclusive.
+
+Children that are neither @c tool nor @c separator must be instances of classes
+derived from wxControl and are added to the toolbar using
+wxToolBar::AddControl().
+
+Example:
+@code
+<object class="wxToolBar">
+ <style>wxTB_FLAT|wxTB_NODIVIDER</style>
+ <object class="tool" name="foo">
+ <bitmap>foo.png</bitmap>
+ <label>Foo</label>
+ </object>
+ <object class="tool" name="bar">
+ <bitmap>bar.png</bitmap>
+ <label>Bar</label>
+ </object>
+ <object class="separator"/>
+ <object class="tool" name="view_auto">
+ <bitmap>view.png</bitmap>
+ <label>View</label>
+ <dropdown>
+ <object class="wxMenu">
+ <object class="wxMenuItem" name="view_as_text">
+ <label>View as text</label>
+ </object>
+ <object class="wxMenuItem" name="view_as_hex">
+ <label>View as binary</label>
+ </object>
+ </object>
+ </dropdown>
+ </object>
+ <object class="space"/>
+ <object class="wxComboBox">
+ <content>
+ <item>Just</item>
+ <item>a combobox</item>
+ <item>in the toolbar</item>
+ </content>
+ </object>
+</object>
+
+@endcode
+
+
+@subsubsection xrc_wxtoolbook wxToolbook
+
+A toolbook can have one or more child objects of the @c toolbookpage
+pseudo-class (similarly to @ref xrc_wxnotebook "wxNotebook" and its
+@c notebookpage) and one child object of the @ref xrc_wximagelist class.
+@c toolbookpage objects have the following properties:
+
+@beginTable
+@hdr3col{property, type, description}
+@row3col{label, @ref overview_xrcformat_type_text,
+ Sheet page's title (required).}
+@row3col{bitmap, @ref overview_xrcformat_type_bitmap,
+ Bitmap shown alongside the label (default: none).}
+@row3col{image, integer,
+ The zero-based index of the image associated with the item
+ into the image list.}
+@row3col{selected, @ref overview_xrcformat_type_bool,
+ Is the page selected initially (only one page can be selected; default: 0)?}
+@endTable
+
+Each @c toolbookpage has exactly one non-toplevel window as its child.
+
projects / wxWidgets.git / blobdiff