Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Expand]Common Features
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.DataAccess.UI.Design
  [Expand]DevExpress.DataAccess.UI.EntityFramework
  [Expand]DevExpress.DataAccess.UI.Excel
  [Expand]DevExpress.DataAccess.UI.Localization
  [Expand]DevExpress.DataAccess.UI.ObjectBinding
  [Expand]DevExpress.DataAccess.UI.Sql
  [Expand]DevExpress.DataAccess.UI.Wizard
  [Expand]DevExpress.DataAccess.UI.Wizard.Services
  [Expand]DevExpress.DataAccess.UI.Wizard.Views
  [Expand]DevExpress.DocumentView
  [Expand]DevExpress.DocumentView.Controls
  [Expand]DevExpress.LookAndFeel
  [Expand]DevExpress.LookAndFeel.Helpers
  [Expand]DevExpress.Skins
  [Expand]DevExpress.Snap
  [Expand]DevExpress.Snap.API.Native
  [Expand]DevExpress.Snap.Core
  [Expand]DevExpress.Snap.Core.API
  [Expand]DevExpress.Snap.Core.Fields
  [Expand]DevExpress.Snap.Core.Forms
  [Expand]DevExpress.Snap.Core.Options
  [Expand]DevExpress.Snap.Core.Services
  [Expand]DevExpress.Snap.Extensions
  [Expand]DevExpress.Snap.Extensions.Localization
  [Expand]DevExpress.Snap.Localization
  [Expand]DevExpress.Snap.Options
  [Expand]DevExpress.Snap.Services
  [Expand]DevExpress.Utils
  [Expand]DevExpress.Utils.Animation
  [Expand]DevExpress.Utils.Controls
  [Expand]DevExpress.Utils.Drawing
  [Expand]DevExpress.Utils.Menu
  [Expand]DevExpress.Utils.Taskbar
  [Expand]DevExpress.Utils.Taskbar.Core
  [Expand]DevExpress.Utils.UI.Localization
  [Expand]DevExpress.Utils.VisualEffects
  [Expand]DevExpress.Utils.Win
  [Expand]DevExpress.XtraBars
  [Expand]DevExpress.XtraBars.Alerter
  [Expand]DevExpress.XtraBars.Docking
  [Expand]DevExpress.XtraBars.Docking2010
  [Expand]DevExpress.XtraBars.Docking2010.Customization
  [Expand]DevExpress.XtraBars.Docking2010.Views
  [Expand]DevExpress.XtraBars.Docking2010.Views.NativeMdi
  [Expand]DevExpress.XtraBars.Docking2010.Views.Tabbed
  [Expand]DevExpress.XtraBars.Docking2010.Views.Widget
  [Expand]DevExpress.XtraBars.Docking2010.Views.WindowsUI
  [Expand]DevExpress.XtraBars.Localization
  [Expand]DevExpress.XtraBars.Navigation
  [Expand]DevExpress.XtraBars.Ribbon
  [Expand]DevExpress.XtraBars.Ribbon.Gallery
  [Expand]DevExpress.XtraBars.Ribbon.ViewInfo
  [Expand]DevExpress.XtraBars.ToastNotifications
  [Expand]DevExpress.XtraBars.Utils
  [Expand]DevExpress.XtraBars.WinRTLiveTiles
  [Expand]DevExpress.XtraCharts
  [Expand]DevExpress.XtraCharts.Designer
  [Expand]DevExpress.XtraCharts.Wizard
  [Expand]DevExpress.XtraDataLayout
  [Expand]DevExpress.XtraDiagram
  [Expand]DevExpress.XtraDiagram.Options
  [Expand]DevExpress.XtraEditors
  [Expand]DevExpress.XtraEditors.ButtonPanel
  [Expand]DevExpress.XtraEditors.Calendar
  [Expand]DevExpress.XtraEditors.Camera
  [Expand]DevExpress.XtraEditors.Container
  [Expand]DevExpress.XtraEditors.Controls
  [Expand]DevExpress.XtraEditors.CustomEditor
  [Expand]DevExpress.XtraEditors.DXErrorProvider
  [Expand]DevExpress.XtraEditors.Filtering
  [Expand]DevExpress.XtraEditors.Mask
  [Expand]DevExpress.XtraEditors.Persistent
  [Expand]DevExpress.XtraEditors.Repository
  [Expand]DevExpress.XtraEditors.ViewInfo
  [Expand]DevExpress.XtraFilterEditor
  [Expand]DevExpress.XtraGauges.Presets.Styles
  [Expand]DevExpress.XtraGauges.Win
  [Expand]DevExpress.XtraGauges.Win.Base
  [Expand]DevExpress.XtraGauges.Win.Gauges.Circular
  [Expand]DevExpress.XtraGauges.Win.Gauges.Digital
  [Expand]DevExpress.XtraGauges.Win.Gauges.Linear
  [Expand]DevExpress.XtraGauges.Win.Gauges.State
  [Expand]DevExpress.XtraGrid
  [Expand]DevExpress.XtraGrid.Columns
  [Expand]DevExpress.XtraGrid.EditForm
  [Expand]DevExpress.XtraGrid.FilterEditor
  [Expand]DevExpress.XtraGrid.Localization
  [Expand]DevExpress.XtraGrid.Views.BandedGrid
  [Expand]DevExpress.XtraGrid.Views.BandedGrid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Base
  [Expand]DevExpress.XtraGrid.Views.Base.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Card
  [Expand]DevExpress.XtraGrid.Views.Card.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Grid
  [Expand]DevExpress.XtraGrid.Views.Grid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Layout
  [Expand]DevExpress.XtraGrid.Views.Layout.Events
  [Expand]DevExpress.XtraGrid.Views.Layout.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Printing
  [Collapse]DevExpress.XtraGrid.Views.Tile
   [Expand]BeforeItemDragEventArgs Class
   [Expand]BeforeItemDropEventArgs Class
   [Expand]ItemDropEventArgs Class
   [Collapse]TileView Class
     TileView Members
    [Expand]TileView Constructor
    [Collapse]TileView Properties
      AnimateArrival Property
      Appearance Property
      AppearanceGroupText Property
      AppearanceItem Property
      AppearancePrint Property
      ColumnSet Property
      ContextButtonOptions Property
      ContextButtons Property
      DetailTabHeaderLocation Property
      FocusBorderColor Property
      GroupCount Property
      HtmlImages Property
      IsVisible Property
      OptionsBehavior Property
      OptionsDragDrop Property
      OptionsEditForm Property
      OptionsFilter Property
      OptionsImageLoad Property
      OptionsList Property
      OptionsPrint Property
      OptionsSelection Property
      OptionsTiles Property
      OptionsView Property
      PaintStyleName Property
      Position Property
      TemplateItem Property
      Templates Property
      TileColumns Property
      TileRows Property
      TileSpans Property
      TileTemplate Property
      ViewCaptionHeight Property
      ViewRect Property
    [Expand]TileView Events
    [Expand]TileView Methods
    TileViewBeforeItemDragEventHandler Delegate
    TileViewBeforeItemDropEventHandler Delegate
   [Expand]TileViewContextButtonCustomizeEventArgs Class
    TileViewContextButtonCustomizeEventHandler Delegate
   [Expand]TileViewContextButtonToolTipEventArgs Class
    TileViewContextButtonToolTipEventHandler Delegate
    TileViewEditingMode Enumeration
   [Expand]TileViewGroup Class
   [Expand]TileViewItem Class
   [Expand]TileViewItemCustomizeEventArgs Class
    TileViewItemCustomizeEventHandler Delegate
    TileViewItemDropEventHandler Delegate
   [Expand]TileViewItemElement Class
   [Expand]TileViewItemOptions Class
    TileViewLayoutMode Enumeration
   [Expand]TileViewOptionsBehavior Class
   [Expand]TileViewOptionsDragDrop Class
   [Expand]TileViewOptionsEditForm Class
   [Expand]TileViewOptionsImageLoad Class
  [Expand]DevExpress.XtraGrid.Views.WinExplorer
  [Expand]DevExpress.XtraGrid.WinExplorer
  [Expand]DevExpress.XtraLayout
  [Expand]DevExpress.XtraLayout.Customization
  [Expand]DevExpress.XtraLayout.HitInfo
  [Expand]DevExpress.XtraLayout.Localization
  [Expand]DevExpress.XtraLayout.Utils
  [Expand]DevExpress.XtraMap
  [Expand]DevExpress.XtraMap.Printing
  [Expand]DevExpress.XtraNavBar
  [Expand]DevExpress.XtraNavBar.ViewInfo
  [Expand]DevExpress.XtraPdfViewer
  [Expand]DevExpress.XtraPdfViewer.Commands
  [Expand]DevExpress.XtraPdfViewer.Localization
  [Expand]DevExpress.XtraPivotGrid
  [Expand]DevExpress.XtraPivotGrid.Data
  [Expand]DevExpress.XtraPrinting
  [Expand]DevExpress.XtraPrinting.Control
  [Expand]DevExpress.XtraPrinting.Preview
  [Expand]DevExpress.XtraPrintingLinks
  [Expand]DevExpress.XtraReports.UI
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Commands
  [Expand]DevExpress.XtraRichEdit.Export
  [Expand]DevExpress.XtraRichEdit.Import
  [Expand]DevExpress.XtraRichEdit.Localization
  [Expand]DevExpress.XtraRichEdit.Menu
  [Expand]DevExpress.XtraScheduler
  [Expand]DevExpress.XtraScheduler.Drawing
  [Expand]DevExpress.XtraScheduler.Printing
  [Expand]DevExpress.XtraScheduler.Reporting
  [Expand]DevExpress.XtraScheduler.Reporting.UI
  [Expand]DevExpress.XtraScheduler.Services
  [Expand]DevExpress.XtraScheduler.Services.Implementation
  [Expand]DevExpress.XtraScheduler.UI
  [Expand]DevExpress.XtraSpellChecker
  [Expand]DevExpress.XtraSpellChecker.Localization
  [Expand]DevExpress.XtraSplashForm
  [Expand]DevExpress.XtraSplashScreen
  [Expand]DevExpress.XtraSpreadsheet
  [Expand]DevExpress.XtraSpreadsheet.Services
  [Expand]DevExpress.XtraTab
  [Expand]DevExpress.XtraTab.Buttons
  [Expand]DevExpress.XtraTab.ViewInfo
  [Expand]DevExpress.XtraTabbedMdi
  [Expand]DevExpress.XtraToolbox
  [Expand]DevExpress.XtraTreeList
  [Expand]DevExpress.XtraTreeList.Columns
  [Expand]DevExpress.XtraTreeList.Data
  [Expand]DevExpress.XtraTreeList.Localization
  [Expand]DevExpress.XtraTreeList.Menu
  [Expand]DevExpress.XtraTreeList.Nodes
  [Expand]DevExpress.XtraTreeList.Nodes.Operations
  [Expand]DevExpress.XtraTreeList.StyleFormatConditions
  [Expand]DevExpress.XtraTreeMap
  [Expand]DevExpress.XtraVerticalGrid
  [Expand]DevExpress.XtraVerticalGrid.Events
  [Expand]DevExpress.XtraVerticalGrid.Localization
  [Expand]DevExpress.XtraVerticalGrid.Rows
  [Expand]DevExpress.XtraWaitForm
  [Expand]DevExpress.XtraWizard
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

