RibbonToggleButton.ToolTipDescription Property

Article
02/04/2013

Gets or sets the descriptive text that is displayed in the ToolTip for this control.

Namespace: Microsoft.Windows.Controls.Ribbon
Assembly: RibbonControlsLibrary (in RibbonControlsLibrary.dll)

Syntax

'Declaration
Public Property ToolTipDescription As String

public string ToolTipDescription { get; set; }

public:
property String^ ToolTipDescription {
    String^ get ();
    void set (String^ value);
}

member ToolTipDescription : string with get, set

function get ToolTipDescription () : String
function set ToolTipDescription (value : String)

Property Value

Type: System.String
The descriptive text to display in the ToolTip. The registered default is nulla null reference (Nothing in Visual Basic). For more information about what can influence the value, see Dependency Property Value Precedence.

Dependency Property Information

Identifier field	ToolTipDescriptionProperty
Metadata properties set to true	None

Remarks

Caution
Each ribbon control inherits a FrameworkElement.ToolTip property. If the FrameworkElement.ToolTip property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead.

Examples

The following example shows the markup used to create the enhanced ToolTip.

Enhanced ToolTip

<ribbon:RibbonToggleButton Label="Ribbon Control"
                SmallImageSource="Images/Lightbulb16.png" 
                LargeImageSource="Images/Lightbulb32.png"
                KeyTip="N"
                ToolTipTitle="Command Name (Ctrl+N)" 
                ToolTipDescription="All ribbon commands should have enhanced tooltips to give the command name, shortcut key, description, and optional supplemental information."
                ToolTipImageSource="Images/Suggestion32.png"
                ToolTipFooterTitle="Press F1 for Help" 
                ToolTipFooterDescription="When practical, completely describe the command using a concise description. Link to Help only if further explanation is really necessary."
                ToolTipFooterImageSource="Images/Help16.png" />

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.