The Guibuilder HOWTO

Version 0.8 - 2004/09/02
Recently I've started using guibuilder, which is a very interesting in-code gui editor for plt scheme  (drscheme).  The tutorial will cover some of the more interesting features, ending with the component archetecture, which i think is really cool.

What's a in-code gui editor?  You have to see it to fully appreciate it, but in short it's a gui editor which does not pop up a window to represent the window your making, but it puts the representation between two lines of your source code.  Go get guibuilder for yourself, from here (works with plt scheme 208 as of 8/27/04), then read on!

****Note.  The example files now require the new guibuilder.   If you downloaded it before 09/02/04, then you need to get it again. ****

Any important changes to this document will be announced on the rss feed.RSS feed

I couldn't find any docs for guibuilder.  I've spent quite a bit of time exploring it, and thought I might share what i found with everyone else, thus this HOWTO.

Note: I wont be explaining how to lay out a GUI from a HCI perspective.  Hopefully this  is documented elsewhere.  I'll be assuming you know what buttons/vertical boxes (vertical panels), etc are.  (If anyone knows of something good for that i could splice in or reference, let me know.)

The obvious stuff:
Go install DrScheme  and guibuilder  if you havn't already.  Copy all the guibuilder files into your collects/guibuilder directory (which you'll have to make).

Note:  all of these examples are included in guibuilder.test.7.scm.

The simple stuff:
Start DrScheme.  Open a new DrScheme file, and click the "Special" menu, and pick "Insert GUI".   A frame should be inserted in your code at the cursor like so:

Right click on the frame and click "New Button" and get a new button added like so:

Double click on the button and a properties box will come up.  Set the Label to "This is a Button" (or whatever you want it to say), and set the Scheme name to "button-of-doom", like so.

and get

now click run, and see what you made:


That's the end, but you can always go back to

RSS feed