Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)

Standard preamble:
========================================================================
..

..

.. Set up some character translations and predefined strings. \*(-- will
give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
double quote, and \*(R" will give a right double quote. \*(C+ will
give a nicer C++. Capital omega is used to do unbreakable dashes and
therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
nothing in troff, for use with C<>.
.tr \(*W- . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\}
Escape single quotes in literal strings from groff's Unicode transform.

If the F register is >0, we'll generate index entries on stderr for
titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
entries marked with X<> in POD. Of course, you'll have to process the
output yourself in some meaningful fashion.

Avoid warning from groff about undefined register 'F'.
.. .nr rF 0 . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF
Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] .\} . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents . \" corrections for vroff . \" for low resolution devices (crt and lpr) \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} ========================================================================

Title "dkct-wxgui 5" For nroff, turn off justification. Always turn off hyphenation; it makes
way too many mistakes in technical documents.
dkct-wxgui - Dirk Krause's C tool, *.wxc file syntax Header "DESCRIPTION" The %% wx-gui section in a *.wxc file describes the layout of a main window or dialog box in an ini-file style. Parts of the class definition and the constructor code are generated automatically from this section. Header "SYNTAX" A *.wxc file contains the following sections: Item "%% options" General setup for the module. Item "%% wx-gui" \s-1GUI\s0 description. Item "%% header start" Header file code to be placed before the class definition. Item "%% class start" Header file code to be placed in the class definition before the automatically created variables. Item "%% class end" Header file code to be placed in the class definition after the automatically created variables. Item "%% header end" Header file code to be placed after the class definition. Item "%% module start" Source file code to be placed before the class constructor. Item "%% constructor start" Start of class constructori, placed before automatically generated code for \s-1GUI\s0 setup. Item "%% constructor end" End of class constructor, placed after automatically generated code for \s-1GUI\s0 setup. Item "%% module end" Source file code to be placed after the class constructor.

The options section is used for general setup as described in dkct\|(5).

Code from header start, class start, class end and header end sections is copied into the *.h output file, code from module start, constructor start, constructor end and module end sections is copied to the *.cpp output file. These sections may contain special instructions as described for the %%module section of *.ctr, *.cpt and *.mtr files in dkct\|(5).

Header "THE WX-GUI SECTION" Subsection "General syntax" The section is a list of paragraphs. Each paragraph describes either the top window or one of the \s-1GUI\s0 components.

Each paragraph - except the first one - is introduced by a

\fB[type name]

line which will result in a

\fItype *name;

member variable of the class to create.

The first paragraph without a header line describes the top level window.

The remaining lines in a paragraph are key=value lines to set the attributes of the component.

