New to Telerik UI for WinForms? Download free 30-day trial

Wrapping Text in RadMenu and RadDropDownButton Items in WinForms

Environment

Product Version Product Author
2024.3.924 RadDropDownButton for WinForms Hristo Krastev

Description

When using a RadMenu or a RadDropDownButton in Telerik UI for WinForms, you might have items with long text that doesn't fit comfortably within the viewable area. This article demonstrates how to wrap such text to ensure it's completely visible.

This KB article also answers the following questions:

  • How to use text wrapping for menu items in WinForms applications?
  • How to ensure long text is visible in RadMenu items?

Solution

To wrap the text of a RadMenuItem, access the TextPrimitive object responsible for painting the text. Then set its MaxSize and TextWrap properties to enable text wrapping.

// Create or access the RadMenuItem
RadMenuItem menuItem = (RadMenuItem)this.radDropDownButton1.Items[0];

// Set the maximum size for the text area and enable text wrapping
menuItem.Layout.Text.MaxSize = new Size(240, 0);
menuItem.Layout.Text.TextWrap = true;

// Set the long text to be wrapped
menuItem.Text = "START Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua." +
    " Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat." +
    " Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.Excepteur sint occaecat cupidatat non proident,";

menuitem-text-wrap

Adjust the MaxSize property according to your requirements to ensure the text fits well within the available space.

See Also

In this article