Microsoft KB Archive/103645

= How To Change the Default Windows Printer from FoxPro =

Article ID: 103645

Article Last Modified on 6/29/2004

-

APPLIES TO


 * Microsoft Visual FoxPro 3.0 Standard Edition
 * Microsoft Visual FoxPro 5.0 Standard Edition
 * Microsoft Visual FoxPro 6.0 Professional Edition
 * Microsoft FoxPro 2.6 Standard Edition
 * Microsoft FoxPro 2.6a Standard Edition

-



This article was previously published under Q103645





SUMMARY
With the set of procedures included in this article, you can change the default Windows printer from within FoxPro for Windows.

NOTE: These procedures also work in Window NT. The method described below does not work with FoxPro 2.6a in Windows 95.



MORE INFORMATION
Following is a summary of the three main procedures: LISTPRINT, GETPRINT, and PUTPRINT.

LISTPRINT
LISTPRINT displays on the screen all the printers in the WIN.INI file, the number of printers, and the default printer.

GETPRINT
The GETPRINT procedure is called by LISTPRINT and gets a list of available printers, the number of printers, and the default printer in the WIN.INI file. The parameters are as follows:


 * Printer list (array)
 * Number of printers in WIN.INI file (numeric)
 * efault printer in the WIN.INI file (character)

PUTPRINT
The PUTPRINT procedure sets the default printer in the WIN.INI file. This procedure takes three or four parameters, as follows


 * Printer list (array--Use parameter 1 from GETPRINT.)
 * Number of printers (numeric--Use parameter 2 from GETPRINT.)
 * The new default print string (Put directly into the WIN.INI file.)

or passes two numeric parameters (3 and 4):


 * Number of the printer in the printer array (numeric)
 * Port number (If a printer has more than one port [FILE:, LPT1:] the number will represent the number in the list order [FILE: = 1, LPT1: = 2]. If a third parameter is passed that is numeric, but no fourth parameter is passed, it will default to the first or only port.)

For example, after first executing the LISTPRINT procedure with the DO LISTPRINT command, the WIN.INI file's printer information is placed in the device array. The PUTPRINT procedure can then be used to change the default printer driver. There are two ways to use the GETPRINT and PUTPRINT routines, as shown in the examples below. (Example 1 is the easier of the two). LISTPRINT is the only a way to display the current printers. Both examples use GETPRINT to pass the number of printers back to PUTPRINT.

Example 1
Printers = "" Number = 0 Defa_print = "" DO GETPRINT WITH Printers, Number, Defa_print *Printers  - is an array with all the printers installed. *Number    - is the number of printers in the WIN.INI file. *Defa_print - is the default printer in the WIN.INI file.

DO PUTPRINT WITH Printers, Number, x  *Printers   - is the return array from the GETPRINT. *Number    - is the return number of printers from GETPRINT. *x         - is the number of the row (in the Printers array) that *            you want to be the new default printer. *y         - is only needed if the printer has more than one output *            port. If it does, you use this parameter to set the port *            (LPT1 = 1, LPT2 = 2 and LPT3 = 3)

Example 2
Printers = "" Number = 0 Defa_print = "" DO GETPRINT WITH Printers, Number, Defa_print *Printers  - is an array with all the printers installed. *Number    - is the number of printers in the WIN.INI file. *Defa_print - is the default printer in the WIN.INI file.

DO PUTPRINT WITH Printers, Number, NEW_DEFA *Printers  - is the return array from the GETPRINT. *Number    - is the return number of printers from GETPRINT. *NEW_DEFA  - is the new default string that will be put directly into *            the WIN.INI file (e.g., "HP LaserJet III,HPPCL5MS,LPT1;") *            This should only be done if you know exactly what should *            be in the Default printer string. Keep in mind that PUTPRINT puts the information that you supply directly into the WIN.INI file. Therefore, GETPRINT is used first, so that no installed printers are lost while you are setting a new default printer.

To verify that the correct driver has been set as the default, issue the following commands:

RELEASE device DO LISTPRINT

Following is the code for the three main procedures, GETPRINT, LISTPRINT, and PUTPRINT, which make calls to three additional procedures, PUTPROSTRG, GETPROSTRG, and GETPORT.

NOTE: Removing the SET TALK lines from this code will cause a "Cannot access characters beyond string" error. *!*****************************************************************  *!   *!     Procedure: GETPRINT *!  *!*****************************************************************   PROCEDURE getprint * Query WIN.INI to get data on the installed and default printers.

