Open Views

Objects can have open actions or open views associated with them. Open views typically are the views of an object, for example, Icon, Tree, Details, and Settings. Open views, for data file objects, also include programs or program references that the user has associated with the object. Open views are displayed when the user selects the cascaded mini-push button that appears next to the Open action on the pop-up menu. The user then can select the default open view or any of the open views listed in the conditional cascaded menu. The Workplace Shell defines a set of predefined open views, as shown in the following table:

┌────────────────────┬────────────────────────────────────────┐
│View                │Description                             │
├────────────────────┼────────────────────────────────────────┤
│OPEN_CONTENTS       │Opens content view.                     │
├────────────────────┼────────────────────────────────────────┤
│OPEN_DEFAULT        │Opens default view.                     │
├────────────────────┼────────────────────────────────────────┤
│OPEN_DETAILS        │Opens Details view.                     │
├────────────────────┼────────────────────────────────────────┤
│OPEN_HELP           │Opens help view.                        │
├────────────────────┼────────────────────────────────────────┤
│OPEN_RUNNING        │Executes object.                        │
├────────────────────┼────────────────────────────────────────┤
│OPEN_SETTINGS       │Opens Settings notebook.                │
├────────────────────┼────────────────────────────────────────┤
│OPEN_TREE           │Opens Tree view.                        │
├────────────────────┼────────────────────────────────────────┤
│OPEN_USER           │Opens class-specific view (value greater│
│                    │than OPEN_USER)                         │
└────────────────────┴────────────────────────────────────────┘

Some of the predefined open views are meaningful only to certain Workplace Shell classes:

• OPEN_RUNNING is meaningful only to a program or program reference object

• OPEN_TREE is meaningful only to file system objects such as folders, drives and directories.

Workplace Shell classes can define new open views for their objects by:

• Adding the New view menu item to the Open submenu.

• Overriding wpMenuItemSelected to support user selection of the New view menu item.

• Overriding wpOpen to open the New view.

• Creating and opening a standard window for the New view by calling WinCreateStdWindow.

  Note: The preferred method for displaying application views of an object is for the object to start a separate process, using DosExecPgm, for the application. This approach moves the larger part of the application code out of the Workplace Shell's process, thus conserving the its resources. It also helps prevent a misbehaved application from potentially interfering with the execution of the Workplace Shell.

  5.
  Adding a USAGE_VIEW item to the object's in-use list by calling wpAddToObjUseList.
  6.
  Registering the New view by calling wpRegisterView.

  Note: The Sample Code for Pop-Up Menu Methods is a complete program that demonstrates how to define and open a new open view.

  ---

  [Back: Support for User Selection of Standard Pop-Up Menu Items]
  [Next: Using Pop-Up Menu Methods]