RadTileView
An items control that is suitable for building interactive dashboard-like layouts.
Definition
Namespace:Telerik.Windows.Controls
Assembly:Telerik.Windows.Controls.Navigation.dll
Syntax:
[Themable]
[TelerikToolboxCategory("Containers")]
public class RadTileView : MultiSelector
Inheritance: objectRadTileView
Constructors
Initializes a new instance of the RadTileView class.
public RadTileView()
Use this constructor to create and initialize a new instance of the RadTileView control.
Fields
BringIntoViewOnSelectionProperty
DependencyProperty
Identifies the BringIntoViewOnSelection dependency property.
public static readonly DependencyProperty BringIntoViewOnSelectionProperty
ColumnsCountProperty
DependencyProperty
Identifies the ColumnsCount dependency property.
public static readonly DependencyProperty ColumnsCountProperty
ColumnWidthProperty
DependencyProperty
Identifies the ColumnWidth dependency property.
public static readonly DependencyProperty ColumnWidthProperty
ContentTemplateProperty
DependencyProperty
Identifies the ContentTemplate dependency property.
public static readonly DependencyProperty ContentTemplateProperty
ContentTemplateSelectorProperty
DependencyProperty
Identifies the ContentTemplateSelector dependency property.
public static readonly DependencyProperty ContentTemplateSelectorProperty
DragModeProperty
DependencyProperty
Identifies the DragMode dependency property.
public static readonly DependencyProperty DragModeProperty
HeaderStyleProperty
DependencyProperty
Identifies the HeaderStyle dependency property.
public static readonly DependencyProperty HeaderStyleProperty
IsAutoScrollingEnabledProperty
DependencyProperty
Identifies the IsAutoScrollingEnabled dependency property.
public static readonly DependencyProperty IsAutoScrollingEnabledProperty
IsDockingEnabledProperty
DependencyProperty
Identifies the IsDockingEnabled dependency property.
public static readonly DependencyProperty IsDockingEnabledProperty
IsItemDraggingEnabledProperty
DependencyProperty
Identifies the IsItemDraggingEnabled dependency property.
public static readonly DependencyProperty IsItemDraggingEnabledProperty
IsItemsAnimationEnabledProperty
DependencyProperty
Identifies the IsItemsAnimationEnabled dependency property.
public static readonly DependencyProperty IsItemsAnimationEnabledProperty
IsItemsSizeInPercentagesProperty
DependencyProperty
Identifies the IsItemsSizeInPercentages dependency property.
public static readonly DependencyProperty IsItemsSizeInPercentagesProperty
IsSelectionEnabledProperty
DependencyProperty
Identifies the IsSelectionEnabled dependency property.
public static readonly DependencyProperty IsSelectionEnabledProperty
IsVirtualizingProperty
DependencyProperty
Identifies the IsVirtualizing dependency property.
public static readonly DependencyProperty IsVirtualizingProperty
MaxColumnsProperty
DependencyProperty
Identifies the MaxColumns dependency property.
public static readonly DependencyProperty MaxColumnsProperty
MaximizedItemProperty
DependencyProperty
Identifies the MaximizedItem dependency property.
public static readonly DependencyProperty MaximizedItemProperty
MaximizeModeProperty
DependencyProperty
Identifies the MaximizeMode dependency property.
public static readonly DependencyProperty MaximizeModeProperty
MaxRowsProperty
DependencyProperty
Identifies the MaxRows dependency property.
public static readonly DependencyProperty MaxRowsProperty
MinimizedColumnsCountProperty
DependencyProperty
Identifies the MinimizedColumnsCount dependency property.
public static readonly DependencyProperty MinimizedColumnsCountProperty
MinimizedColumnWidthProperty
DependencyProperty
Identifies the MinimizedColumnWidth dependency property.
public static readonly DependencyProperty MinimizedColumnWidthProperty
MinimizedItemsPositionProperty
DependencyProperty
Identifies the MinimizedItemsPosition dependency property.
public static readonly DependencyProperty MinimizedItemsPositionProperty
MinimizedRowHeightProperty
DependencyProperty
Identifies the MinimizedRowHeight dependency property.
public static readonly DependencyProperty MinimizedRowHeightProperty
MinimizedRowsCountProperty
DependencyProperty
Identifies the MinimizedRowsCount dependency property.
public static readonly DependencyProperty MinimizedRowsCountProperty
PossibleDockingPositionProperty
DependencyProperty
Identifies the PossibleDockingPosition dependency property.
public static readonly DependencyProperty PossibleDockingPositionProperty
PreservePositionWhenMaximizedProperty
DependencyProperty
Identifies the PreservePositionWhenMaximized dependency property.
public static readonly DependencyProperty PreservePositionWhenMaximizedProperty
PreviewTileDragStartedEvent
RoutedEvent
Occurs before a drag operation is started.
public static readonly RoutedEvent PreviewTileDragStartedEvent
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.
PreviewTilesSelectionChangedEvent
RoutedEvent
Identifies the PreviewSelectionChanged routed event.
public static readonly RoutedEvent PreviewTilesSelectionChangedEvent
PreviewTilesStateChangedEvent
RoutedEvent
Occurs before all RadTileViewItem have changed their TileState.
public static readonly RoutedEvent PreviewTilesStateChangedEvent
ReorderingDurationProperty
DependencyProperty
Identifies the ReorderingDuration dependency property.
public static readonly DependencyProperty ReorderingDurationProperty
ReorderingEasingProperty
DependencyProperty
Identifies the ReorderingEasing dependency property.
public static readonly DependencyProperty ReorderingEasingProperty
ResizingDurationProperty
DependencyProperty
Identifies the ResizingDuration dependency property.
public static readonly DependencyProperty ResizingDurationProperty
ResizingEasingProperty
DependencyProperty
Identifies the ResizingEasing dependency property.
public static readonly DependencyProperty ResizingEasingProperty
RowHeightProperty
DependencyProperty
Identifies the RowHeight dependency property.
public static readonly DependencyProperty RowHeightProperty
RowsCountProperty
DependencyProperty
Identifies the RowsCount dependency property.
public static readonly DependencyProperty RowsCountProperty
SelectedItemsProperty
DependencyProperty
Identifies the SelectedItems dependency property.
public static readonly DependencyProperty SelectedItemsProperty
SelectionModeProperty
DependencyProperty
Identifies the SelectionMode dependency property.
public static readonly DependencyProperty SelectionModeProperty
TileDragEndedEvent
RoutedEvent
Occurs when a drag operation has ended.
public static readonly RoutedEvent TileDragEndedEvent
Use this event to detect when a dragging operation has ended.
TileDragStartedEvent
RoutedEvent
Occurs when a drag operation has started.
public static readonly RoutedEvent TileDragStartedEvent
Use this event to detect when a tile has started being dragged.
TilesAnimationCompletedEvent
RoutedEvent
Occurs after the tiles animations.
public static readonly RoutedEvent TilesAnimationCompletedEvent
TilesPositionChangedEvent
RoutedEvent
Occurs after all RadTileViewItem have changed their TileState.
public static readonly RoutedEvent TilesPositionChangedEvent
TilesSelectionChangedEvent
RoutedEvent
Identifies the TilesSelectionChanged routed event.
public static readonly RoutedEvent TilesSelectionChangedEvent
TilesStateChangedEvent
RoutedEvent
Occurs after all RadTileViewItem have changed their TileState.
public static readonly RoutedEvent TilesStateChangedEvent
TileStateChangeTriggerProperty
DependencyProperty
Identifies the TileStateChangeTrigger dependency property.
public static readonly DependencyProperty TileStateChangeTriggerProperty
Properties
Gets or sets whether a newly selected item should be brought into view.
public bool BringIntoViewOnSelection { get; set; }
Gets or sets the ColumnsCount property.
public int ColumnsCount { get; set; }
ColumnWidth
GridLength
Gets or sets the ColumnWidth property.
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.
[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.
[SRCategory("AppearanceCategory")]
public DataTemplateSelector ContentTemplateSelector { get; set; }
Gets or sets the DragMode property.
public TileViewDragMode DragMode { get; set; }
HeaderStyle
Style
Gets or sets the HeaderStyle property.
public Style HeaderStyle { get; set; }
Gets or sets the IsAutoScrollingEnabled property.
public bool IsAutoScrollingEnabled { get; set; }
Gets or sets the IsDockingEnabled property.
public bool IsDockingEnabled { get; set; }
Gets a value indicating whether a drag operation is in progress.
public bool IsDragging { get; }
Gets or sets a value indicating whether item dragging is enabled.
public bool IsItemDraggingEnabled { get; set; }
True if item dragging is enabled; otherwise, false.
Gets or sets a value indicating whether items animation is enabled.
public bool IsItemsAnimationEnabled { get; set; }
True if items animation is enabled; otherwise, false.
Gets or sets the IsItemsSizeInPercentages property.
public bool IsItemsSizeInPercentages { get; set; }
Gets or sets the IsSelectionEnabled property.
public bool IsSelectionEnabled { get; set; }
Gets or sets the is virtualized property.
public bool IsVirtualizing { get; set; }
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.
public int MaxColumns { get; set; }
The maximum number of columns.
Gets or sets the currently maximized item.
public object MaximizedItem { get; set; }
Gets or sets the maximize mode.
public TileViewMaximizeMode MaximizeMode { get; set; }
The maximize mode.
Gets or sets the maximum number of rows. 0 for no maximum. Max rows takes priority over max columns.
public int MaxRows { get; set; }
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.
public int MinimizedColumnsCount { get; set; }
MinimizedColumnWidth
GridLength
Gets or sets the width for the minimized column.
public GridLength MinimizedColumnWidth { get; set; }
Gets or sets the position of the minimized items.
public Dock MinimizedItemsPosition { get; set; }
MinimizedRowHeight
GridLength
Gets or sets the height for the minimized row.
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.
public int MinimizedRowsCount { get; set; }
Gets or sets the PreservePositionWhenMaximized property.
public bool PreservePositionWhenMaximized { get; set; }
ReorderingDuration
Duration
Gets or sets the duration of the item reordering.
public Duration ReorderingDuration { get; set; }
The duration of the item reordering.
ReorderingEasing
IEasingFunction
Gets or sets the items reordering easing.
public IEasingFunction ReorderingEasing { get; set; }
ResizingDuration
Duration
Gets or sets the duration of the item resizing.
public Duration ResizingDuration { get; set; }
The duration of the item resizing.
ResizingEasing
IEasingFunction
Gets or sets the items resizing easing.
public IEasingFunction ResizingEasing { get; set; }
RowHeight
GridLength
Gets or sets the RowHeight property.
public GridLength RowHeight { get; set; }
Gets a collection containing the items that are currently selected.
public IList SelectedItems { get; }
SelectionMode
SelectionMode
Gets or sets the SelectionMode property.
public SelectionMode SelectionMode { get; set; }
Gets or sets the tile state change trigger.
public TileStateChangeTrigger TileStateChangeTrigger { get; set; }
The tile state change trigger.
Methods
Brings an Item into the viewable area.
Clean up RadTileView item.
protected override void ClearContainerForItemOverride(DependencyObject element, object item)
The source RadTileView item.
itemobjectThe source item.
GetContainerForItemOverride()
DependencyObject
Returns a new RadTileView.
protected override DependencyObject GetContainerForItemOverride()
DependencyObject
A new RadTileView.
Applies the template for the RadTileView.
public override void OnApplyTemplate()
OnCreateAutomationPeer()
AutomationPeer
Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.
protected override AutomationPeer OnCreateAutomationPeer()
AutomationPeer
The type-specific AutomationPeer implementation.
Invoked when the HeaderStyle property changes.
protected virtual void OnHeaderStyleChanged(Style oldValue, Style newValue)
Raises the event. This method is invoked whenever is set to true internally.
protected override void OnInitialized(EventArgs e)
The RoutedEventArgs that contains the event data.
Invoked when the Items property changes.
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)
The NotifyCollectionChangedEventArgs that contains the event data.
Invoked after a key has been pressed.
protected override void OnKeyDown(KeyEventArgs e)
Invoked on mouse left button up.
protected override void OnMouseLeftButtonUp(MouseButtonEventArgs e)
Raises the event.
protected virtual void OnPreviewTileDragStarted(TileViewDragEventArgs e)
The TileViewDragEventArgs instance containing the event data.
Raises the event.
protected virtual bool OnPreviewTilesSelectionChanged(SelectionChangedEventArgs e)
The RadRoutedEventArgs instance containing the event data.
Returns:Raises the event.
protected virtual void OnPreviewTilesStateChanged(RadRoutedEventArgs e)
The RadRoutedEventArgs instance containing the event data.
Invoked after the SelectionChanges has finished changes.
protected override void OnSelectionChanged(SelectionChangedEventArgs e)
Raises the event.
protected virtual void OnTileDragEnded(TileViewDragEventArgs e)
The TileViewDragEventArgs instance containing the event data.
Raises the event.
protected virtual void OnTileDragStarted(TileViewDragEventArgs e)
The TileViewDragEventArgs instance containing the event data.
Raises the event.
protected virtual void OnTilePositionChanged(RadRoutedEventArgs e)
The RadRoutedEventArgs instance containing the event data.
Raises the event.
protected virtual void OnTilesSelectionChanged(SelectionChangedEventArgs e)
The RadRoutedEventArgs instance containing the event data.
Raises the event.
Prepares a TileView item.
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)
The TileView item.
itemobjectThe source item.
Resets the theme.
public void ResetTheme()
Selects all items.
public void SelectAll()
Deselects all items.
public void UnselectAll()
Events
Occurs before a drag operation has started.
public event EventHandler<TileViewDragEventArgs> PreviewTileDragStarted
Occurs before when the Position of a RadTileViewItem is changed.
public event EventHandler<RadRoutedEventArgs> PreviewTilePositionChanged
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.
public event SelectionChangedEventHandler PreviewTileSelectionChanged
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.
public event SelectionChangedEventHandler PreviewTilesSelectionChanged
Occurs before all RadTileViewItem have changed their TileState.
public event EventHandler<RadRoutedEventArgs> PreviewTilesStateChanged
Occurs before the TileState of a RadTileViewItem is changed.
public event EventHandler<PreviewTileStateChangedEventArgs> PreviewTileStateChanged
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.
public event EventHandler<TileViewDragEventArgs> TileDragEnded
Occurs after a drag operation has started.
public event EventHandler<TileViewDragEventArgs> TileDragStarted
Occurs when the Position of a RadTileViewItem is changed.
public event EventHandler<RadRoutedEventArgs> TilePositionChanged
Use this event to detect when the Position of a RadTileViewItem is changed.
Occurs when the tiles animations have completed.
public event EventHandler<TilesAnimationCompletedEventArgs> TilesAnimationCompleted
TileSelectionChanged
SelectionChangedEventHandler
Occurs after someRadTileViewItem have changed their Selection.
public event SelectionChangedEventHandler TileSelectionChanged
Occurs after someRadTileViewItem have changed their Positions.
public event EventHandler<RadRoutedEventArgs> TilesPositionChanged
TilesSelectionChanged
SelectionChangedEventHandler
Occurs after someRadTileViewItem have changed their Selection.
public event SelectionChangedEventHandler TilesSelectionChanged
Occurs after all RadTileViewItem have changed their TileState.
public event EventHandler<RadRoutedEventArgs> TilesStateChanged
Occurs when the TileState of a RadTileViewItem is changed.
public event EventHandler<RadRoutedEventArgs> TileStateChanged
Use this event to detect when the TileState of a RadTileViewItem is changed.