Difference between revisions of "WinOpenObject"

From EDM2
Jump to: navigation, search
m
m
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.
+
 
 +
==Syntax==
 +
WinOpenObject(objectHandle, viewForObject, flag)
  
 
=== Parameters ===
 
=== Parameters ===
Line 46: Line 48:
  
 
=== 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''.
 
The REXX counterpart is ''SysOpenObject''.
  

Revision as of 21:05, 22 March 2017

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.

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

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