TabControl

Описание

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

Комментарии

Компонент реализован классом TabControl.

Дочерним элементом компонента TabControl является компонент TabItem, представляющий из себя вкладку.

Пример

Компонент может включать в себя несколько вкладок. Новые вкладки добавляются при нажатии на вкладку со знаком «+». Во время добавления новых вкладок наступают события AfterAddItem и BeforeAddItem.

Вкладка открывается при нажатии на заголовок. С открытием и закрытием вкладок связаны события ItemSelected и ItemDeselected.

При помощи свойства TabControl.EnableDelete можно отобразить на вкладках значок , при нажатии на который будет удалена вкладка.

При помощи свойства TabControl.EnableEdit можно сделать редактируемыми заголовки вкладок.

В зависимости от значения свойства DragDropEnabled вкладки могут перетаскиваться при помощи механизма Drag&Drop:

ItemMoved - событие перемещения вкладки.

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

Конструктор

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

Свойства

  Имя свойства Краткое описание
AddTabButtonTemplate Свойство AddTabButtonTemplate определяет шаблон вкладки при добавление ее в панель.
Background Свойство Background устанавливает фон для панели компонента. на которой размещаются заголовки вкладок.
BlockUpdateSize Свойство BlockUpdateSize определяет, включена ли блокировка изменения размеров компонента.
Buttons Свойство Buttons содержит объект с массивами кнопок каждой стороны элемента управления.
ContentAutoFit Свойство ContentAutoFit определяет автоподгонку содержимого элемента управления под родительский элемент.
DragDropEnabled Свойство DragDropEnabled устанавливает возможность изменять положение вкладок при помощи механизма Drag&Drop.
EnableDelete Свойство EnableDelete определяет, доступно ли удаление вкладок.
EnableDragOutside Свойство EnableDragOutside определяет возможность выноса вкладки из элемента управления.
EnableDropFromOutside Свойство EnableDropFromOutside определяет возможность вставки вкладки из другого элемента управления.
EnableEdit Свойство EnableEdit определяет возможность редактирования заголовков вкладок.
EnableGroupSeparator Свойство EnableGroupSeparator определяет наличие разделителя между группами вкладок.
ImagePath Свойство ImagePath указывает путь до папки с изображениями для компонента.
IsAddTabButtonVisible Свойство IsAddTabButtonVisible определяет, отображается ли вкладка для добавления новых вкладок.
Items Свойство Items содержит массив вкладок элемента управления.
MenuAddItems Свойство MenuAddItems определяет меню добавления вкладок.
PaddingLeft Свойство PaddingLeft определяет величину левого отступа панели вкладок элемента управления.
SelectedIndex Свойство SelectedIndex устанавливает индекс выбранной вкладки.
SelectedItem Свойство SelectedItem определяет, какая вкладка является выделенной.
SelectOnStartEditing Свойство SelectOnStartEditing определяет, будет ли выделяться заголовок вкладки при двойном клике по нему.
TabsHeight Свойство TabsHeight определяет высоту вкладок элемента управления.
UseToolBarSwitch Свойство UseToolBarSwitch определяет стиль вкладок, как у панели инструментов.

Методы

  Имя метода Краткое описание
