New to Telerik UI for WPFStart a free 30-day trial

An items control that is suitable for building interactive dashboard-like layouts.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Navigation.dll

Syntax:

C#
[Themable]
[TelerikToolboxCategory("Containers")]
public class RadTileView : MultiSelector

Inheritance: objectRadTileView

Constructors

Initializes a new instance of the RadTileView class.

C#
public RadTileView()
Remarks:

Use this constructor to create and initialize a new instance of the RadTileView control.

Fields

Identifies the BringIntoViewOnSelection dependency property.

C#
public static readonly DependencyProperty BringIntoViewOnSelectionProperty

ColumnsCountProperty

DependencyProperty

Identifies the ColumnsCount dependency property.

C#
public static readonly DependencyProperty ColumnsCountProperty

ColumnWidthProperty

DependencyProperty

Identifies the ColumnWidth dependency property.

C#
public static readonly DependencyProperty ColumnWidthProperty

ContentTemplateProperty

DependencyProperty

Identifies the ContentTemplate dependency property.

C#
public static readonly DependencyProperty ContentTemplateProperty

Identifies the ContentTemplateSelector dependency property.

C#
public static readonly DependencyProperty ContentTemplateSelectorProperty

DragModeProperty

DependencyProperty

Identifies the DragMode dependency property.

C#
public static readonly DependencyProperty DragModeProperty

HeaderStyleProperty

DependencyProperty

Identifies the HeaderStyle dependency property.

C#
public static readonly DependencyProperty HeaderStyleProperty

Identifies the IsAutoScrollingEnabled dependency property.

C#
public static readonly DependencyProperty IsAutoScrollingEnabledProperty

IsDockingEnabledProperty

DependencyProperty

Identifies the IsDockingEnabled dependency property.

C#
public static readonly DependencyProperty IsDockingEnabledProperty

Identifies the IsItemDraggingEnabled dependency property.

C#
public static readonly DependencyProperty IsItemDraggingEnabledProperty

Identifies the IsItemsAnimationEnabled dependency property.

C#
public static readonly DependencyProperty IsItemsAnimationEnabledProperty

Identifies the IsItemsSizeInPercentages dependency property.

C#
public static readonly DependencyProperty IsItemsSizeInPercentagesProperty

IsSelectionEnabledProperty

DependencyProperty

Identifies the IsSelectionEnabled dependency property.

C#
public static readonly DependencyProperty IsSelectionEnabledProperty

IsVirtualizingProperty

DependencyProperty

Identifies the IsVirtualizing dependency property.

C#
public static readonly DependencyProperty IsVirtualizingProperty

MaxColumnsProperty

DependencyProperty

Identifies the MaxColumns dependency property.

C#
public static readonly DependencyProperty MaxColumnsProperty

MaximizedItemProperty

DependencyProperty

Identifies the MaximizedItem dependency property.

C#
public static readonly DependencyProperty MaximizedItemProperty

MaximizeModeProperty

DependencyProperty

Identifies the MaximizeMode dependency property.

C#
public static readonly DependencyProperty MaximizeModeProperty

MaxRowsProperty

DependencyProperty

Identifies the MaxRows dependency property.

C#
public static readonly DependencyProperty MaxRowsProperty

Identifies the MinimizedColumnsCount dependency property.

C#
public static readonly DependencyProperty MinimizedColumnsCountProperty

Identifies the MinimizedColumnWidth dependency property.

C#
public static readonly DependencyProperty MinimizedColumnWidthProperty

Identifies the MinimizedItemsPosition dependency property.

C#
public static readonly DependencyProperty MinimizedItemsPositionProperty

MinimizedRowHeightProperty

DependencyProperty

Identifies the MinimizedRowHeight dependency property.

C#
public static readonly DependencyProperty MinimizedRowHeightProperty

MinimizedRowsCountProperty

DependencyProperty

Identifies the MinimizedRowsCount dependency property.

C#
public static readonly DependencyProperty MinimizedRowsCountProperty

Identifies the PossibleDockingPosition dependency property.

C#
public static readonly DependencyProperty PossibleDockingPositionProperty

Identifies the PreservePositionWhenMaximized dependency property.

C#
public static readonly DependencyProperty PreservePositionWhenMaximizedProperty

Occurs before a drag operation is started.

