SoFixedMenu

InventorModule

genre	Interaction
author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	SoMenu
definition	SoMenu.def
see also	SoPopupMenu, SoBorderMenu, SoMenuItem, SoInteractionMapping, SoView2DMenuItem, SoView2DMenu
inherits from	SoRectangularMenuBase
keywords	node, button, selection, popup, radiobox, openinventor, managed, interaction

Purpose

The node SoFixedMenu shows a menu of SoMenuItem items arranged at the positions given by SoMenuItem.fixedPosition. This can be a static menu where the top-level items are always shown, or a pop-up menu, where the items are shown when the mouse button is pressed, and relative to the initial mouse cursor position.

Usage

See SoRectangularMenuBase.

Interaction

The interaction mouse button is the left button for static menus and the right button if Popup Menu is set. This can be overridden with SoInteractionMapping.

Tips

If Popup Menu is false, the same tips as for SoBorderMenu apply.

Windows

Default Panel

Output Fields

self

name: self, type: SoNode

see SoRectangularMenuBase.self

Parameter Fields

Field Index

Alpha (backgroundAlpha): Float	Font Size: Integer	Offset: Vector2
Alpha (backgroundAlphaSelected): Float	Gap Between Icon and Text: Integer	On: Bool
Background Color: Color	hoverItemID: String	Outer Border: Float
Background Color Selected: Color	Icon Blend Mode: Enum	Popup Menu: Bool
Color: Color	Inner Border: Float	popupDelay: Float
Color Selected: Color	interactionProviderID: String	Relative Anchor Point: Vector2
Disable ZBuffer: Bool	lastClickedItemId: String	Text Shadow: Bool
drawBackground: Bool	Menu Id: String
Enabled: Bool	Mouse Over Color Factor: Float

Visible Fields

On

name: on, type: Bool, default: TRUE

see SoRectangularMenuBase.on

Enabled

name: enabled, type: Bool, default: TRUE

see SoRectangularMenuBase.enabled

Menu Id

name: menuId, type: String

see SoRectangularMenuBase.menuId

Icon Blend Mode

name: iconBlendMode, type: Enum, default: IconReplace

see SoRectangularMenuBase.iconBlendMode

Color

name: color, type: Color, default: 1 1 1

see SoRectangularMenuBase.color

Color Selected

name: colorSelected, type: Color, default: 1 1 1

see SoRectangularMenuBase.colorSelected

Background Color

name: backgroundColor, type: Color, default: 0.5 0.5 0.5

see SoRectangularMenuBase.backgroundColor

Alpha (backgroundAlpha)

name: backgroundAlpha, type: Float, default: 0.80000001, minimum: 0, maximum: 1

see SoRectangularMenuBase.backgroundAlpha

Background Color Selected

name: backgroundColorSelected, type: Color, default: 0.699999988079071 0.699999988079071 0.699999988079071

see SoRectangularMenuBase.backgroundColorSelected

Alpha (backgroundAlphaSelected)

name: backgroundAlphaSelected, type: Float, default: 0.80000001, minimum: 0, maximum: 1

see SoRectangularMenuBase.backgroundAlphaSelected

Mouse Over Color Factor

name: mouseOverColorFactor, type: Float, default: 0.80000001, minimum: 0, maximum: 1

see SoRectangularMenuBase.mouseOverColorFactor

Disable ZBuffer

name: disableZBuffer, type: Bool, default: TRUE

see SoRectangularMenuBase.disableZBuffer

Font Size

name: fontSize, type: Integer, default: 10, minimum: 0

see SoRectangularMenuBase.fontSize

Text Shadow

name: textShadow, type: Bool, default: TRUE

see SoRectangularMenuBase.textShadow

Outer Border

name: itemOuterBorder, type: Float, default: 1, minimum: 0

see SoRectangularMenuBase.itemOuterBorder

Inner Border

name: itemInnerBorder, type: Float, default: 3, minimum: 0

see SoRectangularMenuBase.itemInnerBorder

Gap Between Icon and Text

name: textIconGap, type: Integer, default: 4, minimum: 0

see SoRectangularMenuBase.textIconGap

Popup Menu

name: asPopupMenu, type: Bool, default: FALSE

If checked, the menu is only shown when the configured mouse button is pressed, and relative to the initial mouse cursor position (plus the configured Offset).

Otherwise, the top-level menu items are always shown.

Offset

name: offset, type: Vector2, default: 0 0

Sets a pixel offset to apply to the SoMenuItem.fixedPosition of each menu item.

If Popup Menu is set, the initial mouse cursor position when the mouse button went down is also added.

Relative Anchor Point

name: relativeAnchorPoint, type: Vector2, default: 0 0

Sets an anchor point of the menu in relative coordinates [0-1] of the current viewport.

This position is added (together with Offset) to the SoMenuItem.fixedPosition of each menu item, but only if Popup Menu is not set (as the anchor point is determined by the mouse cursor position then).

Hidden Fields

interactionProviderID

name: interactionProviderID, type: String

see SoRectangularMenuBase.interactionProviderID

drawBackground

name: drawBackground, type: Bool, default: TRUE

see SoRectangularMenuBase.drawBackground

lastClickedItemId

name: lastClickedItemId, type: String, persistent: no

see SoRectangularMenuBase.lastClickedItemId

hoverItemID

name: hoverItemID, type: String

see SoRectangularMenuBase.hoverItemID

popupDelay

name: popupDelay, type: Float, default: 250, minimum: 0, maximum: 2000

see SoRectangularMenuBase.popupDelay