Subsection "Key=value lines to set attributes" Item "bitmap=wxBitmap:bitmap" Bitmap to show (for wxStaticBitmap and wxBitmapButton). Item "bitmap button style=[auto-draw] [top] [left] [right] [bottom]" Optional style information for a wxBitmapButton, a space separated keyword list: Item "bitmap disabled=wxBitmap:bitmap" Bitmap to show on a disabled wxBitmapButton, optional. Item "bitmap focus=wxBitmap:bitmap" Bitmap to show when a wxBitmapButton has focus, optional. Item "bitmap hover=wxBitmap:bitmap" Bitmap to show when the mouse is over an enabled wxBitmapButton, optional. Item "bitmap selected=wxBitmap:bitmap" Bitmap to show when wxBitmapButton is selected, optional. Item "border=int:border [all] | { [top] [left] [right] [bottom] }" Additional border around objects (number of pixels). The border can be applied to all sides of the object (default) or to specified sides. Item "button style=[fit] [no-border] [top] [left] [right] [bottom]" Style for wxButton objects: Item "cell data=int:row int:column wxString:text" Data for one grid cell. Allowed multiple times. Item "choices=int:size const wxString[]:texts" Choice texts for wxChoice, wxComboBox, wxListBox and wxCheckListBox. Item "choices=wxArrayString:texts" Choice texts for wxChoice, wxComboBox, wxListBox and wxCheckListBox. Alternative form. Item "column head=wxString:text" Column head for a wxGrid. May be used multiple times for all column heads. Item "columns=int:columns" Number of columns in a wxRadioBox or wxGrid. For a wxRadioBox either the maximum number of rows or columns must be specified. For a wxGrid either a table object or both the numbers of rows and columns must be specified. Item "complete constructor specified=boolean:complete" Flag: The constructor attribute contains all constructor arguments. If set to false, the parent window and the window \s-1ID\s0 (default: wxID_ANY) are inserted before the other arguments. Item "constructor=*:argument [, ...]" List of arguments passed to the constructor. \s-1NOTE:\s0 The parent wxWindow and the window \s-1ID\s0 are inserted at start of the list unless the \*(L"complete constructor specified\*(R" attribute (see above) is set. Item "contents= object:obj int:row int:column int:height int:width] [[top] | [centered-y] | [bottom]] [[left] | [centered-x] | [right]]" Contents to add to a wxGridBagSizer. The alignment keywords control the alignment of the object within the available space. Use \*(L"text style\*(R" to set up the alignment of a text label within the object. Item "contents= object:obj [[top] | [centered-y] | [bottom]] [[left] | [centered-x] | [right]]" Contents to add to a other sizers (not a wxGridBagSizer). The alignment keywords control the alignment of the object within the available space. Use \*(L"text style\*(R" to set up the alignment of a text label within the object. Item "direction=horizontal | vertical" Direction of wxBoxSizer, wxGauge or wxSlider Item "expand=boolean:expand" Flag: Object should grow when container grows. Item "gauge style=smooth" Flag: Gauge increases pixel by pixel. Item "grid=int:y_gap int:x_gap" Grid settings for a wxGridBagSizer. Item "grid=int:rows int:columns int:y_gap int:x_gap" Grid settings for a wxGridBagSizer (more detailed setup). Item "grid style=[autosize-data] [[autosize-labels] | [autosize-labels-rows] | [autosize-labels-columns]]" Style settings for a wxGrid: Item "grow=boolean:grow" Flag: Object should grow when container grows (alias for \*(L"expand\*(R"). Item "growable column=int:index" Insert a growable column before the column specified by the 0-based \fIindex number in a wxGridBagSizer. Allowed multiple times, you should start with the largest index. Item "growable row=int:index" Insert a growable row before the row specified by the 0-based \fIindex number in a wxGridBagSizer. Allowed multiple times, you should start with the largest index. Item "icon=wxIcon:icon" Icon for top level windows. Item "id=int:id" Window \s-1ID\s0 for object. Item "keys=boolean:keyboard" Flag: Keyboard can be used (for wxSpinControl and wxSpinButton). Item "menu bar=wxMenuBar:menubar" Menu bar object for top level window, optional. Item "menu item style=normal | check | radio | separator" Optional style for wxMenuItem. Item "minimum pane size=int:size" Minitmum size for pane in wxSplitter window, optional. Item "minimum size=int:width int:height" Minimum object size. Item "notebook style=[fixed-width] [multiline] [no-theme] [flat] [top | bottom] [left | right]" Style for wxNoteBook, optional: Item "proportion=int:factor" Proportion for growing the element when the container grows. Item "range=int:min int:max" Range for wxSpinButton, wxSpinControl, wxSlider. Item "range=int:max" Range for gauge, minimum is 0. Item "row head=wxString:text" Row head specification for a wxGrid row. Allowed multiple times to cover all rows of the grid. Item "rows=int:rows" Maximum number of rows in a wxRadioBox or wxGrid. For a wxRadioBox either the maximum number of rows or columns must be specified. For a wxGrid either a table object or both the numbers of rows and columns must be specified. Item "sash=int:size" Size of wxSplitterWindow children. Positive values are the size of the first (upper or left) child. Negative values specify the size of the second (lower or right) child. The default 0 assigns equal size to both children. Item "selection=single | multiple | extended" Selection style for wxListBox and wxCheckListBox: Item "size=int:width int:height" Default size for an object. Item "slider style=[ticks] [labels] [range] [inverse] [top | bottom] [left | right]" Style for wxSlider object: Item "splitter window style=[3d | 3d-sash | 3d-border] [border | no-border] [no-xp-theme] [permit-unsplit] [live-update]" Style for wxSplitterWindow: Item "start-group=boolean:flag" Flag: the wxRadioButton is the start of a new radio button group. Default: no. Item "states=int:number [checked | unchecked | undetermined]" Number of states (2 or 3) and optionally initial state for a wxCheckBox: Item "status bar=int:nparts [wxString:text]" Number of parts in the status bar of a top level window and optionally the initial status text for the first part. Item "status text=wxString:text" Optional status text for a top level window. Item "table=table:object [boolean:isOwner]" Table object for a wxGrid and optionally the flag whether the wxGrid is the owner of the table object. Item "text=wxString:text" Text for various elements, title text for top level windows. Item "text style=[readonly] [enter] [tab] [multiline] [password] [rich | rich2] [url] [selection] [left | centered | right] [no-wrap | char-wrap | word-wrap | best-wrap] [capitalize] [no-autoresize]" Style for wxTextCtrl, wxStaticText or wxGrid object: Item "tip=wxString:text" Tool tip text. Item "tool bar=wxToolBar:object" Toolbar object for a top level window. Item "toolbar button style=normal | check | radio | separator" Optional style for toolbar button: Item "toolbar style=[flat] [dockable] [text] [no-icons] [no-divider] [horizontal-layout] [no-tooltips] [right | bottom]" Optional style for wxToolBar: Item "tooltip flag=boolean:tooltips" Flag: Show tooltips. Item "type=dialog | frame" Top level window type. Item "validator=validator:object" Validator object for control. Item "value=int:value" Initial value for wxSpinButton, wxSpinControl, wxSlider and wxGauge. Item "wrap=boolean:wrap" Flag: Allow wxSpinButton and wxSpinControl to wrap. Subsection "Required, recommended and optional attributes" Item "wxFrame" Item "wxDialog" Item "wxMDIParentFrame" Item "wxMDIChildFrame" Item "wxPopupWindow" Item "wxBoxSizer" Item "wxFlexGridSizer" Item "wxGridBagSizer" Item "wxGridSizer" Item "wxStaticBoxSizer" Item "wxStdDialogButtonSizer" Item "wxPanel" Item "wxNotebook" Item "wxScrolledWindow" Item "wxSplitterWindow" Item "wxButton" Item "wxBitmapButton" Item "wxChoice" Item "wxComboBox" Item "wxCheckBox" Item "wxListBox" Item "wxCheckListBox" Item "wxRadioBox" Item "wxRadioButton" Item "wxScrollBar" Item "wxSpinButton" Item "wxSpinCtrl" Item "wxSlider" Item "wxTextCtrl" Item "wxGrid" Item "wxToggleButton" Item "wxGauge" Item "wxStaticText" Item "wxStaticBitmap" Item "wxStaticLine" Item "wxStaticBox" Item "wxMenuBar" Item "wxMenu" Item "wxMenuItem" Item "wxToolBar" Item " wxStatusBar" Item "wxToolBarToolBase" Item "any other class not listed above" Subsection "Pseudo objects" Item "$space(width[,height])" Fixed width placeholder for space between elements, can be added to sizers. Does not grow if sizer grows. Item "$stretch(width[,height])" Variable width placeholder for space between elements, can be added to sizers. Grows when sizer grows. Item "$separator" Separator between menu items. Header "AUTHOR" Dirk Krause Header "COPYRIGHT AND LICENSE" Copyright (c) 2011-2016, Dirk Krause

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of the copyright holder(s) nor the names of contributors may be used to endorse or promote products derived from this software without specific prior written permission.

\s-1THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\s0 ``\s-1AS IS\s0'' \s-1AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\s0 (\s-1INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES\s0; \s-1LOSS OF USE, DATA, OR PROFITS\s0; \s-1OR BUSINESS INTERRUPTION\s0) \s-1HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\s0 (\s-1INCLUDING NEGLIGENCE OR OTHERWISE\s0) \s-1ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\s0

Header "SEE ALSO" Item "dkct" The dkct program (Dirk Krause's C tool). Item "dkct" Input file syntax for dkct (*.ctr, *.cpt and *.mtr files). Item "<http://sourceforge.net/p/dktools/wiki/Home/>." Project homepage.