ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Modifying the displayed page
  • Case of PDF and DOCX files with a large number of pages
  • Limit
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
The NumberPage property is used to get:
  • WINDEV the number of pages found in a "multi-page" image file. This image is displayed in an Image control or in the background of a Chart control.
  • WINDEVAndroidiPhone/iPad the number of pages found in a PDF file displayed in an Image control.
  • WINDEVAndroidiPhone/iPad the number of pages found in a PDF file displayed in a PDF Reader control.
  • WINDEV the number of pages found in a DOCX file displayed in a Word Processing control.
Reminder: Some image formats (TIFF for example) can contain several images in the same file. Each image corresponds to a file page. These formats are called "multi-page" formats.
Example
WINDEV
// Modify the image file associated with the "IMG_MyImage" control
IMG_MyImage.Image = "MultipageFile.TIF"
// Successively display the different pages found in the image file
FOR I = 1 TO IMG_MyImage.NumberPage
IMG_MyImage.PageNumber = I
// Timeout for loading images
Multitask(-100)
END
WINDEVAndroidiPhone/iPad
// Display page 23 in the PDF Reader control
IF PDF_MyPDFReader.NumberPage>23 THEN
PDF_MyPDFReader.NumberDisplayedPage = 23
END
Syntax
<Number of pages> = <Control used>.NumberPage
<Number of pages>: Integer
  • Number of pages found in the file associated with the specified control.
  • 1 if the format of image file is not "multi-page" or if the "multi-page" format contains a single page.
  • 0 if the specified control is not associated with an image format supported by WINDEV.
<Control used>: Control name
Name of the control to be used:
  • WINDEVAndroidiPhone/iPad Name of Image control,
  • WINDEV Name of Chart control,
  • WINDEVAndroidiPhone/iPad Name of the PDF Reader control.
  • WINDEV Name of the Word Processing control.
Remarks

Modifying the displayed page

To modify the displayed page:
  • For the Image controls and the Chart controls, use PageNumber.
  • For the PDF Reader controls and the Word Processing controls, use NumberDisplayedPage.
WINDEV

Case of PDF and DOCX files with a large number of pages

If the PDF or DOCX file opened in the control contains a large number of pages, the control loads each page successively: some pages are not immediately accessible.
In this case:
  • NumberPage is a blocking property: it waits for the file load operation to complete. The application is blocked.
  • The NumberAccessiblePages property returns the number of pages currently loaded in the PDF file without waiting for the load process to complete.
  • The NumberDisplayedPage property returns the number of the page currently displayed in the control (at least 50% of the page).

Limit

The NumberPage property applies only to:
  • WINDEVAndroidiPhone/iPad Image controls in windows,
  • WINDEV Chart controls in windows,
  • WINDEVAndroidiPhone/iPad PDF Reader controls.
  • WINDEV Word Processing controls.
Related Examples:
The Image control (display a PDF or a TIFF) Unit examples (WINDEV): The Image control (display a PDF or a TIFF)
[ + ] Displaying a PDF or TIFF document in the Image control found in a window.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help