DROPCOPY Property [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== DROPCOPY Property ======


 
==== Applies To ====
 
Drop Source controls
 
==== Description ====
 
A boolean property denoting if a drop source control allows a copy operation.
 
==== Usage ====
 
dropCopy = Get_Property(dropSource, "DROPCOPY")

existingState = Set_Property(dropSource,"DROPCOPY", bValue)
 
 
==== Remarks ====
 
Values passed in Set_Property():

^Value^Description^
|bValue|Boolean true (1) or false (0)|

By default the DROPCOPY property is set to 1.   If the Drag Source control does not allow a copy operation then setting this property to True will have no effect. OpenInsight will set this property before calling the DRAGOVER event based upon the restrictions of the Drag Source.

 

When overriding the default property of the Drop Target control, this property should be set during the DRAGOVER event.

 
==== Returns ====
 
Values returned by Get_Property and Set_Property

^Value^Description^
|dropCopy|the Boolean status of the control’s DROPCOPY.|
|existingState|the Boolean status of the control’s DROPCOPY, when Set_Property was run.|
 
==== See Also ====
 
[[dragsource|DROPSOURCE property]], [[dragmove|DROPMOVE property]]
 
==== Example ====
 
<code>
Declare function Get_Property, Set_Property

 

* Turn the DROPCOPY property off on the Dragover event.

 

dropSource = Get_Property("SYSTEM","DROPSOURCE")

dropCopy = Set_Property(dropSource,"DROPCOPY",0)
</code>