Back to Devexpress

RibbonControl.ShowMessage(RibbonMessageArgs) Method

windowsforms-devexpress-dot-xtrabars-dot-ribbon-dot-ribboncontrol-dot-showmessage-x28-devexpress-dot-xtrabars-dot-ribbon-dot-ribbonmessageargs-x29.md

latest4.0 KB
Original Source

RibbonControl.ShowMessage(RibbonMessageArgs) Method

Displays a message with the specified settings in the message bar.

Namespace : DevExpress.XtraBars.Ribbon

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
public void ShowMessage(
    RibbonMessageArgs args
)
vb
Public Sub ShowMessage(
    args As RibbonMessageArgs
)

Parameters

NameTypeDescription
argsRibbonMessageArgs

An object with message settings.

|

Remarks

The ShowMessage method creates a message, adds it to the Messages collection, and displays it in the message bar.

Read the following topic for information: Ribbon Message.

Example

csharp
using DevExpress.XtraBars.Ribbon;

void ShowMessage() {
    RibbonMessageArgs args = new RibbonMessageArgs();
    args.Caption = "What's New";
    args.Text = "Explore our new WinForms-related features we expect to introduce in our first major update this year (v23.1).";
    args.Icon = MessageBoxIcon.Information;
    args.Buttons = new DialogResult[] { DialogResult.OK };
    args.Showing += Args_Showing;
    Ribbon.ShowMessage(args);
    Ribbon.MessageClosed += Ribbon_MessageClosed;
}
void Ribbon_MessageClosed(object sender, RibbonMessageClosedArgs e) {
    if(e.Result == DialogResult.OK)
        DevExpress.Data.Utils.SafeProcess.Start("https://community.devexpress.com/blogs/winforms/archive/2023/02/16/devexpress-winforms-roadmap-23-1.aspx");
}
void Args_Showing(object sender, RibbonMessageShowingArgs e) {
    e.Buttons[DialogResult.OK].Caption = "Explore Roadmap";
}
vb
Imports DevExpress.XtraBars.Ribbon

Private Sub ShowMessage()
    Dim args As New RibbonMessageArgs()
    args.Caption = "What's New"
    args.Text = "Explore our new WinForms-related features we expect to introduce in our first major update this year (v23.1)."
    args.Icon = MessageBoxIcon.Information
    args.Buttons = New DialogResult() { DialogResult.OK }
    AddHandler args.Showing, AddressOf Args_Showing
    Ribbon.ShowMessage(args)
    AddHandler Ribbon.MessageClosed, AddressOf Ribbon_MessageClosed
End Sub
Private Sub Ribbon_MessageClosed(ByVal sender As Object, ByVal e As RibbonMessageClosedArgs)
    If e.Result = DialogResult.OK Then
        DevExpress.Data.Utils.SafeProcess.Start("https://community.devexpress.com/blogs/winforms/archive/2023/02/16/devexpress-winforms-roadmap-23-1.aspx")
    End If
End Sub
Private Sub Args_Showing(ByVal sender As Object, ByVal e As RibbonMessageShowingArgs)
    e.Buttons(DialogResult.OK).Caption = "Explore Roadmap"
End Sub

The following image shows the result:

See Also

CloseMessage

Messages

RibbonControl Class

RibbonControl Members

DevExpress.XtraBars.Ribbon Namespace