{ WebProperty=Client }
Property String psDropZoneObjName
| Web Property Read Access: | WebGet psDropZoneObjName to StringVariable |
| Web Property Write Access: | WebSet psDropZoneObjName to StringVariable/Value |
| Read Access: | Get psDropZoneObjName to StringVariable |
| Write Access: | Set psDropZoneObjName to StringVariable/Value |
Modern browsers support dragging and dropping files onto the browser window. The file upload controls (cWebFileUploadButton and cWebFileUploadForm) both support this as a way to specify the set of files to be uploaded to the server.
The file upload controls define a 'drop-zone', which is an area of the browser window where files can be dropped to initiate the file upload. By default, the drop zone of a file upload control is the area occupied by the control. For example: the drop zone for a cWebFileUploadButton is the button itself.
The drop zone is configurable using the psDropZoneObjName property. Set psDropZoneObjName to the object name of any web object in scope. Examples of controls that it could be set to too extend the drop area are: cWebPanel, cWebView, cWebTabPage, cWebGroup or even cWebApp.
psDropZoneObjName differs from the phoDropZone property in that it can be changed (via WebSet) while the application is running.
This example shows how the drop zone can be changed to a panel.
Procedure ChangeDropZone
String sObj
Get WebObjectName of oWebMainPanel to sObj
WebSet psDropZoneObjName of oWebFileUploader2 to sObj
End_Procedure
Each web property maintains two values: The regular property value is set during object creation and should not be changed during the lifetime of that object. To access that value, use the standard property Get and Set syntax.
The web property value is the local value stored at each client. This is synchronized to the client's local value whenever a server call is being processed. To access the web property value, use the WebGet and WebSet syntax above instead of the standard Get and Set syntax.