Tile Object

Common API for all Tile Types

Main tile properties

Name	Type	Description
AutoPostBack	bool	Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the selection state or clicks on the tile. Defaults to false.
Badge	RadBaseTile.Badge	The Badge object that can be used to configure the tile's badge. More information on its properties and configuration is availabe below and in the Badge and Title elements help article.
DataItem	System.Data.DataRowView	The DataItem object related to each tile when in a databound RadTileList. There is data in it only in the OnTileDataBound event of the RadTileList.
EnableSelection	bool	Whether the tile can be selected. Will not be used in the context of a RadTileList, in this case the behavior of all tiles is controlled through the SelectionMode property of the RadTileList. Defaults to false.
Height	unit	The height of the tile. It is generally controlled by the Shape property and setting it here can break some of the appearance/functionality ofthe control. Inherited from WebControl.
Name	string	Gets or sets the Name proerty of a tile. Can be used to uniquely identify a tile in a RadTileList through the RadTileList's GetTileByName(string) method.
OnClientClicked	string	Gets or sets the name of the JavaScript function that will be called when the tile is clicked, after the OnClientClicking event. This event is not cancellable. See the OnClientClicked help article for more information.
OnClientClicking	string	Gets or sets the name of the JavaScript function that will be called when the tile is being clicked, before the OnClientClicked event. This event is cancellable. See the OnClientClicking help article for more information.
OnClientSelected	string	Gets or sets the name of the JavaScript function that will be called when the tile is selected, before the OnClientSelecting event. This event is not cancellable. See the OnClientSelected help article for more information.
OnClientSelecting	string	Gets or sets the name of the JavaScript function that will be called when the tile is being selected, before the OnClientSelected event. This event is cancellable. See the OnClientSelecting help article for more information.
NavigateUrl	string	Gets or sets the URL of the page to navigate to, without posting the page back to the server. If AutoPostBack for the RadTileList is true navigation will not occur.
PeekContentContainer	Telerik.Web.UI.SingleTemplateContainer	Gets the control, where the ContentTemplate for the PeekTemplate will be instantiated. You can add controls programmatically here.
PeekTemplate	ITemplate	Gets or sets the System.Web.UI.ITemplate that contains the controls which will be placed in the control content area for the PeekTemplate. You can use this to set the PeekTemplate in the markup.
PeekTemplateSettings	Telerik.Web.UI.TilePeekTemplateSettings	Defines the peek template configuration settings. See below for more information.
PostBackUrl	string	Gets or sets the URL of the page to post to from the current page when a tile from RadBaseTile is clicked.
Selected	bool	Gets or sets the selected state of the tile. Defaults to false.
Shape	Telerik.Web.UI.TileShape	Gets or sets the shape of the tile. Possible values: Square - 150x150px, Wide - 310x150px.
Target	string	The target for the navigation. Can be one of the standard targets for an anchor (_blank, _top, _parent, _self, _search) or the name of a frame on the page. Values must begin with a letter in the range of a through z (case-insensitive), except for the special values which begin with an underscore: _blank renders the content in a new window without frames. _parent renders the content in the immediate frameset parent. _search renders the content in the search pane. _self renders the content in the frame with focus. _top renders the content in the full window without frames. Note: check your browser documentation to determine if the _search value is supported. For example, Microsoft Internet Explorer 5.0 and later support the _search target value.The default value is an empty string ("").Navigation is done through JavaScript and browser restrictions may apply for opening new popups (due to popup blockers) and navigating frames in higher in the hierarchy (same-origin policy).
Title	RadBaseTile.Title	The Title object that can be used to configure the tile's title. More information on its properties and configuration is availabe below and in the Badge and Title elements help article.
Width	unit	The width of the tile. It is generally controlled by the Shape property and setting it here can break some of the appearance/functionality of the control. Inherited from WebControl.

Properties like BackColor, BorderColor, BorderWidth, Font-Size, Font-Bold , etc. are inherited from the WebControl class and can also be used in a RadTile.

PeekTemplateSettings properties

Name	Type	Description
Animation	Telerik.Web.UI.PeekTemplateAnimation	Get/Set the animation effect of the PeekTemplate conent element.
AnimationDuration	integer	Gets/Sets the duration of the animation in milliseconds.
CloseDelay	integer	Gets or sets when the interval (in milliseconds) after which the peek template will automatically be closed.
Easing	string	Gets or sets the name of a jQuery extension method, which will be applied as easing on the animation.
HidePeekTemplateOnMouseOut	bool	Gets a value indicating whether the peek template should be hidden on mouse out.
ShowInterval	integer	Gets or sets when the interval after which the peek template will automatically show (in milliseconds).
ShowPeekTemplateOnMouseOver	bool	Gets a value indicating whether the peek template should be shown on mouse in.

Read more on configuring the animations and PeekTemplates in the Peek Template help article and test them out in the Animations online demo.

Title properties

Name	Type	Description
ImageUrl	string	This property sets/gets the src of a title image, which will be displayed at the bottom left corner of the tile. Has higher priority than text. See the Badge and Title Elements help article for more information.
Text	string	This property sets/gets the title text, which will be displayed at the bottom left corner of the tile. Has lower priority than image title. See the Badge and Title Elements help article for more information.

Badge properties

