1. An idea of improving the win32lib.htm

I got the idea from looking at win2lib.htm
because the htm file is still not good at detail
for example:
  PushButton
  Command button control.
  Category: Controls
  A PushButton is a normal push button (sometimes called
  command button). A PushButton has the following attributes:


  WS_CHILD: child control of the parent
  WS_VISIBLE: it is visible
  BS_PUSHBUTTON: button style is pushbutton
  WS_TABSTOP: the control can be tabbed to
  .........
where we should put these attributes in create(.....)?
is it a function or a procedure?(of couse it is not)
and the example inside it is too short.
this is just my commant
i am a begainer of Euphoria and i know that this languge need to  AIY (Ask it
yourself) although these problems are small, it will affect all begainers like
me, and just don't know how to do.
after reading my letter, i hope you can "open" a new project called (or will
call) Euphoria Document Project, the army(correct spelling?) is to "create" and
improve the document of Euphoria.
by the end, i hope Euphoria will popular than other language like c++ or VB
thank you for reading my long letter.
YanYanCup--A Hong-Konger
_____________________________________________________
Sent by Hong Kong E-Mail at http://www.hkem.com
It's free. It's easy. Sign up your account Now!

new topic     » topic index » view message » categorize

2. Re: An idea of improving the win32lib.htm

The good thing about Win32Lib is that you don't have to worry about this
(low-level) details. If you want to place a button in a window, the
properties likes WS_ and BS_ are automagically added, thus creating a
PushButton. An example

-- suppose you have a window called "TheWindow"
-- create a button in TheWindow
global constant OK = create(PushButton,        -- the kind of control
                                          "OK",                 -- the text
on the control
                                          TheWindow,        -- the 'parent'
of the control
                                          8,                       --
distance from left of parent
                                          16,                     --
distance from top of parent
                                          90,                     -- width
of the control
                                          30,                     -- height
of the control
                                          0)                       --
additional attributes
The last parameter is not used in general. If it is used, it should contain
a sequence of attributes that 'replace' the default WS_ and BS_. So don't
bother with that for the time being.
In general, I recommend you to try and read and execute the example files
that come with Win32Lib. Also, there is the EUWinTutor by Wolfgang Fritz &
others:
http://www.king.igs.net/~wolfritz/EUWinTutor.zip

And you know, don't hesitate to ask further questions.

Bye,    Ad

----- Oorspronkelijk bericht -----
Van: euphoria euphoria <euphoria at HKEM.COM>
Aan: <EUPHORIA at LISTSERV.MUOHIO.EDU>
Verzonden: zondag 24 september 2000 15:08
Onderwerp: An idea of improving the win32lib.htm


> I got the idea from looking at win2lib.htm
> because the htm file is still not good at detail
> for example:
>   PushButton
>   Command button control.
>   Category: Controls
>   A PushButton is a normal push button (sometimes called
>   command button). A PushButton has the following attributes:
>
>
>   WS_CHILD: child control of the parent
>   WS_VISIBLE: it is visible
>   BS_PUSHBUTTON: button style is pushbutton
>   WS_TABSTOP: the control can be tabbed to
>   .........
> where we should put these attributes in create(.....)?
> is it a function or a procedure?(of couse it is not)
> and the example inside it is too short.
> this is just my commant
> i am a begainer of Euphoria and i know that this languge need to  AIY (Ask
it yourself) although these problems are small, it will affect all begainers
like me, and just don't know how to do.
> after reading my letter, i hope you can "open" a new project called (or
will call) Euphoria Document Project, the army(correct spelling?) is to
"create" and improve the document of Euphoria.
> by the end, i hope Euphoria will popular than other language like c++ or
VB
> thank you for reading my long letter.
> YanYanCup--A Hong-Konger
> _____________________________________________________
> Sent by Hong Kong E-Mail at http://www.hkem.com
> It's free. It's easy. Sign up your account Now!

new topic     » goto parent     » topic index » view message » categorize

3. Re: An idea of improving the win32lib.htm

------=_NextPart_000_0026_01C025FC.008B7660
        charset="iso-8859-1"

All,

