Back to all docs
API Reference / Telerik.Windows.Controls / RadTileList

Class
RadTileList

Represents a control that displays a collection of tiles in a list format, allowing for easy organization and interaction with the items. The RadTileList supports features like auto-generation of tiles, grouping, and selection handling, as well as layout management for tiles in a customizable manner. It provides various properties to control the appearance and behavior of the tiles, including TileReorderMode for reordering tiles, Grouping capabilities based on a specified property, and support for touch interactions for handling drag-and-drop scenarios.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.dll

Syntax:
cs-api-definition
[TelerikToolboxCategory("Navigation")]
public class RadTileList : ItemsControl

Inheritance: objectRadTileList

Constructors

RadTileList()

Initializes a new instance of the RadTileList class.

Declaration

cs-api-definition
public RadTileList()

Fields

AutoGenerateTileProperty

Represents the AutoGenerateTile dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AutoGenerateTileProperty

Field Value

DependencyProperty

CanUserSelectProperty

Identifies the CanUserSelect dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CanUserSelectProperty

Field Value

DependencyProperty

GroupHeaderHeightProperty

Represents the GroupHeaderHeight dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupHeaderHeightProperty

Field Value

DependencyProperty

GroupHeaderVisibilityProperty

Represents the GroupHeaderVisibility dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupHeaderVisibilityProperty

Field Value

DependencyProperty

GroupOffsetProperty

Represents the GroupOffset dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupOffsetProperty

Field Value

DependencyProperty

GroupTemplateProperty

Represents the GroupTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupTemplateProperty

Field Value

DependencyProperty

HorizontalTilesAlignmentProperty

Represents the HorizontalTilesAlignment dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty HorizontalTilesAlignmentProperty

Field Value

DependencyProperty

OrientationProperty

Represents the TilesOrientation dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty OrientationProperty

Field Value

DependencyProperty

PanoramaBackgroundProperty

Represents the PanoramaBackground dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty PanoramaBackgroundProperty

Field Value

DependencyProperty

SelectedIndexProperty

Represents the SelectedItem dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedIndexProperty

Field Value

DependencyProperty

SelectedItemProperty

Represents the SelectedItem dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedItemProperty

Field Value

DependencyProperty

SelectionChangedEvent

Identifies the SelectionChanged routed event.

Declaration

cs-api-definition
public static readonly RoutedEvent SelectionChangedEvent

Field Value

RoutedEvent

SelectionModeProperty

Identifies the SelectionMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionModeProperty

Field Value

DependencyProperty

SelectionMouseButtonProperty

Identifies the SelectionMouseButton dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionMouseButtonProperty

Field Value

DependencyProperty

TilePlaceHolderSideProperty

Represents the TilePlaceHolderSide Property.

Declaration

cs-api-definition
public static readonly DependencyProperty TilePlaceHolderSideProperty

Field Value

DependencyProperty

TileReorderModeProperty

Represents the TileReorderMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TileReorderModeProperty

Field Value

DependencyProperty

VerticalTilesAlignmentProperty

Represents the VerticalTilesAlignment dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty VerticalTilesAlignmentProperty

Field Value

DependencyProperty

Properties

AutoGenerateTile

Gets or sets a value indicating whether tiles will be auto-generated.

Declaration

cs-api-definition
public bool AutoGenerateTile { get; set; }

Property Value

bool

CanUserSelect

Gets or sets a value indicating whether the user can select a tile.

Declaration

cs-api-definition
public bool CanUserSelect { get; set; }

Property Value

bool

true if user can select; otherwise, false.

GroupHeaderHeight

Gets or sets the height of the group header.

Declaration

cs-api-definition
public GridLength GroupHeaderHeight { get; set; }

Property Value

GridLength

GroupHeaderVisibility

Gets or sets the visibility of the groups' headers.

Declaration

cs-api-definition
public Visibility GroupHeaderVisibility { get; set; }

Property Value

Visibility

GroupMember

Gets or sets a property name that indicates the member to group by.

Declaration

cs-api-definition
public string GroupMember { get; set; }

Property Value

string

GroupOffset

Gets or sets the distance between the groups.

Declaration

cs-api-definition
public double GroupOffset { get; set; }

Property Value

double

GroupTemplate

Gets or sets the template for the group overlay.

Declaration

cs-api-definition
public DataTemplate GroupTemplate { get; set; }

Property Value

DataTemplate

Groups

Gets the collection used to generate the groups of RadTileList.

Declaration

cs-api-definition
public ObservableCollection<TileGroup> Groups { get; }

Property Value

ObservableCollection<TileGroup>

HorizontalTilesAlignment

Gets or sets HorizontalAlignment of the tiles according to the TileListPanel they are placed.

Declaration

cs-api-definition
public HorizontalAlignment HorizontalTilesAlignment { get; set; }

Property Value

HorizontalAlignment

Orientation

Gets or sets the orientation of the control. When set to Vertical (default) tiles are arranged top to bottom and if a scrollbar is needed it is horizontal. When set to Horizontal tiles are arranged left to right and if a scrollbar is needed it is vertical.

Declaration

cs-api-definition
public Orientation Orientation { get; set; }

Property Value

Orientation

PanoramaBackground

Gets or sets the content to be used as panorama effect background.

Declaration

cs-api-definition
public object PanoramaBackground { get; set; }

Property Value

object

SelectedIndex

Gets or sets the selected item.

Declaration

cs-api-definition
public int SelectedIndex { get; set; }

Property Value

int

SelectedItem

Gets or sets the selected item.

Declaration

cs-api-definition
public object SelectedItem { get; set; }

Property Value

object

SelectedItems

Gets a collection that contains the data items corresponding to the selected rows.

Declaration

cs-api-definition
public ObservableCollection<object> SelectedItems { get; }

