The requested page is not available for the requested platform. You are viewing the content for Default platform.

Hyperlink Column

A hyperlink column allows you to display hyperlinks in the Grid dashboard item. In code, a hyperlink column is a GridHyperlinkColumn class instance.

GridHyperLinkColumn_Example_Web

You can provide hyperlinks as a separate data column or they can be automatically created at run-time from any column using the specified URI pattern.

In this document the sample data source contains four fields: country name, official country name, Wikipedia country page's URI and the GDP value.

GridHyperLinkColumn_UnderlyingDataSource

The following sections describe how to create hyperlink columns in more detail:

Data Field Containing Uri Values

The Grid dashboard item is initially bound to the Name and GDP fields (the dimension and measure columns, respectively).

GridHyperLinkColumn_InitialGrid_Web

Click the Add Column data item placeholder and bind it to the Link field. The Grid automatically processes this column as the dimension column and displays links as a plain text.

GridHyperLinkColumn_HyperlinkAsText_Web

Invoke the column's menu and change its type to Hyperlink. The Grid displays column values as clickable hyperlinks allowing you to navigate to the Wiki's pages.

GridHyperLinkColumn_HyperlinkAsLink_Web

GridHyperLinkColumn_HyperlinkAsLink_Web_Result

You can bind the Display value and URI value to different data fields. Click the Add Column data item placeholder and change its type to Hyperlink.

GridHyperLinkColumn_HyperlinkAsLink_Web_NewColumn

Click the Display Value placeholder and select the OfficialName field to display official names. Click the Uri placeholder and select the Link field to specify URIs.

GridHyperLinkColumn_HyperlinkWithDisplayText_Web

The grid displays official country names with links obtained from the Link data source field.

GridHyperLinkColumn_HyperlinkWithDisplayText_TwoColumns_Result_Web

URI Pattern

In this case, a specified URI pattern is used to generate links. The Grid is bound to the Name and GDP fields in the initial state

GridHyperLinkColumn_InitialGrid_Web

Click the first column (Name) to invoke its menu and change its type to Hyperlink. Specify the URI Pattern option as follows:

https://en.wikipedia.org/wiki/{0}

GridHyperLinkColumn_UriPatternLink_Web

The {0} placeholder is replaced with the Name data item value. The links are generated for country names and displayed in the grid as illustrated in the following picture.

GridHyperLinkColumn_UriPatternDisplayValue