OpenEuphoria

Re: An idea of improving the win32lib.htm

• Posted by David Cuny <dcuny at LANSET.COM> Sep 24, 2000
• 418 views

Dan Moyer wrote:

> [Win32Lib] needs examples for every entry, &
> perhaps more clarity.

I agree that adding an example for each control would be a Good Thing. It's
also not clear that the attributes are the default setting for the *flags*
of the class. The ReBar in the documentation does it like this, but is too
generic:


      rebar = create( ReBar, "", owner, x, y, cx, cy, flags )

That is, it should probably have specific values, like:

      -- create a ReBar control called MyRebar in MyWindow
      constant MyRebar = create( ReBar, "", MyWindow, 0, 0, 0, 0, {} )

The closer the example is to code that can actually be cut and paste, the
better. In fact, a complete example, such as:

      include Win32Lib
      integer MyWindow, MyRebar, MyCombo

      -- create a top level window for the application
      MyWindow = create( Window, "ReBar Demo", 0, ... )

      -- create a ReBar control in MyWindow
      MyRebar = create( ReBar, "", MyWindow, ... )

      -- place a combo in the ReBar
      MyCombo = create( Combo, "", ReBar, ... )

      -- open MyWindow as the application's main window
      WinMain( MyWindow, Normal )

that could be cut and paste would be even better. Since the example code
should be tested first, it might also be a Good Thing if there were a
hyperlink to the executable code that the user could click to run the
example as well.

It would also be nice if graphics were included in the help file - at least
for the controls.

On the other hand, even with extensive examples, the help file still can't
replace the need for a good tutorial.

Finally, all the controls
-- David Cuny