Purpose

.MousePressedGraphic allows you to specify the graphic to be applied to certain objects when the mouse pointer is over it and the primary mouse is depressed.

This property can also be used to configure the visual appearance of the Drag avatar used in the Drag and Drop functionality.

Note that the Drag operation does not have its own Logic Event (logic is fired on the Drop). Consequently, you must set the visual appearance of the Drag avatar in code before the Drag occurs in the Timing Cycle. Click here for more information about Drag and Drop. 

Syntax

Setting:      ObjectReference.MousePressedGraphic = Value

Retrieving:   Variable = ObjectReference.MousePressedGraphic
 

Operation

ObjectReference is the Tag Name of the object
Value is the Graphic filename string.
Variable is an alphanumeric variable
 

Remarks

The MousePressedGraphic appears on the icon or when the mouse is moved over the object if the property has been explicitly set.  A graphic can have three variants (in addition to the base version) that PROIV will automatically use without programmer intervention, one of which is the graphic displayed when the mouse pointer is over the object and the primary mouse is pressed. This automatic use can be overridden by setting the .MousePressedGraphic property.

The retrieving command will cause the variable to contain the value in the same format it was specified.

Example

To set the MousePressedGraphic to 'Visa_MP.BMP' on an icon object (Tag Name = CUSTOMERACTIVEICON:

CUSTOMERACTIVEICON.MousePressedGraphic = 'Visa_MP.BMP'  or

$VISA_MP = 'Visa_MP.BMP'
CUSTOMERACTIVEICON.MousePressedGraphic = $VISA_MP

 
To retrieve the current file name for the MousePressedGraphic of the same object:

$CUSTOMERACTIVEICON_MP = CUSTOMERACTIVEICON.MousePressedGraphic