Property Value

ObservableCollection<object>

A collection of the data items corresponding to the selected rows.

Remarks

If the SelectionMode property is set to Single, the SelectedItems list will contain only the SelectedItem property value.

SelectionMode

Gets or sets the SelectionMode. This is a dependency property.

Declaration

cs-api-definition
public SelectionMode SelectionMode { get; set; }

Property Value

SelectionMode

SelectionMouseButton

Gets or sets which mouse button should be used for selection.

Declaration

cs-api-definition
public SelectionMouseButton SelectionMouseButton { get; set; }

Property Value

SelectionMouseButton

The selection mouse button.

TilePlaceHolderSide

Gets or sets the TilePlaceHolderSide.

Declaration

cs-api-definition
public double TilePlaceHolderSide { get; set; }

Property Value

double

TileReorderMode

Gets or sets the allowed ways user can reorder tiles.

Declaration

cs-api-definition
public TileReorderMode TileReorderMode { get; set; }

Property Value

TileReorderMode

VerticalTilesAlignment

Gets or sets VerticalAlignment of the tiles according to the TileListPanel they are placed.

Declaration

cs-api-definition
public VerticalAlignment VerticalTilesAlignment { get; set; }

Property Value

VerticalAlignment

Methods

ClearContainerForItemOverride(DependencyObject, object)

Declaration

cs-api-definition
protected override void ClearContainerForItemOverride(DependencyObject element, object item)

Parameters

element

DependencyObject

item

object

GetContainerForItemOverride()

Creates a Tile.

Declaration

cs-api-definition
protected override DependencyObject GetContainerForItemOverride()

Returns

DependencyObject

IsItemItsOwnContainerOverride(object)

Declaration

cs-api-definition
protected override bool IsItemItsOwnContainerOverride(object item)

Parameters

item

object

Returns

bool

OnApplyTemplate()

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnCreateAutomationPeer()

Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

The type-specific AutomationPeer implementation.

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

OnItemContainerStyleChanged(Style, Style)

Declaration

cs-api-definition
protected override void OnItemContainerStyleChanged(Style oldItemContainerStyle, Style newItemContainerStyle)

Parameters

oldItemContainerStyle

Style

newItemContainerStyle

Style

OnItemContainerStyleSelectorChanged(StyleSelector, StyleSelector)

Declaration

cs-api-definition
protected override void OnItemContainerStyleSelectorChanged(StyleSelector oldItemContainerStyleSelector, StyleSelector newItemContainerStyleSelector)

Parameters

oldItemContainerStyleSelector

StyleSelector

newItemContainerStyleSelector

StyleSelector

OnItemTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)

Declaration

cs-api-definition
protected override void OnItemTemplateSelectorChanged(DataTemplateSelector oldItemTemplateSelector, DataTemplateSelector newItemTemplateSelector)

Parameters

oldItemTemplateSelector

DataTemplateSelector

newItemTemplateSelector

DataTemplateSelector

OnItemsChanged(NotifyCollectionChangedEventArgs)

Declaration

cs-api-definition
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)

Parameters

e

NotifyCollectionChangedEventArgs

OnKeyUp(KeyEventArgs)

Declaration

cs-api-definition
protected override void OnKeyUp(KeyEventArgs e)

Parameters

e

KeyEventArgs

PrepareContainerForItemOverride(DependencyObject, object)

Prepares the specified element to display the specified item.

Declaration

cs-api-definition
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)

Parameters

element

DependencyObject

Element used to display the specified item.

item

object

Specified item.

SelectAll()

Selects all items.

Declaration

cs-api-definition
public void SelectAll()

UnselectAll()

Unselects all items.

Declaration

cs-api-definition
public void UnselectAll()

Events

AutoGeneratingTile

Occurs when a tile is being generated.

Declaration

cs-api-definition
public event EventHandler<AutoGeneratingTileEventArgs> AutoGeneratingTile

Event Value

EventHandler<AutoGeneratingTileEventArgs>

SelectionChanged

Occurs when the selected items have changed.

Declaration

cs-api-definition
public event SelectionChangedEventHandler SelectionChanged

Event Value

SelectionChangedEventHandler

In this article
DefinitionConstructorsRadTileList()FieldsAutoGenerateTilePropertyCanUserSelectPropertyGroupHeaderHeightPropertyGroupHeaderVisibilityPropertyGroupOffsetPropertyGroupTemplatePropertyHorizontalTilesAlignmentPropertyOrientationPropertyPanoramaBackgroundPropertySelectedIndexPropertySelectedItemPropertySelectionChangedEventSelectionModePropertySelectionMouseButtonPropertyTilePlaceHolderSidePropertyTileReorderModePropertyVerticalTilesAlignmentPropertyPropertiesAutoGenerateTileCanUserSelectGroupHeaderHeightGroupHeaderVisibilityGroupMemberGroupOffsetGroupTemplateGroupsHorizontalTilesAlignmentOrientationPanoramaBackgroundSelectedIndexSelectedItemSelectedItemsSelectionModeSelectionMouseButtonTilePlaceHolderSideTileReorderModeVerticalTilesAlignmentMethodsClearContainerForItemOverride(DependencyObject, object)GetContainerForItemOverride()IsItemItsOwnContainerOverride(object)OnApplyTemplate()OnCreateAutomationPeer()OnInitialized(EventArgs)OnItemContainerStyleChanged(Style, Style)OnItemContainerStyleSelectorChanged(StyleSelector, StyleSelector)OnItemTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)OnItemsChanged(NotifyCollectionChangedEventArgs)OnKeyUp(KeyEventArgs)PrepareContainerForItemOverride(DependencyObject, object)SelectAll()UnselectAll()EventsAutoGeneratingTileSelectionChanged
Not finding the help you need?
Contact Support