A rating system that uses integer values between 0 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 = None
- 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- enumRange
minValue = 100
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 0 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 user interface (UI) means in terms of the System.Rating value.
| System.Rating | Star Rating |
|---|
| 0 | Unrated |
| 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 |
|---|
| Unrated | N/A |
| 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 |
|---|
| 0 | 0 |
| 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