Share via


MouseOver Effects Foundation Class

Category User Interface
Default Catalog Visual FoxPro Catalog\Foundation Classes\User Controls
Class _mouseoverfx
Base Class Custom
Class Library _ui.vcx
Parent Class _custom
Sample ...\Samples\Solution\Ffc\mousefx.scx

Remarks

This class highlights a control as the mouse is dragged over it.

To use, drop the class on a project or form or, from the Component Gallery Item Shortcut Menu, select Add to Project or Add to Form. When you add the class to a form, specify the appropriate values for the highlight (iHighlightColor and nHighlightWidth), and other appropriate properties, then place a reference to the HighlightMe method in the MouseMove event of the control you want to affect. When you drop the class on a project, you can choose between adding the class or creating a subclass.

See Guidelines for Using Visual FoxPro Foundation Classes for more information on using foundation classes.

Properties, Events, Methods Description
nMargin property Specifies the border between the control and the highlight.
Default: 2
iShadowColor property Specifies the color code of the shadow.
Default: 0
lMouseoverHost property Specifies whether the mouse is over the mousefx host.
Default: .T.
nHighlightWidth property Specifies the width of the highlight.
Default: 2
iHighlightColor property Specifies the color code of the highlight.
Default: 0
CancelHighlight method Uses the value of lMouseoverHost to determine whether there is a highlighted object requiring change. Sets oCurrentCoolControl to .NULL. and Returns true (.T.) when lMouseOver indicates that the current control has just changed.
Your subclasses can check this return value or the state of lMouseOverHost and oCurrentCoolControl to "subtract" their own special effects from cool controls at the appropriate times.
Syntax: CancelHighlight (toObject)
Return:lChange
Arguments:
toObject specifies the object affected upon the MouseOver event.
lChange specifies whether the current control has already changed.
HighlightMe method Sets .oCurrentCoolControl, the current control, to the object reference specified by toObject. Returns true (.T.) when it has to act because the current control has just changed. Returns .F. if it doesn't need to act because there is no change in the current control. Your subclasses can use the oCurrentCoolControl property and the return value of this method to decide when they have to act, providing other special effects, perhaps specific for some special classes of "current controls".
Syntax: HighlightMe(toObject)
Return:lChange
Arguments:
toObject specifies the object affected upon the MouseOver event.
lChange specifies whether the current control has already changed.
oCurrentCoolControl property Internal to the class.
Default: ""

See Also

Guidelines for Using Visual FoxPro Foundation Classes | Visual FoxPro Foundation Classes A-Z | Visual FoxPro Foundation Class Samples