PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview
  • Principle
  • The principle for scrolling internal windows is straightforward
  • Implementation
  • Browsing internal windows: Programmed browse
  • Browsing internal windows: automatic browse on a data file or query
  • Advanced programming
  • WLanguage functions for handling the internal windows
  • Events run when scrolling the internal windows
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
In the Windows applications, all the operations are performed via the mouse or the keyboard. Touch screens also allows operations to be performed using your hands directly.
In the applications for mobile devices, several features are available via finger movements.
The internal windows propose a scroll by swipe:
  • AndroidiPhone/iPad In the Android and iPhone/iPad applications: the scroll of windows is performed via a simple swipe.
  • Versions 22 and later
    Universal Windows 10 App In the Universal Windows applications: the scroll of windows is performed via buttons (only the swipe by programming is available).
    New in version 22
    Universal Windows 10 App In the Universal Windows applications: the scroll of windows is performed via buttons (only the swipe by programming is available).
    Universal Windows 10 App In the Universal Windows applications: the scroll of windows is performed via buttons (only the swipe by programming is available).
Android Use conditions:
To scroll the internal windows in Android, the "Android Support Library V4" extension is required on the development computer, when generating the Android application. The procedure for installing this extension is available from:
http://developer.android.com/tools/extras/support-library.html#Downloading
Versions 22 and later
Universal Windows 10 App This feature is now available in Universal Windows 10 app mode.
New in version 22
Universal Windows 10 App This feature is now available in Universal Windows 10 app mode.
Universal Windows 10 App This feature is now available in Universal Windows 10 app mode.
Principle

The principle for scrolling internal windows is straightforward

  • An "Internal window" control is created in the editor. This "Internal window" control supports the swipe.
  • By programming, a list of internal windows is associated with the "Internal window" control.
  • At run time, the different internal windows of the list will be displayed when the user modifies the displayed element (via the fingers, the mouse or specific buttons).
You also have the ability to create a scroll of internal windows based on a data file or on a query. In this case, the principle is as follows:
  • An internal window is created. The controls of this window are associated with a data file or with a query.
  • An "Internal window" control is created in the editor. This "Internal window" control supports the swipe and it is associated with the data file or with the query of the internal window.
  • At run time, the data file (or the query) will be browsed and displayed in the internal window when the user modifies the displayed element (via the fingers, the mouse or specific buttons).
Implementation

Browsing internal windows: Programmed browse

To implement a browse of internal windows:
  1. Create the internal windows that will be displayed during the browse. These internal windows can accept parameters during their opening if necessary.
  2. Create an "Internal window" control in your window: on the "Creation" pane, in the "Containers" group, click "Internal window".
  3. Display the description window of "Internal window" control. In the "GUI" tab:
    • Check "Allow the change of content by swipe".
    • Specify:
      • the size of the cache. The size of the cache corresponds to the number of internal windows that will be stored in memory (3 by default). The smaller this number is, the smaller the memory consumption will be. On the contrary, the windows will be loaded more frequently.
      • Versions 22 and later
        the orientation of the swipe: vertical or horizontal.
        New in version 22
        the orientation of the swipe: vertical or horizontal.
        the orientation of the swipe: vertical or horizontal.
      • Versions 22 and later
        the animation to perform during the swipe (if necessary). Click "Configure the animation".
        The "Style" tab of the control appears positioned on the "Control animation" element. You can select the requested animation and configure its parameters via the "Parameters" button.
        If the option "Defined by the project" is selected, the animation performed will be the one configured in the project options. See Animation of controls for more details.
        New in version 22
        the animation to perform during the swipe (if necessary). Click "Configure the animation".
        The "Style" tab of the control appears positioned on the "Control animation" element. You can select the requested animation and configure its parameters via the "Parameters" button.
        If the option "Defined by the project" is selected, the animation performed will be the one configured in the project options. See Animation of controls for more details.
        the animation to perform during the swipe (if necessary). Click "Configure the animation".
        The "Style" tab of the control appears positioned on the "Control animation" element. You can select the requested animation and configure its parameters via the "Parameters" button.
        If the option "Defined by the project" is selected, the animation performed will be the one configured in the project options. See Animation of controls for more details.
  4. By programming, build the list of internal windows that will be displayed in the "Internal window" control. To do so, use IWListAdd as many times as necessary.
