Properties for Customizing Rotator Control in C#.NET
KetticRotator .NET component provides a variety of properties for the users to customize this control in their C# Windows applications. By using these properties included in the C# APIs of KetticRotator control, the developers can create rich functionalities for rotations, like customizing the scrolling or slideshows and setting the functions of Start, Stop, GoTo frame, Previous and Next. The C# APIs of Rotator component will allow the users easily to add the rotation features to all elements like, text box, buttons, and combobox and customize the animation between frames to opaque or transparent.
Properties of KetticRotator Control for Windows Forms
The following list demonstrates the key properties that are unique to the KetticRotator WinForms control.
- Items Collection, KetticRotator provides an Items collection to hold a variety of KetticElements, by which the users can add any elements to the rotator control in their C# Windows application. The KetticItemsCollectionEditor can be open through the Items property and an item type can be added via the Add split button. For example, we can add an image through the KetticImageItem and display a web page by using the KetticWebBrowserItem, etc.
- AnimationFrames, The AnimationFrames is the property that determines the number of the frames, which are able to show the transition between items. When we increase the numbers of the frames for the animation, the transition will get smoother and slower.
- LocationAnimation, The LocationAnimation property determines the moving direction of an animated item. This is achieved by setting the value of the Width and Height to this property. When the value of the Width or Height is greater than 0, the items will move to left or up respectively, whereas they will move to right or down respectively.
- CurrentIndex, This property is able to index the rotator items shown currently.
- Running Property, When the developers need to run the project to start the animation, the can enable this Running property.
- Interval, This property determines the interval time of the transition between two items in milliseconds.
- OpacityAnimation, This property is used to customize the transparent of items moving off the screen. When enabling this property, the transparent will increase and the new added item will get opaque. The animation will smoothly blend from one item to the other. When disabling the property, no fading effect will appear when the new added item replaces the old one.
- Start(), This is a method that can immediately run the animation. We are able to call the Start() method without parameters or the overload, in which the parameter takes a Boolean to run the animation.
- Stop(), This method is used to freeze the animation on the current item shown.
- BeginRotate and EndRotate, The BeginRotate and EndRotate events fire before and after a transition between the items of the rotation. The BeginRotate is able to pass a BeginRotateEventArgs with one of the From, To, and Cancel properties. The From property contains the index of the previous rotated item, the To property contains the index of rotating item that will be shown, and the Cancel property will undo the rotating item that will be shown.
- StartRotation and StopRotation, The StartRotation event is able to pass a CancelEventArgs to stop the rotation and it fires when enabling the Running property or calling the Start() method. The StopRotation() event fires when disabling the Running property or calling the Stop().