[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Collapse]Rich Text Editor
   [Expand]Product Information
    Product Class Structure
    Supported Formats
   [Collapse]Getting Started
     How to: Create a Simple Word Processor with a Bar UI
     How to: Create a Simple Word Processor with a Ribbon UI
     How to: Use the Template Gallery to Create a Simple Word Processor
   [Expand]RichEditControl Document
    Text Formatting
    Import and Export
   [Expand]Page Layout
    Spell Checking
    Mail Merge
    Restrictions and Protection
    Syntax Highlighting
   [Expand]Visual Elements
    Keyboard Shortcuts
    HTML Tag Support
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[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]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

How to: Create a Simple Word Processor with a Bar UI

This tutorial describes how to create an MS Office-inspired word processing application with the bar user interface.

  1. In Visual Studio menu, click FILE | New | Project... In the invoked New Project dialog, select Windows Forms Application, specify the project name and location, and click OK.

  2. Drop the RichEditControl item from the DX.18.2: Rich Text Editor toolbox tab onto the form.

  3. Click the RichEditControl's smart tag and select Dock in Parent Container in the invoked RichEditControl Tasks menu to stretch the control to fill the parent form.

  4. Click the RichEditControl's smart tag once again, and select Create BarManager in the invoked menu to add a BarManager to the form.

  5. Select Create All Bars in the RichEditControl Tasks menu to add all available bar groups at once (or click the required item(s) to add a particular bar group(s) to the form).

    Note that you can convert traditional bars and menus to the modern ribbon interface at any time by clicking the BarManager's smart tag and selecting Convert to Ribbon.

  6. You can also generate a BarManager at runtime. The code sample below creates all available bar groups. Paste this code to the form constructor or to the Load event handler.


    The bar items are generated with vector icons by default. Set the WindowsFormsSettings.AllowDefaultSvgImages property to DefaultBoolean.False on application startup to switch to the bitmap icons.

  7. A simple word processing application is now ready. Run it and view the result. For example, type and format text, insert pictures and explore the various toolbar buttons.

You can disable or hide any command button. Specify restriction settings for a RichEditControl by setting the required properties of the RichEditBehaviorOptions (RichEditControl.Options.Behavior) and DocumentCapabilitiesOptions (RichEditControl.Options.DocumentCapabilities) objects to the DocumentCapability value to solve the task.


Commands executed using the Bar (Ribbon) user interface can throw unhandled exceptions if a problem occurs. Consider the situation when a document is being saved to a locked or read-only file. To prevent application failure, subscribe to the RichEditControl.UnhandledException event and set the RichEditUnhandledExceptionEventArgs.Handled property to true.

For more examples on how to work with the Rich Text Editor, refer to the Examples section.

Expanded See Also

Is this topic helpful?​​​​​​​