TabControl

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

Комментарии

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

Пример

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

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

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

, при нажатии на который будет удалена вкладка.

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

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

Конструктор

Свойства

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

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

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

Методы, унаследованные от класса 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 возвращает массив названий методов и свойств для указанного объекта.

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

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

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