TileView.ContextButtons Property

Provides access to context buttons, displayed within this TileView's tiles.

Namespace:DevExpress.XtraGrid.Views.Tile
Assembly:DevExpress.XtraGrid.v17.1.dll

Expanded Syntax

Property value

Type: ContextItemCollection
A ContextItemCollection that stores context buttons, displayed within this TileView's tiles.

Expanded Remarks

Tile View allows you to display context buttons for each tile (see the image below). These buttons allow your end-users to rate view items or perform specific operations on them.

Context buttons are stored within the ContextButtons collection. At design-time, you can populate this collection using the Context Buttons editor, invoked when modifying the ContextButtons property in the view's property grid.

This editor contains the preview section, buttons to add or remove context buttons and the property grid to modify individual button properties. The combo-box next to the 'Add' button allows you to choose the type of the added button.

There are three button types available:
  • Context Buttons (ContextButton objects) - simple push buttons that perform specific actions when clicked. With no glyph assigned, can also be used as a label;
  • Context Check Buttons (CheckContextButton objects) - buttons that support checked and unchecked states changed when clicked;
  • Rating Buttons (RatingContextButton objects) - based on the RatingControl, these buttons provide an easy and intuitive way to rate specific items;
Depending on their ContextItem.Alignment property values, context buttons can be displayed at the bottom or top of the item image. For both of these positions, there is a panel displayed on item hover. These panels improve the visual side of the feature, so that context buttons are not drawn right above item images. You can access the ContextButtonOptions property to modify the BottomPanelColor and TopPanelColor properties to manually set panel colors.
Tip

When setting the panel colors, you can use 4-number RGBA values, instead of the standard 3-number RGB mode. In this case, the first number specifies the alpha-channel and affects the panel transparency. For instance, on the figure above, both the top and bottom panels have the 160, 0, 0, 0 colors that are displayed as semi-transparent dark gray stripes.

By default, items are automatically displayed when a view item is hovered (this can be changed by modifying the ContextItem.Visibility property for any individual context button). This is followed by a smooth animation. You are free to choose the desired animation type by setting the AnimationType property to the desired value.

All tiles display the same context buttons with the same settings. However, you can handle the ContextButtonCustomize event to modify individual context buttons for specific data rows.

Clicking any context button raises the ContextButtonClick event regardless of the clicked item's type (regular, check or rating). You can handle this event to check exactly which button has been clicked, and based on this, perform specific actions.

Expanded See Also

How would you rate this topic?​​​​​​​