HoverPicture

HoverPicture is the image-based hover trigger that opens a HoverPanel, and is the direct base class of HoverHelp. Unlike HoverLabel, it exposes a Fill(text) method for setting the popup's content programmatically and a configurable content panel width, making it the more general-purpose of the two simple triggers.

Purpose

• Renders an image trigger (ControlImageURL) that opens an associated HoverPanel on hover.
• Provides Fill(text) so callers can set the popup's content text programmatically at runtime rather than only through markup. (BR-AJAX-016)
• Exposes ContentPanelWidth so the popup width can be tuned independently per instance.

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
ControlImageURL	Property ControlImageURL As String	URL of the image rendered as the hover trigger
ContentPanelWidth	Property ContentPanelWidth As Unit	Width applied to the composed HoverPanel
Fill	Sub Fill(text As String)	Sets the composed HoverPanel's ContentText to the supplied text (BR-AJAX-016)

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

• Fill writes directly into the composed HoverPanel's ContentText, so the same unencoded-rendering behavior applies to whatever text is passed in. (BR-AJAX-015)
• If no content has been set, the composed panel renders nothing, so an unfilled HoverPicture shows only its trigger image with no popup. (BR-AJAX-016)

Constraints and usage notes

• Requires the AJAX Control Toolkit (AjaxControlToolkit.dll) at runtime, transitively through the composed HoverPanel.
• Callers passing user-influenced text to Fill should encode it themselves if it must not be treated as markup. (BR-AJAX-015)

Related documentation

• Index
• Overview
• Architecture
• Business rules
• API reference

Sources

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