the software that grows
with you
Vouch32 ChangeLog
| Vouch32.lib Change Log |
|
Version 4.0 06 February 2005 |
||
| New | Vouch32 Serial Communication Functions . v4.0 is centered around the Clipper Tools III compatible Serial Communications functions with enhancements to accommodate lower level WinApi functionality to handle your own protocols effectively. It must be noted that these functions are only usable when Vouch32 Server is run as "Server" protocol. | |
| V32Com_Open( ncPort, nInBuffer, nOutBuffer ) | ||
| V32Com_Init( ncPort, nBaudRate, cParity, nStopbits, nDatabits ) | ||
| V32Com_Close( ncPort ) | ||
| V32Com_Send( ncPort, cString ) | ||
| V32Com_Read( ncPort, nBytesToRead ) | ||
| V32Com_SSend( ncPort, cString ) | ||
| V32Com_SRead( ncPort ) | ||
| V32Com_Flush( ncPort ) | ||
| V32Com_Count( ncPort ) | ||
| V32Com_SCount( ncPort ) | ||
| V32Com_SFlush( ncPort ) | ||
| V32Com_Hard( ncPort, lOnOff, lDsrDtr ) | ||
| V32Com_Soft( ncPort, lOnOff, ncXonChar, ncXoffChar ) | ||
| V32Com_SSoft( ncPort ) | ||
| V32Com_RSoft( ncPort, lNewStatus ) | ||
| V32Com_Break( ncPort, nDuration ) | ||
| V32Com_Cts( ncPort ) | ||
| V32Com_Dsr( ncPort ) | ||
| V32Com_Ring( ncPort ) | ||
| V32Com_Dtr( ncPort, lNewStatus ) | ||
| V32Com_Rts( ncPort, lNewStatus ) | ||
| V32Com_Dcb( ncPort, aDcb ) | ||
| V32Com_TimeOuts( ncPort, aTimeouts ) | ||
| V32Com_Stat( ncPort ) | ||
| V32Com_Dialog( cDevice ) | ||
| V32Com_Default( cDevice ) | ||
| V32Com_Error( ncPort ) | ||
| V32Com_Escape( ncPort, nFunction ) | ||
| V32Com_SMask( ncPort, nMask ) | ||
| V32Com_GMask( ncPort ) | ||
| V32Com_GEvent( ncPort ) | ||
| V32Com_Transmit( ncPort, ncChar ) | ||
| New | V32Speak( cText ) | |
| Enhanced | V32SendMail() . Now attachments can be sent with SMTP protocol as well. | |
Changes in Version 3.5 07 September 2003 |
||
 |
