WinOpenObject: Difference between revisions

Revision as of 06:50, 4 March 2006

Opens object with the specified view, or, if already open, surfaces it.

Handle of the object to open.

Specifies which view to open. An object can define its own view codes. The system defines those listed in the constants section.

TRUE - Opens a view of the object which already exists by calling wpViewObject, otherwise by calling wpOpen.
FALSE - Opens a view of the object by calling wpOpen.

True if successful, false if not successful.

INCL_WINWORKPLACE

...
HOBJECT objectHandle;
ULONG viewForObject;
BOOL flag;
BOOL rc;
...
rc = WinOpenObject (objectHandle, viewForObject, flag);
...

If concurrent views are off, wpViewObject will resurface an existing object. The REXX counterpart is SysOpenObject.

OS/2 Warp 3.0 and above, eCS 1.0 and above

@@ Line 9: / Line 9: @@
 Specifies which view to open.  An object can define its own view codes.  The system defines those listed in the constants section.
 ; flag - [[OS2 API:DataType:BOOL|BOOL]] - input :
-* [[OS2 API:DataType:TRUE|TRUE]] - Opens a view of the object which already exists by calling [[OS2 API:wpViewObject|wpViewObject]], otherwise by calling [[OS2 API:wpOpen|wpOpen]].
+* [[OS2 API:Constant:TRUE|TRUE]] - Opens a view of the object which already exists by calling [[OS2 API:wpViewObject|wpViewObject]], otherwise by calling [[OS2 API:wpOpen|wpOpen]].
-* [[OS2 API:DataType:FALSE|FALSE]] - Opens a view of the object by calling [[OS2 API:wpOpen|wpOpen]].
+* [[OS2 API:Constant:FALSE|FALSE]] - Opens a view of the object by calling [[OS2 API:wpOpen|wpOpen]].
 === Constants ===
@@ Line 23: / Line 23: @@
 === Returns ===
 True if successful, false if not successful.
-* [[OS2 API:DataType:TRUE|TRUE]]
+* [[OS2 API:Constant:TRUE|TRUE]]
-* [[OS2 API:DataType:FALSE|FALSE]]
+* [[OS2 API:Constant:FALSE|FALSE]]
 Returns from [[OS2 API:WinGetLastError|WinGetLastError]] should [[OS2 API:WinOpenObject|WinOpenObject]] fail:
 * [[OS2_API:PMI:error#WPERR_OBJECT_NOT_FOUND|WPERR_OBJECT_NOT_FOUND]]