The Carousel control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Carousel control

The Carousel control

Overview of Carousel control

Two modes for using the Carousel control

Notes

Related examples

See also

The Carousel control

Overview of Carousel control

The Carousel control is used to display an animated menu made of images.

To create a Carousel control:

On the "Creation" pane, in the "Other controls" group, click "Carousel".
Click at the desired location to create the control.

To display the characteristics of the control, select "Description" from the popup menu of the control:

The "General" tab is used to define the orientation, the animation and the background image.
The "Details" tab is used to define the display mode of the carousel control.
The "Content" tab is used to define the images displayed in the carousel control as well as their caption.

Remark: WINDEV allows you to automatically create a Carousel control from several controls:

Select the controls to include in the Carousel control.
On the "Modification" pane, in the "Transformations" group, expand "Refactoring and swapping" and select "Create a carousel from the selection".

Only the Image controls and the Button controls are taken into account to create this carousel.

Two modes for using the Carousel control

Overview

To optimize the Carousel control, WINDEV proposes two operating modes:

Using the .NET 3.0 framework.
Using the WINDEV framework (GDI+).

.NET 3.0 framework

To base the Carousel control on the .Net 3.0 framework, simply check the option "The control is based on the .Net 3.0 framework (the Xaml functions will also be available for this control)" in the "Details" tab of the control description window.

In this case:

The functions from the Xaml family are available for this control.
You can propose to download the .Net 3.0 framework if this one is not installed on the end-user computer. This framework is included in Vista and it can be downloaded for Windows XP (from the Microsoft site).
The first use of a control that requires the.Net 3.0 framework (Carousel control, Cube control or Xaml control) loads this framework, which may cause delay (out of our control).
This control consumes a lot of resources: we recommend that you use it on high-performance computers only.

Depending on the configuration of the computer, the display of the Carousel control will be done as follows:


	"Download" option checked		"Download" option unchecked
	Computer with .NET 3.0 framework	Computer without .NET 3.0 framework	Computer without .NET 3.0 framework
Computer with the GDI+ framework	Using the .NET framework	Using the GDI+ framework	Using the GDI+ framework
Computer without GDI+ framework	x	Link for downloading the .NET framework Link for displaying a listview	Using a listview (crippled mode)

Limitations of the Carousel control in .Net 3.0 mode:

The .Net framework version 3.0 (or later) must be installed on the computer. This framework is included in Vista (and later) and it can be downloaded for Windows XP (from the Microsoft site).
The application cannot be started from the network.
The DDW (Dim Disabled Windows) feature is disabled for all the windows containing a Carousel control.
This control does not operate under TSE.
This control uses the wdxxxxaml.dll library. This library cannot be renamed when creating the executable.

WINDEV framework (GDI+)

To base the Carousel control on the WINDEV framework, simply check the option "The control is based on the WINDEV framework (GDI+)" in the "Details" tab of the control description window.

In this case, the functions from the Xaml family are not available for this control.

Depending on the configuration of the computer, the display of the Carousel control will be done as follows:


	Computer with .NET 3.0 framework	Computer without .NET 3.0 framework
Computer with the GDI+ framework	Using the GDI+ framework	Using the GDI+ framework
Computer without GDI+ framework	x	Using a listview (crippled mode)

See Installing the GDI+ Framework for more details

Crippled mode

The .Net framework version 3.0 (or later) or the WINDEV framework (GDI+) is required to use the Carousel control. However, WINDEV proposes a "crippled" mode for this control so that it can be used regardless of the configuration of the end-user computer. If the .Net 3.0 framework or the WINDEV framework (GDI+) is not installed on the end-user computer, the Carousel control will be automatically replaced by a listview in crippled mode.

To use this crippled mode in your applications:

Open the description of the Carousel control.
In the "Details" tab, you can configure the ListView control used via "Parameters of ListView control".
Validate the control description.

The ListView control will be used according to the display mode of the Carousel control and according to the configuration of the user computer (see the previous paragraphs).

Notes

Simulating the absence of .Net 3.0 framework

When developing an application containing a Carousel control, it may be wise to run the test the application on a computer where the .Net framework version 3.0 (or later) is not installed.

To simulate the absence of the framework on a computer:

use XamlDisable.
rename the following registry key: "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v3.0".

Remarks: A Carousel control that uses the .NET framework can be automatically replaced by a Carousel control that uses the WINDEV framework (GDI+).

Related Examples:

Unit examples (WINDEV): The Carousel control

[ + ] Using the Carousel control of WINDEV.
It can be handled like a ListView control.
Several properties are available, including the ability to modify the orientation of the carousel.