Interface: quadMenuSettings

Interfaces > Core Interfaces > quadMenuSettings

 

   

Core Interfaces - Quick Navigation

The quadMenuSettings Core Interface exposes methods for controlling the Quad Menu settings.

Available in 3ds Max 4 and higher.

   

Methods:

<void>quadMenuSettings.ResetDefaults() 	 

This method will reset the menu settings to their defaults.

   

<void>quadMenuSettings.SetBorderSize <integer>borderSize 

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

   

<integer>quadMenuSettings.GetBorderSize() 

This method returns the menu border size.

   

<void>quadMenuSettings.SetHorizontalMarginInPoints <integer>horizontalMarginInPoints 

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

   

<integer>quadMenuSettings.GetHorizontalMarginInPoints() 

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

   

<void>quadMenuSettings.SetVerticalMarginInPoints <integer>verticalMarginInPoints 

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

   

<integer>quadMenuSettings.GetVerticalMarginInPoints() 

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

   

<void>quadMenuSettings.SetItemFontFace <string>szItemFontFace 

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

   

<string>quadMenuSettings.GetItemFontFace() 

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

   

<void>quadMenuSettings.SetTitleFontFace <string>szTitleFontFace 

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

   

<string>quadMenuSettings.GetTitleFontFace() 

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

   

<void>quadMenuSettings.SetItemFontSize <integer>itemFontSize 

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

   

<integer>quadMenuSettings.GetItemFontSize() 

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

   

<void>quadMenuSettings.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>quadMenuSettings.GetTitleFontSize() 

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

   

<void>quadMenuSettings.SetUseUniformItemHeight <boolean>useUniformItemHeight 

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

   

<boolean>quadMenuSettings.GetUseUniformItemHeight() 

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

   

<void>quadMenuSettings.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>quadMenuSettings.GetOpacity() 

This method returns the menu’s opacity value.

   

<void>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.SetAnimatedSteps <integer>animatedSteps 

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

   

<integer>quadMenuSettings.GetAnimatedSteps() 

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

   

<void>quadMenuSettings.SetAnimatedStepTime <integer>animatedStepTime 

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

   

<integer>quadMenuSettings.GetAnimatedStepTime() 

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

   

<void>quadMenuSettings.SetSubMenuPauseTime <integer>subMenuPauseTime 

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

   

<integer>quadMenuSettings.GetSubMenuPauseTime() 

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

   

<void>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.SetRemoveRedundantSeparators <boolean>removeRedundantSeparators 

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

   

<integer>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.SetUseUniformQuadWidth <boolean>useUniformQuadWidth 

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

   

<boolean>quadMenuSettings.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>quadMenuSettings.SetMirrorQuad <boolean>mirrorQuad 

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

   

<integer>quadMenuSettings.GetMirrorQuad() 

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

   

<void>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.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>quadMenuSettings.SetTitleBarBackgroundColor <integer>quad <&RGB color>color 

color is In parameter 

This method allows you to set the title bar background color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetTitleBarTextColor <integer>quad <&RGB color>color 

color is In and Out parameter 

This method allows you to set the title bar text color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetItemBackgroundColor <integer>quad <&RGB color>color 

color is In and Out parameter 

This method allows you to set the item background color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetItemTextColor <integer>quad <&RGB color>color 

color  is In and Out parameter 

This method allows you to set the item text color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetLastExecutedItemTextColor <integer>quad <&RGB color>color 

color is In and Out parameter 

This method allows you to set the last executed item text color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetHighlightedItemBackgroundColor <integer>quad <&RGB color>color 

color is In and Out parameter 

This method allows you to set the highlighted item background color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetHighlightedItemTextColor <integer>quad <&RGB color>color 

color is In and Out parameter 

This method allows you to set the highlighted item text color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetBorderColor <integer>quad <&RGB color>color 

color is In and Out parameter 

This method allows you to set the border color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetDisabledShadowColor <integer>quad <&RGB color>color 

color is In and Out parameter 

This method allows you to set the disabled shadow color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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>quadMenuSettings.SetDisabledHighlightColor <integer>quad <&RGB color>color 

color is In parameter 

This method allows you to set the disabled highlight color for a specific quad.

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

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

   

<&RGB color>quadMenuSettings.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