C#
public static readonly RoutedEvent PreviewTileDragStartedEvent
Remarks:

Use this event to detect when a drag operation is about to begin. In cases when you need to prevent the dragging, you can handle this event.

Identifies the PreviewSelectionChanged routed event.

C#
public static readonly RoutedEvent PreviewTilesSelectionChangedEvent

Occurs before all RadTileViewItem have changed their TileState.

C#
public static readonly RoutedEvent PreviewTilesStateChangedEvent

ReorderingDurationProperty

DependencyProperty

Identifies the ReorderingDuration dependency property.

C#
public static readonly DependencyProperty ReorderingDurationProperty

ReorderingEasingProperty

DependencyProperty

Identifies the ReorderingEasing dependency property.

C#
public static readonly DependencyProperty ReorderingEasingProperty

ResizingDurationProperty

DependencyProperty

Identifies the ResizingDuration dependency property.

C#
public static readonly DependencyProperty ResizingDurationProperty

ResizingEasingProperty

DependencyProperty

Identifies the ResizingEasing dependency property.

C#
public static readonly DependencyProperty ResizingEasingProperty

RowHeightProperty

DependencyProperty

Identifies the RowHeight dependency property.

C#
public static readonly DependencyProperty RowHeightProperty

RowsCountProperty

DependencyProperty

Identifies the RowsCount dependency property.

C#
public static readonly DependencyProperty RowsCountProperty

SelectedItemsProperty

DependencyProperty

Identifies the SelectedItems dependency property.

C#
public static readonly DependencyProperty SelectedItemsProperty

SelectionModeProperty

DependencyProperty

Identifies the SelectionMode dependency property.

C#
public static readonly DependencyProperty SelectionModeProperty

Occurs when a drag operation has ended.

C#
public static readonly RoutedEvent TileDragEndedEvent
Remarks:

Use this event to detect when a dragging operation has ended.

Occurs when a drag operation has started.

C#
public static readonly RoutedEvent TileDragStartedEvent
Remarks:

Use this event to detect when a tile has started being dragged.

Occurs after the tiles animations.

C#
public static readonly RoutedEvent TilesAnimationCompletedEvent

Occurs after all RadTileViewItem have changed their TileState.

C#
public static readonly RoutedEvent TilesPositionChangedEvent

Identifies the TilesSelectionChanged routed event.

C#
public static readonly RoutedEvent TilesSelectionChangedEvent

Occurs after all RadTileViewItem have changed their TileState.

C#
public static readonly RoutedEvent TilesStateChangedEvent

Identifies the TileStateChangeTrigger dependency property.

C#
public static readonly DependencyProperty TileStateChangeTriggerProperty

Properties

Gets or sets whether a newly selected item should be brought into view.

C#
public bool BringIntoViewOnSelection { get; set; }

Gets or sets the ColumnsCount property.

C#
public int ColumnsCount { get; set; }

ColumnWidth

GridLength

Gets or sets the ColumnWidth property.

C#
public GridLength ColumnWidth { get; set; }

ContentTemplate

DataTemplate

Gets or sets the DataTemplate that will be used as a ContentTemplate for all items that do not have a ContentTemplate. This is a dependency property.

C#
[SRCategory("AppearanceCategory")]
public DataTemplate ContentTemplate { get; set; }

ContentTemplateSelector

DataTemplateSelector

Gets or sets the DataTemplateSelector that will be used to select a DataTemplate for the items that do not have a ContentTemplate set. This is a dependency property.

C#
[SRCategory("AppearanceCategory")]
public DataTemplateSelector ContentTemplateSelector { get; set; }

Gets or sets the DragMode property.

C#
public TileViewDragMode DragMode { get; set; }

Gets or sets the HeaderStyle property.

C#
public Style HeaderStyle { get; set; }

Gets or sets the IsAutoScrollingEnabled property.

C#
public bool IsAutoScrollingEnabled { get; set; }

Gets or sets the IsDockingEnabled property.

C#
public bool IsDockingEnabled { get; set; }

Gets a value indicating whether a drag operation is in progress.

C#
public bool IsDragging { get; }

Gets or sets a value indicating whether item dragging is enabled.

C#
public bool IsItemDraggingEnabled { get; set; }
Property Value:

True if item dragging is enabled; otherwise, false.

Gets or sets a value indicating whether items animation is enabled.

