System.Rating
A rating system that uses integer values between 1 and 99. This is the rating system used by the Windows Vista Shell.
propertyDescription name = System.Rating shellPKey = PKEY_Rating formatID = 64440492-4C8B-11D1-8B70-080036B11A03 propID = 9 searchInfo inInvertedIndex = false isColumn = true isColumnSparse = true columnIndexType = OnDisk maxSize = 128 labelInfo label = Rating sortDescription = LowestHighest invitationText hideLabel = false typeInfo type = UInt32 groupingRange = Discrete isInnate = false canBePurged multipleValues = false isGroup = false aggregationType = Average isTreeProperty = false isViewable = true isQueryable = true includeInFullTextQuery = false conditionType = String defaultOperation = Equal aliasInfo sortByAlias = None additionalSortByAliases = prop:System.ItemNameDisplay displayInfo defaultColumnWidth = 12 displayType = Enumerated alignment = Left relativeDescriptionType = General defaultSortDirection = Ascending stringFormat formatAs = General booleanFormat formatAs = YesNo numberFormat formatAs = General formatDurationAs = hh:mm:ss dateTimeFormat formatAs = General formatTimeAs = ShortTime formatDateAs = ShortDate enumeratedList defaultText = Unrated useValueForDefault = False enum value text RATING_ONE_STAR minValue = 1 setValue = 1 text = 1 Star RATING_TWO_STARS minValue = 13 setValue = 25 text = 2 Stars RATING_THREE_STARS minValue = 38 setValue = 50 text = 3 Stars RATING_FOUR_STARS minValue = 63 setValue = 75 text = 4 Stars RATING_FIVE_STARS minValue = 88 setValue = 99 text = 5 Stars drawControl control = Rating editControl control = Rating filterControl control = Default queryControl control = Rating
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
- propertyDescription
- searchInfo
- labelInfo
- typeInfo
- displayInfo
- stringFormat
- booleanFormat
- numberFormat
- dateTimeFormat
- enumeratedList
- drawControl
- editControl
- filterControl
- queryControl
Send comments about this topic to Microsoft
Build date: 2/3/2012
