Utility function - deprecated in OI 10 [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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|

 
==== Syntax ====
 
//returnvalue// = **Utility**(<**Service**> [, <//object//>] [,<//value//>])

==== Remark ====

See documentation for each service for more information.
 
==== See Also ====
 
[[beep_service|BEEP]] Service

[[destroy_service|DESTROY]] Service

[[removedir_service|REMOVEDIR]] Service

[[choosecolor_service|CHOOSECOLOR]] Service

[[flush_service|FLUSH]] Service

[[renamedir_service|RENAMEDIR]] Service

[[choosedir_service|CHOOSEDIR]] Service

[[get_event_service|GET_EVENT]] Service

[[renamefile_service|RENAMEFILE]] Service

[[choosefile_service|CHOOSEFILE]] Service

[[getlogicaldrives_service|GETLOGICALDRIVES]] Service

[[runhelp_service|RUNHELP]] Service

[[choosefont_service|CHOOSEFONT]] Service

[[makedir_service|MAKEDIR]] Service

[[runwin_service|RUNWIN]] Service

[[copyfile_service|COPYFILE]] Service

[[objectid_service|OBJECTID]] Service

[[textrect_service|TEXTRECT]] Service

[[create_service|CREATE]] Service

[[objectlist_service|OBJECTLIST]] Service

[[wincount_service|WINCOUNT]] Service

[[cursor_service|CURSOR]] Service

[[printsetup_service|PRINTSETUP]] Service

[[utility|Utility]] function

[[HANDLE_BY_CURSOR_Service|HANDLE_BY_CURSOR]] Service

[[IUNKNOWN_RELEASE_Service|IUNKNOWN_RELEASE]] Service

[[LOAD_PICTURE_Service|LOAD_PICTURE]] Service

[[OBJECT_BY_CURSOR_Service|OBJECT_BY_CURSOR]] Service

[[PICTURE_PROPS_Service|PICTURE_PROPS]] Service

[[oi10:openinsight_10_presentation_server_object_model#system_object|SYSTEM Object]]
 
[[oi10:openinsight_10_presentation_server_object_model#filesystem_object|FILESYSTEM Object]]

[[[guides:programming:programmers_reference_manual:exec_method|Exec_Method Function]]