windowsforms-devexpress-dot-xtrabars-dot-ribbon-f1898bce.md
The control designed to build a complex content for BackstageViewTabItem objects.
Namespace : DevExpress.XtraBars.Ribbon
Assembly : DevExpress.XtraBars.v25.2.dll
NuGet Package : DevExpress.Win.Navigation
[DXLicenseWinForms]
public class RecentItemControl :
BaseStyleControl,
IXtraAnimationListener,
ISupportXtraAnimation,
ISupportInitialize,
IMouseWheelSupport,
IGestureClient,
IKeyboardSelectionClient
<DXLicenseWinForms>
Public Class RecentItemControl
Inherits BaseStyleControl
Implements IXtraAnimationListener,
ISupportXtraAnimation,
ISupportInitialize,
IMouseWheelSupport,
IGestureClient,
IKeyboardSelectionClient
The following members return RecentItemControl objects:
The Recent Item Control is a stand-alone component that extends the BackstageViewControl control’s capabilities (see the figure below). It features a large variety of UI elements (buttons, pin items, hyperlinks etc.) that when mixed together, allow you to easily emulate content of any complexity.
The component provides its own tabs, which expand the specific content to their right. Coupled with the BackstageViewControl’s tabs, this means you can emulate multi-level main menus, similar to most modern Microsoft Office apps. Refer to the Recent Item Control link to learn more.
This code sample illustrates how to initialize and populate a sample RecentItemControl in code.
DevExpress.XtraBars.Ribbon.RecentItemControl recentItemControl = new DevExpress.XtraBars.Ribbon.RecentItemControl();
recentItemControl.BorderStyle = DevExpress.XtraEditors.Controls.BorderStyles.NoBorder; //to hide border
recentItemControl.Dock = System.Windows.Forms.DockStyle.Fill;
recentItemControl.Name = "recentItemControl";
recentItemControl.Title = "RecentControl Main Title";
//create the mandatory right panel for tab items' content
DevExpress.XtraBars.Ribbon.RecentStackPanel recentStackPanelRight = new DevExpress.XtraBars.Ribbon.RecentStackPanel();
recentStackPanelRight.Name = "recentStackPanelRight";
recentStackPanelRight.SelectedItem = null;
recentItemControl.DefaultContentPanel = recentStackPanelRight;
SimpleButton simpleButton = new SimpleButton();
simpleButton.Dock = System.Windows.Forms.DockStyle.Fill;
simpleButton.Name = "simpleButton";
simpleButton.Text = "Simple Button";
//should be added to the RecentItemControl.Controls collection
DevExpress.XtraBars.Ribbon.RecentControlItemControlContainer recentControlItemControlContainer = new DevExpress.XtraBars.Ribbon.RecentControlItemControlContainer();
recentControlItemControlContainer.Controls.Add(simpleButton);
recentControlItemControlContainer.Name = "recentControlItemControlContainer";
recentControlItemControlContainer.Size = new System.Drawing.Size(267, 40);
recentItemControl.Controls.Add(recentControlItemControlContainer);
//create container item, should have a parent RecentControlItemControlContainer
DevExpress.XtraBars.Ribbon.RecentControlContainerItem recentControlContainerItem = new DevExpress.XtraBars.Ribbon.RecentControlContainerItem();
recentControlContainerItem.ClientHeight = 40;
recentControlContainerItem.ControlContainer = recentControlItemControlContainer;
recentControlContainerItem.Name = "recentControlContainerItem";
DevExpress.XtraBars.Ribbon.RecentLabelItem recentLabelItem = new DevExpress.XtraBars.Ribbon.RecentLabelItem();
recentLabelItem.Caption = "RecentControl Label";
recentLabelItem.Name = "recentLabelItem";
//create the right panel for the tab item
DevExpress.XtraBars.Ribbon.RecentStackPanel recentStackPanell = new DevExpress.XtraBars.Ribbon.RecentStackPanel();
recentStackPanell.Caption = "RecentControl Stack Panel";
//add items to the right panel
recentStackPanell.Items.AddRange(new DevExpress.XtraBars.Ribbon.RecentItemBase[] {
recentLabelItem});
recentStackPanell.Name = "recentStackPanell";
recentStackPanell.SelectedItem = null;
//the element of the main panel
DevExpress.XtraBars.Ribbon.RecentTabItem recentTabItem1 = new DevExpress.XtraBars.Ribbon.RecentTabItem();
recentTabItem1.Caption = "RecentControl Tab Item";
recentTabItem1.Name = "recentTabIteml";
recentTabItem1.TabPanel = recentStackPanell;
//create the mandatory main panel
DevExpress.XtraBars.Ribbon.RecentStackPanel recentStackPanelMain = new DevExpress.XtraBars.Ribbon.RecentStackPanel();
//add elements to the main panel
recentStackPanelMain.Items.AddRange(new DevExpress.XtraBars.Ribbon.RecentItemBase[] {
recentTabItem1,
recentControlContainerItem
});
recentStackPanelMain.Name = "mainPanel1";
recentStackPanelMain.SelectedItem = recentTabItem1;
recentItemControl.MainPanel = recentStackPanelMain;
Dim recentItemControl As New DevExpress.XtraBars.Ribbon.RecentItemControl()
recentItemControl.BorderStyle = DevExpress.XtraEditors.Controls.BorderStyles.NoBorder 'to hide border
recentItemControl.Dock = System.Windows.Forms.DockStyle.Fill
recentItemControl.Name = "recentItemControl"
recentItemControl.Title = "RecentControl Main Title"
'create the mandatory right panel for tab items' content
Dim recentStackPanelRight As New DevExpress.XtraBars.Ribbon.RecentStackPanel()
recentStackPanelRight.Name = "recentStackPanelRight"
recentStackPanelRight.SelectedItem = Nothing
recentItemControl.DefaultContentPanel = recentStackPanelRight
Dim simpleButton As New SimpleButton()
simpleButton.Dock = System.Windows.Forms.DockStyle.Fill
simpleButton.Name = "simpleButton"
simpleButton.Text = "Simple Button"
'should be added to the RecentItemControl.Controls collection
Dim recentControlItemControlContainer As New DevExpress.XtraBars.Ribbon.RecentControlItemControlContainer()
recentControlItemControlContainer.Controls.Add(simpleButton)
recentControlItemControlContainer.Name = "recentControlItemControlContainer"
recentControlItemControlContainer.Size = New System.Drawing.Size(267, 40)
recentItemControl.Controls.Add(recentControlItemControlContainer)
'create container item, should have a parent RecentControlItemControlContainer
Dim recentControlContainerItem As New DevExpress.XtraBars.Ribbon.RecentControlContainerItem()
recentControlContainerItem.ClientHeight = 40
recentControlContainerItem.ControlContainer = recentControlItemControlContainer
recentControlContainerItem.Name = "recentControlContainerItem"
Dim recentLabelItem As New DevExpress.XtraBars.Ribbon.RecentLabelItem()
recentLabelItem.Caption = "RecentControl Label"
recentLabelItem.Name = "recentLabelItem"
'create the right panel for the tab item
Dim recentStackPanell As New DevExpress.XtraBars.Ribbon.RecentStackPanel()
recentStackPanell.Caption = "RecentControl Stack Panel"
'add items to the right panel
recentStackPanell.Items.AddRange(New DevExpress.XtraBars.Ribbon.RecentItemBase() { recentLabelItem})
recentStackPanell.Name = "recentStackPanell"
recentStackPanell.SelectedItem = Nothing
'the element of the main panel
Dim recentTabItem1 As New DevExpress.XtraBars.Ribbon.RecentTabItem()
recentTabItem1.Caption = "RecentControl Tab Item"
recentTabItem1.Name = "recentTabIteml"
recentTabItem1.TabPanel = recentStackPanell
'create the mandatory main panel
Dim recentStackPanelMain As New DevExpress.XtraBars.Ribbon.RecentStackPanel()
'add elements to the main panel
recentStackPanelMain.Items.AddRange(New DevExpress.XtraBars.Ribbon.RecentItemBase() { recentTabItem1, recentControlContainerItem })
recentStackPanelMain.Name = "mainPanel1"
recentStackPanelMain.SelectedItem = recentTabItem1
recentItemControl.MainPanel = recentStackPanelMain
Object MarshalByRefObject Component Control DevExpress.XtraEditors.XtraControl ControlBase BaseControl BaseStyleControl RecentItemControl
See Also