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
HoverMenuExtenderso it appears when the caller-suppliedTargetControlIdis hovered. (BR-AJAX-014) - Renders
ContentTextdirectly 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 inSAIF.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: NoneplusZ-INDEX: 99999999, so it is always the topmost element on the page whenever the toolkit reveals it. (BR-AJAX-014) - Because
ContentTextis assigned toTableCell.Textdirectly 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 forHoverMenuExtender/HoverMenuPopupPosition. TargetControlIdmust reference a real control ID on the same page; the toolkit extender is otherwise inert.
Related documentation¶
Sources¶
SAIF.Presentation.Web.Controls.AJAX.Infragistics111/HoverPanel.vb