FoxGUIb/FAQ

From eqqon

(Difference between revisions)
Jump to: navigation, search
(New page: = Frequently Asked Questions = == foxGUIb == === What is foxGUIb? === FoxGUIb is an interactive GUI builder and code generator for Ruby. It is the perfect tool for newbies to find out ...)
m (Frequently Asked Questions)
Line 1: Line 1:
= Frequently Asked Questions =
= Frequently Asked Questions =
-
== foxGUIb ==
 
=== What is foxGUIb? ===
=== What is foxGUIb? ===
[[FoxGUIb]] is an interactive GUI builder and code generator for Ruby. It is the perfect tool for newbies to find out how the Fox-Toolkit works without reading the API docs. It is of course also a tool for professionals because it saves you a lot of typing and "build-cycles" when tweaking user interface look-and-feel.
[[FoxGUIb]] is an interactive GUI builder and code generator for Ruby. It is the perfect tool for newbies to find out how the Fox-Toolkit works without reading the API docs. It is of course also a tool for professionals because it saves you a lot of typing and "build-cycles" when tweaking user interface look-and-feel.
 +
=== Is there a foxGUIb tutorial? ===
=== Is there a foxGUIb tutorial? ===
-
Mike Parr has written a [users guide]
+
Mike Parr has written a small [http://www.mikeparr.info/rubyguib/foxguibhome.htm users guide] targeted at beginners.
=== Is foxGUIb still actively developed? ===
=== Is foxGUIb still actively developed? ===
Line 12: Line 12:
If you have written any useful extensions to foxGUIb / libGUIb or corrected any bugs please send in the patches.  
If you have written any useful extensions to foxGUIb / libGUIb or corrected any bugs please send in the patches.  
-
== libGUIb ==
+
=== foxGUIb crashes! What should I do? ===
 +
First check out the file log.txt at foxGUIb's directory. It may contain useful information (i.e. exception backtrace) that may help you to solve your problem. If not, you are welcome to send in the file to <meinrad dot recheis at gmail dot com> and ask for help.
 +
 
 +
=== I found an annoying little bug ===
 +
Please fix it and send me the patch or if you are not able to do it you may send a bug report to <meinrad dot recheis at gmail dot com>.
 +
 
 +
=== Why does foxGUIb change my x, y, with or height values ===
 +
Actually it does not.  The underlying fox-toolkit overwrites these values. Use the layout hints LAYOUT_FIX_WIDTH, LAYOUT_FIX_HEIGHT, LAYOUT_FIX_X, LAYOUT_FIX_Y or simply LAYOUT_EXPLICIT which is a combination of all the previous. You need to set such layout hints in order to preserve the x, y, width and height values. All other kinds of layout hints will ignore them.
 +
 
 +
=== I get thousands of warnings when foxGUIb starts ===
 +
This is a bug which is exhibited by a specific combination of FXRuby nd Ruby version (FXRuby 1.6.?). The bug has already been fixed. It should not happen if you update to the latest Ruby / FXRuby version. If this is not possible you can work around by inserting the statement ''$VERBOSE=nil'' at the very first line in foxGUIb's source.
 +
 
=== What is libGUIb? ===
=== What is libGUIb? ===
[[LibGUIb]] is the library behind foxGUIb which is needed by the generated sources. LibGUIb contains facades (less complicated interfaces) for every widget, extends widgets with convenience methods and adds some handy tools.
[[LibGUIb]] is the library behind foxGUIb which is needed by the generated sources. LibGUIb contains facades (less complicated interfaces) for every widget, extends widgets with convenience methods and adds some handy tools.

Revision as of 18:27, 5 October 2007

Contents

Frequently Asked Questions

What is foxGUIb?

FoxGUIb is an interactive GUI builder and code generator for Ruby. It is the perfect tool for newbies to find out how the Fox-Toolkit works without reading the API docs. It is of course also a tool for professionals because it saves you a lot of typing and "build-cycles" when tweaking user interface look-and-feel.

Is there a foxGUIb tutorial?

Mike Parr has written a small users guide targeted at beginners.

Is foxGUIb still actively developed?

No. At the time beeing the author is quite busy trying to start his own business. Therefore there is no time left for foxGUIb. If you would like to push foxGUIb beyond what it is now please send a mail to <meinrad dot recheis at gmail dot com>.

How can I help?

If you have written any useful extensions to foxGUIb / libGUIb or corrected any bugs please send in the patches.

foxGUIb crashes! What should I do?

First check out the file log.txt at foxGUIb's directory. It may contain useful information (i.e. exception backtrace) that may help you to solve your problem. If not, you are welcome to send in the file to <meinrad dot recheis at gmail dot com> and ask for help.

I found an annoying little bug

Please fix it and send me the patch or if you are not able to do it you may send a bug report to <meinrad dot recheis at gmail dot com>.

Why does foxGUIb change my x, y, with or height values

Actually it does not. The underlying fox-toolkit overwrites these values. Use the layout hints LAYOUT_FIX_WIDTH, LAYOUT_FIX_HEIGHT, LAYOUT_FIX_X, LAYOUT_FIX_Y or simply LAYOUT_EXPLICIT which is a combination of all the previous. You need to set such layout hints in order to preserve the x, y, width and height values. All other kinds of layout hints will ignore them.

I get thousands of warnings when foxGUIb starts

This is a bug which is exhibited by a specific combination of FXRuby nd Ruby version (FXRuby 1.6.?). The bug has already been fixed. It should not happen if you update to the latest Ruby / FXRuby version. If this is not possible you can work around by inserting the statement $VERBOSE=nil at the very first line in foxGUIb's source.

What is libGUIb?

LibGUIb is the library behind foxGUIb which is needed by the generated sources. LibGUIb contains facades (less complicated interfaces) for every widget, extends widgets with convenience methods and adds some handy tools.

May I redistribute libGUIb with my programs?

Yes. LibGUIb has been packed into only one file for exactly this purpose. You may place libGUIb-1x.rb together with your sources or redistribute the installable libGUIb package.