Skip to main content
All docs
V24.1

StepProgressBar.ItemHyperlinkClick Event

Occurs when users click on the step progress bar item’s hyperlink.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

public event StepProgressBarItemHyperlinkClickEventHandler ItemHyperlinkClick

Event Data

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

Property Description
IsCaption Gets if the hyperlink is displayed in the content block’s caption (Caption).
IsDescription Gets if the hyperlink is displayed in the content block’s description (Description).
Item Specifies the item that contains the hyperlink.
ItemContentBlock Gets the clicked hyperlink’s content block.
Link Get or sets the URL of the clicked hyperlink. Inherited from HyperlinkClickEventArgs.
MouseArgs Gets or sets mouse coordinates calculated from the toolbar’s upper left corner. Inherited from HyperlinkClickEventArgs.
Text Gets or sets the hyperlink alt text. Note that modifying this text does not change the item caption. Inherited from HyperlinkClickEventArgs.

Remarks

You can display a hyperlink in a step progress bar item’s content block. To do this, set the AllowHtmlText property to True and then add the HTML <href> or <a> tags in the content block’s Caption or Description properties.

The clicked link does not automatically open in the browser. Handle the ItemHyperlinkClick event to perform actions when users click on a hyperlink.

Example

The code below adds a hyperlink to an item, and handles the ItemHyperlinkClick event to open the link in the browser when it is clicked.

  public Form1() {
    InitializeComponent();
    stepProgressBar1.AllowHtmlText = DevExpress.Utils.DefaultBoolean.True;
    spBarItem1.ContentBlock2.Description = "<href=www.devexpress.com>Go to web-site</href>";
  }

  private void stepProgressBar1_ItemHyperlinkClick(object sender, StepProgressBarItemHyperlinkClickEventArgs ea) {
    System.Diagnostics.Process.Start(ea.Link);
  }
See Also