HoverHelp¶
HoverHelp is the help-specific specialization of HoverPicture: it defaults to a bundled help icon (/Resources/Images/DefaultHelpImage.gif) and adds a Fill(clsHelpText) overload that lets callers populate the popup directly from a clsHelpText business object retrieved from the APPLICATION_HELP_* tables, rather than passing raw text. (BR-AJAX-043)
Purpose¶
- Defaults its trigger image to a bundled help icon so pages get a consistent help affordance without configuring an image per instance. (BR-AJAX-043)
- Adds
Fill(clsHelpText)so the popup can be populated directly from a retrieved help-text business object, connecting this UI control to theAPPLICATION_HELP_MASTER/APPLICATION_HELP_DETAILdata model. (BR-AJAX-020)
Context¶
- Namespace:
SAIF.Presentation.Web.Controls.V2.AJAX - Assembly/package:
SAIF.Presentation.Web.Controls.AJAX.Infragistics111(packaged inSAIF.BOF.Presentation.Web.Infragistics111) - Base class: HoverPicture
Public members¶
| Member | Signature | Purpose |
|---|---|---|
Fill |
Overloads Sub Fill(inHelpObject As clsHelpText) |
Assigns ContentText = inHelpObject.HelpText; ignores a Nothing argument, leaving existing content unchanged (BR-AJAX-020) |
Inherited public members¶
Members in this section are inherited from HoverPicture in SAIF.Presentation.Web.Controls.AJAX.Infragistics111. They are available on this type through inheritance.
| Member | Signature | Purpose | Origin |
|---|---|---|---|
ControlImageURL |
Property ControlImageURL As String (default /Resources/Images/DefaultHelpImage.gif) |
URL of the image rendered as the hover trigger | SAIF.Presentation.Web.Controls.AJAX.Infragistics111 — HoverPicture |
ContentPanelWidth |
Property ContentPanelWidth As Unit |
Width applied to the composed HoverPanel |
SAIF.Presentation.Web.Controls.AJAX.Infragistics111 — HoverPicture |
Fill |
Overloads Sub Fill(text As String) |
Sets the composed HoverPanel's ContentText to the supplied text |
SAIF.Presentation.Web.Controls.AJAX.Infragistics111 — HoverPicture |
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¶
- Passing
NothingtoFill(clsHelpText)is a deliberate no-op rather than a null-reference error, so a failed or empty help lookup simply leaves the control unchanged (typically showing no popup at all). (BR-AJAX-020) - Because
clsHelpText.HelpTextmay come from data entered intoAPPLICATION_HELP_DETAIL, andContentTextis rendered unencoded, this control carries the same unencoded-output exposure as itsHoverPicture/HoverPanelancestors if the stored help text is not trusted. (BR-AJAX-015)
Constraints and usage notes¶
- The default image path
/Resources/Images/DefaultHelpImage.gifis a hosting-environment contract: consuming applications must publish that asset, since it is not packaged with this library's compiled output. (BR-AJAX-043)
Related documentation¶
Sources¶
SAIF.Presentation.Web.Controls.AJAX.Infragistics111/HoverHelp.vb