Customising the Drag Avatar Appearance Overview

Appearance of the Drag Avatar

When a Drag operation is initiated, the client creates a visible object that is dragged by the mouse. This object is created by taking a copy of the current state of the Static Icon (the icon's image and text). To explain further, the current state means the image and text that appears when the drag is started. This means that if the icon has mouse down image or text, it is that image or text that is used for the avatar because the mouse is down when the drag starts. The avatar also includes a ‘state image’. This is one of two images that indicate the Drop Allowed status. The default is a green tick if the drop is allowed and a red stop sign if drop is not allowed. The drop status changes as the avatar is dragged over the screen.

Customising the Drag and Drop Avatar in PROIV

The appearance of the item that is dragged during the Drag and Drop operation can be configured in PROIV. You can change the graphic by using the .MousePressedGraphic property. Similarly, the label associated with the graphic can be configured using the .MousePressedLabel property. These can be configured in code and on the Static Icon’s Property Sheet. However, it is important to 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 to here to learn more.

Note: .MousePressedLabel and .MousePressedGraphic properties are not new to PROIV but can be used to configure the appearance of the Drag avatar in PROIV used in the Drag and Drop functionality.

 

Customising the Drag and Drop Avatar in Open Client

The Drag avatar can also be customised using the Open Client appResources folder in two ways: you can configure the avatar's style sheet properties in the application style sheet, or change the Drag avatar state images in the application appImages folder. Click to here to learn more.

Comment on this topic

Topic ID: 800116