addButton Метод addButton добавляет кнопку в компонент TabControl.
addItem Метод addItem добавляет вкладку к компоненту.
beginUpdate Метод beginUpdate отключает перерисовку элемента управления до тех пор, пока не будет вызван метод endUpdate.
clear Метод clear удаляет все вкладки компонента.
endUpdate Метод endUpdate включает перерисовку элемента управления и обновляет её.
getActiveItem Метод getActiveItem возвращает выделенную вкладку элемента управления.
getContentPanel Метод getContentPanel возвращает DOM-узел, в котором располагается содержимое вкладок.
getItemByPoint Метод getItemByPoint возвращает вкладку элемента управления по заданным координатам.
getItemsList Метод getItemsList возвращает список вкладок из раскрывающейся панели компонента.
getLayoutItems Метод getLayoutItems возвращает массив вкладок элемента управления.
getPanel Метод getPanel возвращает панель вкладок элемента управления.
getToolBarButtonByTabItem Метод getToolBarButtonByTabItem возвращает кнопку панели инструментов вкладки элемента управления.
getToolBarButtonTemplate Метод getToolBarButtonTemplate возвращает шаблон кнопок панели инструментов.
getVisibleTabItemsAtPanel Метод getVisibleTabItemsAtPanel возвращает массив видимых вкладок панели элемента управления.
hideContent Метод hideContent скрывает содержимое вкладок.
insertButton Метод insertButton добавляет кнопку в компонент TabControl.
insertItem Метод insertItem добавляет вкладку в указанную позицию.
isElementVisible Метод isElementVisible возвращает признак видимости элемента.
removeItem Метод removeItem удаляет из компонента вкладку по ее индексу.
removeItemByIndex Метод removeItemByIndex удаляет вкладку по индексу.
scrollToItem Метод scrollToItem прокручивает панель вкладок до указанной вкладки.
showContent Метод showContent отображает содержимое вкладок.

События

  Имя события Краткое описание
AddButton Событие AddButton наступает при добавлении кнопки в элемент управления вкладками.
AddingItemFromMenu Событие AddingItemFromMenu наступает при добавлении вкладки из меню добавления вкладки.
AddMenuShowing Событие AddMenuShowing наступает во время вызова меню добавления вкладки.
AfterAddItem Событие AfterAddItem наступает после добавления в компонент новой вкладки.
BeforeAddItem Событие BeforeAddItem наступает перед добавлением новой вкладки.
BeforeShowGroupSeparator Событие BeforeShowGroupSeparator наступает перед отображением разделителя между группами вкладок.
DropedAfterGroupSeparator Событие DropedAfterGroupSeparator наступает после отображения разделителя между группами вкладок.
ItemDeselected Событие ItemDeselected наступает при закрытии вкладки.
ItemMoved Событие ItemMoved наступает после перемещения вкладки.
ItemSelected Событие ItemSelected наступает при выборе вкладки.
SelectableSelected Событие SelectableSelected наступает при нажатии кнопки мыши на элемент.
TabDeleted Событие TabDeleted наступает после удаления вкладки.
TabDragIn Событие TabDragIn наступает при внесении вкладки в область элемента управления.
TabDragOut Событие TabDragOut наступает при вынесении вкладки за пределы области элемента управления.
TabEdited Событие TabEdited наступает после выхода из режима редактирования.
TabEditing Событие TabEditing наступает при переходе в режим редактирования.
TabMenuShowing Событие TabMenuShowing наступает во время вызова меню у вкладки.
TextEdited Событие TextEdited наступает при выходе из режима редактирования, если был изменен текст заголовка.
TextEditing Событие TextEditing наступает при выходе из режима редактирования заголовка вкладки,  даже если текст данного заголовка не был изменён.

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

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

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

  Имя свойства Краткое описание

Id

Свойство Id определяет идентификатор объекта репозитория.

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

  Имя метода Краткое описание
clone Метод clone создает копию объекта.
dispose Метод dispose уничтожает компонент.
getHashCode Метод getHashCode возвращает хэш-код объекта репозитория.
getSettings Метод getSettings возвращает настройки объекта репозитория.
getTypeName Метод getTypeName возвращает имя типа объекта без пространства имен, к которому он принадлежит.
isEqual Метод isEqual определяет, равен ли заданный объект текущему объекту репозитория.
isLive Метод isLive определяет действительность объекта репозитория.
removeAllEvents Метод removeAllEvents удаляет все обработчики событий объекта по заданному контексту.
setSettings Метод setSettings задает настройки объекта репозитория.
defineProps Метод defineProps создает методы get и set из массива имен для указанного класса.
keys Метод keys возвращает массив названий методов и свойств для указанного объекта.

См. также:

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