Hi James, Thank you for your attempt at developing a style for describing the widgets. I havn¹t spent any real time on this, but what you¹ve provided below looks very reasonable to me.
I do have a small critique, however, if I may. Since the book is aimed at introductory wxPerl programming, the use of ³$self->{radiobox}² seems a little frightening. Personally, I would prefer a simpler syntax like, my $radiobox = Wx::RadioBox->new( $parent, ... ); Kind Regards, Ron. On 19/01/16 6:10 AM, "James Lynes" <jmlyne...@gmail.com> wrote: > Ron & Steve: > > Here's an initial shot at a format for documenting a widget. As I remember the > wxWidgets 2.8 pdf documentation was 2500+ pages, so we need to not get overly > ambitious. I have no idea if all of the Member Functions that are listed in > the wxWidgets HTML docs are actually wrapped. > > In the example below, it is assumed that $self is the parent frame created > elsewhere in the app. > > Comments/additions? Everyone's coding style will probably vary. > > James > > > wxRadioBox (A wxControl) > -------------------------------------- > Usage > --------- > my @boxes = qw(One Two Three Four Five); > my $cols = 3; > $self->{radiobox} = Wx::RadioBox->new($self, wxID_ANY, > "RadioBox", wxDefaultPosition, wxDefaultSize, > \@boxes, $cols, wxRA_SPECIFY_COLS); > $self->{selection} = $self->{radiobox}->GetStringSelection; > > Styles > --------- > wxRA_SPECIFY_ROWS, wxRA_SPECIFY_COLS > > Events > ---------- > EVT_RADIOBOX > > Member Functions > -------------------------- > Enable, FindString, GetColumnCount, GetItemFromPoint, > GetItemHelpText, GetItemToolTip, GetRowCount, IsItemEnabled, > IsItemShown, SetItemHelpText, SetItemToolTip, SetSelection, > Show, GetCount, GetString, SetString, GetSelection, GetStringSelection > > Notes > -------- > Item numbers start at 0. > The first item in the @boxes list is the default selection. > > On Mon, Jan 18, 2016 at 10:19 AM, Steve Cookson - gmail > <steveco.1...@gmail.com> wrote: >> >> Hi Ron, >> >> Thanks for this. >> >> >> On 17/01/16 12:53, Ron Grunwald wrote: >> >> >>> >>> 1. Introduction to GUI programming and wxPerl >>> 2. The wxPerl widgets (currently worked on in the design doc.) >>> 3. Geometry management in wxPerl (to be worked on next in the design doc.) >>> 4. Event handling in wxPerl >>> 5. Advanced Topics >>> 6. >>> >>> >> Is Geometry Management the same as layout? If so I had to do a double take >> to work out what it meant. >> >> Maybe we should also have something about platforms and installation, which >> is always a joy! It could be an appendix if you wanted, so that the flow of >> the chapters was not disrupted. >> >> Regards >> >> Steve. >> > >