Client-side Programming Overview

RadRotator for ASP.NET AJAX offers a rich Client-Side API that allows you to control the look and the behavior of the control on the client with JavaScript.

Method	Description
add_buttonClick	Sets a name of a JavaScript function to be called when rotator's button is clicked
add_buttonOut	Sets a name of a JavaScript function to be called when mouse's cursor hovers out of rotator's button
add_buttonOver	Sets a name of a JavaScript function to be called when mouse's cursor is over rotator's button
add_itemClicked(function_name)	Sets a name of a JavaScript function to be called after a item is clicked
add_itemClicking(function_name)	Sets a name of a JavaScript function to be called when an item is clicked
add_itemShowing(function_name)	Sets a reference to the JavaScript function to be called when an item is about to be shown.
add_itemShown(function_name)	Sets a reference to the JavaScript function to be called after an item has been shown.
add_load	Sets a name of a JavaScript function to be called when the rotator is loaded.
add_mouseOut(function_name)	Sets a reference to the JavaScript function to be called after the mouse leaves a item.
add_mouseOver(function_name)	Sets a reference to the JavaScript function to be called when the mouse hovers a item.
addRotatorItem	Creates and adds a new item to the RadRotator's client-side item collection. The item will not exist in the rotator's items collection on the serverThis method accepts two parameters: radRotatorItemData - an object that has a property named Html . The HTML markup of the new item should be specified in this property. If this parameter is not set, an empty item will be added in the RadRotator.; index - the position, in which the item will be added. If this parameter is not specified, the new item will be added at the last position.
clearItems	Clears all items in the RadRotator's client-side items collection. The items will not be removed in the rotator's items collection on the server
dataBind	Binds the data of the RadRotator
get_appendClientDataBoundItems	Gets whether data bound items will be appended to the Rotator
get_clientDataSource	Gets the RadClientDataSource that is associated with the Rotator
get_clientDataSourceID	Gets the ID of the RadClientDataSource that is associated with the Rotator
get_clientTemplate	Gets the client template of the Rotator
get_currentItem	Gets the current item.
get_currentItemIndex	Gets the index of the currently shown item.
get_dataSource	Gets the data source of the Rotator
get_defaultAnimationDirection	Returns the default animation direction.
get_frameDuration	Gets the time in milliseconds each frame will display in automatic scrolling scenarios.
get_height	Gets rotator's height
get_initialItemIndex	Gets rotator's initial item's index
get_items	Returns rotator's item collection.
get_rotatorType	Gets rotator's type
get_scrollDuration	Gets the speed in milliseconds for scrolling rotator items.
get_width	Gets rotator's width
get_wrapFrames	Returns true if RadRotator is set to start scrolling the rotator frames from the beginning, once the rotator shows the last frame.
isAutomaticAdvance	Returns a Boolean that indicates if the rotator is set in AutomaticAdvance mode.
isScrollingForward	Returns a Boolean that indicates if the rotator is scrolling forwards.
isScrollingLeft	Returns a Boolean that indicates if the rotator is scrolling to the left.
isScrollingUp	Returns a Boolean that indicates if the rotator is scrolling upward.
isSlideShow	Returns a Boolean that indicates if the rotator is set in SlideShow mode
isVertical	Returns a Boolean that indicates if the rotator is verticalr
isViewportScrollMode	Returns a Boolean that indicates if the rotator is scrolling item by item or it is scrolling the whole viewport
isVisible	Returns a Boolean that indicates if the rotator is visible.
loadItemsFromWebService	Manually requests new data for a RadRotator that uses load-on-demand.
pause	Pauses the animation
remove_buttonClick	Removes the reference
remove_buttonOut	Removes the reference
remove_buttonOver	Removes the reference
remove_itemClicked(function_name)	Removes the Javascript function identified by function_reference.
remove_itemClicking(function_name)	Removes the Javascript function identified by function_reference.
remove_itemShowing(function_name)	Removes the Javascript function identified by function_reference.
remove_itemShown(function_name)	Removes the Javascript function identified by function_reference.
remove_load	Removes the reference.
remove_mouseOut(function_name)	Removes the Javascript function identified by function_reference.
remove_mouseOver(function_name)	Removes the Javascript function identified by function_reference.
removeRotatorItem	Removes an item from the RadRotator's client-side items collection. The removed item will exist in the rotator's items collection on the serverThis method accepts one parameter: index - the position of the item that will be removed. If this parameter is not specified, the last item from the collection will be removed.
repaint	Redraw the rotator
resume	Resumes the paused animation
set_appendClientDataBoundItems(value)	Sets whether data bound items will be appended to the Rotator
set_clientDataSourceID(id)	Sets the ID of the RadClientDataSource that is associated with the Rotator
set_clientTemplate(value)	Sets the client template of the Rotator
set_currentItemIndex	Sets currently shown item by its index
set_dataSource(data)	Sets a custom data source for the RadRotator
set_frameDuration	Sets the time in milliseconds each frame will display in automatic scrolling scenarios.
set_height	Sets the RadRotator height in pixels.
set_rotatorType	Sets rotator's type
set_scrollDuration	Sets the speed in milliseconds for scrolling rotator items.
set_width	Sets the RadRotator width in pixels.
set_wrapFrames	Accepts true or false as an argument. When set to true, RadRotator will start scrolling the rotator frames from the beginning, once the last frame is shown.
showNext	scrolls the rotator in the specified direction and shows the next frame. The direction parameter must be of type Telerik.Web.UI.RotatorScrollDirection , e.g. rotator1.showNext(Telerik.Web.UI.RotatorScrollDirection.Right);
start	Starts the animation
stop	Stops the animation
stopViewportAnimation	If an item is partially shown and the rotator is paused, calling this function will force the rotator to fully display the item.

RadTicker for ASP.NET AJAX methods:

Method	Description
get_autoAdvance	Gets whether RadTicker will begin ticking the next tickerline (if any) after it has finished ticking the current one. Returns true or false.
get_lineDuration	Gets time in milliseconds the of pause RadTicker makes before starting to tick the next line (if AutoAdvance=True ).
get_loop	Gets whether RadTicker will repeat the first tickerline after displaying the last one. Returns true or false.
get_tickSpeed	Gets the duration in milliseconds between ticking each character of a tickerline.
set_autoAdvance	Sets whether RadTicker will begin ticking the next tickerline (if any) after it has finished ticking the current one. Accepts true or false.
set_lineDuration	Sets time in milliseconds the of pause RadTicker makes before starting to tick the next line (if AutoAdvance=True ).
set_loop	Sets whether RadTicker will repeat the first tickerline after displaying the last one. Accepts true or false.
set_tickSpeed	Sets the duration in milliseconds between ticking each character of a tickerline.
startTicker	Starts the ticker
stopTicker	Stops the ticker
tickNextLine	forces the ticker to tick to the next line

The main idea of the methods pause , resume , start , stop is to be used in combination. Their functionality can be compared to that of a player - when stopped, the animation will be reset on a new start and when paused, the animation will continue from the same moment if rotation is resumed. These methods are designed to be used with a RadRotator control that includes automatic advance. This means the following modes: AutomaticAdvance , Carousel , CoverFlow , SlideShow .