PARAMETER DEVICE, NUMBER, dfltprnt * Usage: *   DIMENSION device[1] *   numprinters = 0 *   defaultprnt = "" *   DO GETPRINT WITH device, numprinters, defaultprnt *  * The "device" array will be populated with the names and * parameters for all installed print devices. *  * The "device" array has this structure: * Col 1: Printer name * Col 2: Parameter for [device] section * Col 3: Parameter for [PrinterPort] section (includes time-out  * parameters) *  * The contents of "device" might look something like this after * GETPRINT is called: *  Col 1                      Col 2           Col 3 *  -  --     *   Apple LaserWriter II NTX   pscript,LPT2:   pscript,LPT2:,15,90 *  Generic / Text Only=TTY    fred.prn        fred.prn,15,45 *  HP LaserJets(Level 5)      HPPCL5MS,LPT1:  HPPCL5MS,LPT1:,15,45 *  * "numprinters" in this case would be 3 * "defaultprnt" might be this: *   HP LaserJets(Level 5),HPPCL5MS,LPT1:

#DEFINE buflen 2048 PRIVATE m.in_talk, m.dcount, m.retbuf, m.bytes, m.thisdevice

IF PARAMETERS < 3 WAIT WINDOW "This procedure requires 3 parameters" RETURN ENDIF

IF FILE(SYS(2004)+"FOXTOOLS.FLL") SET LIBRARY TO (SYS(2004)+"foxtools.fll") ADDITIVE ELSE WAIT WINDOW "GETPRINT requires the FoxTools library." RETURN ENDIF

IF SET("TALK") = "ON" SET TALK OFF m.in_talk = "ON" ELSE m.in_talk = "OFF" ENDIF

* Fill in the first column of the array with installed device * names. m.retbuf = REPLICATE(CHR(0),buflen) m.bytes = getprostrg("devices",0,CHR(0),@m.retbuf,buflen) * The second argument of 0 to GetProfileString returns the contents * of the entire section, with each entry separated by a null terminator * (CHR(0)). m.dcount = 0 m.retbuf = LEFT(m.retbuf,m.bytes) DO WHILE CHR(0) $ m.retbuf m.thisdevice = LEFT(m.retbuf,AT(CHR(0),m.retbuf)-1) IF LEFT(m.thisdevice,1) <> CHR(0) m.dcount = m.dcount + 1 DIMENSION device[m.dcount,3] device[m.dcount,1] = m.thisdevice ENDIF m.retbuf = SUBSTR(m.retbuf,AT(CHR(0),m.retbuf)+1) ENDDO

* Fill in the second and third columns of the device array with the * parameters of each installed device from the [devices] section * (column 2) and the [PrinterPorts] section (column 3). FOR m.j = 1 TO m.dcount retbuf = REPLICATE(CHR(0),256) m.bytes = ; getprostrg("devices",device[m.j,1],CHR(0),@m.retbuf,256) m.retbuf = LEFT(m.retbuf,m.bytes) device[m.j,2] = m.retbuf

retbuf = REPLICATE(CHR(0),256) m.bytes = ; getprostrg("PrinterPorts",device[m.j,1],CHR(0),@m.retbuf,256) m.retbuf = LEFT(m.retbuf,m.bytes) device[m.j,3] = m.retbuf ENDFOR

* Store the number of installed devices. m.number = m.dcount

* Now get the default printer. retbuf = REPLICATE(CHR(0),256) m.bytes = getprostrg("windows","device",CHR(0),@m.retbuf,256) m.retbuf = LEFT(m.retbuf,m.bytes) m.dfltprnt = m.retbuf

SET TALK &in_talk

*!*****************************************************************  *!   *!     Procedure: LISTPRINT *!  *!*****************************************************************   PROCEDURE listprint PARAMETER DEVICE #DEFINE buflen 2048 PRIVATE m.in_talk,m.i  IF FILE(SYS(2004)+"FOXTOOLS.FLL") SET LIBRARY TO (SYS(2004)+"foxtools.fll") ADDITIVE ELSE WAIT WINDOW "LISTPRINT requires the FoxTools library." RETURN ENDIF IF SET("TALK") = "ON" SET TALK OFF m.in_talk = "ON" ELSE m.in_talk = "OFF" ENDIF

DIMENSION DEVICE(1) NUMBER = 0 dflt = ""

