Share via


MouseOver Effects Foundation Class

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

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

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.

See Also

Concepts

Guidelines for Using Visual FoxPro Foundation Classes

Reference

Visual FoxPro Foundation Classes A-Z

Other Resources

Foundation Class Samples