Name
OpenPopupMenu -- open popup menu (V10.0)
Synopsis
int ok = OpenPopupMenu(APTR display, struct hwMenuTreeInfo *menu, int x,
             int y, struct hwTagList *tags);
Function
This function is optional and must only be implemented if the HWEXT_DISPLAYADAPTER_POPUPMENU extension bit has been set. See Extension plugins for details. If that is the case, OpenPopupMenu() will be called if Hollywood wants your display adapter to show a popup menu. Hollywood will pass a struct hwMenuTreeInfo pointer in menu which contains all nodes and leaves of the menu bar. See SetMenuBar for a description of this structure. Whenever the user selects a menu item, you need to post an HWEVT_MENUITEM event to Hollywood's event queue. See hw_PostEvent for details.

The x and y parameters will contain the desired position for the popup menu on the screen or CO_UNSPECIFIED if the popup menu should appear under the mouse pointer. Note that all coordinates are relative to the screen's origin, not the display's origin.

Note that if you want Hollywood to call this function, you also must set the HWSDAFLAGS_OPENPOPUPMENU flag in your call to hw_SetDisplayAdapter(). See hw_SetDisplayAdapter for details.

Inputs
handle
display handle returned by OpenDisplay()
menu
menu strip to show
x
x position for the popup menu
y
y position for the popup menu
tags
reserved for future use, currently always NULL
Results
ok
return True to indicate success, False to indicate failure
Show TOC