Back to Devexpress

XRControl.HtmlItemCreated Event

xtrareports-devexpress-dot-xtrareports-dot-ui-dot-xrcontrol-544f75a1.md

latest4.1 KB
Original Source

XRControl.HtmlItemCreated Event

Occurs when a new item used for a Web representation of the control is created.

Namespace : DevExpress.XtraReports.UI

Assembly : DevExpress.XtraReports.v25.2.dll

NuGet Package : DevExpress.Reporting.Core

Declaration

csharp
public virtual event HtmlEventHandler HtmlItemCreated
vb
Public Overridable Event HtmlItemCreated As HtmlEventHandler

Event Data

The HtmlItemCreated event's data class is HtmlEventArgs. The following properties provide information specific to this event:

PropertyDescription
BrickGets a visual brick that represents the content of the currently processed item on a report page.
ContentCellGets the content of the currently processed item.
ScriptContainerGets an object that implements the IScriptContainer interface and is used for registering the scripts and styles in the current HTML document.

Remarks

This event is used for creating a customized view of controls on a Web page.

Example

The following example demonstrates how to use the XRControl.HtmlItemCreated event to customize the content of an XRLabel control, when a report is exported to HTML. In the event handler, create two custom HTML elements, which will display a check box and a hyperlink on a Web page, and add them to the control’s content using the HtmlEventArgs.ContentCell property of the event parameter.

Follow the steps below to create a sample project.

  1. Start Visual Studio and create a new Windows Forms Application or open an existing one.
  2. Add a new report (named XtraReport1 ) to the application.
  3. Drop an XRLabel control onto a report and handle its HtmlItemCreated event as follows.

Then, to export a report to HTML, you can use code similar to the following.

csharp
using System;
using System.Windows.Forms;
using System.Diagnostics;
// ...

private void ExportToHTML() {
    XtraReport1 report = new XtraReport1();
    report.ExportToHtml("Test.html");
    StartProcess("Test.html");
}

public void StartProcess(string path) {
    Process process = new Process();
    try {
        process.StartInfo.FileName = path;
        process.Start();
        process.WaitForInputIdle();
    }
    catch { }
}
vb
Imports System
Imports System.Windows.Forms
Imports System.Diagnostics
' ...

Private Sub ExportToHTML()
    Dim report As New XtraReport1()
    report.ExportToHtml("Test.html")
    StartProcess("Test.html")
End Sub

Public Sub StartProcess(ByVal path As String)
    Dim process As New Process()
    Try
        process.StartInfo.FileName = path
        process.Start()
        process.WaitForInputIdle()
    Catch
    End Try
End Sub

See Also

XRControl Class

XRControl Members

DevExpress.XtraReports.UI Namespace