System.Rating

MSDN Home

MSDN
MSDN Library
Win32 and COM Development
User Interface
Windows Shell
Shell Reference
Shell Properties
System

System

System.AcquisitionID
System.ApplicationName
System.Author
System.Capacity
System.Category
System.Comment
System.Company
System.ComputerName
System.ContainedItems
System.ContentStatus
System.ContentType
System.Copyright
System.DateAccessed
System.DateAcquired
System.DateArchived
System.DateCompleted
System.DateCreated
System.DateImported
System.DateModified
System.DueDate
System.EndDate
System.FileAllocationSize
System.FileAttributes
System.FileCount
System.FileDescription
System.FileExtension
System.FileFRN
System.FileName
System.FileOwner
System.FileVersion
System.FindData
System.FlagColor
System.FlagColorText
System.FlagStatus
System.FlagStatusText
System.FreeSpace
System.FullText
System.Identity
System.Identity.Blob
System.Identity.DisplayName
System.Identity.IsMeIdentity
System.Identity.PrimaryEmailAd ...
System.Identity.ProviderID
System.Identity.UniqueID
System.Identity.UserName
System.IdentityProvider.Name
System.IdentityProvider.Pictur ...
System.ImageParsingName
System.Importance
System.ImportanceText
System.IsAttachment
System.IsDefaultNonOwnerSaveLo ...
System.IsDefaultSaveLocation
System.IsDeleted
System.IsEncrypted
System.IsFlagged
System.IsFlaggedComplete
System.IsIncomplete
System.IsLocationSupported
System.IsPinnedToNameSpaceTree
System.IsRead
System.IsSearchOnlyItem
System.IsSendToTarget
System.IsShared
System.ItemAuthors
System.ItemClassType
System.ItemDate
System.ItemFolderNameDisplay
System.ItemFolderPathDisplay
System.ItemFolderPathDisplayNa ...
System.ItemName
System.ItemNameDisplay
System.ItemNamePrefix
System.ItemParticipants
System.ItemPathDisplay
System.ItemPathDisplayNarrow
System.ItemType
System.ItemTypeText
System.ItemUrl
System.Keywords
System.Kind
System.KindText
System.Language
System.LayoutPattern.ContentVi ...
System.LayoutPattern.ContentVi ...
System.MileageInformation
System.MIMEType
System.Null
System.OfflineAvailability
System.OfflineStatus
System.OriginalFileName
System.OwnerSID
System.ParentalRating
System.ParentalRatingReason
System.ParentalRatingsOrganiza ...
System.ParsingBindContext
System.ParsingName
System.ParsingPath
System.PerceivedType
System.PercentFull
System.Priority
System.PriorityText
System.Project
System.ProviderItemID
System.Rating
System.RatingText
System.Sensitivity
System.SensitivityText
System.SFGAOFlags
System.SharedWith
System.ShareUserRating
System.SharingStatus
System.Shell.OmitFromView
System.SimpleRating
System.Size
System.SoftwareUsed
System.SourceItem
System.StartDate
System.Status
System.Subject
System.Thumbnail
System.ThumbnailCacheId
System.ThumbnailStream
System.Title
System.TotalFileSize
System.Trademarks

Switch View :

Classic

Lightweight Beta

ScriptFree

Feedback

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 user interface (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.

Remarks

Related Topics