Observable
  Component
    BoxComponent
      Button
        SplitButton
          CycleButton

Class Ext.CycleButton

Package:Ext
Defined In:CycleButton.js
Class:CycleButton
Extends:SplitButton
A specialized SplitButton that contains a menu of Ext.menu.CheckItem elements. The button automatically cycles through each menu item on click, raising the button's change event (or calling the button's changeHandler function, if supplied) for the active menu item. Clicking on the arrow section of the button displays the dropdown menu just like a normal SplitButton. Example usage:
var btn = new Ext.CycleButton({
    showText: true,
    prependText: 'View as ',
    items: [{
        text:'text only',
        iconCls:'view-text',
        checked:true
    },{
        text:'HTML',
        iconCls:'view-html'
    }],
    changeHandler:function(btn, item){
        Ext.Msg.alert('Change View', item.text);
    }
});

Config Options

Config OptionsDefined By
 allowDepress : Boolean
False to not allow a pressed Button to be depressed (defaults to undefined). Only valid when enableToggle is true.
Button
 allowDomMove : Boolean
Whether the component can move the Dom node when rendering (defaults to true).
Component
 arrowHandler : Function
A function called when the arrow button is clicked (can be used instead of click event)
SplitButton
 arrowTooltip : String
The title attribute of the arrow
SplitButton
 cls : String
A CSS class string to apply to the button's main element.
Button
 disabled : Boolean
True to start disabled (defaults to false)
Button
 disabledClass : String
CSS class added to the component when it is disabled (defaults to 'x-item-disabled').
Component
 enableToggle : Boolean
True to enable pressed/not pressed toggling (defaults to false)
Button
 handleMouseEvents : Boolean
False to disable visual cues on mouseover, mouseout and mousedown (defaults to true)
Button
 hidden : Boolean
True to start hidden (defaults to false)
Button
 iconCls : String
A css class which sets a background image to be used as the icon for this button
Button
 menuAlign : String
The position to align the menu to (see Ext.Element.alignTo for more details, defaults to 'tl-bl?').
Button
 minWidth : Number
The minimum width for this button (used to give a set of buttons a common width). See also Ext.Panel.minButtonWidth.
Button
 pageX : Number
The page level x coordinate for this component if contained within a positioning container.
BoxComponent
 pageY : Number
The page level y coordinate for this component if contained within a positioning container.
BoxComponent
 pressed : Boolean
True to start pressed (only if enableToggle = true)
Button
 scope : Object
The scope (this reference) in which the handler and toggleHandler is executed. Defaults to this Button.
Button
 showText : Boolean
True to display the active item's text as the button text (defaults to false)
CycleButton
 tabIndex : Number
Set a DOM tabIndex for this button (defaults to undefined)
Button
 text : String
The button text to be used as innerHTML (html tags are accepted)
Button
 toggleGroup : String
The group this toggle button is a member of (only 1 per group can be pressed)
Button
 tooltipType : String
The type of tooltip to use. Either 'qtip' (default) for QuickTips or 'title' for title attribute.
Button
 type : String
submit, reset or button - defaults to 'button'
Button
 x : Number
The local x (left) coordinate for this component if contained within a positioning container.
BoxComponent
 y : Number
The local y (top) coordinate for this component if contained within a positioning container.
BoxComponent

Public Properties

PropertyDefined By
 disabled : Boolean
Read-only. True if this button is disabled
Button
 hidden : Boolean
Read-only. True if this button is hidden
Button
 initialConfig : Object
This Component's initial configuration specification. Read-only.
Component
 menu : Menu The {@link Ext.menu.Menu Menu} object used to display the {@link Ext.menu.CheckItem CheckItems} representing the available choices.
CycleButton
 pressed : Boolean
Read-only. True if this button is pressed (only if enableToggle = true)
Button
 rendered : Boolean
True if this component has been rendered. Read-only.
Component

Public Methods

MethodDefined By

Public Events

EventDefined By