https://github.com/unbreakable-syntax/starratingcontrol

A Star Rating Control made for C# WinForms.
https://github.com/unbreakable-syntax/starratingcontrol

csharp winforms winforms-controls

Last synced: 28 days ago
JSON representation

A Star Rating Control made for C# WinForms.

• Host: GitHub
• URL: https://github.com/unbreakable-syntax/starratingcontrol
• Owner: Unbreakable-Syntax
• Created: 2024-11-28T08:54:47.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2024-12-06T05:07:12.000Z (28 days ago)
• Last Synced: 2024-12-06T06:18:52.233Z (28 days ago)
• Topics: csharp, winforms, winforms-controls
• Language: C#
• Homepage:
• Size: 74.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Description

This is a Star Rating Control implementation for C# WinForms that has been derived from [here](https://www.codeproject.com/articles/9117/csharp-star-rating-control), the original article has a broken link for the source code of the custom control, this repository is a rebuild of the linked custom control, with some other extra changes.

# Extra changes

As per the author stated, this custom control can be optimized by caching some values to optimize performance. This reimplementation applies that idea by caching data points inside a secondary array. The render data for the stars will only be redrawn when any of the fields that are part of the rendering process (such as the margin, and star count) has been changed. Otherwise, calling Invalidate() will simply recolor the stars, making the OnMouseMove() and other methods to be at least somewhat faster.

As per the author, the custom control could also benefit from extra exposed brush style properties, which this reimplementation also does. The new properties are FillBrushStyle, StarColor, and GradientDirection. The FillBrushStyle can either be Solid or Gradient. The GradientDirection determines the gradient color direction application (if I described it correctly, which indicates on what direction should the first color fade to the second color), and the StarColor determines the color of the stars themselves, which is used on GradientDirection to apply the gradient color.

This reimplementation also provides an OnMouseDown() event to allow clicking of the stars, as well as the SelectedStar property, which is used to retrieve the value of the current selected star.

Some other changes here includes using SmoothingMode.AntiAlias to reduce jagged lines, and allowing for a proper distinction between selected and unselected stars during mouse hover, by coloring unselected stars with the HoverStarColor, and selected stars with SelectedStarColor