Skip to content

SAIFAlphaNumericLinkControl

SAIFAlphaNumericLinkControl generates a row of 27 SAIFLinkButton link controls (A–Z plus a combined "0-9" numeric link), commonly used as an alphabetical index/jump bar above a list or grid.

Purpose

  • Provide a ready-made alphabet index bar so consuming pages do not need to hand-build 27 link controls and their click wiring.
  • Surface a single unified click event (LinkClicked) identifying which letter/number range was clicked, regardless of which of the 27 generated links triggered it.

Context

  • Namespace: SAIF.Presentation.Web.Controls.V2
  • Assembly/package: Compiled into SAIF.BOF.Presentation.Web.Infragistics103*

Public members

Member Signature Purpose
LinkClicked Public Event LinkClicked(Value As AlphaNumericCharacter) Raised when any generated letter/number link is clicked, passing the corresponding AlphaNumericCharacter value so host pages can filter their data accordingly.

Inherited public members

SAIFAlphaNumericLinkControl inherits from WebControl (System.Web.UI.WebControls), a framework base class rather than a documented SAIF dependency library.

Member Signature Purpose
AccessKey Public Property AccessKey As String Keyboard shortcut character used to move focus to the rendered link-bar container.
Attributes Public ReadOnly Property Attributes As AttributeCollection Collection of arbitrary HTML attributes rendered on the control's outer tag.
BackColor Public Property BackColor As Color Background color applied to the rendered outer element.
ForeColor Public Property ForeColor As Color Foreground (text) color applied to the rendered outer element.
BorderColor Public Property BorderColor As Color Border color applied to the rendered outer element.
BorderStyle Public Property BorderStyle As BorderStyle Border line style applied to the rendered outer element.
BorderWidth Public Property BorderWidth As Unit Border width applied to the rendered outer element.
CssClass Public Property CssClass As String CSS class name(s) rendered on the control's outer tag.
Enabled Public Property Enabled As Boolean Controls whether the generated link controls participate in enabled-state behavior.
Font Public ReadOnly Property Font As FontInfo Font styling applied to the rendered outer element.
Height Public Property Height As Unit Height of the rendered outer element.
Width Public Property Width As Unit Width of the rendered outer element.
Style Public ReadOnly Property Style As CssStyleCollection Inline CSS style declarations rendered on the outer tag.
ToolTip Public Property ToolTip As String Text shown as a native tooltip when hovering the rendered element.

Standard WebControl/Control members (ID, ClientID, Controls, Visible, DataBind, FindControl, etc.) are not re-documented here as they are unmodified framework behavior**.

Behavioral notes

  • CreateChildControls generates 26 SAIFLinkButton controls (A–Z, mapped from character codes 65–90) plus one additional link labeled "0-9" with Value = AlphaNumericCharacter.Number.
  • Each generated link's Click event is wired to a private handler that re-raises the public LinkClicked event with the clicked link's Value.

Constraints and usage notes

  • All 27 links post back individually; consuming pages must handle LinkClicked to filter or navigate based on the received AlphaNumericCharacter.

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources

  • SAIF.Presentation.Web.Controls.V2\SAIFAlphaNumericLinkControl.vb