Utility function - deprecated in OI 10

Description

The Utility function is the OpenInsight interface to the Windows API, which provides a series of services that can be used to perform various tasks.

One of the things we have tried to do in OpenInsight 10 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 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 its functionality 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.

The Utility services map to the SYSTEM and FILESYSTEM objects in the following manner:

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	Method
CHOOSEDIR	SYSTEM	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