home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BUG 4
/
BUGCD1997_05.BIN
/
aplic
/
clip4win
/
clip4win.exe
/
C4W30E.HUF
/
README4W.TXT
< prev
next >
Wrap
Text File
|
1996-06-19
|
25KB
|
712 lines
┌──────────────────────────┐
│ Clip-4-Win Version 3.0 │
│ Release Notes │
└──────────────────────────┘
Dear Clip-4-Win User,
Some of this file is aimed at purchasers of the full product. Please
keep that in mind if you have only the Evaluation Version. For example,
some of the source and other files are not supplied with the Evaluation
Version.
Thank you for purchasing Clip-4-Win, which is the only product that
lets you create TRUE Microsoft Windows executables with CA-Clipper 5.
This file contains:
1. Revised instructions for installation, checking it's working,
and Getting Started Quickly
2. New features added
3a. What's Where
3b. Information about files on the disk
4. Quick Start information
5. Answers to some commonly-asked questions
(especially about International characters)
Common errors are also described.
6. Edit control/combobox warning
7. Known problems
8. Contact information
To help improve this product, please suggest the feature(s) you would
most like adding. (Be sure to make clear which is most/least important.)
Samples are always welcome - especially those that interface to other
products/DLL's. Please see the contact information.
For TrueType browsers, see wbrowset.hlp (and wbrowset.lib), which is
used by many of the samples (e.g. source\oo\ brow.prg, browmdi.prg,
and mdiwbrow.prg).
Be sure to follow QUICK.TXT & to look at the tutorials in the manual
(and online NG & HLP files).
For a comprehensive demonstration of using Windows functions, try demomult.
Consultants! If you'd like to be included in a register of consultants
and developers who can provide services related to Clip-4-Win, please
contact Skelton Software.
Best Wishes,
John Skelton
1. Revised instructions for installation / Getting Started Quickly
===================================================================
Please look at the QUICK.TXT file. Sorry to send you elsewhere,
but this file is big enough already. (You might like to print QUICK.TXT
so you can work through it, step-by-step.)
After QUICK.TXT you are recommended to work through CONVERT.TXT and
the tutorials in the manuals/NG/HLP.
Please check for any TXT files on the installation diskette(s) for more
recent information.
2. New features added
======================
The major changes from version 2.0 to version 3.0 are:
- Greatly increased ease of use, especially for beginners
- Detailed tutorials, both non-OO and OO (Object Oriented)
- A feature-rich (and faster) browser, modelled on TBrowse
- Optional easy to use Command layer
- An optional class creation system (TopClass)
- Optional Application Classes (C4WClass), with source code
- VBX support
- Enhanced ODBC/SQL support
- Tabbed dialogs (property sheets)
- Enhanced MDI support
- Greatly enhanced dialogs
- More data-driven support
- Toolbar can be a dialog
- Many more samples
- R & R for Windows 6 support
- MAPI support
- DDE Server support
- More Windows API support
- Improved and more detailed documentation - printed and online
- Extra files contributed by users - many thanks!
- Multi-instance support (ability to run app several times concurrently)
- Support for Video for Windows (AVI) files
- Bug fixes (just a few)
- Still doesn't _require_ OO to be used!
- Still allows Class(y), HighClass, etc. to be used!
The major changes from version 1.2 to version 2.0 were:
- support for the Clipper debugger (CLD.LIB)
- complete sample applications
- tool bar support
- bitmapped buttons
- enhancements to dialogs, including CALLBACKs with dynamic
dialogs (using code blocks)
- ability to set Clipper's default font (used with QOUT, @ ... SAY,
TBrowse, etc.)
- window subclassing
- drag and drop support
- full support for MDI (Multiple Document Interface)
- optional use of window procedures
- owner drawn controls and menus
- full access to all window messages
- an IDE, with source, written in Clip-4-Win
- bitmaps over 1MB
- many more sample files (over 1.2MB source code)
- Windows metafile support
- sample interface code for Crystal Reports
- sample interface code for Q+E Database library / ODBC
- sample interface code for BTrieve
- sample interface code for MCI
For more details of the changes made, consult the changes.txt file.
3a. What's Where
================
- WinHelp files.
hlp\otabt.hlp Tabbed dialogs using TopClass
hlp\wbrowset WBrowse(T), i.e. WBrowse for TopClass
hlp\c4w.hlp Windows Help for Clip-4-Win
- The Clip-4-Win library.
lib\clip4win.lib
- The Clip-4-Win NG.
ng\clip4win.ng See the topics: Getting Started,
Compiling and Linking, Classes,
Commands, and the TopClass summaries
- Optional class creation layer: TopClass (TM).
include\topclass.ch
lib\topclass.lib Normal library
- Optional Clip-4-Win Application Classes (TM).
lib\c4wclass.lib Requires topclass.lib
source\oo\classes\
*.prg Source of most classes
c4wclass.rmk To build c4wclass.lib
- Sample Non-OO Command-oriented programs.
source\
avi2.prg Video for Windows (AVI) sample
button2.prg Simple buttons-only sample
cmd\
app*.prg Samples for the tutorial
draw.prg Simple drawing program
colour2.prg Shows using colours
font2.prg Using fonts
help.prg Invoking WinHelp (windows Help)
icondem2.prg Showing an icon
mci2.prg MCI sample
rrwapi.prg R & R for Windows 6 API
run.prg RUN programs, using WinExec()
users\
userscmd.prg From the non-OO tutorial
usersres\
userscmd.prg From the non-OO tutorial
vbxdemo2.prg Using a VBX (Visual Basic control)
video2.prg Video for Windows (AVI) sample
- Sample Non-OO programs.
source\
addmgr\*.* A complete non-trivial application
bwcc.prg For Borland's Custom Controls
clipb.prg Using the clipboard
colour.prg Shows using colours
combobox.prg Functions for combo boxes
edit.prg Functions for edit controls
listbox.prg Functions for list boxes
lzfuncs.prg Some Windows decompression functions
toolbar.prg Toolbar functions and demo
and many more!
- Sample OO programs.
source\oo\
brow.prg browser, using WDBrowse
browmdi.prg MDI browser, using WDBrowse
brush.prg Various brush samples
dbfgen.* Generates DBF files
ddeclien.prg DDE client demo
ddeserve.prg DDE server demo
dragdrop.prg Drag & drop sample
icondemo.prg Icon sample
mci.prg Multimedia (video) demo
mdibars.prg Multiple status bars and toolbars
mdibitma.prg MDI bitmap display demo
mdiblist.prg MDI dialog sample using BListBox
mdimenus.prg MDI menu demo
mdiwbrow.prg MDI browser using WBrowse(T)
odbcbrow.prg ODBC browse using BListBox
odbcwbro.prg MDI ODBC browser, using WBrowse
pbar.prg Progress bar demos
toolbdlg.prg A toolbar using a dialog
wb.prg A sample browse in a dialog (blistbox)
c4wbuild.bat tries to build an app, using rmk if any
linkit.bat tries to link an app & add any resources
users\*.prg various versions of the tutorial app
usersmdi\*.prg various versions of the tutorial app
vbxgen.* Generates VBX class .PRG & .CH files
- A TopClass version of WBrowse.
lib\wbrowset.lib Requires topclass.lib
source\wbtdemo.zip Demo files
- A TopClass version of oTab (tabbed dialogs).
lib\otabt.lib Requires topclass.lib
source\otabdemo.zip Demo files
- The optional command-oriented layer.
include\
commands.ch Requires c4wclass.lib
dll.ch Easier interfacing to DLL's
menu.ch MENU commands
source\cmd\
*.* Non-OO samples
source\icondem2.prg Icon sample
source\font2.prg Font sample
source\mci2.prg Multimedia (video) demo
source\users\*.prg Non-OO version of USERS (dynamic)
source\usersres\*.prg Non-OO version of USERS (resource)
source\oo\cmd\
*.* OO samples
source\oo\*.prg Most OO samples use the commands
dbfgen.* Generates DBF files
vbxgen.* Generates VBX class .PRG & .CH files
- Enhanced ODBC support
changes.txt MS ODBC API - brief documentation
source\oo\
odbcbrow.* ODBC browser using WBListBox class
odbcwbro.* MDI ODBC browser using WBrowse(T)
classes\odbc.prg ODBC class
- New / updated header files.
include\
bitmap.ch
commands.ch
dde.ch
dll.ch
etextout.ch
font.ch
mapi.ch
menu.ch
odbc.ch ODBC 2.x using MS DLL(s)
openfile.ch
print.ch
setemode.ch
topclass.ch
vbxbi.ch VBX using Borland's BIVBXnnn.DLL
vo.ch Don't get too excited!
windows.ch
wnet.ch Windows (e.g. Workgroups) network API
- VBX Support
include\commands.ch E.g. @ ID ... VBX
source\vbxdemo2.* Non-OO sample
source\oo\vbxdemo.* OO sample
source\oo\vbxgen.* Generates VBX class .PRG & .CH files
source\oo\circ3*.* Sample using CIRC3.VBX
- Generate DBF files in Windows
source\oo\dbfgen.* Try it!
- More data-driven support
changes.txt Dynamic dialogs can be used with
DialogBox(), CreateDialog(), and
MDICreateDialog()
e.g. see source\oo\classes\dialog.prg
- Debugging / tracing
source\dbg.prg Just keep calling DbgTrace()
and then DbgShow() to view the trace
e.g. see the OO layer (must compile
with /dWIN_DEBUG)
- More Windows API functions
changes.txt Brief documentation
include\setemode.ch SetErrorMode()
lib\clip4win.lib GetOpenFileName() & GetSaveFileName()
can return the filter index
lib\clip4win.lib GetClassName() & GetClassInfo()
source\lzfuncs.prg LZOpenFile(), LZCopy(), etc.
source\printdc.zip ExtDeviceMode()
source\winapi\
adjrect.prg Adjust[Window]Rect()
devmode.prg ExtDeviceMode(); & see source\printdc.zip
dll.prg Samples of _DLL command
modusage.prg GetModuleUsage()
stretchb.prg StretchBlt() [also in clip4win.lib]
wnet.prg WNet*() API
- More DOS functions
changes.txt Brief documentation
lib\clip4win.lib Drive & Directory operations
- Contributed by users
oTab
WBrowse(T)
source\printdc.zip ExtDeviceMode()
source\printfls.prg File printing program
source\rrw*.* R & R Windows 6 API & sample
source\contrib\mapi.zip MAPI
Note: I have more that I need to sort through...
- Multi-instance support (ability to run app several times concurrently)
source\multinst.prg Call it if you want this feature
- Fairly intelligent app builder
bin\c4wbuild.bat
- Bug fixes/enhancements
changes.txt Brief documentation (not much to fix!)
lib\clip4win.lib New drive & directory operations
lib\clip4win.lib Enhanced A2Bin() & Bin2A()
lib\clip4win.lib Enhanced GetProcAddress()
lib\clip4win.lib GetClassName() & GetClassInfo()
source\achoice.prg Enhanced
source\addmgr.prg Minor fixes
source\app.prg Enhanced
source\clip4win.def Increased stacksize; big apps can
need more (10K - 14K)
source\listbox.prg Enhanced
source\toolbar.prg Enhanced
source\dbrowse\*.prg Enhanced/minor fixes
52\source\getsys.prg Fixed as in 2.0
3b. Information about files on the disk
=======================================
With Clip-4-Win are many files (especially README.*), including:
changes.txt changes made to Clip-4-Win
quick.txt getting started quickly
readme4w.txt this file
52\ Clipper 5.2-specific files
lib\ LIB files after you run MAKELIBS
source\getsys.prg enhanced GET System
53\ Clipper 5.3-specific files
lib\ LIB files after you run MAKELIBS
bin\
exemark.exe can be used if you have Microsoft LINK 5.1x to mark
the .exe file as suitable for Win 3.x
c4wstub.exe a Windows stub program (used by *.def when linking)
blinker\ sample link script
dll\ resource-only dll
hlp\
c4w.hlp Windows Help file
icondraw\ a shareware icon editor (not supported)
include\
accel.ch definitions for accelerators
commdlg.ch useful definitions for ChooseColor(), ChooseFont(),
PrintDlg() and other Common Dialogs
dde.ch definitions for DDE
dialog.ch definitions for @ DIALOG ... GET, etc.
font.ch font-related header file
say.ch definitions for @ ... SAY with fonts, etc.
setcaret.ch definitions for changing the Windows caret
textmetr.ch definitions for GetTextMetrics()
unwindow.h renames common Windows API's so the names do not
conflict with Clipper names and so you can
use CLIP4WIN.LIB without needing the Windows SDK
windows.ch the main header file
ng\
clip4win.ng Norton Guides
optlink\ hints for OptLink
rtfgen\ a shareware HLP maker
slssetup\ a shareware setup maker
snpshot\ a shareware bitmap grabber
source\
achoice.prg replacement for AChoice()
addrc.bat basic batch file to add resources to your .EXE
file (requires the use of a resource compiler
such as that provided with the Windows SDK)
alert.prg Clip-4-Win version of Alert()
app.* an application template/framework
cl.bat simple batch file for compiling and linking
clip4win.def a typical definition file for linkers to use
*.rmk various RMAKE files
bitmap.prg bitmap demo
button.prg button demo
chkevent.prg a wrapper for handling events from _ChkEvent()
clipb.prg an example using the Windows clipboard
(many programs can copy/cut/paste to/from the
clipboard, e.g. Notepad, WinWord)
colour.prg simple example of ChooseColor()
combobox.prg sample of simple and drop-down combo boxes
combobox.def
combobox.rmk (includes quite a number of useful functions, too)
ctl3d.dll optional 3d controls for use with dialog.prg
(or your own application)
dde.prg sample DDE program and functions
dem4old.prg an event-driven demo, showing clipboard, colours,
dll access, fonts, a pie chart, printer, and timer
dem4mold.prg a multi-window version of dem4old.prg
demomult.prg combined demo, with browse, data entry, bitmap,
demomult.def pie chart, bar chart, clipboard, fonts, clock,
demomult.rmk modeless GETs, etc.
dialog.prg modal and modeless dialogs, both dynamic and
dialog.rc from resource files, and optional 3d controls
dlog.ch also shows validation using GETs
draw.* a drawing program, using a window procedure
drop.* drag-and-drop sample
edit.prg sample of single-line and multi-line edit controls
edit.def
edit.rmk (includes quite a number of useful functions, too)
errorsys.prg enhanced error system
evhand.prg Clipper source for the event-handling functions
AddHandler(), DelHandler(), and HandleEvent()
font.prg font demo, using ChooseFont() and CreateFont()
hello.prg "Hello World!" in 1 line (+function/return)
listbox.prg sample listbox as a child control, and also as
a dialog item
mdi*.* MDI samples
memoedit.prg replacement for MemoEdit()
metafd.* metafile sample
od.*, odraw.* owner-drawn controls
printer.def
printer.prg printer/GDI demo
prt.prg suggestions for PrintDlg()
scrollba.prg scroll bar demo
scrollwi.prg the ScrollWindow() function, using a DLL call
tbrowse.prg a TBrowse which responds to events such as mouse
clicks and double clicks, being re-sized, and
needing to be re-drawn (see DEMOMULT.PRG for a
larger example). Plan to use WBrowse instead!!
toolbar.prg how to do a toolbar (also see app.prg,
demomult.prg, addmgr\ and oo\mdibars.prg)
window.def
window.prg sample Window Manager and other classes
(needs SuperClass)
winsetup.prg typical Windows initialisation
wndsetup.prg typical Windows initialisation with window proc.
wreader.prg custom GET reader, used by demomult.prg
source\addmgr a complete application (Address List Manager),
with TrueType browse, support for Crystal
Reports 3, toolbar, Borland buttons, resources
including menus, window subclassing, WinHelp,
status/message bar, etc.
source\contrib user-contributed files
Note: do look at these -- they're very good,
and some parts are likely to be used in the
main part of Clip-4-Win.
The only restriction is that you must use them
with Clip-4-Win applications.
Many thanks to ADM, AK, B, DM, DW, HL, JB, JS,
TK and anyone I've mistakenly forgotten!
Also note: they're not "fully supported", sorry.
Not having written them does make support
harder. You're welcome to ask, just don't be
upset if the answer is "sorry, don't know".
source\dbrowse browser with TrueType fonts
source\ide an IDE (Integrated Development Environment),
written in Clip-4-Win
source\lines drawing and using WinExec() (German)
source\padding multiple notepads
source\pubnews sample using dbrowse
source\users resource and non-resource DBF form view samples
source\usersres
source\winapi sample C, PRG and ASM functions showing how to
call Windows API and DOS functions for:
bitmaps, pattern brushes, DLL access, menus,
MCI (Media Control Interface), etc.
supercls\
readme.txt description of what's here
arr.obj allows SuperClass III to work with Clip-4-Win
object.prg a file missing from the SuperClass III disk
dbxstore\
readme.txt description of what's here
dbx.obj allows dBxStore II to work with Clip-4-Win
4. Quick Start information
===========================
Please look at the QUICK.TXT file.
Please check for any TXT files on the installation diskette(s) for more
recent information.
5. Answers to some commonly-asked questions
============================================
Moved to the NG and HLP files. See topic FAQ (Frequently Asked Questions).
6. Edit control/combobox warning
=================================
Note: This does NOT apply to dialogs - they don't use heapsize this way.
If you encounter general protection faults (Windows errors) when
using edit controls and/or comboboxes, this indicates that you
should increase your application's heap size. This can be done
very easily by including the following line in the .DEF file that
you use when linking the application:
heapsize 5120
Note: that's heapsize, not stacksize.
This parameter determines the maximum size of the edit control. The
5120 is just an example, you may be happy with less or need more.
7. Known problems
==================
Please check for any TXT files on the installation diskette(s) for more
recent information.
7.1 The Debugger
-----------------
Important: Consider getting Mr Debug for Windows (MrD4Win). Please
contact Skelton Software for details.
The debugger doesn't know anything about Windows. This has various
repercussions, e.g. no mouse support inside CLD.
You need to compile with /b. You also need to call the AltD()
function (you can't type Alt-D).
The debugger often updates its screen in an annoying fashion.
In the debugger, pressing F4 can be confusing. Try pressing it
again (or not at all).
The debugger doesn't always re-draw its screen properly, e.g. after
examining an array.
Debugging can be harder with window procedures because messages
are passed to the window procs even if you stop at a breakpoint.
If you need to stop in a window proc you must do so inside a
DO CASE, but WM_PAINT is not a good idea as it's quite likely to
occur again and again. Child windows can cause problems, because
if a child window receives certain messages (e.g. WM_PAINT) it may
send messages such as WM_CTLCOLOR or WM_DRAWITEM to its parent.
Whether that happens or not, because the window proc remains active
the values of LOCAL variables can be misleading/wrong.
Example:
FUNCTION MyWndProc(hWnd, nMsg, nwParam, nlParam)
// .
// . DON'T STOP HERE
// .
DO CASE
CASE nMsg == WM_PAINT
// DON'T STOP HERE
CASE nMsg == WM_xxx
// here is probably ok
CASE nMsg == WM_xxx
// so is here
ENDCASE
// . . .
Please report any other problems you find.
8. Contact information
=======================
Skelton Software
Kendal Cottage
Hillam
Leeds LS25 5HP
England
Tel: +44 1977 683296
Fax: +44 1977 681650
CompuServe: 100112,3102
Internet: john@skelton.com
or 100112.3102@compuserve.com
The Legal Stuff
---------------
Clip-4-Win and Clip-4-Win Toolkit are trademarks of Skelton Software.
Clip-4-NT, Clip-4-OS2, Clip-4-OS/2, Clip-4-UNIX and Clip-4-VO are
trademarks of Skelton Software. TopClass and Clip-4-Win Application
Classes are Trademarks of Skelton Software.
This file and the software it refers to are proprietary and copyright.
They may only be used in accordance with a license granted by the
copyright holder.
All other trademarks acknowledged.
Copyright (C) 1995 Skelton Software. All Rights Reserved.