wpFindViewItem

This method is specific to version 3, or higher, of the OS/2 operating system.

This instance method locates either the first or next occurrence of one of the specified views in the in-use list.

Syntax

_wpFindViewItem(somSelf, flViews, pCurrentItem)

Parameters

somSelf (WPObject *) - input

Pointer to the object on which the method is being invoked.

Points to an object of class WPObject.

flViews (ULONG) - input

Flag indicating the views to search for.

• VIEW_CONTENTS Icon view.
• VIEW_SETTINGS Settings notebook.
• VIEW_HELP Help view.
• VIEW_RUNNING Program running.
• VIEW_DETAILS Details view.
• VIEW_TREE Tree view.
• VIEW_ANY Any view item.

pCurrentItem (PVIEWITEM) - input

Pointer to the previous view item in the in-use list. A value of **NULL** indicates that the current view item is the first item in the list.

Returns

pNextItem (PVIEWITEM) - returns

Pointer to the view item that was found.

How to Override

This method is generally not overridden.

Usage

This method can be called at any time to find either the first or next view item.

Example Code

#define INCL_WINWORKPLACE
#include <os2.h>

WPObject *somSelf; /* Pointer to the object on which the method is being invoked. */
ULONG flViews; /* Flag indicating the views to search for. */
PVIEWITEM *pCurrentItem; /* Pointer to the previous view item in the in-use list. */
PVIEWITEM *pNextItem; /* Pointer to the view item that was found. */

pNextItem = _wpFindViewItem(somSelf, flViews,
              pCurrentItem);