Name	Type	Description
ImageUrl	string	This property sets/gets the src of a badge image, which will be displayed at the bottom right corner of the tile. Has the lowest priority of the three options. See the Badge and Title Elements help article for more information.
PredefinedType	Telerik.Web.UI.TileBadgeType	This property sets/gets the predefined image, which will be displayed at the bottom right corner of the tile. Available options: None, Activity, Alert, Attention, Available, Away, Busy, Error, NewMessage, Paused, Playing, Unavailable. See the Badge and Title Elements help article for more information.
Value	integer	Gets or sets the numerical value of the badge. It has highest priority of the three. See the Badge and Title Elements help article for more information.

RadContentTemplateTile Specific properties

Name	Type	Description
ContentTemplate	ITemplate	Gets or sets the System.Web.UI.ITemplate that contains the controls which will be placed in the control content area. You can add content in the markup in this tag and it will be the primary content for the given tile. See the ContentTemplate Tile help article for more information.
ContentContainer	Telerik.Web.UI.SingleTemplateContainer	Gets the control, where the ContentTemplate will be instantiated in. You can add controls programmatically here.

RadIconTile Specific Properties

Name	Type	Description
ImageHeight	Unit	Gets or sets the height of the image which will be rendered in the tile. By default, the image does not have dimensions set from the control and its own dimensions are applied. This property can be used to set a new size and/or aspect ratio.
ImageUrl	string	Gets or sets the url of the image which will be rendered in the tile. See the Icon Tile help article for more information.
ImageWidth	Unit	Gets or sets the width of the image which will be rendered in the tile. By default, the image does not have dimensions set from the control and its own dimensions are applied. This property can be used to set a new size and/or aspect ratio.

RadImageAndTextTile Specific Properties

Name	Type	Description
ImageHeight	Unit	Gets or sets the height of the image which will be rendered in the tile. By default, the image does not have dimensions set from the control and its own dimensions are applied. This property can be used to set a new size and/or aspect ratio.
ImageUrl	string	Gets or sets the url of the image which will be rendered in the tile. See the ImageAndText Tile help article for more information.
ImageWidth	Unit	Gets or sets the width of the image which will be rendered in the tile. By default, the image does not have dimensions set from the control and its own dimensions are applied. This property can be used to set a new size and/or aspect ratio.
Text	string	Gets or sets the text which will be rendered in the bottom of the tile.

See the ImageAndText Tile help article for more information.

RadImageTile Specific Properties

Name	Type	Description
ImageHeight	Unit	Gets or sets the height of the image which will be rendered in the tile. By default, the image does not have dimensions set from the control and its own dimensions are applied. This property can be used to set a new size and/or aspect ratio.
ImageUrl	string	Gets or sets the url of the image which will be rendered in the tile. See the Image Tile help article for more information.
ImageWidth	Unit	Gets or sets the width of the image which will be rendered in the tile. By default, the image does not have dimensions set from the control and its own dimensions are applied. This property can be used to set a new size and/or aspect ratio.

RadLiveTile Specific Properties

Attribute Properties of the Main RadLiveTile Tag

Name	Type	Description
ClientTemplate	string	Gets/sets the HTML template that will be instantiated in the tile after live data request. This property is also exposed in an inner tag so that the string can be written in a more comfortable manner, like any other HTML content in Visual Studio. There is no intellisense, however, because this is still just a string value for a control property. See Example 1.
DataModelID	string	Gets/sets the DataModelID of the OData service that is used for fetching data.
ODataDataSourceID	string	Gets/sets the ID of the RadODataDataSource control that is used to fetch OData for the tile.
OnClientDataLoaded	string	Gets/sets the name of the JavaScript function that handles the OnClientDataLoaded event.
OnClientDataLoading	string	Gets/sets the name of the JavaScript function that handles the OnClientDataLoading event.
OnClientDataLoadingError	string	Gets/sets the name of the JavaScript function that handles the OnClientDataLoadingError event.
OnClientTemplateDataBound	string	Gets/sets the name of the JavaScript function that handles the OnClientTemplateDataBound event.
UpdateInterval	int	Gets/sets the time (in milliseconds) that passes between the requests for data initiated by the LiveTile.
Value	string	Gets or sets a string value which can be send as an argument on data request.

Example 1: Defining a ClientTemplate as an inner tag.

ASP.NET

<telerik:RadLiveTile runat="server" ID="liveTile1">
	<ClientTemplate>
		This here is the template.
		<br />
		It will show the data from the <strong>sampleField</strong> field of the data
		#=dataItem.sampleField #
	</ClientTemplate>
</telerik:RadLiveTile>

Attribute Properties of the ClientTemplateAnimationSettings Inner Tag

Name	Type	Description
Animation	Telerik.Web.UI.ClientTemplateAnimation	Gets/sets the animation effect of the ClientTemplate content element.
AnimationDuration	int	Gets/sets the duration of the animation in milliseconds.
Easing	string	Gets/sets the easing that will be applied on the animation. The easing effect is described at the end of the Peek Template article.

Attribute Properties of the WebServiceSettings Inner Tag

Name	Type	Description
Method	string	Gets/sets the Web service method name to be called.
Path	string	Gets/sets the URL of the Web service that will be called.
UseHttpGet	bool	Gets/sets whether the GET HTTP verb will be used for the request. Defaults to false (i.e., POST will be used).

More information on populating a LiveTile with data is available in the Populating with data help article.

RadTextTile Specific Properties

Name	Type	Description
Text	string	Gets or sets the text which will be rendered in the tile. See the Text Tile help article for more information.

See Also

• Overview

• ContentTemplate Tile

• Icon Tile

• ImageAndText Tile

• Image Tile

• Text Tile

• Badge and Title Elements

• Peek Template

• TileList Object

• Populating a LiveTile with data