ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Print functions
  • Reinitializing the print module
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
iConfigure (Function)
In french: iConfigure
Configures the printer for a print performed in WLanguage:
  • by opening the configuration window. If the information is validated by the user, the changes are performed for the current application only.
  • by modifying the printer used for the current print. This modification can be temporary (for the current program only) or permanent (the default printer is modified in the control panel of Windows for example).
To configure the printer when printing reports (created with the report editor), use iConfigureReport.
Example
WEBDEV - Server codeAjax
IF iConfigure("ServerPrinter") = True THEN
// Create a 48-point Pica font
iCreateFont(1, 48, iBold + iItalic, iRoman)
// Print a text with this font
iPrint(iFont(1) + "48-pica text")
// Ends the print
iEndPrinting()
END
Syntax
WEBDEV - Server codeAjax

Modifying the destination printer Hide the details

<Result> = iConfigure([<Printer name> [, <Temporary modification>]])
<Result>: Boolean
  • True if the change of printer was performed,
  • False otherwise.
<Printer name>: Optional character string
Identifies the printer to use. Its name was defined in the control panel of or in the window for print configuration.
WEBDEV - Server code This parameter must be specified.
<Temporary modification>: Optional boolean
  • True (by default) if the modification of the printer must be taken into account for the current program. This change will remain effective until the end of program execution (except if iReset is called).
  • False if the modification of the printer must be performed in the control panel of Windows or in the window for configuring the print. The default printer is modified.
Remarks
WEBDEV - Server codeAjax

Reinitializing the print module

If iConfigure returns True, the print module is reinitialized. Therefore, iConfigure must be used before any other print function. Otherwise, all the operations previously performed by the print functions will be ignored (the settings performed by iParameter for example).
If a print is in progress, iConfigure cancels this print. Therefore, iConfigure must be called before the start of print.
WEBDEV - Server code To directly print on a printer connected to the server, a specific configuration is required. For more details, see Configuring the server to perform a print job.
Component: wd290prn.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
 // GET AND SET THE PRINTER STANDARD WINDOWS
sCurrentPrinter is string = iInfoPrinter() //Impressora Atual

sDefaultPrinter is string = iInfoPrinter(False) // Impressora Padrao do Painel de Controle

sDriverUsadoImpressoraPadrao is string = iInfoPrinter(False,iDriverName) //"winspool"

sNomeImpressoraPadrao is string = iInfoPrinter(False,iPrinterName) //"LX300"

sPortaImpressoraPadrao is string = iInfoPrinter(False,iDeviceName) //"LPT1:"

sListaTodasImpressorasInstaladas is string = iListPrinter() //LX300 CR HP1200 CR FAX CR CutePDF

//IMPORTANTE:

ok_situacao_01 is boolean = iConfigure("HP1200", False) // Mudar para a HP1200

IF ok_situacao_01 = True

Info("Impressora foi alterada com sucesso no painel de controle")

Info("
Printer has been successfully changed on the control panel")

ELSE
Info(ErrorInfo())
END

// OU

ok_situacao_02 is boolean = iConfigure("HP1200", True) // Mudar para a HP1200

IF ok_situacao_02 = True

Info("Impressora foi alterada com sucesso somente enquanto tiver usando o aplicativo windev")

Info("
Printer has been successfully changed only while you are using the WINDEV application")

ELSE
Info(ErrorInfo())
END

//Meu muito obrigado pela ajuda José Jorge Matos (Portugal).
adrianoboller
30 Apr. 2016

Last update: 06/21/2023

Send a report | Local help