PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview
  • Control in a window or in a page
  • Creating a Rating control
  • Characteristics of Rating control
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

Control in a window or in a page

The Rating control allows the user to:
  • indicate the popularity level of an element via repeated pictograms.
  • find out the popularity level of an element via repeated pictograms.
In most cases, this type of control presents the popularity level as a rating from 1 to 5 stars:
It can also be used to indicate a user choice:
WINDEV and WEBDEV give you the ability to:
  • use any number of pictograms.
  • use any shape of pictogram. For example, you have the ability to use images from the image catalog.
Versions 19 and later
Android This type of control is now available for Android applications.
iPhone/iPad This type of control is now available for iPhone/iPad applications.
New in version 19
Android This type of control is now available for Android applications.
iPhone/iPad This type of control is now available for iPhone/iPad applications.
Android This type of control is now available for Android applications.
iPhone/iPad This type of control is now available for iPhone/iPad applications.
Versions 23 and later
Universal Windows 10 App This type of control is now available in Universal Windows 10 App mode.
New in version 23
Universal Windows 10 App This type of control is now available in Universal Windows 10 App mode.
Universal Windows 10 App This type of control is now available in Universal Windows 10 App mode.
Creating a Rating control
To create a Rating control:
  1. On the "Creation" pane, in the "Graphic controls" group, click "Rating".
  2. Click where the control will be created in the window or page. The control appears in the editor.
Tip: You can also create a "preset" Rating control by clicking the arrow found on the right of "Rating" option. The list of available controls is displayed with the project skin template. Simply click the control you want to create in the editor.
To view the control characteristics, select "Description" in the popup menu of the control.
Characteristics of Rating control
The "General" tab in the Rating control description window allows defining the characteristics of the control:
  • The maximum possible mark: is used to define the number of pictogram repetitions in the Rating control. This option is available in "Same image for each mark" mode only.
  • The number of marks in the image: indicates the number of pictograms found in the image. This option is available only if the layout of the image set uses the "Different image for each mark" mode.
  • The initial mark, which means the mark used when the control is displayed.
  • The granularity of marks. This option corresponds to the mode for selecting the marks. The rating can evolve:
    • by integer value: the mark will evolve by 1 at a time
    • by half-value: the mark will evolve by 0,5 at a time.
    • by real value: the mark will evolve according to the value typed by the user.
  • The image of marks: Image used to view the marks. If this parameter is not specified, the image of a star is used by default. The Drop-down button button is used to select:
  • an image accessible from your computer ("Browse" option).
  • an image in the image catalog ("Catalog" option). In this case, the selected image is automatically adapted to the specified options.
  • Dividing the image set: used to define the mode for dividing the control image set:
    • Same image for each mark: The image must contain a single pictogram (represented by several states). The repetition of the pictogram will be used to represent the different possible values in the control.
    • Different image for each mark: The image must contain several pictograms (each one being represented by several states). Each pictogram will be used to represent the different possible values in the control. In this mode, the maximum mark corresponds to the number of pictograms contained in the image.
  • Graphically differentiate marks below the current mark:
    • When this mode is disabled, the marks below the current mark are displayed like the current mark.
    • When this mode is enabled, the marks below the current mark are drawn by using the state 0 of the image set (the marks below the current mark will be invisible if the image contains a single state).
Related Examples:
The Rating control Unit examples (WINDEV): The Rating control
[ + ] Using a Rating control
Minimum version required
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment