Interface: quadMenuSettings

This represents a Core Interface for controlling the quad menu settings.

Methods:

<void>ResetDefaults()

This method will reset the menu settings to their defaults.

<void>SetBorderSize <integer>borderSize

This method allows you to set the menu border size in pixels.

<integer>GetBorderSize()

This method returns the menu border size.

<void>SetHorizontalMarginInPoints <integer>horizontalMarginInPoints

This method allows you to set the menu’s horizontal margin size in points.

<integer>GetHorizontalMarginInPoints()

This method returns the menu’s horizontal margin size in points.

<void>SetVerticalMarginInPoints <integer>verticalMarginInPoints

This method allows you to set the menu’s vertical margin size in points.

<integer>GetVerticalMarginInPoints()

This method returns the menu’s vertical margin size in points.

<void>SetItemFontFace <string>szItemFontFace

This method allows you to set the menu item’s font typeface by providing a string containing the typeface name.

<string>GetItemFontFace()

This method returns the name of the menu item’s font typeface.

<void>SetTitleFontFace <string>szTitleFontFace

This method allows you to set the menu title’s font typeface by providing a string containing the typeface name.

<string>GetTitleFontFace()

This method returns the name of the menu title’s font typeface.

<void>SetItemFontSize <integer>itemFontSize

This method allows you to set the menu item’s font size in points.

<integer>GetItemFontSize()

This method returns the menu item’s font size, in points.

<void>SetTitleFontSize <integer>titleFontSize

This method allows you to set the menu title’s font size, where the title font size value is given in points.

<integer>GetTitleFontSize()

This method returns the menu title’s font size, in points.

<void>SetUseUniformItemHeight <boolean>useUniformItemHeight

This method allows you to set the status of a menu item’s uniform height flag.

<boolean>GetUseUniformItemHeight()

This method returns true or false if the menu item’s uniform height flag is set or not set, respectively.

<void>SetOpacity <float>opacity

This method allows you to set the menu’s opacity value. The opacity value can range from 0.0 to 1.0, where 1.0 is opaque.

<float>GetOpacity()

This method returns the menu’s opacity value.

<void>SetDisplayMethod <integer>displayMethod

This method allows you to set a menu’s display method.

The display method argument can be one of the following:

0 - displays the menu with transparency, if opacity is < 1.

1 - stretch animate the menu by making it grow in size from its center with transparency, if opacity is < 1.

2 - fade in from invisible to whatever opacity is set to.

<integer>GetDisplayMethod()

This method returns the menu’s display method, which is either of the following; DM_NORMAL, DM_STRETCH, DM_FADE, DM_NUM_METHODS

<void>SetAnimatedSteps <integer>animatedSteps

This method allows you to set the menu’s number of animated steps for the ‘growing’ effect as integer.

<integer>GetAnimatedSteps()

This method returns the menu’s number of animated steps used for the ‘growing’ effect.

<void>SetAnimatedStepTime <integer>animatedStepTime

This method allows you to set the menu’s animated step time in milliseconds.

<integer>GetAnimatedStepTime()

This method returns the menu’s animated step time in milliseconds.

<void>SetSubMenuPauseTime <integer>subMenuPauseTime

This method allows you to set the delay before a submenu is displayed, in milliseconds.

<integer>GetSubMenuPauseTime()

This method returns the delay before a submenu is displayed, in milliseconds.

<void>SetUseLastExecutedItem <boolean>useLastSelectedItem

This method allows you to set the "last executed item" flag which determines whether to use the menu’s last executed item when the user clicks on the menu’s titlebar.

<boolean>GetUseLastExecutedItem()

This method returns whether the "last executed item" flag is set (true) or not set (false). The flag determines whether to use the menu’s last executed item when the user clicks on the menu’s titlebar.

<void>SetRepositionWhenClipped <boolean>repositionWhenClipped

This method allows you to set the flag which controls and determines whether the menu is repositioned when near the edge of the screen.

<integer>GetRepositionWhenClipped()

This method returns the status of the flag which controls and determines whether the menu is repositioned when near the edge of the screen. Returns true if the flag is on, otherwise false.

<void>SetRemoveRedundantSeparators <boolean>removeRedundantSeparators

This method allows you to set the flag which controls and determines whether the menu should remove redundant separators.

<integer>GetRemoveRedundantSeparators()

This method returns the status of the flag which controls and determines whether the menu should remove redundant separators. Returns true if the flag is on, otherwise false.

<void>SetFirstQuadDisplayed <integer>firstQuadDisplayed

This method allows you to set the first quad which will be displayed when a quad menu pops up.

The quad index, an integer between 0 and 3.

<integer>GetFirstQuadDisplayed()

This method returns the index of the first quad which will be displayed. Returns the quad index, an integer between 0 and 3.

<void>SetUseUniformQuadWidth <boolean>useUniformQuadWidth

This method allows you to set whether the quad menu has a uniform width or not.

<boolean>GetUseUniformQuadWidth()

This method returns the status of the uniform width flag for the quad menu. true if the quad menu has been set to use uniform width, otherwise false.

<void>SetMirrorQuad <boolean>mirrorQuad

This method allows you to set whether the quad menus are mirrored left to right.

<integer>GetMirrorQuad()

This method returns true if the quad menu is mirrored left to right, otherwise false.

