In our previous Send_Message posting we mentioned that we had deprecated another well-known function, and I’m sure you can guess which one from the title of this post – Yep, we deprecated the Utility function!
One of the things we’ve tried to do in this release is to tidy up and standardize the interface between your Basic+ programs and the Presentation Server, providing a standard object-based model based on properties, methods and events. The Utility function has always been been an exception to this however, essentially providing a shorthand way of executing what should be SYSTEM object methods, thereby breaking the paradigm.
In light of this the Utility function has been deprecated and it’s functionally exposed as properties and methods of the SYSTEM and FILESYSTEM objects instead. Utility itself still works, but it is now a shell that maps to the two aforementioned objects (more of which we’ll cover later).
In case you’re interested here’s how the Utility services map to the SYSTEM and FILESYSTEM objects:
Utility Service | Object | Type |
BEEP | SYSTEM | Method |
COPYFILE | FILESYSTEM | Method |
CREATE | SYSTEM | Method |
CURSOR | SYSTEM | Property [S] |
CHOOSECOLOR | SYSTEM | Method |
CHOOSEFONT | SYSTEM | Method |
CHOOSEFILE | SYSTEM + FILESYSTEM | Method |
CHOOSEDIR | SYSTEM + FILESYSTEM | Method |
DESTROY | SYSTEM | Method |
DIALOG_BOX | SYSTEM | Method |
FLUSH | SYSTEM | Method |
GET_EVENT | SYSTEM | Method |
GETLOGICALDRIVES | FILESYSTEM | Property [G] (DRIVELIST) |
HANDLE_BY_CURSOR | SYSTEM | Method |
HOOKCTRL | SYSTEM | Method |
IUNKNOWN_RELEASE | SYSTEM | Method |
LOAD_PICTURE | SYSTEM | Method |
MAKEDIR | FILESYSTEM | Method |
OBJECTID | SYSTEM | Method |
OPENAPP | SYSTEM | Method |
OBJECT_BY_CURSOR | SYSTEM | Method |
OBJECTLIST | SYSTEM | Method |
PRINTSETUP | SYSTEM | Method |
POST_WINMSG | SYSTEM | Method |
PICTURE_PROPS | SYSTEM | Method |
REMOVEDIR | FILESYSTEM | Method |
RENAMEDIR | FILESYSTEM | Method |
RENAMEFILE | FILESYSTEM | Method |
RUN | SYSTEM | Method |
RUNHELP | SYSTEM | Method |
RUNWIN | SYSTEM | Method |
SHELLEXECUTE | SYSTEM | Method |
SEND_WINMSG | SYSTEM | Method |
TEXTRECT | SYSTEM | Method |
UNHOOKCTRL | SYSTEM | Method |
WINCOUNT | SYSTEM | Property [G] |
WINDOW_BY_POS | SYSTEM | Method |
[EDIT: 19 Nov 15, Updated CHOOSEDIR and CHOOSEFILE methods to include FILESYSTEM]
(Disclaimer: This article is based on preliminary information and may be subject to change in the final release version of OpenInsight 10).