1. Win32Lib: some "add-on" html documentation : "synopsis"
------=_NextPart_000_0021_01BF3EB6.7D18A3C0
charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
David,
=20
Adding "multiple windows" to your IDE sure makes a world of difference!! =
Nice going!
=20
Being a perpetual newbie/dilettante, I still find myself making constant =
"external" reference to all the documentation I can find, including your =
html doc & Wolfgang & Ad's Tutorial (which now lacks the "Synopsis" =
which I really liked). So I took your html doc & abstracted a bunch of =
stuff up into a "Synopsis" section (with the eventual intention of =
amending your IDE to jump from the code editor (by right click) into =
your html doc with my abstracted synopsis "top end", like their Tutorial =
does. That would put the info I usually need just one mouse click away =
while using your IDE.).
Below is a copy of what I did, in case anyone else might find it =
useful. It goes in right after <body> in your html doc. I did change & =
add a little to what I abstracted, so if I introduced errors, =
inaccuracies, or confusion, I hope someone will let me know. =20
=20
Dan Moyer=20
=20
<h1><a name=3D"SYNOPSIS"></a>SYNOPSIS of <a =
href=3D"#INTRODUCTION">Win32Lib</a> Documentation:</h1>
<p><h3> CORE CONCEPTS:</h3>
<li> <a href=3D"#CONTROL">CONTROLS</a>
are the basic visual & useable elements of Windows programs. They are =
what you see, act upon, or set to perform actions. You can=20
<a href=3D"#CREATE">create</a> them, query and change their <a =
href=3D"#ATTRIBUTE">Attributes</a>, and respond to=20
<a href=3D"#EVENT">Events</a> which happen to them.
<li><a href=3D"#ATTRIBUTE">ATTRIBUTES of Controls</a>:=20
Controls can have a variety of properties, such as size, font size, etc.
Various routines let you inspect and alter attributes of=20
controls.
<li> <a href=3D"#EVENT">EVENTS</a>: Windows programming consists of =
writing routines to respond to various events, such as actions taken=20
by the user of the application - mouse clicks, key presses, resizing=20
windows, and so on.
<li> <a href=3D"#WINMAIN">MAIN EVENT LOOP</a>
: WinMain is the main processing loop for Win32Lib. You call WinMain at =
the very end of your program, after all the controls have been declared =
to run in the event loop, and after all the routines you have written to =
handle all of the events you want to respond to in your program.
<p><hr>
<p><h3>WIN32LIB ROUTINES CATEGORIES:</h3>
<li> <a href=3D"#DIALOG">DIALOGS</a>
These are functions that bring up common dialogs.
<li> <a href=3D"#EDIT CONTROL">EDIT CONTROL</a>
These are routines that let you inspect and alter attributes of=20
the text edit controls
<li> <a href=3D"#FONT">FONTS</a>
These routines allow you to work with text graphics: displaying text,=20
changing the font, and so on.
<li> <a href=3D"#GRAPHIC">GRAPHICS</a>
These are routines that allow you to draw on controls, typically=20
a <a href=3D"#WINDOW">Window</a>, <a href=3D"#PIXMAP">Pixmap</a> or <a =
href=3D"#PRINTER">Printer</a>.
<li> <a href=3D"#LIST CONTROL">LIST CONTROLS</a>
These are routines that let you inspect and alter attributes of=20
controls with lists
<li> <a href=3D"#LOW LEVEL ROUTINE">LOW LEVEL ROUTINES</a>
These routines give you access to C data structures, the device context, =
and other Win32 API goodies
<li> <a href=3D"#PRINTING">PRINTING</a>
These are routines that allow you to interact with the <a =
href=3D"#PRINTER">Printer</a>
<li> <a href=3D"#SCROLL CONTROL">SCROLL CONTROLS</a>
These routines let you inspect and alter attributes of the scroll=20
bar controls <a href=3D"#HSCROLL">HScroll</a> and <a =
href=3D"#VSCROLL">VScroll</a>
<li> <a href=3D"#UTILITIE">UTILITIES</a>
These are routines that didn't seem to fit in any other category.
<li> <a href=3D"#XPM">XPM</a>
These routines deal with a portable graphics file format called XPM -=20
"X Pixmap". XPM graphics can be embedded in programs as text data.
<hr>
<p><h3>WIN32 DATA TYPES:</h3>
<li> <a href=3D"#TYPE">DATA TYPES</a>:
These are data types defined by Win32Lib.
<p>
<hr><hr>
<h1><a name=3D"INTRODUCTION">Win32Lib INTRODUCTION:</a></h1>
<strong>WHAT IS IT?</strong><br>
Win32Lib is a toolkit for coding applications in Euphoria without having =
to learn the many intricacies of Win32. It is based loosely around =
Visual Basic.
<p><strong>WHAT DOES IT COST?</strong><br>
Win32Lib is FREEWARE, but if you develop applications in it, I ask that:
<ol><li>I receive credit for Win32Lib. This means inclusion of the =
following (or similar text) in an "About" box, located in the "Help" =
menu option:<br>
"Developed using David Cuny's Win32Lib"
<li>I receive a full, registered version of the application.
</ol>
<strong>DISCLAIMER:</strong><br>=20
This program is distributed in the hope that it will be useful, but=20
WITHOUT ANY WARRANTY; without even the implied warranty of =
MERCHANTABILITY=20
or FITNESS FOR A PARTICULAR PURPOSE.
=20
<p> I do not accept responsibility for any effects, adverse or =
otherwise,
that this code may have on you, your computer, your sanity, your dog,
and anything else that you can think of. Use it at your own risk.
<p><hr><hr>
=20
=20
------=_NextPart_000_0021_01BF3EB6.7D18A3C0
charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
<!DOCTYPE HTML PUBLIC "-//W3C//DTD W3 HTML//EN">
<HTML>
<HEAD>
<META content=3Dtext/html;charset=3Diso-8859-1 =
http-equiv=3DContent-Type><!DOCTYPE HTML PUBLIC "-//W3C//DTD W3 =
HTML//EN">
<META content=3D'"MSHTML 4.72.3110.7"' name=3DGENERATOR>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT color=3D#000000 face=3D"Times New Roman">David,</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman"></FONT> </DIV>
<DIV><FONT face=3D"Times New Roman">Adding "multiple windows" =
to your=20
IDE sure makes a world of difference!! Nice going!</FONT></DIV>
<DIV><FONT face=3D"Times New Roman"></FONT> </DIV>
<DIV><FONT face=3D"Times New Roman">Being a perpetual newbie/dilettante, =
I still=20
find myself making constant "external" reference to all the=20
documentation I can find, including your html doc & Wolfgang & =
Ad's=20
Tutorial (which now lacks the "Synopsis" which I really=20
liked). So I took your html doc & abstracted a bunch of =
stuff up=20
into a "Synopsis" section (with the eventual intention of =
amending=20
your IDE to jump from the code editor (by right click) into your html =
doc with=20
my abstracted synopsis "top end", like their Tutorial =
does. That=20
would put the info I usually need just one mouse click away while using =
your=20
IDE.).</FONT></DIV>
<DIV><FONT face=3D"Times New Roman"></FONT> </DIV>
<DIV><FONT face=3D"Times New Roman"> Below is a copy of what I =
did, in case=20
anyone else might find it useful. It goes in right after =
<body> in=20
your html doc. I did change & add a little to what I =
abstracted, so if=20
I introduced errors, inaccuracies, or confusion, I hope someone will let =
me=20
know. </FONT></DIV>
<DIV><FONT face=3D"Times New Roman"></FONT> </DIV>
<DIV><FONT face=3D"Times New Roman">Dan Moyer </FONT></DIV>
<DIV><FONT face=3D"Times New Roman"></FONT> </DIV>
<DIV><FONT size=3D2>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><h1><a=20
name=3D"SYNOPSIS"></a>SYNOPSIS of <a=20
Documentation:</h1></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><p><h3> CORE=20
CONCEPTS:</h3></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>are the =
basic visual=20
& useable elements of Windows programs. They are what you see, act =
upon, or=20
set to perform actions. You can </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><a=20
href=3D"#CREATE">create</a> them, query and change =
their <a=20
href=3D"#ATTRIBUTE">Attributes</a>, and respond to=20
</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><a=20
href=3D"#EVENT">Events</a> which happen to =
them.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><li><a=20
href=3D"#ATTRIBUTE">ATTRIBUTES of Controls</a>: =
</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>Controls =
can have a=20
variety of properties, such as size, font size, etc.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>Various =
routines let you=20
inspect and alter attributes of </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3>controls.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
href=3D"#EVENT">EVENTS</a>: Windows programming =
consists of=20
writing routines to respond to various events, such as actions taken=20
</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>by the user =
of the=20
application - mouse clicks, key presses, resizing </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>windows, =
and so=20
on.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
href=3D"#WINMAIN">MAIN EVENT LOOP</a></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>: WinMain =
is the main=20
processing loop for Win32Lib. You call WinMain at the very end of your =
program,=20
after all the controls have been declared to run in the event loop, and =
after=20
all the routines you have written to handle all of the events you want =
to=20
respond to in your program.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman"=20
size=3D3><p><hr></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman"=20
size=3D3><p><h3>WIN32LIB ROUTINES =
CATEGORIES:</h3></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These are =
functions that=20
bring up common dialogs.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
href=3D"#EDIT CONTROL">EDIT CONTROL</a></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These are =
routines that=20
let you inspect and alter attributes of </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>the text =
edit=20
controls</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These =
routines allow you=20
to work with text graphics: displaying text, </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>changing =
the font, and so=20
on.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These are =
routines that=20
allow you to draw on controls, typically </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>a <a=20
href=3D"#WINDOW">Window</a>, <a=20
href=3D"#PIXMAP">Pixmap</a> or <a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
href=3D"#LIST CONTROL">LIST CONTROLS</a></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These are =
routines that=20
let you inspect and alter attributes of </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>controls =
with=20
lists</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
href=3D"#LOW LEVEL ROUTINE">LOW LEVEL =
ROUTINES</a></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These =
routines give you=20
access to C data structures, the device context, </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>and other =
Win32 API=20
goodies</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These are =
routines that=20
allow you to interact with the <a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
href=3D"#SCROLL CONTROL">SCROLL =
CONTROLS</a></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These =
routines let you=20
inspect and alter attributes of the scroll </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>bar =
controls <a=20
href=3D"#HSCROLL">HScroll</a> and <a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These are =
routines that=20
didn't seem to fit in any other category.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These =
routines deal with=20
a portable graphics file format called XPM - </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>"X =
Pixmap". XPM=20
graphics can be embedded in programs as text data.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><hr></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><p><h3>WIN32=20
DATA TYPES:</h3></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li> =
<a=20
href=3D"#TYPE">DATA TYPES</a>:</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>These are =
data types=20
defined by Win32Lib.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><p></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman"=20
size=3D3><hr><hr></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><h1><a=20
name=3D"INTRODUCTION">Win32Lib=20
INTRODUCTION:</a></h1></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><strong>WHAT IS=20
IT?</strong><br></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>Win32Lib is =
a toolkit for=20
coding applications in Euphoria without having to learn the many =
intricacies of=20
Win32. It is based loosely around Visual Basic.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman"=20
size=3D3><p><strong>WHAT DOES IT=20
COST?</strong><br></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>Win32Lib is =
FREEWARE, but=20
if you develop applications in it, I ask that:</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3><ol><li>I=20
receive credit for Win32Lib. This means inclusion of the following (or =
similar=20
text) in an "About" box, located in the "Help" menu=20
option:<br></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3>"Developed using=20
David Cuny's Win32Lib"</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><li>I =
receive a=20
full, registered version of the application.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3></ol></FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman"=20
size=3D3><strong>DISCLAIMER:</strong><br> =
</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>This =
program is=20
distributed in the hope that it will be useful, but </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>WITHOUT ANY =
WARRANTY;=20
without even the implied warranty of MERCHANTABILITY </FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>or FITNESS =
FOR A=20
PARTICULAR PURPOSE.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" =
size=3D3></FONT> </DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3><p> I =
do not accept=20
responsibility for any effects, adverse or otherwise,</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>that this =
code may have=20
on you, your computer, your sanity, your dog,</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman" size=3D3>and =
anything else that=20
you can think of. Use it at your own risk.</FONT></DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman"=20
size=3D3><p><hr><hr></FONT></FONT><FONT =
color=3D#000000=20
face=3D"Times New Roman" size=3D3></FONT></DIV></DIV>
<DIV> </DIV>
<DIV><FONT color=3D#000000 face=3D"Times New Roman"></FONT> </DIV>
<DIV><FONT color=3D#000000=20
------=_NextPart_000_0021_01BF3EB6.7D18A3C0--
