System.Rating
A rating system that uses integer values between 1 and 99. This is the rating system used by the Windows Vista Shell.
Windows 10, version 1703, Windows 10, version 1607, Windows 10, version 1511, Windows 10, version 1507, Windows 8.1, Windows 8, Windows 7
propertyDescription
name = System.Rating
shellPKey = PKEY_Rating
formatID = 64440492-4C8B-11D1-8B70-080036B11A03
propID = 9
SearchInfo
InInvertedIndex = false
IsColumn = true
typeInfo
type = UInt32
EnumeratedList
UseValueForDefault = True
enumRange
name = OneStar
minValue = 1
setValue = 1
defineMaxValue = 12
text = 1 Star
defineToken = RATING_ONE_STAR
enumRange
name = TwoStars
minValue = 13
setValue = 25
defineMaxValue = 37
text = 2 Stars
defineToken = RATING_TWO_STARS
enumRange
name = ThreeStars
minValue = 38
setValue = 50
defineMaxValue = 62
text = 3 Stars
defineToken = RATING_THREE_STARS
enumRange
name = FourStars
minValue = 63
setValue = 75
defineMaxValue = 87
text = 4 Stars
defineToken = RATING_FOUR_STARS
enumRange
name = FiveStars
minValue = 88
setValue = 99
defineMaxValue = 99
text = 5 Stars
defineToken = RATING_FIVE_STARS
enumRange
name
minValue = 100
Windows Vista
propertyDescription
name = System.Rating
shellPKey = PKEY_Rating
formatID = 64440492-4C8B-11D1-8B70-080036B11A03
propID = 9
SearchInfo
InInvertedIndex = false
IsColumn = true
typeInfo
type = UInt32
EnumeratedList
UseValueForDefault = True
enumRange
minValue = 0
defineMinName = RATING_UNRATED_MIN
setValue = 0
defineSetName = RATING_UNRATED_SET
defineMaxValue = 0
defineMaxName = RATING_UNRATED_MAX
text = Unrated
enumRange
minValue = 1
defineMinName = RATING_ONE_STAR_MIN
setValue = 1
defineSetName = RATING_ONE_STAR_SET
defineMaxValue = 12
defineMaxName = RATING_ONE_STAR_MAX
text = 1 Star
enumRange
minValue = 13
defineMinName = RATING_TWO_STARS_MIN
setValue = 25
defineSetName = RATING_TWO_STARS_SET
defineMaxValue = 37
defineMaxName = RATING_TWO_STARS_MAX
text = 2 Stars
enumRange
minValue = 38
defineMinName = RATING_THREE_STARS_MIN
setValue = 50
defineSetName = RATING_THREE_STARS_SET
defineMaxValue = 62
defineMaxName = RATING_THREE_STARS_MAX
text = 3 Stars
enumRange
minValue = 63
defineMinName = RATING_FOUR_STARS_MIN
setValue = 75
defineSetName = RATING_FOUR_STARS_SET
defineMaxValue = 87
defineMaxName = RATING_FOUR_STARS_MAX
text = 4 Stars
enumRange
minValue = 88
defineMinName = RATING_FIVE_STARS_MIN
setValue = 99
defineSetName = RATING_FIVE_STARS_SET
defineMaxValue = 99
defineMaxName = RATING_FIVE_STARS_MAX
text = 5 Stars
enumRange
minValue = 100
Remarks
PKEY values are defined in Propkey.h.
For compatibility with ratings systems that use values between 1 and 5, see the property System.SimpleRating. Note, however, that System.SimpleRating is not used in the Windows Vista Shell.
The following table describes what the star rating system used in the Shell UI means in terms of the System.Rating value.
| System.Rating | Star Rating |
|---|---|
| 1-12 | 1 Star |
| 13-37 | 2 Stars |
| 38-62 | 3 Stars |
| 63-87 | 4 Stars |
| 88-99 | 5 Stars |
When a user rates an item by choosing a star rating value in the UI, actual System.Rating values are assigned as shown in this table:
| Star Rating | Value Assigned Through UI |
|---|---|
| 1 Star | 1 |
| 2 Stars | 25 |
| 3 Stars | 50 |
| 4 Stars | 75 |
| 5 Stars | 99 |
If your file has a System.SimpleRating value rather than a System.Rating value, use the table below to convert and specify values for System.Rating.
| System.SimpleRating | System.Rating |
|---|---|
| 1 | 1 |
| 2 | 25 |
| 3 | 50 |
| 4 | 75 |
| 5 | 99 |
If your file has both System.Rating and System.SimpleRating persisted values, always use the System.Rating value when it is directly requested, without reference to System.SimpleRating.
Related topics