SplitButton

Описание

Компонент SplitButton представляет собой кнопку, состоящую из двух частей: верхняя часть - кнопка с картинкой, нижняя - кнопка с раскрывающимся меню.

Комментарии

Кнопка с картинкой возвращается при помощи метода SplitButton.getImageButton, кнопка с раскрывающимся меню - при помощи метода SplitButton.getContentButton.

Пример

Кнопка имеет следующий вид:

Пример создания компонента SplitButton

Кнопка может размещаться горизонтально:

Пример создания горизонтальной кнопки

Конструктор

  Имя конструктора Краткое описание
SplitButton Конструктор SplitButton создает экземпляр компонента SplitButton.

Свойства

  Имя свойства Краткое описание
ImageList Свойство ImageList определяет спрайт, откуда будет выбрана пиктограмма для верхней части кнопки.
ImageUrl Свойство ImageUrl определяет путь к изображению верхней части кнопки.
IsPressed Свойство IsPressed устанавливает признак того, что кнопка находится в нажатом состоянии.
IsToggleButton Свойство IsToggleButton определяет, можно ли переключать состояния верхней части кнопки (нажать/отжать).
Menu Свойство Menu определяет дочернее меню компонента.
MenuDropPosition Свойство MenuDropPosition устанавливает позицию открытия дочернего меню компонента.
UseWrapping Свойство UseWrapping осуществляет перенос слов по строкам.

Методы

  Имя метода Краткое описание
getColumnIndex Метод getColumnIndex возвращает индекс столбца с пиктограммой, выбранной из спрайта.
getContentButton Метод getContentButton возвращает нижнюю часть кнопки (с раскрывающимся меню).
getImageButton Метод getImageButton возвращает верхнюю часть кнопки (с картинкой).
getIsHorizontal Метод getIsHorizontal возвращает признак того, что для кнопки применяется горизонтальное размещение.
getRowIndex Метод getRowIndex возвращает индекс строки с пиктограммой, выбранной из спрайта.

События

  Имя события Краткое описание
DefaultAction Событие DefaultAction наступает при нажатии на верхнюю часть кнопки (с картинкой).

Свойства, унаследованные от класса Control

Примечание. Значение свойства Height для компонента SplitButton изменить нельзя, так как высота компонента предопределена.

  Имя свойства Краткое описание
Свойство Anchors определяет позицию компонента, размещенного внутри контейнера.
Свойство Animation устанавливает параметры анимации для компонента.
Bottom Свойство Bottom устанавливает отступ снизу при размещении компонента внутри LayoutPanel.
Свойство Content устанавливает содержимое компонента.
Свойство ContextMenu устанавливает контекстное меню для компонента.
Свойство Data предназначено для хранения любых пользовательских данных.
DataContext Свойство DataContext содержит объект с данными.
Свойство Enabled устанавливает, является ли компонент доступным для использования.
Свойство Height устанавливает высоту компонента.
Свойство IsResizable определяет, можно ли изменять размеры компонента.
Свойство IsRTL устанавливает направление текста справа налево.
Свойство IsVisible определяет, отображается ли компонент.
Свойство Left устанавливает отступ слева при размещении компонента внутри GridPanel.
Свойство Offset определяет координаты корневой DOM-вершины элемента управления.
Свойство Opacity определяет прозрачность компонента.
Свойство Parent определяет родительский компонент элемента управления.
Свойство ParentNode устанавливает родительскую DOM-вершину.
Свойство ResourceKey устанавливает ресурсный ключ для компонента.
Right Свойство Right устанавливает отступ справа при размещении компонента внутри LayoutPanel.
Свойство Rotate устанавливает угол поворота компонента.
Свойство ShowToolTip определяет, включена ли возможность отображать всплывающую подсказку компонента.
Свойство Style устанавливает стиль для компонента.
Свойство TabIndex задает последовательность перехода элемента управления внутри контейнера.
Свойство Tag устанавливает JSON-объект, ассоциированный с компонентом.
Свойство ToolTip определяет текст всплывающей подсказки компонента.
Свойство Top устанавливает отступ сверху при размещении компонента внутри GridPanel.
Свойство Value задает значение компоненту.
Свойство Width устанавливает ширину компонента.

