iPrintWord (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Characteristics of print

See also

InitRequest

InitRequestConnection

iChangeSubReportSource

iInitReportQueryConnection

iReportPrintingStatus

Characteristics of print

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iPrintWord (Function)

In french: iImprimeMot

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

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

Versions 18 and later

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available for iPhone/iPad applications.

Versions 19 and later

This function is now available in Android Widget mode.

This function is now available for Android applications.

New in version 19

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available in Android Widget mode.

This function is now available for Android applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

iPrintWord(iFont(1) + "Text using font 1")
iPrintWord(iFont(2) + "Text using font 2")
iPrint()
iEndPrinting()

// Example for printing a secure PDF with password
// In this example, the password is "password"
iParameterPDF("opening", "password", iProtectionPrinting + iProtectionSelection)
// Create the PDF file
iDestination(iPDF, "MyPDF.PDF")
// Print code
iCreateFont(1, 16, iBold, iRoman)
iPrintWord("First line of my PDF" + CR + "Second line of my PDF" + CR + ...
"Last line of my PDF")
// End of print and close the created PDF file
iEndPrinting()
// Display the PDF
ShellExecute(iLastFile())

Syntax

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

<Result>: Boolean

True if the print was performed,
False if the print 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 (with quotes)

Character string to print.

<String on 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 value): 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

Characteristics of print

The origin (0,0) is located in the top left corner of the sheet. It takes the physical margins of 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: wd260prn.dll