How to show Multiline Tooltip

Sean Howard

created 9 years ago

Hello,

I would like to use a multi-line tooltip in my .Net project. I have found one reference to this issue in your forums, but the solution is now so old that it will not compile. I can’t imagine that this is a big issue, but none-the-less ask whether it be possible please to show how to display a multi-line tooltip using C# or VB (with a preference for the latter). Such an example would be greatly appreciated.

A loyal and very happy customer,
Sean

Answers

DevExpress Support Team

created 9 years ago

Hi,

To show a multiline text in a tooltip, it is sufficient to insert new line characters to this text.

C#
simpleButton1.SuperTip = new SuperToolTip();  
simpleButton1.SuperTip.Items.Add(new ToolTipItem() { Text = "Line1\r\nLine2\r\nLine3" });  
//or  
simpleButton1.ToolTip = "Line1\r\nLine2\r\nLine3";

For VB.NET, use the Constants.vbNewLine field.

If you need to enable the word wrap feature, it is enabled by default. Is the tooltip text cut off on your side? Please provide us with screenshots to show the current and expected results.

Show previous comments (4)

TSW 5 years ago

Is it possible to do this in the designer? currently if I paste your example below into the ToolTip on myToolTipProvider field of my control, it shows exactly as pasted

C#
Line1\r\nLine2\r\nLine3

Brendon Muck [DevExpress MVP] 5 years ago

The designer already allows you to enter a newline just by pressing the Enter key. You don't need to use the newline/carriage return escape character.

DevExpress Support Team 5 years ago

Hi,

When you add "\r\n" to your tooltip text, VS serializes this text as "\\r\\n". That is why multiple lines are not shown, and these characters are interpreted as regular text.

Brendon is right. You can simply press ENTER to add new lines at design time.

Alternatively, you can add a new line by using HTML tags if you enable the SimpleButton.AllowHtmlTextInToolTip option. Refer to the HTML Text Formatting help topic for more information in this regard.

TSW 5 years ago

The attached image is a screenshot of what I see in the properties window of one of my controls. These fields show up on each control in my view when I drag a ToolTipController onto my view (similar to how error providers work). Super Tips have their own editor where I can easily do what I'm asking, but I'd like to avoid using super tips, as it is more complex than what we need. If I click into the ToolTip on toolTipProvider field and hit enter, it doesn't insert a new line. The textbox loses focus, as if hitting enter was to accept the text I typed and move on to the next field. I have tried hitting shift+enter as well. There is not a dropdown or button appearing on the right side of the box when i hover over it either, as some properties that accept text have. Hopefully I have explained this well enough. I'm finding it very strange and am wondering if perhaps my vs19 settings are preventing it

tooltipExample.png

DevExpress Support Team 5 years ago

Hi,

We are using System.ComponentModel.Design.MultilineStringEditor to edit tooltip text at design time when operating the BaseControl.ToolTip property. In this case, it is necessary to click a combo button to expand a popup window for typing multiline text.

In turn, a default single-line UITypeEditor is used when using attached properties that appear for standard controls when placing ToolTipController onto a form. We are ready to support System.ComponentModel.Design.MultilineStringEditor for this case as well in version 19.2. However, you indicated version 15.2.4 in the current ticket. We do not publish updates for this version any longer. Would you please clarify if you can move to version 19.2?

TSW 5 years ago

We are currently on 19.1. We could move to 19.2 but it will take a lot of testing to make sure you haven't made any changes that impact our implementations of your classes. Is 19.1 still supported by updates? Meaning is it possible to get this functionality without having to upgrade to 19.2 on our end? Thank you!

DevExpress Support Team 5 years ago

Hi,

Yes, we release minor updates for version 19.1. Once we fix this shortcoming, we will include changes in the next minor update - 19.1.9.
I have created a new report (ToolTipController - It is impossible to enter multiline text at design time for the attached ToolTip property) regarding this issue, so that you can track our progress.

Created: January 14, 2016 4:07 PM

Modified: January 9, 2020 11:46 AM

Platform: WinForms

Build: 15.2.4

IDE: Microsoft Visual Studio 2013

Disclaimer: The information provided on DevExpress.com and affiliated web properties (including the DevExpress Support Center) is provided "as is" without warranty of any kind. Developer Express Inc disclaims all warranties, either express or implied, including the warranties of merchantability and fitness for a particular purpose. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.

Confidential Information: Developer Express Inc does not wish to receive, will not act to procure, nor will it solicit, confidential or proprietary materials and information from you through the DevExpress Support Center or its web properties. Any and all materials or information divulged during chats, email communications, online discussions, Support Center tickets, or made available to Developer Express Inc in any manner will be deemed NOT to be confidential by Developer Express Inc. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.

How to show Multiline Tooltip

Answers

Recently viewed tickets