Remarks:
  • The windows must be added in the requested browse order.
  • The parameters that must be passed to the added internal windows can be specified in IWListAdd.
  • The same internal window can be added several times with different parameters.
  • Versions 22 and later
    Universal Windows 10 App In your Universal Windows 10 App applications, in order for the user to scroll the internal windows, create the necessary button and call IWListPrevious and IWListNext.
    New in version 22
    Universal Windows 10 App In your Universal Windows 10 App applications, in order for the user to scroll the internal windows, create the necessary button and call IWListPrevious and IWListNext.
    Universal Windows 10 App In your Universal Windows 10 App applications, in order for the user to scroll the internal windows, create the necessary button and call IWListPrevious and IWListNext.

Browsing internal windows: automatic browse on a data file or query

To implement a browse of internal windows based on a data file or on a query:
  1. Create the internal window that must display the different records. The controls of this internal window must be linked to the items of the file or query being read.
  2. Create an "Internal window" control in your window: on the "Creation" pane, in the "Containers" group, click "Internal window".
  3. Display the description window of "Internal window" control.
    • In the "General" tab, associate the internal window that was just created with the "Internal window" control.
    • In the "GUI" tab:
      • Check "Allow the change of content by swipe".
    • Specify:
      • the size of the cache. The size of the cache corresponds to the number of internal windows that will be stored in memory (3 by default). The smaller this number is, the smaller the memory consumption will be. On the contrary, the windows will be loaded more frequently.
      • Versions 22 and later
        the orientation of the swipe: vertical or horizontal.
        New in version 22
        the orientation of the swipe: vertical or horizontal.
        the orientation of the swipe: vertical or horizontal.
      • Versions 22 and later
        the animation to perform during the swipe (if necessary). Click "Configure the animation".
        The "Style" tab of the control appears positioned on the "Control animation" element. You can select the requested animation and configure its parameters via the "Parameters" button.
        If the option "Defined by the project" is selected, the animation performed will be the one configured in the project options. See Animation of controls for more details.
        New in version 22
        the animation to perform during the swipe (if necessary). Click "Configure the animation".
        The "Style" tab of the control appears positioned on the "Control animation" element. You can select the requested animation and configure its parameters via the "Parameters" button.
        If the option "Defined by the project" is selected, the animation performed will be the one configured in the project options. See Animation of controls for more details.
        the animation to perform during the swipe (if necessary). Click "Configure the animation".
        The "Style" tab of the control appears positioned on the "Control animation" element. You can select the requested animation and configure its parameters via the "Parameters" button.
        If the option "Defined by the project" is selected, the animation performed will be the one configured in the project options. See Animation of controls for more details.
      • Check (if necessary) "Position on the current record when opening the internal window". This option is used to automatically position the data of the internal window on the current record. This option is taken into account only if the change of content is performed by swipe and if the content corresponds to a data source (file, query, etc.).
    • In the "Content" tab:
      • Select the mode for filling the internal window: "File/Query".
      • Select the source used: file, query or embedded query.
      • Select the search item.
Versions 22 and later
Universal Windows 10 App Remark: In your Universal Windows 10 App applications, in order for the user to scroll the internal windows, create the necessary button and call IWListPrevious and IWListNext.
New in version 22
Universal Windows 10 App Remark: In your Universal Windows 10 App applications, in order for the user to scroll the internal windows, create the necessary button and call IWListPrevious and IWListNext.
Universal Windows 10 App Remark: In your Universal Windows 10 App applications, in order for the user to scroll the internal windows, create the necessary button and call IWListPrevious and IWListNext.
Advanced programming

WLanguage functions for handling the internal windows