Vouch32 Server
Protocol . v3.5 is centered around the SERVER concept where
VouchSrv.exe is executed independent of application as a server and client
application's requests are entertained by it on
first-come-first-serve basis.
The necessity to develop SERVER protocol evolved due to few considerations, viz.: 1) The complexity of functions responsible to execute some child process process through command-line parameters with different compilers. For example, Clipper provides RUN command, Clipper + Blinker provides SwpRunCmd() function, Xbase++ provides RunShell() function and (x)Harbour _Run() function. The behavior of all these is not consistent with each other. Also parameter passing is again a problem with them. Moreover, the behavior or these functions and commands is peculiar with OS to OS. With SERVER protocol, no RUN function or command is needed and hence renders Vouch32 more acceptable to any compiler comfortably. 2) Windows NT, 2000, XP operating systems do not release the child process until it is finished unlike Windows 98 or ME. This basic change in the behavior of Windows is not desired at times under Vouch32's underlying design and concept, where a client's request is desired to be terminated as soon as it is executed, to be run at the background. 3) OLEDB connectivity through ADO object to access various RDBMS servers, viz., Oracle, SqlServer, Informix, Sybase, MySql, etc., needs a different kind of functionality in order to use them in real-time environments. So a complete set of new functions are provided if Vouch32 is run as SERVER besides all previous functions which can be run under both protocols. To run Vouch32 as SERVER you need overall two code changes and one change in execution behavior: a) V32Init( cTitle, cServerPath, cConnectPath, cLibrary, lAsServer, cLinker ) . <lAsServer> need to be set to TRUE. b) VouchSrv.ini . Under [PATHS] section <VouchConnectionPath> must be set equal to <cConnectPath> of V32Init(). c) VouchSrv.exe is to be executed prior to any V32...() command is executed, but make it sure that VouchSrv.exe is NOT exxecuted from within the application.
|
|
|
|
New The above group of functions is designed exclusively for Vouch32Server protocol. Under this group of functions, connection to the database is established only once and the subsequent operations are carried in relation to that open connection. More than one connection can be opened simultaneously. Thus data access is almost instant because it eliminates the need to open and close connections with every call of Vouch32 functions. These functions correspond to : V32Ado2Dbf(
cConxnString, cSql, cDbf, aStruct, aProgBar ) which run under threaded execution of VouchSrv.exe. |
|
|
|
New V32AdoDatabase( cConxnString ) . Creates a database given the cConxnString. |
|
|
|
New V32AdoTable( cConxnString, cTable, aStruct ) . Create a Table within the database space of cConxnString. The structure definition can be that of Clipper type and/or peculiar to database in question. |
|
|
|
New V32AdoExecute( cConxnString, cSql ) . Executes a cSql command against the database opened through cConxnString. |
|
Changes in Version 3.4 02 August 2003 |
||
|
|
Enhanced Print Preview Dialog . Active Keys . Now Print Preview Dialog responds to keystrokes, e.g., PgUp, PgDn, Ctrl_S, Ctrl_C, Ctrl_P, etc. |
|
|
|
Enhanced Print Dialog ( V32P_DLG_VOUCH ) is now multi-language compatible. All prompts can be changed through VouchSrv.ini. The same is true for all associated dialogs of VPE Print Preview Window, viz., Page Selection, Print and Info dialogs including the text on titlebar. |
|
|
|
New V32PGetTextWidth( cnPrinter, nOrientation, aFont ) will return an array of 255 elements containg width of each character in ASCII table for the specified printer, orientation and font attributes. Then with the help of this table you can calculate the width of any string in pixels and can control precisely the text output. <aFont> contains the elements { cFont, nHeight, nAngle, lBold, lItalic, lUnderline, lStrikeout, nCharSet } |
|
|
|
New V32PGraph( <nRow>,<nCol>,<n2Row>,<n2Col>, <aData>, <aLabels>, <aLegends>, [aColors], [nType], [cTitleTop], [cTitleLeft], [cTitleBottom], [cBkGdBitmap], [l3D], [lSpace], [lStacked], [lGridX], [lGridY], [lLegends], [lLabelsX], [lLabelsY], [lOutLines], [lData], [nPxlLeft], [nPxlTop], [nPxlWidth], [nPxlHeight], [nBGColor] ) will print a graph object identical to V32Graphs() object with Vouch32 Print Engine. Now you can create reports studded with Bar/Line/Area/Pie, 2d/3d, Spaced/Stacked charts along with other graphic objects which Vouch32 Print Engine supports. |
|
|
|
New
V32MakeDir(
cDir ) . Creates a directory <cDir> any level deep at once. The only
restriction is the length of <cDir> == 255. All the top level
directories will be created at once. |
|
|
|
New V32Orc2Dbf( cConnect, cDatabase, cSql, cDbf, aStruc, lWantInfo, aProg ) . Returns a .dbf file matching the fields of cSQL statement and aStruc out of an Oracle database. |
|
|
|
New V32Acs2Dbf( cConnect, cDatabase, cSql, cDbf, aStruc, lWantInfo, aProg ) . Returns a .dbf file matching the fields of cSQL statement and aStruc out of an Access Database. |
|
|
|
New V32Sql2Dbf( cConnect, cDatabase, cSql, cDbf, aStruc, lWantInfo, aProg ) . Returns a .dbf file matching the fields of cSQL statement and aStruc out of a MSSQL Server database. |
|
|
|
New V32Ado2Dbf( cConnect, cDatabase, cSql, cDbf, aStruc, lWantInfo, aProg ) . Returns a .dbf file matching the fields of cSQL statement and aStruc out of a cConnect ADODB compatible data source. |
|
Changes in Version 3.3 30 May 2003 |
||
|
|
Enhanced Vouch32 Print Engine is enhanced drastically. Now you can exercise a lot more control over the printer and the way application should behave. Specially <nPrintDlg> parameter of V32PBeginDoc() allows you to control the Print Preview Window and Printer attributes in one go. If set to V32P_DLG_VOUCH (default), it presents a Vouch32 defined Print Dialog which is preset to options supplied by the V32PBeginDoc() parameters and allow to change them on the fly and with a option to fire the preview window if so desired. |
|
|
||
New Param V32PBeginDoc( ncPrinter, cTitle, nOrient, nCopies, lPreview, cFont, nPoint, nWidth, nZoomFactor, nPrintQuality, nPaperLength|nPaperSize, nPaperWidth, nDuplex, lMono, nPaperSource, nPrintDlg ) |
||
|
||
Enhanced V32PSetUnit( nUnit ) now supports V32P_TEXT V32P_MILL V32P_CENT V32P_INCH V32P_PIXEL units of measurement. |
||
|
||
Functional V32PBarCode( nRow, nCol, cCode, nHeight, nThick, lPrintCode, nType ) is now functional and supports nType == V32P_3OF9 V32P_I2OF5 V32P_UPC_A V32P_UPC_E barcodes. V32P_EAN13 will be available in next release. |
||
|
||
New Param V32PTextOut( nRow, nCol, xValue, cPicture, nJustify, cFont, nStyle, nPoint, nFColor, nBColor, nAngle, nCharSet ). <nCharSet> receives the parameters out of ??_CHARSET constants from Vouch32.ch. |
||
|
||
Functional V32PTextBox( nRow, nCol, nRow2, nCol2, cText, nJustify, cFont, nStyle, nPoint, nFColor, nBColor, nThick, nCharSet ). This is fully functional now. |
||
|
||
New Param V32PSetFont( cFont, nStyle, nPoint, nFColor, nBColor, nCharSet ) |
||
|
||
New V32PSetDuplex( nDuplex ). <nDuplex> = one of DMDUP_ constants from Vouch32.ch. |
||
|
||
New V32PSetBin( nPaperSource ). < nPaperSource> = one of DMBIN_ constant from Vouch32.ch. |
||
|
||
New V32PSetPrnQuality( nPrnQuality ). < nPrnQuality > = one of DBRES_ constant from Vouch32.ch. |
||
|
||
New V32PSetMonoPrint( lYes ) sets the print in grayscale. |
||
|
||
New V32PGetPrinters() returns a list of installed printers in a single dimentional array. |
||
|
||
New V32PGetDefPrinter( lByName ) retrieves the default printer either by ordinal position or by name. |
||
|
||
New V32PGetCaps( ncPrinter, nOrientation ) returns a one-dimentional array of printer capabilities. |
||
|
||
New V32PGetFonts( ncPrinter, cFaceName ) returns a list of available fonts for the printer in question and optionally those fonts only matching the <cFaceName>. |
||
|
||
New V32PGetPaperSizes() returns an array of default paper sizes recognized by printer drivers. |
||
|
||
New V32OemToChar( cOem ) converts Character string to Oem string. |
||
New V32CharToOem( cChar ) converts Oem string to Character string. |
||
|
||
New Param V32Brw2Excel( oBrw, cPath ) where cPath must be without trailing backslash. |
||
|
||
Changes in Version 3.0 19 Mar 2003 |
||
|
|
New Vouch32 Print Engine with Preview . Includes PageScript language level compatible functions with more parameters. Presents a window to preview pages. Support for selected pages to send to printer, saving a page to .bmp file format, copying the page being previewed to clip-board for pasting purposes in other ole objects, per page different orientation ( portrait or landscape ) are few of the features. Following functions are included in current version: |
|
V32PBeginDoc( nPrinter, cTitle, nOrient, nCopies, lPreview, cFont, nPoint, nWidth ) |
||
V32PEndDoc() |
||
V32PNewPage( nOrient ) |
||
V32PBitmap( nRow, nCol, nRow2, nCol2, cBmpFile, nTransColor ) |
||
V32PPicture( nRow, nCol, nRow2, nCol2, cPictureFile ) |
||
V32PMetaFile( nRow, nCol, nRow2, nCol2, cMetaFile ) |
||
V32PBarCode( nRow, nCol, cCode, nHeight, nThick, lPrintCode, nType ) |
||
V32PTextOut( nRow, nCol, xValue, cPicture, nJustify, cFont, nStyle, nPoint, nFColor, nBColor, nAngle ) |
||
V32PTextBox( nRow, nCol, nRow2, nCol2, cText, nJustify, cFont, nStyle, nPoint, nFColor, nBColor, nThick ) |
||
V32PLine( nRow, nCol, nRow2, nCol2, nThick, nColor, nStyle ) |
||
V32PEllipse( nRow, nCol, nRow2, nCol2, nThick, nBColor, nFColor, nPattern ) |
||
V32PFrame( nRow, nCol, nRow2, nCol2, nThick, nBColor, nFColor, nPattern, nRoundR, nRoundC ) |
||
V32PSetUnit( nUnit ) |
||
V32PVersion() |
||
V32PSetPageSize( nLength, nWidth ) |
||
V32PSetRowCol( nRows, nCols ) |
||
V32PSetFont( cFont, nStyle, nPoint, nFColor, nBColor ) |
||
V32PSetFill( nColor, nPattern ) |
||
V32PSetBorder( nThick, nColor ) |
||
V32PSetJustify( nJustify ) |
||
|
|
New V32() . |
|
|
|
Enhanced V32DllCall() . Now the function supports 20 parameters instead of 10. |
|
|
|
Enhanced V32Graphs() . Context menu now offers four new options: 1) Copy Client Area ( Clipboard ) |
|
|
|
New V32ActiveX() . Fires any ActiveX installed on the machine which does not require any external container and has its own window or which can be run in the background, e.g., Excel, Word, Access, etc. Through this function you can set/get properties of the object and can store them in Vouch32 defined variables which can be exploited as normal variables and can execute the methods of the com object. |
|
|
Changes in Version 2.8 26 Dec 2002 |
||
|
|
New V32Db2Excel() . Opens a database file as an Excel sheet. |
|
|
|
New V32ExcelScript() . Creates a sheet in the Excel workbook, or number of sheets in a workbook through an array of user defined scripts, virtually offering the precise control over the contents of the Excel sheet(s). It also allows the use of formulaes provided by Excel API. |
|
|
|
New V32RegCreateKey() . Creates a specified key in the Windows' Registry database. |
|
|
|
New V32RegDeleteKey() . Deletes a specified key from the Windows' Registry database. |
|
|
|
New V32RegSetValue() . Sets a value for a name for a specified key in the Windows' Registry database. |
|
|
|
New V32RegGetValue() . Retrieves value for a specified name related to a specified key from the Windows' Registry database. |
|
|
|
Enhanced V32Graphs() . Added 15 new parameters to exercise greater control over look and feel of the chart window when displayed first time. Now the function with parameters is as: V32Graphs( <aData>, <aLabels>, <aLegends>, [aColors], [nType], [cTitleTop], [cTitleLeft], [cTitleBottom], [cBkGdBitmap], [l3D], [lSpace], [lStacked], [lGridX], [lGridY], [lLegends], [lLabelsX], [lLabelsY], [lOutLines], [lData], [nPxlLeft], [nPxlTop], [nPxlWidth], [nPxlHeight], [nBGColor] ) |
|
|
|
Enhanced V32HttpGet() . Added a parameter <cSaveAs> to save the contents of the http pages as a file represented by <cSaveAs>. |
|
|
Changes in Version 2.7 05 Nov 2002 |
||
|
|
New V32Notify() . Executes a MSN Messenger's mail arrival notification alert alike window with specified text. Program execution is never halted. |
|
|
|
New V32Splash() . Displays a splash window containing a bitmap for a specified duration. |
|
|
|
New VouchSrv.Ini . Country specific DateFormat initialization. Hope it will solve date field problem in V32Array2Excel() function. |
|
|
|
New V32SendMany() . Supports multiple reciepients and attachments via MAPI protocol. A function with reduced parameters. |
|
|
|
New V32CbCopy() . Copies the <cText> to the Windows Clipboard. |
|
|
|
New V32CbPaste() . Retrieves the text contents from the Windows Clipboard. |
|
|
|
Enhanced VouchSrv.ini . Multi language support is extended to all dialogs of Vouc32, including V32Graph and V32Edit dialogs. VouchSrv.ini can be configured to change strings for window controls and menu options whereever applicable. |
|
|
|
Enhanced
V32Ftp .
Now a number of <acSource> and <acTargets> can be issued with a single call to V32Ftp().
'DIR' command now returns a two-dimentional array with FileName, Attribute, Size, Date, Time columns for each file found on the server, correctly. [lWantInfo] A new parameter whether you need to receive the return values from FTP operations or not. If set to FALSE program execution will not wait for this function to return. Default is TRUE. [lNotify] A new parameter specifying whether a notification window be appear after each operation executed by V32Ftp. This notification window is synonymous to V32Notify(), a new function ( see above ). Default is FALSE. |
|
|
Changes in Version 2.6 30 Sep 2002 |
||
|
|
New
.
Performs commands requested for a specified ftp server. Commands available
are:
GET . Copies a remote
file onto a local drive. |
|
|
|
New . Returns various info about the system, viz., Major, minor and build numbers of Windows, Disk Volume Label, Disk Serial Number, Computer Name, User Name. | |
|
|
Enhanced . Added a parameter <aProgInfo>, an array holding the info required to configure the progress bar. This parameter is only considered if <lProgressBar> is set to TRUE. <aProgInfo> = { cTitle, nBkColor, nBarColor, nStyle, lShowPercent, lBorder }. | |
|
Changes in Version 2.5 23 Sep 2002 |
||
|
|
New V32PopStatus() . Returns number of messages and size in bytes therof from a specified POP3 account. | |
|
|
New V32PopInfo() . Returns a two dimentional array of various information from a POP3 account as to Id, Size, Header, Deleted, Subject, From and DateTime. | |
|
|
New V32PopMsgs() . Retrieves message bodies from a POP3 account given the message ids earlier retrieved through V32PopInfo() | |
|
|
New V32PopDelete() . Delets messages at a POP3 account given the message ids retrieved hrough V32PopInfo(). | |
|
|
New V32HttpGet() . Returns a specified url page contents as a character string from a specified HTTP server. | |
|
|
New V32INetConnected() . Checks whether a dial-up connection to the network has been established or not. | |
|
|
New V32INetDial() . Opens the default or specified dial-up connection for dialing. | |
|
|
New V32CopyFile() . Uses WinApi to copy a file to another destination. | |
|
|
New V32FileOperation() . Performs MOVE, COPY, DELETE, RENAME operations on specified filed with or without the Windows' Copy Progress Bar. Wildcards such as '*.*' and recursions are also supported. | |
|
|
New . Converts a TBrowse object into a .HTM file. The type of browser is immaterial. | |
|
|
New V32Tb2Dbf() . Converts a TBrowse object into a .DBF file. The type of browser is immaterial. | |
|
|
New V32Tb2Del() . Converts a TBrowse object into a delimited text file. The type of browser is immaterial. | |
|
|
New V32Tb2Sdf() . Converts a TBrowse object into a SDF ( System Data Format ) file. The type of browser is immaterial. | |
|
|
Enhanced
V32SendMail() . Three new parameters <lDefaulDlg>,
<lChkConnection>, <cConnectionId> are added.
If <lDefaultDlg> = TRUE and <cProto> = 'MAPI' then default mail client's mail drafting dialog is opened instead of Vouch32's dialog. You will find a few merits and few demerits in both systems. Choose as the situation demands. If <lChkConnection> = TRUE then Vouch32 checks whether some connection to the internet has been established or not, and if not, opens up the dial-up dialog to establish one. Which connection dial-up window is to be activated depends upon <cConnectionId>. If <cConnectionId> is not present, default dial-up connection will be used. |
|
|
|
Introduced VouchSrv.ini . The concept of INI has been introduced. Now Vouch32 defined dialogs can be configured to display prompts in language of choice. At present, two dialogs, viz., Edit Dialog and Mail Dialog are available in Vouch32. Redefine the entries therein to suit your language. With this feature, Internationalization of Vouch32 has started. | |
|
Changes in Version 2.2.1 13 Sep 2002 |
||
|
|
XBase++ Users There was an error related with SetCursor() function when compiled in pure GUI mode. It is corrected. A GUI demo with source is also included. All functions are working correctly except two, viz., V32Brw2Graph() and V32Brw2Excel(). These functions neeeds oColumn:picture, block and width properties and XbpColumn() class does not provide them. If you happen to have written XbpColumn() class, please let me know so that a solution to this problem be there. | |
|
Changes in Version 2.2 09 Sep 2002 |
||
|
|
New . Given a two-dimentional array of data alongwith column presentation information, it will display that array contents as the active Excel sheet. It is just like V32Brw2Excel() which converts a browers contents into an Excel sheet. It has the added functionality to control the look and appearnce of any single column as respect to font, size, color ( interior and/or font ). Also properties like bold, italics and underlines are supported. This functionality is lacking in V32Brw2Excel() function. | |
|
|
New . Given a two dimentional array containing paragraphs info, it will create a Word document for you. You can preview the document or can send to printer or can create and save/print at the background. Plain text, disk text files, array as table, bitmaps are supported. Font, size, color, alignment properties are also suppoted. These properties can be changed for each paragraph separately. | |
|
|
New . Supporting function to V32Word() which helps build the paragraphs through command syntax. Thus created array of paragraphs are submitted to V32Word(). | |
|
|
New . Header file to organize the pseudo-commands and define directives to ease out the parameter passing. | |
|
|
New . A function to call any function from a Windows DLL which has the normal parameters type. Structures as parameters are not supported yet. Also there is a limit of 10 parameters per function. This function is specially included on demand from a lot of developers. | |
|
|
Enhanced V32ShowBitmap( cFileBmp, lModal ) <lModal> is new parameter to open bitmap viewer in modal state. Default is FALSE means viewer will be opened in modeless state and control will be returned to application immediately after it is displayed on the screen. | |
|
|
Corrected The non-modal windows of Vouch32 were opened minimized when invoked from Xbase++. Now these windows open as normal. | |
|
Changes in Version 2.0 |
||
|
|
New . Given a two dimention array of numeric data and that is converted to a beautiful graph in a separate and threaded window. There you have all the power to change it to any type of graph. A lot of properties can be changed on the fly to have a desired effect of graphics display. Ic can be sent to printer with a click. | |
|
|
New . Converts the contents of an oBrowse to a beautiful graph in a separate threaded window. ( See Above ). | |
|
|
New . Converts an oBrowse contents into an Excel sheet and invokes the MS Excel forcing it to display it in its window. | |
|
|
New . Creates a .ZIP file format archive given an array of files to zip. | |
|
|
New . Uncompresses the files contained in a given archieve. | |
|
|
New V32ZipInfo() . Returns a two dimentional array of information in previously stored archive containing File Name, Uncompressed Bytes, Compressed Bytes, Percentage of Compression, Date Stamp and Time Stamp per file. | |
|
|
New . Extracts the selected files from an archive. It is similar to V32UnzipFile() but with a difference that it only extract the files of choice. | |
|
|
Functional V32SendMail() : <nClpBPos> parameters now correctly adjusts the clipboard text and <cMessage> parameters. | |
|
Changes in Version 1.2 |
||
|
|
New V32SendMail() function. Now you can send emails from within your Clipper & XBase++ programs. Both MAPI and SMTP protocols are supported. The function is extensively parameterized to facilitate you to control the behaviour of mails meticulously. It supports interactive mode and background mode. | |
|
|
New <cLinker> parameter to V32Init(). Now developers without Blinker can link Vouch32.lib. They have only to define a dummy function SwpRunCmd() anywhere in their project | |
|
|
New <cWndTitle>, <cFont>,<nFontSize> parameters to V32Edit(). Now users can control the look and feel of edit dialog. | |
|
|
Edit Dialog now suports resizing. All controls adjust accordingly. | |
|
Changes in Version 1.1 |
||
|
|
New Added support for Clipper 5.2e, Xbase++ 1.7, XBase++ 1.8. 1.0 supported only Clipper 5.3b. | |
|
|
Installation now creates Program Group and places icons in it to run demos for all compilers. | |
|
|
Structure of installation folder made more tangible and easy to use. Please discard previous installation, if any. | |
|
|
Paths to the relevant files made relative to the installation folder. Now Vouch32.lib can be installed on any drive and directory. Simply do not change the internal structures to run the demos. | |
|
Attension XBase++ Users |
||
|
|
Only executables for both versions are included in the demo. Run time libraries of XBase++ are left out. It is assumed that you have already installed XBase++ 1.7 or 1.8 depending upon your choice and runtime files are already placed in a folder specified in path statement of autoexec.bat file. Otherwise a runtime error will be raised. | |
| Enjoy | ||