I hate to say it, but I think Yan is sorta right: the documentation is *not*
well oriented for beginners.  It needs examples for every entry, & perhaps
more clarity.  I think maybe we can use the difficulties beginners have to
help us see how to improve it?



Yan,

As far as I understand it, those attributes of the pushbutton are *already*
set by default, I think.  Here is an example of creating a push button:

      -- create a pushbutton
      constant MyButton = create( PushButton,     -- the class
                                  "Push Me!",     -- the caption
                                  MyWindow,      -- the parent
                                  10, 10,         -- x and y position
                                  60, 40,         -- width and height
                                  0 )             -- no special flags

It might look like this when you make it, with the comments removed:
constant MyButton = create( PushButton,"Push Me!", MyWindow, 10, 10, 60, 40,
0 )

As you can see, the way to create a control is to use the "constant"
definition facility to create some constant whose name you choose that you
then use when referring to the control, which is set equal to some value
returned from the "create" function, which serves to identify the control to
other routines.

While you are correct that the example in the win32lib.htm is minimal
(actually, there isn't any),  there are example *PROGRAMS* provided with
Win32Lib which illustrate a wide variety of things you can do with Win32Lib,
including the creation of push buttons; and there also is a program I sent
to RDS, "Gateway to Win32Lib Examples", which makes it easier to run & view
the example programs; and I have attached to this post a short Win32Lib FAQ
I started (which is also included with the "Gateway" program), which might
start to answer a couple of your questions.

Dan Moyer



----- Original Message -----
From: "euphoria euphoria" <euphoria at HKEM.COM>
To: <EUPHORIA at LISTSERV.MUOHIO.EDU>
Sent: Sunday, September 24, 2000 6:08 AM
Subject: An idea of improving the win32lib.htm


> I got the idea from looking at win2lib.htm
> because the htm file is still not good at detail
> for example:
>   PushButton
>   Command button control.
>   Category: Controls
>   A PushButton is a normal push button (sometimes called
>   command button). A PushButton has the following attributes:
>
>
>   WS_CHILD: child control of the parent
>   WS_VISIBLE: it is visible
>   BS_PUSHBUTTON: button style is pushbutton
>   WS_TABSTOP: the control can be tabbed to
>   .........
> where we should put these attributes in create(.....)?
> is it a function or a procedure?(of couse it is not)
> and the example inside it is too short.
> this is just my commant
> i am a begainer of Euphoria and i know that this languge need to  AIY (Ask
it yourself) although these problems are small, it will affect all begainers
like me, and just don't know how to do.
> after reading my letter, i hope you can "open" a new project called (or
will call) Euphoria Document Project, the army(correct spelling?) is to
"create" and improve the document of Euphoria.
> by the end, i hope Euphoria will popular than other language like c++ or
VB
> thank you for reading my long letter.
> YanYanCup--A Hong-Konger
> _____________________________________________________
> Sent by Hong Kong E-Mail at http://www.hkem.com
> It's free. It's easy. Sign up your account Now!

------=_NextPart_000_0026_01C025FC.008B7660
        name="W32Faq.htm"
Content-Transfer-Encoding: quoted-printable

new topic     » goto parent     » topic index » view message » categorize

4. Re: An idea of improving the win32lib.htm

Yan,

I forgot to mention, the Win32Lib.htm which is included with the "bleeding
edge" v53 is an improvement over the previous versions; for instance, each
item in it is labeled as to whether it is a procedure, function, or
constant.  You might want to check it out.

Dan

----- Original Message -----
From: "euphoria euphoria" <euphoria at HKEM.COM>
To: <EUPHORIA at LISTSERV.MUOHIO.EDU>
Sent: Sunday, September 24, 2000 6:08 AM
Subject: An idea of improving the win32lib.htm


> I got the idea from looking at win2lib.htm
> because the htm file is still not good at detail
> for example:
>   PushButton
>   Command button control.
>   Category: Controls
>   A PushButton is a normal push button (sometimes called
>   command button). A PushButton has the following attributes:
>
>
>   WS_CHILD: child control of the parent
>   WS_VISIBLE: it is visible
>   BS_PUSHBUTTON: button style is pushbutton
>   WS_TABSTOP: the control can be tabbed to
>   .........
> where we should put these attributes in create(.....)?
> is it a function or a procedure?(of couse it is not)
> and the example inside it is too short.
> this is just my commant
> i am a begainer of Euphoria and i know that this languge need to  AIY (Ask
it yourself) although these problems are small, it will affect all begainers
like me, and just don't know how to do.
> after reading my letter, i hope you can "open" a new project called (or
will call) Euphoria Document Project, the army(correct spelling?) is to
"create" and improve the document of Euphoria.
> by the end, i hope Euphoria will popular than other language like c++ or
VB
> thank you for reading my long letter.
> YanYanCup--A Hong-Konger
> _____________________________________________________
> Sent by Hong Kong E-Mail at http://www.hkem.com
> It's free. It's easy. Sign up your account Now!

new topic     » goto parent     » topic index » view message » categorize

5. Re: An idea of improving the win32lib.htm

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

new topic     » goto parent     » topic index » view message » categorize

6. Re: An idea of improving the win32lib.htm

Hi,
Hey look, anybody who wants to submit improved documentation of any thing in
win32lib can do so. Just write up an improvement, which can be any size of
course, and I'll put it in to the project. Some people have already done
this, (thank you by the way) and I encourage others to put a sentence or two
together too.

For example, you might want to pick a specific function and write up its
details, including examples. Don't worry about format or spelling or
grammar, I can standardise that. Its content that is the time consuming
part.

As for the HTML version, please let me know of ways to improve this too. For
example, I'm thinking that the index could be in a separate frame on the
left-hand side of the screen.



----- Original Message -----
From: "euphoria euphoria" <euphoria at HKEM.COM>
To: <EUPHORIA at LISTSERV.MUOHIO.EDU>
Sent: Monday, September 25, 2000 12:08 AM
Subject: An idea of improving the win32lib.htm


> I got the idea from looking at win2lib.htm
> because the htm file is still not good at detail
> for example:
>   PushButton
>   Command button control.
>   Category: Controls
>   A PushButton is a normal push button (sometimes called
>   command button). A PushButton has the following attributes:
>
>
>   WS_CHILD: child control of the parent
>   WS_VISIBLE: it is visible
>   BS_PUSHBUTTON: button style is pushbutton
>   WS_TABSTOP: the control can be tabbed to
>   .........
> where we should put these attributes in create(.....)?
> is it a function or a procedure?(of couse it is not)
> and the example inside it is too short.
> this is just my commant
> i am a begainer of Euphoria and i know that this languge need to  AIY (Ask
it yourself) although these problems are small, it will affect all begainers
like me, and just don't know how to do.
> after reading my letter, i hope you can "open" a new project called (or
will call) Euphoria Document Project, the army(correct spelling?) is to
"create" and improve the document of Euphoria.
> by the end, i hope Euphoria will popular than other language like c++ or
VB
> thank you for reading my long letter.
> YanYanCup--A Hong-Konger
> _____________________________________________________
> Sent by Hong Kong E-Mail at http://www.hkem.com
> It's free. It's easy. Sign up your account Now!

new topic     » goto parent     » topic index » view message » categorize

7. Re: An idea of improving the win32lib.htm

On 24 Sep 2000, at 9:08, euphoria euphoria wrote:

> I got the idea from looking at win2lib.htm

> i am a begainer of Euphoria and i know that this languge need to  AIY (Ask it
> yourself)
> although these problems are small, it will affect all begainers like me, and
> just don't
> know how to do. after reading my letter, i hope you can "open" a new project
> called (or
> will call) Euphoria Document Project, the army(correct spelling?) is to
> "create" and
> improve the document of Euphoria. by the end, i hope Euphoria will popular
> than other
> language like c++ or VB thank you for reading my long letter. YanYanCup--A
> Hong-Konger
> _____________________________________________________ Sent by Hong Kong E-Mail
> at
> http://www.hkem.com It's free. It's easy. Sign up your account Now!
>

I could still swear this is mts in another alias again.

Kat

new topic     » goto parent     » topic index » view message » categorize

Search



Quick Links

User menu

Not signed in.

Misc Menu