WwPopupMenu Function

Reference Guide > W Routines > WwPopupMenu Function

Creates a popup menu.

Usage

popup = WwPopupMenu(parent, items)

Input Parameters

parent — The widget ID of the parent widget.

items — An unnamed structure specifying the menu bar items. For more details, see "Creating and Handling Menus" in the PV‑WAVE Application Developer’s Guide.

Returned Value

popup — The widget ID of the popup menu widget.

Keywords

Menus — Returns an array of menu pane widget IDs in the order in which the menus were created. A menu pane is a special menu widget that serves as a container for a menu item. Menu pane widget IDs can be used in the WwMenuItem function to add, modify, or delete menu items.

Name — A string specifying the name of the PopupMenu widget. The Name specified is part of the resource specification. (Default: menu.)

Color/Font Keywords

For Unix:

Background — Specifies the background color name.

Font — Specifies the name of the font used for text.

Foreground — Specifies the foreground color name.

For Windows:

MSFont — Adds support for Windows fonts.

Get/Set Value

getvalue — The button label or icon pixmap ID for the selected menu button. Or, if the button is a toggle, returns whether it is selected or unselected (selected = 1, unselected = 0).

setvalue — The button label or icon pixmap ID for the selected menu button. Or, if the button is a toggle, selects or unselects the toggle button (select = 1, unselect = 0).

Callback Parameters

Any popup menu callback procedure must have the following two parameters:

wid — Widget ID of the selected menu item.

index — Index of the selected menu item (1 – n).

Discussion

A popup menu is a menu that appears when the user presses a mouse button (usually the right button) when the pointer is in the popup menu’s parent widget. Thus, the popup menu is not tied to any menu button or menu bar.

note	Avoid creating popup menus that have a multi-line text widget as a parent. The system editing menu may appear over the popup menu that you have defined.

Example

This example creates a drawing widget that serves as the parent for a popup menu. The popup menu is activated when the right mouse button is pressed while the pointer is over the drawing widget. The callback procedure is executed when a menu button is selected.

Enter the callback procedures into a file, and compile the procedures with the .RUN command. Then, enter the widget commands at the WAVE> prompt (or enter them in a command file and run them with the @ command). To dismiss the button box, select the appropriate function (such as Close) from the window manager menu.

Callback Procedures

PRO DrawCB, wid, data

   COMMON draw, img

   PRINT, 'Draw'

   TV, img

END

PRO MenuCB, wid, index

   PRINT, 'Menu Item', index, 'selected.'

   VALUE = WwGetValue(wid)

   PRINT, value

END

Widget Commands

top = WwInit('ww_ex32', 'Examples', layout)

COMMON draw, img

LOADCT, 5, /SILENT

img = BYTARR(512,512)

OPENR,1, !Data_Dir + 'head.img'

READU,1,img

CLOSE, 1

draw = WwDrawing(layout, 1,'DrawCB', [256,256], [512,512])

status = WwSetValue(top, /Display)

menus = {,callback:'MenuCB', $

menubutton:'Fonts', $

menu:{,callback:'MenuCB', $

menubutton:'Adobe', $

menu:{,callback:'MenuCB', $

toggle:'Normal', $

   toggle:'Bold', $

   toggle:'Italic'}, $

   button:'Helvetica', $

   button:'Courier'}, $

menubutton:'Size', $

menu:{,callback:'MenuCB', $

   button:'8', $

   button:'10', $

   button:'12'}}

menu = WwPopupMenu(draw, menus)

status = WwSetValue(top, /Display)

WwLoop