Skip to content

HoverPanel

HoverPanel is the base hover popup used throughout this library's help/tooltip family — HoverLabel, HoverPicture, and (through HoverPicture) HoverHelp all attach one of these panels to their trigger element via the AJAX Control Toolkit's HoverMenuExtender. It renders arbitrary, unencoded content text in an always-hidden, high-Z-INDEX panel that the toolkit reveals on hover. (BR-AJAX-014, BR-AJAX-015)

Purpose

  • Builds a styled popup panel and wires a HoverMenuExtender so it appears when the caller-supplied TargetControlId is hovered. (BR-AJAX-014)
  • Renders ContentText directly into the panel's content cell without HTML encoding, allowing callers to embed markup in help/tooltip content. (BR-AJAX-015)
  • Renders nothing at all when there is no content to show, avoiding empty popups. (BR-AJAX-016)

Context

  • Namespace: SAIF.Presentation.Web.Controls.V2.AJAX
  • Assembly/package: SAIF.Presentation.Web.Controls.AJAX.Infragistics111 (packaged in SAIF.BOF.Presentation.Web.Infragistics111)
  • Base class: SAIFAJAXControlAncestor

Public members

Member Signature Purpose
ContentText Property ContentText As String Raw markup/text rendered unencoded into the panel; empty suppresses all rendering (BR-AJAX-015, BR-AJAX-016)
TargetControlId Property TargetControlId As String ID of the element that triggers this panel via the toolkit's HoverMenuExtender
PopupPosition Property PopupPosition As AjaxControlToolkit.HoverMenuPopupPosition (default Bottom) Where the popup appears relative to the trigger
PanelWidth Property PanelWidth As Unit (default 300) Fixed width of the popup panel

Inherited public members

Members in this section are inherited from SAIFAJAXControlAncestor in SAIF.Presentation.Web.Controls.AJAX.Infragistics111. They are available on this type through inheritance.

Member Signature Purpose Origin
RootObject ReadOnly Property RootObject As Object The hosting page's Model property value SAIF.Presentation.Web.Controls.AJAX.Infragistics111 — SAIFAJAXControlAncestor
IsFirefox ReadOnly Property IsFirefox As Boolean Browser-capability test for the current request SAIF.Presentation.Web.Controls.AJAX.Infragistics111 — SAIFAJAXControlAncestor

Behavioral notes

  • The rendered popup uses Display: None plus Z-INDEX: 99999999, so it is always the topmost element on the page whenever the toolkit reveals it. (BR-AJAX-014)
  • Because ContentText is assigned to TableCell.Text directly rather than HTML-encoded, callers must ensure the text is trusted or pre-encoded; untrusted content is a cross-site-scripting exposure. (BR-AJAX-015)

Constraints and usage notes

  • Requires the AJAX Control Toolkit (AjaxControlToolkit.dll) at runtime for HoverMenuExtender/HoverMenuPopupPosition.
  • TargetControlId must reference a real control ID on the same page; the toolkit extender is otherwise inert.

Sources

  • SAIF.Presentation.Web.Controls.AJAX.Infragistics111/HoverPanel.vb