Методы, унаследованные от класса Control

  Имя метода Краткое описание
Метод addClass добавляет CSS-класс к компоненту.
addEvent Метод addEvent добавляет обработчик события на DOM-вершину.
addEventHandler Метод addEventHandler добавляет обработчик события на DOM-вершину.
addEvents Метод addEvents добавляет массив обработчиков событий на DOM-вершину.
Метод addStateClass добавляет CSS-класс к компоненту и удаляет прежний CSS-класс.
addStyleBySelector Метод addStyleBySelector создает блок со стилем с указанным css-селектором.
Метод addToNode добавляет компонент в указанную вершину.
bindEvents Метод bindEvents подписывает элемент на все стандартные события.
Метод clearStylesCache очищает кэш стилей компонента.
Метод getAnchorFlags возвращает JSON-объект с настройками текущей позиции компонента.
Метод getClass возвращает текущие css-классы компонента.
Метод getCssStyle возвращает стили для указанной вершины.
Метод getDomNode возвращает главную DOM-вершину компонента.
Метод getFocused определяет наличие фокуса у компонента.
getFunctionByName Метод getFunctionByName возвращает функцию по имени.
getIsBinded Метод getIsBinded возвращает признак подписи элемента на события DOM-вершины.
Метод hasClass определяет, задан ли для корневой DOM-вершины элемента управления указанный CSS-класс.
Метод hide скрывает элемент управления.
Метод hideToolTip очищает таймаут появления подсказки и скрывает ее, если она был показана.
Метод isResingNow определяет, изменяются ли в данный момент размеры компонента.
refreshBindingProperty Метод refreshBindingProperty обновляет привязанное свойство по имени.
refreshItemsStyle Метод refreshItemsStyle обновляет CSS-стили дочерних элементов.
refreshStyle Метод refreshStyle обновляет CSS-стили элемента.
Метод removeClass удаляет CSS-класс из компонента.
Метод removeEvent удаляет обработчик события у DOM-вершины.
removeEventHandler Метод removeEventHandler удаляет обработчик события DOM-вершины.
removeFromDOM Метод removeFromDOM удаляет вершину из DOM-структуры.
Метод removeStateClasses удаляет CSS-классы компонента.
Метод setDraggable устанавливает возможность перетаскивания компонента на html-странице.
Метод setFocus устанавливает фокус компонента.
Метод setIsHovered отображает компонент как при наведении на него курсора.
Метод setIsPressed отображает компонент как при клике по нему.
Метод setOpacityIE8 устанавливает значение прозрачности компонента в браузере InternetExplorer 8.
Метод setSize устанавливает размеры компонента.
Метод show отображает элемент управления.
unBindEvents Метод unBindEvents отписывает элемент от всех стандартных событий.
Метод updatePosition корректирует размер и положение при абсолютном позиционировании на основе текущих параметров.
Метод updateSize обновляет размеры компонента подгонке размеров контейнера, в котором находится компонент.

События, унаследованные от класса Control

  Имя события Краткое описание
Событие Drag наступает при нажатии и удерживании клавиши мыши.
Событие DragEnd наступает при окончании перетаскивания компонента.
Событие DragStart наступает, когда начинается перетаскивание компонента.
Событие OnContextMenu наступает при вызове контекстного меню компонента.
Событие SizeChanged наступает после изменения размеров компонента.
Событие SizeChanging наступает во время изменения размеров компонента.

Свойства, унаследованные от класса Object

  Имя свойства Краткое описание
Свойство Data ассоциирует произвольный объект с данным компонентом.
Свойство Id устанавливает идентификатор компонента.
Свойство Settings задает параметры компонента.

Методы, унаследованные от класса Object

  Имя метода Краткое описание
Метод clone создает копию объекта. Не реализован в PP.Ui.Control.
Метод dispose уничтожает компонент.
Метод getTypeName возвращает имя типа объекта без пространства имен, к которому он принадлежит.

См. также:

DHTML-компоненты