Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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.RatingStar Rating
1-121 Star
13-372 Stars
38-623 Stars
63-874 Stars
88-995 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 RatingValue Assigned Through UI
1 Star1
2 Stars25
3 Stars50
4 Stars75
5 Stars99

 

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.SimpleRatingSystem.Rating
11
225
350
475
599

 

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

 

 

Community Additions

Show:
© 2014 Microsoft