User Interface Controls > Common Properties > Layout > Types > Mapbutton |
A Mapbutton control is used to place a button in the rollout that will display the 3ds Max Material/Map Browser dialog when clicked. Only texture maps will be displayed in the Material/Map Browser dialog.
mapbutton <name> [<caption>] [map:<texturemap>] [images:<image_spec_array>] [toolTip:<string>] [border:<boolean>] [iconName:<filename> iconSize:<point3>]
The default alignment of mapbutton items is #center .
The initial textureMap value returned by the map property before the user has selected a texture map using the mapbutton . Defaults to undefined .
An image-specification array for providing bitmap images for the mapbutton . If this is specified, the <label> is ignored and the contents of the mapbutton are replaced with the bitmaps.
images:#(<image>, <maskImage>, <count_integer>, <enabled_out_image_index>, <enabled_in_image_index>, <disabled_out_image_index>, <disabled_in_image_index>)
where <image> and <maskImage> can be either a bitmap file-name string or a MAXScript bitmap value. <count_integer> specifies the number of sub-images in the bitmaps, and the image_index values specify which sub-image in the bitmaps is to be used for each of the four mapbutton states.
FOR EXAMPLE: |
would use a rendering as the mapbutton image, and |
would use sub-images 1 and 4 of bitmaps dcybtns.bmp and dcymask.bmp for the out and in states of the mapbutton , respectively. See also Image Buttons. |
Provides text for a tooltip for the mapbutton . No tooltip if unsupplied.
When set to true or not specified, the mapbutton will be drawn with a border. This was the default behavior prior to 3ds Max 2009.
When set to false, the mapbutton will be drawn without a border, making it one with the UI background. If the mapbutton is enabled, the border will appear when the material button is pressed, or upon mouseover.
Available in 3ds Max 2009 and higher.
iconName:
The filename of an icon to use as an image on the button. If iconName is specified, the caption is ignored. The iconSize specifies the iconName size at 100% DPI scaling. If not specified, the default [24,24] is assumed.
iconSize:
The size of the icon specified by iconName at 100% DPI scaling.
The current textureMap value for the mapbutton , or the textureMap value specified by the map parameter if the user has not yet selected a texture map.
Sets the image-specification array for the mapbutton . This property is write-only.
Get/set the tooltip string of the mapbutton.
Available in 3ds Max 9 and higher.
Called when the user selects a texture map from the Material/Map Browser dialog while in the mapbutton pick command mode. The <arg> argument will contain the selected textureMap value. The handler is not called if the user cancels out of the Material/Map Browser dialog.
Called when the right mouse button is released over the button. Available in 3ds Max 8 and higher.