New to Telerik UI for ASP.NET AJAX? Download free 30-day trial


Telerik RadImageGallery supports complete customization of the item layout. Using the ImageGalleryTemplateItem, you can define your own configuration that can build up various layout structures.

The control provides the opportunity to display your data in any preferable way. You can include the template item in any desired position in the items collection, just as a regular ImageGalleryItem.

You can add a company logo, video, contact information or build your own advanced custom configuration to match your specific needs. Image Gallery Templates 1

Creating the Template Configuration

The first step is to create a new ImageGalleryTemplateItem in the Items collection of the RadImageGallery. You can create as many as you want and set their ThumbnailUrl property which determines the small image displayed in the thumbnail area to represent the original item. There are also Title and Description properties available, used to set a descriptive display message to the user.

Inside the ContentTemplate of the item you can build-up your custom configuration.

<telerik:RadImageGallery RenderMode="Lightweight" ID="RadImageGallery1" runat="server" Skin="Silk"
    Height="500px" Width="700px">
        <telerik:ImageGalleryTemplateItem Description="Welcome Back to Our Gallery!"
                <div style="width: 700px; height: 357px; padding: 30px 0 0 30px; background-image: url(Images/img7.jpg);">
                    <asp:Label ID="Label1" runat="server" ForeColor="White" Font-Size="Larger"
                        Text="Explore the Gallery<br/>or click the button below"></asp:Label>
                    <div style="padding: 30px 0 0 25px;">
                        <telerik:RadButton RenderMode="Lightweight" ID="RadButton1" runat="server" Text="Official Site"
                        <div style="padding-top: 50px; margin-left: -8px;">
                            <asp:Label ID="Label2" runat="server" ForeColor="White" Font-Size="Small"
                                Font-Names="Arial,​Helvetica,​sans-serif" Style="margin-left: 30px;"
                                Text="Rate us:"></asp:Label>
                            <telerik:RadRating RenderMode="Lightweight" ID="RadRating1" runat="server" Skin="Silk"></telerik:RadRating>
        <telerik:ImageGalleryItem ImageUrl="~/Images/img2.jpg"
            ThumbnailUrl="~/Images/thumbnail2.png" />
        <telerik:ImageGalleryItem ImageUrl="~/Images/img2.jpg"
            ThumbnailUrl="~/Images/thumbnail3.png" />
        <telerik:ImageGalleryItem ImageUrl="~/Images/img2.jpg"
            ThumbnailUrl="~/Images/thumbnail4.png" />

The ImageGalleryTemplateItem supports the use of data-bound controls.

        <telerik:RadComboBox RenderMode="Lightweight" ID="RadComboBox1" EmptyMessage="Select a Country"
            DataSourceID="SqlDataSource1" DataTextField="ShipCountry"
            DataValueField="ShipCountry" runat="server">
        <asp:SqlDataSource ID="SqlDataSource1" runat="server"
            ConnectionString="<%$ ConnectionStrings:ConnectionString %>"
            SelectCommand="SELECT [OrderID], [OrderDate], [Freight], [ShipName], [ShipCountry] FROM [Orders]"></asp:SqlDataSource>

You can also configure the properties of the ImageGalleryTemplateItem programmatically.

protected void RadImageGallery1_ItemDataBound(object sender, ImageGalleryItemEventArgs e)
    if (e.Item is ImageGalleryTemplateItem)
        e.Item.Title = "Success";

You should have in mind that the templates are not individual INamingContainers. Therefore, to access the inner controls, you can use their own event handlers.

protected void Label1_Load(object sender, EventArgs e)
    Label label = sender as Label;
    label.Text = "I am an inner control.";

See Also

In this article