Adds a star rating button to the screen. The rating is specified as a string whose value is an integer 1-100 which indicates the number of stars (1 to 5) to be displayed. Think of this as a percentage value <20% = 1 star. This button is displayed in the menu area of the screen and appears in the order added. The userRating specifies the value the user rated the title, while the aggregate Rating represents the total for all users. The userRating takes precedence and determines the color of the buttons if set. The aggregateRating may display half-stars. The button returns the userRating in the event data field.
Event indicating a button on the screen was selected and the ID of the button that was selected.
Event Details: Type = 5, Msg = “”, Index = ID of button from AddButton(), Data = 0 –or- value of user selection if the button type is a rating button.