PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • 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.
Note: To use the Rating control in Windows 2000, the GDI+ framework must be installed on the user computers.
Versions 19 and later
Android This type of control is now available for the Android applications.
iPhone/iPad This type of control is now available for the iPhone/iPad applications.
New in version 19
Android This type of control is now available for the Android applications.
iPhone/iPad This type of control is now available for the iPhone/iPad applications.
Android This type of control is now available for the Android applications.
iPhone/iPad This type of control is now available for the 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. In the window or page editor, click (or select "Insert .. Control .. Rating control").On the "Creation" pane, in the "Graphic controls" group, click "Rating".
  2. Click the position where the control will be created in the window or page. The control appears in creation mode.
Tip: You also have the ability to create a "preset" Rating control by clicking the arrow found on the right of icon. The list of available controls (with their preview in the skin template of project) is displayed. All you have to do is click the requested control to create it 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 (with their preview in the skin template of project) is displayed. All you have to do is click the requested control to create it in the editor.
To display the control characteristics, select "Description" from the popup menu of control.
Characteristics of Rating control
The "General" tab in the description window of Rating control is used to define the control characteristics:
  • 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 image sheet is using 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.
  • Versions 21 and later
    WINDEV The value of a 'star' : value associated with a star (or any other symbol). The value of the Rating control will correspond to the value of a star multiplied by the number of stars displayed.
    New in version 21
    WINDEV The value of a 'star' : value associated with a star (or any other symbol). The value of the Rating control will correspond to the value of a star multiplied by the number of stars displayed.
    WINDEV The value of a 'star' : value associated with a star (or any other symbol). The value of the Rating control will correspond to the value of a star multiplied by the number of stars displayed.
  • 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. This image can be found in the image catalog. In this case, the selected image is automatically adapted to the specified options. 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 sheet: used to define the mode for dividing the image sheet of the control:
    • 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 the marks less than the current mark:
    • When this mode is disabled, the marks less than the current mark are displayed like the current mark.
    • When this mode is enabled, the marks less than the current mark are drawn by using the status 0 of the image sheet (the marks less than the current mark will be invisible if the image contains a single status).
Related Examples:
The Rating control Unit examples (WINDEV): The Rating control
[ + ] Using a Rating control
Minimum required version
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment