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.Extensions.UI
  [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
  [Collapse]DevExpress.XtraBars.Ribbon
   [Expand]ApplicationMenu Class
   [Expand]AppMenuFileLabel Class
   [Expand]BackstageViewButtonItem Class
   [Expand]BackstageViewClientControl Class
   [Expand]BackstageViewControl Class
   [Expand]BackstageViewControlItemCollecton Class
   [Expand]BackstageViewItem Class
   [Expand]BackstageViewItemBase Class
   [Expand]BackstageViewItemEventArgs Class
    BackstageViewItemEventHandler Delegate
   [Expand]BackstageViewItemSeparator Class
    BackstageViewShowRibbonItems Enumeration
   [Expand]BackstageViewTabItem Class
   [Expand]GalleryControl Class
   [Expand]GalleryDropDown Class
   [Expand]GalleryFilterMenuClickEventArgs Class
   [Expand]GalleryFilterMenuEventArgs Class
   [Expand]GalleryItem Class
   [Expand]GalleryItemClickEventArgs Class
    GalleryItemClickEventHandler Delegate
   [Expand]GalleryItemCollection Class
   [Expand]GalleryItemCustomDrawEventArgs Class
    GalleryItemCustomDrawEventHandler Delegate
   [Expand]GalleryItemEventArgs Class
   [Expand]GalleryItemGroup Class
    GalleryItemGroupCaptionAlignment Enumeration
   [Expand]GalleryItemGroupCollection Class
    GallerySizeMode Enumeration
   [Expand]ImageGalleryFilterMenu Class
    ItemImageLocation Enumeration
   [Expand]RadialMenu Class
   [Expand]RecentButtonItem Class
   [Expand]RecentControlContainerItem Class
   [Expand]RecentHyperlinkItem Class
   [Expand]RecentItemBase Class
   [Expand]RecentItemControl Class
   [Expand]RecentItemEventArgs Class
   [Expand]RecentLabelItem Class
   [Expand]RecentPanelBase Class
   [Collapse]RecentPinItem Class
     RecentPinItem Members
     RecentPinItem Constructor
    [Expand]RecentPinItem Properties
    [Expand]RecentPinItem Events
   [Expand]RecentSeparatorItem Class
   [Expand]RecentStackPanel Class
   [Expand]RecentTabItem Class
   [Expand]RecentTextGlyphItemBase Class
   [Expand]RibbonBarItems Class
   [Expand]RibbonControl Class
    RibbonControlColorScheme Enumeration
    RibbonControlStyle Enumeration
   [Expand]RibbonForm Class
    RibbonItemStyles Enumeration
    RibbonMdiMergeStyle Enumeration
   [Expand]RibbonMiniToolbar Class
   [Expand]RibbonMiniToolbarCollection Class
   [Expand]RibbonMiniToolbarOpacityOptions Class
   [Expand]RibbonOptionsTouch Class
   [Expand]RibbonPage Class
   [Expand]RibbonPageCategory Class
    RibbonPageCategoryAlignment Enumeration
   [Expand]RibbonPageCategoryCollection Class
   [Expand]RibbonPageCollection Class
   [Expand]RibbonPageGroup Class
   [Expand]RibbonPageGroupCollection Class
   [Expand]RibbonPageGroupEventArgs Class
    RibbonPageGroupEventHandler Delegate
    RibbonPageGroupItemsLayout Enumeration
   [Expand]RibbonQuickAccessToolbar Class
    RibbonQuickAccessToolbarLocation Enumeration
   [Expand]RibbonStatusBar Class
    ShowPageHeadersMode Enumeration
  [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
  [Expand]DevExpress.XtraGrid.Views.Tile
  [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]ASP.NET Core 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]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

RecentPinItem Class

A pin item within the Recent Item Control.

Namespace:DevExpress.XtraBars.Ribbon
Assembly:DevExpress.XtraBars.v17.2.dll

Expanded Syntax

Expanded Remarks

RecentPinItems are objects capable of displaying two text strings (the RecentTextGlyphItemBase.Caption and Description properties) and an image (see the following figure).

Depending on the PinButtonVisibility property value, these items can display pin buttons. Clicking these buttons at runtime raises the PinButtonCheckedChanged event and toggles the boolean PinButtonChecked property value. Handle this event to implement the desired functionality, invoked on pinning or unpinning an item.

In order to implement your own pin item functionality, you first need to disable the default behavior by setting the RecentPanelBase.MovePinnedItemsUp property to false. The default behavior emulates the related behavior seen in Microsoft Office applications. The pinned pin item seeks the first element, and moves up until it meets the first item that is not another pin item or a separator. The automatically added separator detaches these pinned elements from regular pin items.

See the Recent Item Control topic to learn more about pin items, as well as other elements provided by the RecentItemControl.

Expanded Inheritance Hierarchy

System.Object
    System.MarshalByRefObject
       System.ComponentModel.Component
          RecentItemBase
             RecentTextGlyphItemBase
                RecentPinItem

Expanded See Also

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