iPrintWord (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Print functions

Print characteristics

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iPrintWord (Function)

In french: iImprimeMot

Sends the character string passed as parameter to the print buffer. The print cursor is positioned at the end of the character string. The print job is not started (only iEndPrinting can be used to start the print job).

Remark: unlike the iPrint function, no line feed is automatically inserted after the end of the string.. If a string is printed after iPrintWord, it will be printed on the same line.

Example

iPrintWord(iFont(1) + "Texte en police 1")
iPrintWord(iFont(2) + "Texte en police 2") 
iPrint()
iEndPrinting()

// Exemple d'impression d'un PDF sécurisé avec mot de passe
// Dans cet exemple, le mot de passe est "motdepasse"
iParameterPDF("ouverture", "motdepasse", iProtectionPrinting + iProtectionSelection)
// Création du PDF
iDestination(iPDF, "MonPDF.PDF")
// Code d'impression
iCreateFont(1, 16, iBold, iRoman)
iPrintWord("Première ligne de mon PDF" + CR + "Seconde ligne de mon PDF" + CR + ...
		"Dernière ligne de mon PDF")
// Fin de l'impression et fermeture du fichier PDF créé
iEndPrinting()
// Affichage du PDF
ShellExecute(iLastFile())

Syntax

<Result> = iPrintWord([<Font identifier>+] [ <Horizontal position>+] <Text> [, <Truncated string>])

<Result>: Boolean

True if printed successfully,
False if the print job was canceled.

<Font identifier>: Optional integer

Identifier of the font used to print the text. This identifier is returned by iFont.
If this parameter is not specified, the last font used will be selected.

<Horizontal position>: Optional integer

X-coordinate of the point from which the print must be performed. This position is specified in number of columns from the top left border of the sheet (with iXPos).
If this parameter is not specified, the text is printed at the current position.

<Text>: Character string

Character string to print.

<String of next page>: Optional boolean

Specifies whether the text printed at the end of the page must be truncated or whether it must continue over the next page:
True (default): the string will be printed on the next page if it does not fit on a single page..
False: the character string is truncated: the rest of the string is not printed on the next page.

Remarks

Print characteristics

The origin (0,0) is located in the upper-left corner of the sheet. It takes the physical margins of the printer into account.
iPrintWord does not manage the vertical position.
A set of call to iPrintWord must always end with a call to iPrint that will transfer the strings into the print buffer.
The TAB character (Char(9)) is not interpreted. The line break character (Char(10)) is interpreted as a skip to the next line.

Component: wd300prn.dll