Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

StepProgressBar.ItemHyperlinkClick Event

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

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.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