<void>SetMoveCursorOnReposition <boolean>moveCursorOnReposition

This method allows you to set whether the cursor moves when the quad menu is repositioned because of clipping the edge of the screen.

<boolean>GetMoveCursorOnReposition()

This method returns true if the cursor moves when the quad menu is repositioned because of clipping the edge of the screen, otherwise false.

<void>SetReturnCursorAfterReposition <boolean>returnCursorAfterReposition

This method allows you to set whether the cursor is moved the opposite distance that it was automatically moved when the quad menu is repositioned because of clipping the edge of the screen.

<boolean>GetReturnCursorAfterReposition()

This method returns true if the cursor is moved the opposite distance that it was automatically moved when the quad menu is repositioned because of clipping the edge of the screen, otherwise false.

<void>SetInitialCursorLocInBox_0to1 <float>initialCursorLocX <float>initialCursorLocY

This method allows you to set the initial location of the cursor in the center quad box.

The two arguments specify the X and Y location of the cursor, as a ratio of the box size, between 0.0 and 1.0.

<float>GetInitialCursorLocXInBox_0to1()

This method returns the initial x location of the cursor in the center quad box, as a ratio of the box size, between 0.0 and 1.0.

<float>GetInitialCursorLocYInBox_0to1()

This method returns the initial y location of the cursor in the center quad box, as a ratio of the box size, between 0.0 and 1.0.

The following methods were changed to use RGB color values instead of RGBA in 3ds Max 6 and higher.

<void>SetTitleBarBackgroundColor <integer>quad <&RGB color>color

This method allows you to set the title bar background color for a specific quad. Note: color is In parameter

<integer>quad: The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetTitleBarBackgroundColor <integer>quad

This method returns the title bar background color of a specific quad. This method returns the color as an RGB Color value.

<integer>quad: The quad (numbered 1 through 4).

<void>SetTitleBarTextColor <integer>quad <&RGB color>color

This method allows you to set the title bar text color for a specific quad. Note: color is In and Out parameter

<integer>quad: The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetTitleBarTextColor <integer>quad

This method returns the title bar text color of a specific quad. This method returns the color as a Color.

<integer>quad: The quad (numbered 1 through 4).

<void>SetItemBackgroundColor <integer>quad <&RGB color>color

This method allows you to set the item background color for a specific quad. Note: color is In and Out parameter

<integer>quad: The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetItemBackgroundColor <integer>quad

This method returns the item background color of a specific quad. This method returns the color as an RGB Color value.

<integer>quad: The quad (numbered 1 through 4).

<void>SetItemTextColor <integer>quad <&RGB color>color

This method allows you to set the item text color for a specific quad. Note: color is In and Out parameter

<integer>quad: The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetItemTextColor <integer>quad

This method returns the item text color of a specific quad. This method returns the color as an RGB Color value.

<integer>quad: The quad (numbered 1 through 4).

<void>SetLastExecutedItemTextColor <integer>quad <&RGB color>color

This method allows you to set the last executed item text color for a specific quad. Note: color is In and Out parameter

<integer>quad: The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetLastExecutedItemTextColor <integer>quad

This method returns the last executed item text color of a specific quad. This method returns the color as a Color.

<integer>quad: The quad (numbered 1 through 4).

<void>SetHighlightedItemBackgroundColor <integer>quad <&RGB color>color

This method allows you to set the highlighted item background color for a specific quad. Note: color is In and Out parameter

<integer>quad: The quad (numbered 1 through 4).

<&RGBA color>color: The color to set.

<&RGB color>GetHighlightedItemBackgroundColor <integer>quad

This method returns the highlighted item background color of a specific quad. This method returns the color as a Color.

<integer>quad: The quad (numbered 1 through 4).

<void>SetHighlightedItemTextColor <integer>quad <&RGB color>color

This method allows you to set the highlighted item text color for a specific quad. Note: color is In and Out parameter

<integer>quad: The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetHighlightedItemTextColor <integer>quad

This method returns the highlighted item text color of a specific quad. This method returns the color as a Color.

<integer>quad: The quad (numbered 1 through 4).

<void>SetBorderColor <integer>quad <&RGB color>color

This method allows you to set the border color for a specific quad. Note: color is In and Out parameter

<integer>quad: The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetBorderColor <integer>quad

This method returns the border color of a specific quad. This method returns the color as a Color.

<integer>quad: The quad (numbered 1 through 4).

<void>SetDisabledShadowColor <integer>quad <&RGB color>color

This method allows you to set the disabled shadow color for a specific quad. Note: color is In and Out parameter

<integer>quad : The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetDisabledShadowColor <integer>quad

This method returns the disabled shadow color of a specific quad. This method returns the color as a Color.

<integer>quad: The quad (numbered 1 through 4).

<void>SetDisabledHighlightColor <integer>quad <&RGB color>color

This method allows you to set the disabled highlight color for a specific quad. Note: color is In parameter

<integer>quad : The quad (numbered 1 through 4).

<&RGB color>color: The color to set.

<&RGB color>GetDisabledHighlightColor <integer>quad

This method returns the disabled highlight color of a specific quad. This method returns the color as a Color.

<integer>quad : The quad (numbered 1 through 4).

See also

Menu Manager

Interface: menuMan

Class ImenuSettings (in the SDK Help file accompanying this product)