C#
public bool IsItemsAnimationEnabled { get; set; }
Property Value:

True if items animation is enabled; otherwise, false.

Gets or sets the IsItemsSizeInPercentages property.

C#
public bool IsItemsSizeInPercentages { get; set; }

Gets or sets the IsSelectionEnabled property.

C#
public bool IsSelectionEnabled { get; set; }

Gets or sets the is virtualized property.

C#
public bool IsVirtualizing { get; set; }
Property Value:

True if virtualization is enabled; otherwise, false.

Gets or sets the maximum number of columns. 0 for no maximum. Max rows takes priority over max columns.

C#
public int MaxColumns { get; set; }
Property Value:

The maximum number of columns.

Gets or sets the currently maximized item.

C#
public object MaximizedItem { get; set; }

Gets or sets the maximize mode.

C#
public TileViewMaximizeMode MaximizeMode { get; set; }
Property Value:

The maximize mode.

Gets or sets the maximum number of rows. 0 for no maximum. Max rows takes priority over max columns.

C#
public int MaxRows { get; set; }
Property Value:

The maximum number of rows.

Gets or sets the number of the columns which will be generated when tiles are in Minimized state. This property has affect only when the MinimizedItemsPosition is Left or Right.

C#
public int MinimizedColumnsCount { get; set; }

Gets or sets the width for the minimized column.

C#
public GridLength MinimizedColumnWidth { get; set; }

Gets or sets the position of the minimized items.

C#
public Dock MinimizedItemsPosition { get; set; }

Gets or sets the height for the minimized row.

C#
public GridLength MinimizedRowHeight { get; set; }

Gets or sets the number of the rows which will be generated when tiles are in Minimized state. This property has affect only when the MinimizedItemsPosition is Top or Bottom.

C#
public int MinimizedRowsCount { get; set; }

Gets or sets the PreservePositionWhenMaximized property.

C#
public bool PreservePositionWhenMaximized { get; set; }

Gets or sets the duration of the item reordering.

C#
public Duration ReorderingDuration { get; set; }
Property Value:

The duration of the item reordering.

ReorderingEasing

IEasingFunction

Gets or sets the items reordering easing.

C#
public IEasingFunction ReorderingEasing { get; set; }

Gets or sets the duration of the item resizing.

C#
public Duration ResizingDuration { get; set; }
Property Value:

The duration of the item resizing.

ResizingEasing

IEasingFunction

Gets or sets the items resizing easing.

C#
public IEasingFunction ResizingEasing { get; set; }

RowHeight

GridLength

Gets or sets the RowHeight property.

C#
public GridLength RowHeight { get; set; }

Gets or sets the RowsCount property.

C#
public int RowsCount { get; set; }

Gets a collection containing the items that are currently selected.

C#
public IList SelectedItems { get; }

SelectionMode

SelectionMode

Gets or sets the SelectionMode property.

C#
public SelectionMode SelectionMode { get; set; }

Gets or sets the tile state change trigger.

C#
public TileStateChangeTrigger TileStateChangeTrigger { get; set; }
Property Value:

The tile state change trigger.

Methods

Brings an Item into the viewable area.

C#
public void BringIntoView(object item)
Parameters:itemobject

Clean up RadTileView item.

C#
protected override void ClearContainerForItemOverride(DependencyObject element, object item)
Parameters:elementDependencyObject

The source RadTileView item.

itemobject

The source item.

Returns a new RadTileView.

C#
protected override DependencyObject GetContainerForItemOverride()
Returns:

DependencyObject

A new RadTileView.

Returns true is item is a RadTileView.

C#
protected override bool IsItemItsOwnContainerOverride(object item)
Parameters:itemobject

The item to check.

Returns:

bool

True if item is a RadTileView.

Applies the template for the RadTileView.

C#
public override void OnApplyTemplate()

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

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

The type-specific AutomationPeer implementation.

Invoked when the HeaderStyle property changes.

C#
protected virtual void OnHeaderStyleChanged(Style oldValue, Style newValue)
Parameters:oldValueStylenewValueStyle

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

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

Invoked when the Items property changes.

C#
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)
Parameters:eNotifyCollectionChangedEventArgs

The NotifyCollectionChangedEventArgs that contains the event data.

Invoked after a key has been pressed.

