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] [Next]