Progress
Language Reference
WIDGET-HANDLE Function
Converts a string representation of a widget handle to a valid widget handle.
SYNTAX
CAUTION: Use this function only to convert a widget handle previously stored as a string value back to a valid widget handle. If you convert an arbitrary string to widget handle using this function and then reference the new widget handle, a system error will occur. The VALID-HANDLE function references a widget handle to validate the handle. If you use the VALID-HANDLE function to validate a widget handle generated from an arbitrary string value, a system error will occur.
widget-handle-string
A string representation of a widget handle. Since widget handles are integer values, the string must contain only numeric characters.
EXAMPLEThe following procedure creates a frame, stores the widget handle of the frame as a string value, deletes the frame, converts the string representation of the frame widget handle back to a widget handle, and then tests if the widget handle is valid.
The VALID-HANDLE function returns a FALSE value because the frame was deleted and the widget handle is no longer valid.
NOTES
SEE ALSO
CREATE Widget Statement, DATE Function, DECIMAL Function, INTEGER Function, STRING Function, VALID-HANDLE Function
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |