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