Progress
ADM 2 Reference
linkHandles (smart.p)
Takes a link name and returns a list of handles of objects at the other end of that link, relative to the TARGET–PROCEDURE.
Parameters:INPUT pcLink AS CHARACTER
The link name (including
“
-SOURCE”
or“
-TARGET”
).Returns: CHARACTER (Comma-separated list of handles to the SmartObject procedures at the other end of the link.)Notes:
- This is the Version 9 (ADM2) equivalent of the procedure get–link–handle in Version 8.
- If the link type does not exist in the object, then the empty string (
""
) is returned.- The procedure handle list is returned as a character string because (if the link type requested supports multiple objects at that end of the link) there might be multiple SmartObjects connected by that link type, so these come back as a comma-separated list. The developer must check the NUM–ENTRIES in the returned list (which might be zero, one, or more), and apply the WIDGET–HANDLE function to each entry to derive the procedure’s handle.
Examples:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |