Jump to content

wpQueryActionButtons

From EDM2
Revision as of 04:35, 18 November 2025 by Martini (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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

This instance method returns a list of action buttons displayed on the Toolbar.

Syntax

_wpQueryActionButtons(somSelf, pulNumActions)

Parameters

somSelf (WPLaunchPad *) - input
Pointer to the object on which the method is being invoked.
Points to an object of class WPLaunchPad.
pulNumActions (PULONG) - output
Pointer to the number of actions returned.

Returns

pActions (PACTIONS) - returns
Pointer to an array of actions displayed on the Toolbar.

How to Override

This method can be overridden to add or change actions. If you want to modify the set of actions returned, call the parent **wpQueryActionButtons** first. If you want to return a completely different set of actions, you do not need to call the parent first. If you are adding actions which are not provided or the **ulMenuId** is not a menuID of the WPDesktop class, then you need to also override WPDesktop, using wpMenuItemSelected, to respond to your defined actions.

Usage

This method is not covered in the provided text.

Remarks

This method is not covered in the provided text.

Example Code

#define INCL_WINWORKPLACE
#include <os2.h>

WPLaunchPad *somSelf; /* Pointer to the object on which the method is being invoked. */
PULONG pulNumActions; /* Pointer to the number of actions returned. */
PACTIONS pActions; /* Pointer to an array of actions displayed on the Toolbar. */

pActions = _wpQueryActionButtons(somSelf,
              pulNumActions);

Related Methods