C#
protected override void OnKeyDown(KeyEventArgs e)
Parameters:eKeyEventArgs

Invoked on mouse left button up.

C#
protected override void OnMouseLeftButtonUp(MouseButtonEventArgs e)
Parameters:eMouseButtonEventArgs

Raises the event.

C#
protected virtual void OnPreviewTileDragStarted(TileViewDragEventArgs e)
Parameters:eTileViewDragEventArgs

The TileViewDragEventArgs instance containing the event data.

Raises the event.

C#
protected virtual bool OnPreviewTilesSelectionChanged(SelectionChangedEventArgs e)
Parameters:eSelectionChangedEventArgs

The RadRoutedEventArgs instance containing the event data.

Returns:

bool

Raises the event.

C#
protected virtual void OnPreviewTilesStateChanged(RadRoutedEventArgs e)
Parameters:eRadRoutedEventArgs

The RadRoutedEventArgs instance containing the event data.

Invoked after the SelectionChanges has finished changes.

C#
protected override void OnSelectionChanged(SelectionChangedEventArgs e)
Parameters:eSelectionChangedEventArgs

Raises the event.

C#
protected virtual void OnTileDragEnded(TileViewDragEventArgs e)
Parameters:eTileViewDragEventArgs

The TileViewDragEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnTileDragStarted(TileViewDragEventArgs e)
Parameters:eTileViewDragEventArgs

The TileViewDragEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnTilePositionChanged(RadRoutedEventArgs e)
Parameters:eRadRoutedEventArgs

The RadRoutedEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnTilesSelectionChanged(SelectionChangedEventArgs e)
Parameters:eSelectionChangedEventArgs

The RadRoutedEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnTilesStateChanged(RadRoutedEventArgs e)
Parameters:eRadRoutedEventArgs

Prepares a TileView item.

C#
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)
Parameters:elementDependencyObject

The TileView item.

itemobject

The source item.

Resets the theme.

C#
public void ResetTheme()

Selects all items.

C#
public void SelectAll()

Deselects all items.

C#
public void UnselectAll()

Events

Occurs before a drag operation has started.

C#
public event EventHandler<TileViewDragEventArgs> PreviewTileDragStarted

Occurs before when the Position of a RadTileViewItem is changed.

C#
public event EventHandler<RadRoutedEventArgs> PreviewTilePositionChanged
Remarks:

Use this event to detect when the Position of a RadTileViewItem is going changed.

PreviewTileSelectionChanged

SelectionChangedEventHandler

Occurs before the TileState of a RadTileViewItem is changed.

C#
public event SelectionChangedEventHandler PreviewTileSelectionChanged
Remarks:

Use this event to detect when the TileState of a RadTileViewItem is about to be changed changed. In cases when you need to prevent the Selection from changing, you can handle this event.

PreviewTilesSelectionChanged

SelectionChangedEventHandler

Raised just before the selected items collection has changed.

C#
public event SelectionChangedEventHandler PreviewTilesSelectionChanged

Occurs before all RadTileViewItem have changed their TileState.

C#
public event EventHandler<RadRoutedEventArgs> PreviewTilesStateChanged

Occurs before the TileState of a RadTileViewItem is changed.

C#
public event EventHandler<PreviewTileStateChangedEventArgs> PreviewTileStateChanged
Remarks:

Use this event to detect when the TileState of a RadTileViewItem is about to be changed changed. In cases when you need to prevent the TileState from changing, you can handle this event.

Occurs after a drag operation has ended.

C#
public event EventHandler<TileViewDragEventArgs> TileDragEnded

Occurs after a drag operation has started.

C#
public event EventHandler<TileViewDragEventArgs> TileDragStarted

Occurs when the Position of a RadTileViewItem is changed.

C#
public event EventHandler<RadRoutedEventArgs> TilePositionChanged
Remarks:

Use this event to detect when the Position of a RadTileViewItem is changed.

Occurs when the tiles animations have completed.

C#
public event EventHandler<TilesAnimationCompletedEventArgs> TilesAnimationCompleted

TileSelectionChanged

SelectionChangedEventHandler

Occurs after someRadTileViewItem have changed their Selection.

C#
public event SelectionChangedEventHandler TileSelectionChanged

Occurs after someRadTileViewItem have changed their Positions.

C#
public event EventHandler<RadRoutedEventArgs> TilesPositionChanged

