{ ****************************************************************** } { } { Delphi component TWindowImage (descendant of TImage component) } { } { Window Image Component for Delphi 1.x/Windows 3.1x (16-bit) } { } { Copyright © 1997 C. L. Lankford } { } { This component is offered "AS IS" and WITHOUT ANY WARRANTIES, } { EXPRESSED/IMPLIED. Responsibility for ANY damages, etc., rests } { entirely with the user. } { } { C. L. Lankford lankford@net-master.net } { 108 Marshall St. SW http://www.net-master.net/~lankford/ } { Hartselle, AL 35640-4106 (NO PHONE CALLS ACCEPTED!!!) } { } { TWindowImage is a Delphi/Windows screen image capture component. } { While it can always be used in the same manner as it's parent, } { TImage, it's primary use is for capturing screen/window images. } { TWindowImage is primarily used in screen capture applications. } { } { TWindowImage, as it descends from TImage, has all the events, } { properties, and methods of TImage. In addition, the component } { has the following additional event, method, and properties: } { } { Event: OnCapture, occurs when a screen/window image has } { been captured, as a result of a GetWindowImage } { method call. Add code for this event via the } { Events page of the Object Inspector, to add any } { special code to be executed on image captures. } { Add code for this event at design-time, to be } { executed when the event occurs at run-time. } { } { Method: GetWindowImage, acquires a bitmap image of the } { desired screen, window, or window client area, as } { selected by setting the properties below. } { Callable/executable at run-time only. } { (Example call/usage: WindowImage1.GetWindowImage;)} { } { Property: WActiveWindow (boolean), Window/Screen selection } { TRUE = Select active window only } { FALSE = Select entire display screen } { Selectable at either Design-Time or Run-Time. } { (Example: WindowImage1.WActiveWindow:=TRUE;) } { } { Property: WClientArea (boolean), Window area selection } { TRUE = Select client area of window only } { FALSE = Select entire window (with borders, etc.) } { Selectable at either Design-Time or Run-Time. } { (Example: WindowImage1.WClientArea:=TRUE;) } { (Note: full-screen client area = full-screen) } { } { Property: OtherWindow (hwnd), specifies the handle to some } { other window/control to capture a bitmap of. } { Selectable only at Run-Time. } { (Example: windowwanted:=findwindow(nil, } { 'Program Manager'); } { WindowImage1.OtherWindow:=windowwanted;)} { (Note: using OtherWindow overrides WActiveWindow, } { set to 0, zero, to reset during execution) } { } { ****************************************************************** } Files Included: --------------- file_id.diz - Short package overview for software vendors/libraries readme.txt - This file, package/component description information install.txt - TWindowImage component installation instructions usage.txt - TWindowImage component usage instructions orderfrm.txt - Order form for the TWindowImage registered version winimage.dcr - TWindowImage VCL palette bitmap (compiled resource) winimage.dcu - TWindowImage VCL component (compiled unit) demoinfo.txt - Brief descriptions/objectives of the demo programs demos.zip - .ZIP archive compressed file, containing source code of numerous example Delphi programs which use the TWindowImage component. These demo programs show the various ways that the component can be used by an application, but are not production quality software themselves. Registration: ------------- The winimage.dcu TWindowImage Delphi VCL component provided in the package distributed by software vendors/libraries constitutes a "Demo" version. The winimage.dcu file distributed to registered developers is the version which may be used in applications developed for distribution, either "For-Profit" or otherwise. The "Demo" version works exactly as the registered version, but with the words "TWindowImage Demo" placed in the center of captured images. The registered version does NOT place this text in the images. Registered developers, please note that if this text does NOT appear in captured images, then you are most certainly using the registered version, as no other restrictive mechanisms are present. The registered version ordering details are contained in the file: orderfrm.txt, which is the order form itself. Registration constitutes acceptance of the terms of the disclaimer of warranty, as given below. Benefits of Registration: ------------------------- 1. The "TWindowImage Demo" text does NOT appear in the center of the images captured by the registered version. 2. Registered developers are granted non-exclusive, royalty-free, distribution rights, with regard to applications which have the TWindowImage component (winimage.dcu) embedded/linked into their application. The only restriction is that the winimage.dcu file itself may NOT be distributed in a stand-alone fashion (i.e. you may not distribute the winimage.dcu file itself). 3. Registered developers may request product support for a period of 30 (thirty) days, commencing on the date that the registered version is initially distributed to them. Product support, if needed, is handled via e-mail only, per the author's e-mail address at: lankford@net-master.net E-mail support is more efficient, less costly, less labor intensive, and much faster than ANY other method. 4. Registered developers may use the TWindowImage component, subject to item 2 above, on any number of computers owned, provided that the registered developer is an individual. This is to say that site licensing is NOT required for an individual developer. For site licensing to companies, departments, agencies, etc., please contact the author for details and volume discount pricing. Disclaimer of Warranty: ----------------------- THIS SOFTWARE AND THE ACCOMPANYING FILES ARE PROVIDED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. ALL RESPONSIBILITY FOR DAMAGES (WHETHER ACTUAL/REAL OR IMAGINED) RESTS ENTIRELY WITH THE DEVELOPER OF APPLICATIONS THAT USE THE COMPONENT, AND THEIR CLIENT(S). ANY SOFTWARE DEVELOPER THAT IS NOT IN COMPLETE AGREEMENT WITH THE FOREGOING TEXT SHOULD NOT USE THE COMPONENT, AND SHOULD REMOVE SAID COMPONENT FROM THEIR COMPUTER SYSTEM PERMANENTLY. REGISTRATION/LICENSE OF THE COMPONENT IS CONTINGENT UPON THE ACCEPTANCE OF THIS DISCLAIMER. REGISTRATION CONSTITUTES ACCEPTANCE OF THESE TERMS. Version History: ---------------- V1.0 - TWindowImage Delphi 1.x/Windows 3.1x VCL Component Initial Release (June 1997) Naming Conventions: ------------------- TWindowImage - Class name of the TWindowImage component. WindowImage - Name for the component that shows up in the component palette hint and in the installed component list. Also used as the base name for instances of the component added to forms (i.e. WindowImage1, WindowImage2, etc.), until the developer changes the names via the object inspector, etc. WinImage - Unit name added to application "USES" clauses. Also the base name of the component compiled unit file winimage.dcu, component compiled resource file (containing the palette bitmap) winimage.dcr, etc.