DO getprint WITH DEVICE, NUMBER, dflt CLEAR ? ALLTRIM(STR(m.number,3))+" installed printer devices in win.ini:" FOR m.i = 1 TO NUMBER ? " "+device[m.i,1]+"="+device[m.i,3] ENDFOR ?  ? "Default printer is "+dflt SET TALK &in_talk

*!*****************************************************************  *!   *!     Procedure: PUTPRINT *!  *!*****************************************************************   PROCEDURE putprint PARAMETER DEVICE, NUMBER, dflt, portnum * Take the printer device information in the device array and * update WIN.INI with it. *  * "Number" is the total number of printers listed in "device." * "dflt" is the string to write to the [windows] device= statement * to set the default printer, or if dflt is a number, the array row * to construct this statement from. Thus, to make the default * printer the third one listed in "device," either pass a 3 as dflt * or pass the actual string (something like HP LaserJets(Level * 5),HPPCL5MS,LPT1:). If the string is passed, it must exactly * match an entry in the [devices] section of the WIN.INI file. *  * GETPRINT can be used to construct the device array. *  IF FILE(SYS(2004)+"FOXTOOLS.FLL") SET LIBRARY TO (SYS(2004)+"foxtools.fll") ADDITIVE ELSE WAIT WINDOW "PUTPRINT requires the FoxTools library." RETURN ENDIF

IF TYPE("dflt") = "N" IF PARAMETERS < 4 portnum = 1 ENDIF m.strg = device[m.dflt,1]+","+getport(device[m.dflt,2],portnum) ELSE m.strg = m.dflt ENDIF

* Set the default printer =putprostrg("windows","device",m.strg)

* Delete all existing device and PrinterPort entries. =putprostrg("devices",0,CHR(0)) =putprostrg("PrinterPorts",0,CHR(0))

FOR m.i = 1 TO NUMBER =putprostrg("devices",device[m.i,1],device[m.i,2]) =putprostrg("PrinterPorts",device[m.i,1],device[m.i,3]) ENDFOR

*!*****************************************************************  *!   *!     Function: PUTPROSTRG *!  *!*****************************************************************   FUNCTION putprostrg PARAMETER SECTION, entry, string fn = regfn("WRITEPROFILESTRING","CCC","I") RETURN callfn(fn,SECTION,entry,string) * NOTE: When the code in this section is implemented in a program * running on Windows 95 or Windows NT, the user will get the error * "Entry point writeprofilestring not found." In this case, add the * optional fourth argument to the call to function call RegFN * in the function named putprostrg as per the following example: *  * fn=regfn("WRITEPROFILESTRING","CCC","I","krnl386.exe") *  * The string "krnl386.exe" specifies that the writeprofilestring API * is located in that library. *!*****************************************************************  *!   *!     Function: GETPROSTRG *!  *!*****************************************************************   FUNCTION getprostrg PARAMETER SECTION, entry, dflt, buffer, blen fn = regfn("GETPROFILESTRING","CCC@CI","I") RETURN callfn(fn,SECTION,entry,dflt,@buffer,blen) * NOTE: When the code in this section is implemented in a program * running on Windows 95 or Windows NT, the user will get the error * "Entry point getprofilestring not found." In this case, add the * optional fourth argument to the call to function call RegFN * in the function named Getprostrg as per the following example: *  * fn=RegFN("GETPROFILESTRING","CCC@CI","I","krnl386.exe") *  * The string "krnl386.exe" specifies that the getprofilestring API * is located in that library.

*!*****************************************************************  *!   *!     Function: GETPORT *!  *!*****************************************************************   FUNCTION getport PARAMETER m.pstrg, m.pnum * Get the first "port" from a printer string.

* First get the printer driver name (e.g., pscript) and the comma. m.retstrg = SUBSTR(m.pstrg,1,AT(',',m.pstrg))

* Now get the port designation (e.g., LPT1: or FILE:)

* Check if the port passed is greater than the ports available. IF OCCURS(',',m.pstrg) >= m.pnum m.portstrg = SUBSTR(m.pstrg,AT(',',m.pstrg,m.pnum)+1) ELSE m.portstrg = SUBSTR(m.pstrg,AT(',',m.pstrg,1)+1) ENDIF

IF AT(',',m.portstrg) > 0 m.portstrg = LEFT(m.portstrg,AT(',',m.portstrg)-1) ENDIF

RETURN m.retstrg + m.portstrg

Keywords: kbhowto kbvfp300 kbvfp500 kbvfp600 kbprint kbcode kbprinting KB103645

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.