WinOpenObject: Difference between revisions

Latest revision as of 02:12, 1 December 2019

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

Syntax

WinOpenObject(objectHandle, viewForObject, flag)

Parameters

objectHandle - HOBJECT - input: Handle of the object to open.
viewForObject - ULONG - input: Specifies which view to open. An object can define its own view codes. The system defines those listed in the constants section.
flag - BOOL - input

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.

Constants

OPEN_CONTENTS
OPEN_DEFAULTS
OPEN_DETAILS
OPEN_HELP
OPEN_RUNNING
OPEN_SETTINGS
OPEN_TREE

Returns

True if successful, false if not successful.

TRUE
FALSE

Returns from WinGetLastError should WinOpenObject fail:

Define (C/C++)

INCL_WINWORKPLACE

Calling Convention

Cdecl32

Example Code

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

Related Functions

WinCreateObject

Notes

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

OS Version Introduced

OS/2 Warp 3.0

@@ Line 1: / Line 1: @@
-== WinOpenObject ==
+Opens object with the specified view, or, if already open, surfaces it.
-; WinOpenObject(objectHandle, viewForObject, flag) : Opens object with the specified view, or, if already open, surfaces it.
-=== Parameters ===
+==Syntax==
-; objectHandle - [[HOBJECT]] - input : Handle of the object to open.
+ WinOpenObject(objectHandle, viewForObject, flag)
-; viewForObject - [[ULONG]] - input : Specifies which view to open.  An object can define its own view codes.  The system defines those listed in the constants section.
+== Parameters ==
+;objectHandle - [[HOBJECT]] - input : Handle of the object to open.
+;viewForObject - [[ULONG]] - input : Specifies which view to open.  An object can define its own view codes.  The system defines those listed in the constants section.
 ; flag - [[BOOL]] - input :
-* [[TRUE]] - Opens a view of the object which already exists by calling [[wpViewObject]], otherwise by calling [[wpOpen]].
+* [[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.
-=== Constants ===
+== Constants ==
-* [[OPEN#OPEN_CONTENTS|OPEN_CONTENTS]]
+* OPEN_CONTENTS
-* [[OPEN#OPEN_DEFAULT|OPEN_DEFAULTS]]
+* OPEN_DEFAULTS
-* [[OPEN#OPEN_DETAILS|OPEN_DETAILS]]
+* OPEN_DETAILS
-* [[OPEN#OPEN_HELP|OPEN_HELP]]
+* OPEN_HELP
-* [[OPEN#OPEN_RUNNING|OPEN_RUNNING]]
+* OPEN_RUNNING
-* [[OPEN#OPEN_SETTINGS|OPEN_SETTINGS]]
+* OPEN_SETTINGS
-* [[OPEN#OPEN_TREE|OPEN_TREE]]
+* OPEN_TREE
-=== Returns ===
+== Returns ==
 True if successful, false if not successful.
 * [[TRUE]]
 * [[FALSE]]
 Returns from [[WinGetLastError]] should '''WinOpenObject''' fail:
-* [[OS2_API:PMI:error#WPERR_OBJECT_NOT_FOUND|WPERR_OBJECT_NOT_FOUND]]
+* [[PM Error Codes#WPERR_OBJECT_NOT_FOUND|WPERR_OBJECT_NOT_FOUND]]
-* [[OS2_API:PMI:error#WPERR_INVALID_FLAGS|WPERR_INVALID_FLAGS]]
+* [[PM Error Codes#WPERR_INVALID_FLAGS|WPERR_INVALID_FLAGS]]
-=== Define (C/C++) ===
+== Define (C/C++) ==
 INCL_WINWORKPLACE
-=== Calling Convention ===
+== Calling Convention ==
 [[Cdecl32]]
-=== Example Code ===
+== Example Code ==
   ...
   HOBJECT objectHandle;
@@ Line 42: / Line 44: @@
   ...
-=== Related Functions ===
+== Related Functions ==
 *[[WinCreateObject]]
-=== Notes ===
+== Notes ==
-If concurrent views are off, [[wpViewObject]] will resurface an existing object.
+If concurrent views are off, ''wpViewObject'' will resurface an existing object.
 The REXX counterpart is ''SysOpenObject''.
-=== OS Version Introduced ===
+== OS Version Introduced ==
 OS/2 Warp 3.0
 [[Category:Win]]