DirectOptionMenu
The DirectOptionMenu class models a popup menu with an arbitrary number of items. It is composed of the menu bar, the popup marker, and the popup menu itself. The popup menu appears when the menu is clicked on and disappears when the user clicks again; if the click was inside the popup, the selection changes. By default, the text on the menu changes to whatever item is currently selected. The attributes that affect the appearance of the menu bar don’t apply to the popup. Make sure to specify the items option or it may crash.
Keyword | Definition | Value |
|---|---|---|
textMayChange | Whether the text on the menu changes with the selection | 0 or 1 |
initialitem | The index of the item that appears next to the cursor when the popup appears | Number |
items | List of items in the popup menu | [Strings] |
command | Function called when an item is selected (the item is passed in as a parameter) | Function |
commandButtons | Which mouse button must be clicked to open the popup | LMB, MMB, or RMB |
extraArgs | Extra arguments to the function specified in command | [Extra Arguments] |
highlightColor | Color of highlighted text | (R,G,B,A) |
highlightScale | Scale of highlighted text | (Width,Height) |
rolloverSound | The sound made when the cursor rolls over the button | Sound File Path |
clickSound | The sound made when the cursor clicks on the button | Sound File Path |
popupMarkerBorder | Use width to change the size of the border around the popup marker | (Width,Height) |
popupMarker_image | Set the state images of the popupMarker | (see directButton: image) |
popupMarker_scale | Set the scale of the popupMarker | scale=x or scale=(x,y,z) |
popupMarker_pos | Set the position of the popupMarker relative to the parent optionMenu | pos=(x,y,z) |
popupMarker_relief | Set the relief value of the popupMarker, the depth of the beveled edge | relief=x (for int value) or relief=None (for no relief) |
Example
import direct.directbase.DirectStart from direct.gui.OnscreenText import OnscreenText from direct.gui.DirectGui import * from panda3d.core import * # Add some text bk_text = "DirectOptionMenu Demo" textObject = OnscreenText(text=bk_text, pos=(0.85, 0.85), scale=0.07, fg=(1, 0.5, 0.5, 1), align=TextNode.ACenter, mayChange=1) # Add some text output = "" textObject = OnscreenText(text=output, pos=(0.95, -0.95), scale=0.07, fg=(1, 0.5, 0.5, 1), align=TextNode.ACenter, mayChange=1) # Callback function to set text def itemSel(arg): output = "Item Selected is: " + arg textObject.setText(output) # Create a frame menu = DirectOptionMenu(text="options", scale=0.1, command=itemSel, items=["item1", "item2", "item3"], initialitem=2, highlightColor=(0.65, 0.65, 0.65, 1)) # Run the tutorial base.run() This is a simple demonstration of the DirectOptionMenu.
Dynamic Updating of a Menu
import direct.directbase.DirectStart from direct.gui.OnscreenText import OnscreenText from direct.gui.DirectGui import * from panda3d.core import * # Add some text bk_text = "DirectOptionMenu Demo" textObject = OnscreenText(text=bk_text, pos=(0.85, 0.85), scale=0.07, fg=(1, 0.5, 0.5, 1), align=TextNode.ACenter, mayChange=1) # Add some text output = "" textObject = OnscreenText(text=output, pos=(0.95, -0.95), scale=0.07, fg=(1, 0.5, 0.5, 1), align=TextNode.ACenter, mayChange=1) # Callback function to set text def itemSel(arg): if arg != "Add": # No need to add an element output = "Item Selected is: " + arg textObject.setText(output) else: # Add an element tmp_menu = menu['items'] new_item = "item" + str(len(tmp_menu)) tmp_menu.insert(-1, new_item) #add the element before add menu['items'] = tmp_menu # Set the status message output = "Item Added is: " + new_item textObject.setText(output) # Create a frame menu = DirectOptionMenu(text="options", scale=0.1, initialitem=2, items=["item1", "item2", "item3", "Add"], highlightColor=(0.65, 0.65, 0.65, 1), command=itemSel, textMayChange=1) # Procedurally select a item menu.set(0) # Run the tutorial base.run() In this example we add an item to the menu whenever the Add item is selected.