AlertControl.RaiseHtmlElementClick(String, AlertHtmlPopup) Method

Emulates user click on the given HTML element.

Namespace: DevExpress.XtraBars.Alerter

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

public void RaiseHtmlElementClick(
    string elementId,
    AlertHtmlPopup popup
)

VB.NET

Public Sub RaiseHtmlElementClick(
    elementId As String,
    popup As AlertHtmlPopup
)

Parameters

Name	Type	Description
elementId	String	The ID of an element whose click event should be raised.
popup	DevExpress.XtraBars.Alerter.AlertHtmlPopup	The alert that owns the element with the given ID.

Remarks

The following code shows three alerts that use the same HTML template, but retrieve data from different data objects:

<!-- ... -->
<div class="captionText">${Title}</div>
<div class="subText">${Subtitle}</div>
<div class="regularText">${MessageText}</div>
<div id="okButton" class="ok-button">OK</div>
<!-- ... -->

C#

AlertData aData1 = new AlertData("Notification", "Subtitle string", "Alert #1");
AlertData aData2 = new AlertData("Notification", "Subtitle string", "Alert #2");
AlertData aData3 = new AlertData("Notification", "Subtitle string", "Alert #3");
alertControl1.Show(aData1, this);
alertControl1.Show(aData2, this);
alertControl1.Show(aData3, this);

// Data for alerts
public class AlertData {

    public AlertData(string title, string subtitle, string messageText) {
        Title = title;
        Subtitle = subtitle;
        MessageText = messageText;
    }

    public string Title { get; set; }
    public string Subtitle { get; set; }
    public string MessageText { get; set; }
}

VB.NET

Dim aData1 As New AlertData("Notification", "Subtitle string", "Alert #1")
Dim aData2 As New AlertData("Notification", "Subtitle string", "Alert #2")
Dim aData3 As New AlertData("Notification", "Subtitle string", "Alert #3")
alertControl1.Show(aData1, Me)
alertControl1.Show(aData2, Me)
alertControl1.Show(aData3, Me)

' Data for alerts
Public Class AlertData

    Public Sub New(ByVal title As String, ByVal subtitle As String, ByVal messageText As String)
        Me.Title = title
        Me.Subtitle = subtitle
        Me.MessageText = messageText
    End Sub

    Public Property Title() As String
    Public Property Subtitle() As String
    Public Property MessageText() As String
End Class

To trigger an onClick function associated with an element of a specific notification, you need to call the RaiseHtmlElementClick method with two parameters:

• The unique element ID, which is set in the HTML markup.
• The specific alert instance. All active HTML-designed alerts are stored in the HtmlPopupList collection. You can browse it to find the required notification.

The code below finds the notification that has "#2" in its "MessageText" string, and emulates user clicking the OK button of this notification.

C#

AlertHtmlPopup target = alertControl1.HtmlPopupList.Find(x =>
    (x.DataContext as AlertData).MessageText.Contains("#2"));
alertControl1.RaiseHtmlElementClick("okButton", target);

VB.NET

Dim target As AlertHtmlPopup = alertControl1.HtmlPopupList.Find(Function(x) (TryCast(x.DataContext, AlertData)).MessageText.Contains("#2"))
alertControl1.RaiseHtmlElementClick("okButton", target)