TilesSelectionChanged

SelectionChangedEventHandler

Occurs after someRadTileViewItem have changed their Selection.

C#
public event SelectionChangedEventHandler TilesSelectionChanged

Occurs after all RadTileViewItem have changed their TileState.

C#
public event EventHandler<RadRoutedEventArgs> TilesStateChanged

Occurs when the TileState of a RadTileViewItem is changed.

C#
public event EventHandler<RadRoutedEventArgs> TileStateChanged
Remarks:

Use this event to detect when the TileState of a RadTileViewItem is changed.

In this article
DefinitionConstructorsRadTileView()FieldsBringIntoViewOnSelectionPropertyColumnsCountPropertyColumnWidthPropertyContentTemplatePropertyContentTemplateSelectorPropertyDragModePropertyHeaderStylePropertyIsAutoScrollingEnabledPropertyIsDockingEnabledPropertyIsItemDraggingEnabledPropertyIsItemsAnimationEnabledPropertyIsItemsSizeInPercentagesPropertyIsSelectionEnabledPropertyIsVirtualizingPropertyMaxColumnsPropertyMaximizedItemPropertyMaximizeModePropertyMaxRowsPropertyMinimizedColumnsCountPropertyMinimizedColumnWidthPropertyMinimizedItemsPositionPropertyMinimizedRowHeightPropertyMinimizedRowsCountPropertyPossibleDockingPositionPropertyPreservePositionWhenMaximizedPropertyPreviewTileDragStartedEventPreviewTilesSelectionChangedEventPreviewTilesStateChangedEventReorderingDurationPropertyReorderingEasingPropertyResizingDurationPropertyResizingEasingPropertyRowHeightPropertyRowsCountPropertySelectedItemsPropertySelectionModePropertyTileDragEndedEventTileDragStartedEventTilesAnimationCompletedEventTilesPositionChangedEventTilesSelectionChangedEventTilesStateChangedEventTileStateChangeTriggerPropertyPropertiesBringIntoViewOnSelectionColumnsCountColumnWidthContentTemplateContentTemplateSelectorDragModeHeaderStyleIsAutoScrollingEnabledIsDockingEnabledIsDraggingIsItemDraggingEnabledIsItemsAnimationEnabledIsItemsSizeInPercentagesIsSelectionEnabledIsVirtualizingMaxColumnsMaximizedItemMaximizeModeMaxRowsMinimizedColumnsCountMinimizedColumnWidthMinimizedItemsPositionMinimizedRowHeightMinimizedRowsCountPreservePositionWhenMaximizedReorderingDurationReorderingEasingResizingDurationResizingEasingRowHeightRowsCountSelectedItemsSelectionModeTileStateChangeTriggerMethodsBringIntoView(object)ClearContainerForItemOverride(DependencyObject, object)GetContainerForItemOverride()IsItemItsOwnContainerOverride(object)OnApplyTemplate()OnCreateAutomationPeer()OnHeaderStyleChanged(Style, Style)OnInitialized(EventArgs)OnItemsChanged(NotifyCollectionChangedEventArgs)OnKeyDown(KeyEventArgs)OnMouseLeftButtonUp(MouseButtonEventArgs)OnPreviewTileDragStarted(TileViewDragEventArgs)OnPreviewTilesSelectionChanged(SelectionChangedEventArgs)OnPreviewTilesStateChanged(RadRoutedEventArgs)OnSelectionChanged(SelectionChangedEventArgs)OnTileDragEnded(TileViewDragEventArgs)OnTileDragStarted(TileViewDragEventArgs)OnTilePositionChanged(RadRoutedEventArgs)OnTilesSelectionChanged(SelectionChangedEventArgs)OnTilesStateChanged(RadRoutedEventArgs)PrepareContainerForItemOverride(DependencyObject, object)ResetTheme()SelectAll()UnselectAll()EventsPreviewTileDragStartedPreviewTilePositionChangedPreviewTileSelectionChangedPreviewTilesSelectionChangedPreviewTilesStateChangedPreviewTileStateChangedTileDragEndedTileDragStartedTilePositionChangedTilesAnimationCompletedTileSelectionChangedTilesPositionChangedTilesSelectionChangedTilesStateChangedTileStateChanged
Not finding the help you need?
Contact Support