RecentItemControl Class
The control designed to build a complex content for BackstageViewTabItem objects.
Namespace: DevExpress.XtraBars.Ribbon
Assembly: DevExpress.XtraBars.v18.1.dll
Declaration
[ToolboxTabName("DX.18.1: Navigation & Layout")]
[ToolboxBitmap(typeof(ToolboxIconsRootNS), "RecentItemControl")]
public class RecentItemControl :
BaseStyleControl,
IXtraAnimationListener,
ISupportXtraAnimation,
ISupportInitialize,
IMouseWheelSupport,
IGestureClientRelated API Members
The following members accept/return RecentItemControl objects:
Remarks
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.
Example
This code sample illustrates how to initialize and populate a sample RecentItemControl in code. You can view and download this example from GitHub.
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;
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the RecentItemControl class.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.