Several WLanguage functions can be used to manage the browses of internal windows:
Versions 10 and later
ChangeSourceWindow
New in version 10
ChangeSourceWindow
ChangeSourceWindow
Dynamically changes the window displayed in an Internal Window control.
Case of scrolling internal windows: Modifies the window currently displayed. This modification is saved in the list of internal windows to scroll.
Versions 18 and later
IWListAdd
New in version 18
IWListAdd
IWListAdd
Adds a new internal window to the list of internal windows browsed by an Internal Window control.
Versions 18 and later
IWListCount
New in version 18
IWListCount
IWListCount
Returns the number of internal windows currently found in the list of internal windows browsed by an Internal Window control.
Versions 18 and later
IWListDelete
New in version 18
IWListDelete
IWListDelete
Deletes an internal window found in the list of internal windows browsed by an Internal Window control.
Versions 18 and later
IWListDeleteAll
New in version 18
IWListDeleteAll
IWListDeleteAll
Deletes all the internal windows from the list of internal windows browsed by an Internal Window control.
Versions 18 and later
IWListDisplay
New in version 18
IWListDisplay
IWListDisplay
Refreshes the display of an "Internal window" control with automatic browse on a data file or query.
Versions 19 and later
IWListInsert
New in version 19
IWListInsert
IWListInsert
Inserts a new internal window in the list of internal windows used by an Internal Window control.
Versions 18 and later
IWListNext
New in version 18
IWListNext
IWListNext
Displays the next internal window in the list of internal windows browsed by an Internal Window control.
Versions 18 and later
IWListPosition
New in version 18
IWListPosition
IWListPosition
Displays the internal window corresponding to the specified position (in the list of internal windows browsed by an Internal Window control) or returns the position of the internal window currently displayed (in the list of internal windows browsed by an Internal Window control).
Versions 18 and later
IWListPrevious
New in version 18
IWListPrevious
IWListPrevious
Displays the previous internal window in the list of internal windows browsed by an Internal Window control.
Remarks:
  • During an automatic browse performed on a data file or on a query, ChangeSourceWindow, IWListAdd, IWListInsert, IWListDelete, IWListDeleteAll cannot be used.
  • ChangeSourceWindow is used to modify the window currently displayed. This modification is saved in the list of internal windows to scroll.
  • Only the controls found in the internal window currently displayed can be accessed by programming. For example, the following code is used to change the caption of the button found in the internal window currently displayed:
    MyInternalWindowControl.BTN_Button = "New caption"
  • Versions 21 and later
    ..SwipeEnabled is used to enable or disable the browse of internal windows with the finger. This allows you to temporarily disable the swipe in order to perform a specific operation.
    Universal Windows 10 App This property is not available.
    New in version 21
    ..SwipeEnabled is used to enable or disable the browse of internal windows with the finger. This allows you to temporarily disable the swipe in order to perform a specific operation.
    Universal Windows 10 App This property is not available.
    ..SwipeEnabled is used to enable or disable the browse of internal windows with the finger. This allows you to temporarily disable the swipe in order to perform a specific operation.
    Universal Windows 10 App This property is not available.
  • Versions 22 and later
    ..VerticalSwipe is used to find out and modify the orientation of the swipe.
    Universal Windows 10 App This property is not available.
    New in version 22
    ..VerticalSwipe is used to find out and modify the orientation of the swipe.
    Universal Windows 10 App This property is not available.
    ..VerticalSwipe is used to find out and modify the orientation of the swipe.
    Universal Windows 10 App This property is not available.

Events run when scrolling the internal windows

When implementing the scroll of internal windows, you have the ability to configure the size of the cache, which means the number of internal windows loaded in memory.
When running a window used to scroll a list of internal windows:
  • The internal windows found in the list and corresponding to the number specified in the cache size are loaded. The following events are run for each one:
    • Global declarations of the internal window
    • Initializing the controls found in the internal window
    • Initializing the internal window
    • After loading the internal window.
  • The following events are run when the user swipes to change the content of the internal window:
    • Selection by swipe.
    • Loading the next internal window (the events run are those of the above paragraph).
    • Unloading one of the internal windows (according to the size of the cache). In this case, the events "Before unloading the internal window" and "Closing" are run.
Remarks:
Related Examples:
WM CRM Cross-platform examples (WINDEV Mobile): WM CRM
[ + ] WM CRM is a multi-platform project for Android and iOS.
It explains how to develop a CRM application intended to the Android and iPad tablets.
Minimum version required
  • Version 18
This page is also available for…
Comments
Click [Add] to post a comment