NumberEdit

Описание

Компонент NumberEdit представляет собой числовой редактор с кнопками прокрутки.

Комментарии

Компонент реализован классом NumberEdit, наследником класса SpinEdit.

Пример

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

Изменять значение в редакторе можно с помощью кнопок прокрутки, клавиш «Вверх/вниз» или путем ввода значения с клавиатуры.

Для компонента можно определить, какие символы будут использоваться в качестве разделителя разрядов и разделителя тысяч. Кроме того, можно установить количество символов после запятой, минимальное и максимальное допустимые значения, шаг, с которым будет изменяться значение при нажатии клавиш «Вверх/вниз» или кнопок прокрутки.

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

Конструктор

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

Свойства

	Имя свойства	Краткое описание
	DecimalSeparator	Свойство DecimalSeparator устанавливает символ разделителя разрядов.
	EnableGroupSeparator	Свойство EnableGroupSeparator определяет разделение групп разрядов.
	FractionCount	Свойство FractionCount устанавливает количество знаков после разделителя разрядов.
	GroupSeparator	Свойство GroupSeparator устанавливает разделитель тысяч.
	MaxValue	Свойство MaxValue устанавливает максимальное допустимое значение компонента.
	MinValue	Свойство MinValue устанавливает минимальное допустимое значение компонента.
	Prefix	Свойство Prefix устанавливает префикс для значения в компоненте.
	Step	Свойство Step определяет размер шага, с которым изменяется значение компонента.
	Suffix	Свойство Suffix устанавливает суффикс для значения в компоненте.
	Value	Свойство Value устанавливает числовое значение компонента.
	Walkthrough	Свойство Walkthrough определяет, является ли прокрутка значения цикличной.

События

	Имя события	Краткое описание
	AfterValueChange	Событие AfterValueChange наступает после изменения значения компонента.
	Validate	Событие Validate наступает во время проверки корректности введённых данных.

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

	Имя свойства	Краткое описание
	ShowButtons	Свойство ShowButtons определяет, используются ли кнопки для переключения значений в компоненте.

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

	Имя метода	Краткое описание
	setFocus	Метод setFocus устанавливает фокус для компонента.

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

	Имя события	Краткое описание
	AfterChange	Событие AfterChange наступает при завершении изменения текста в поле ввода.
	BeforeChange	Событие BeforeChange наступает в начале изменения текста в поле ввода.
	SpinDown	Событие SpinDown наступает при прокрутке вниз.
	SpinUp	Событие SpinUp наступает при прокрутке вверх.

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

	Имя свойства	Краткое описание
	ColImgIndex	Свойство ColImgIndex определяет индекс строки спрайта, по которому располагается устанавливаемая фоновая картинка.
	ControlButton	Свойство ControlButton определяет кнопку для управления текстовым полем.
	EnableEdit	Свойство EnableEdit определяет, разрешено ли редактирование текстового поля.
	ImageAlign	Свойство ImageAlign определяет выравнивание фоновой картинки.
	ImageEnabledAlways	Свойство ImageEnabledAlways определяет, будет ли фоновая  картинка текстового поля активна, если само поле неактивно.
	ImageHeight	Свойство ImageHeight определяет высоту фоновой картинки текстового поля.
	ImageList	Свойство ImageList определяет спрайт текстового поля.
	ImageUrl	Свойство ImageUrl определяет путь к фоновой картинке текстового поля.
	ImageWidth	Свойство ImageWidth определяет ширину фоновой картинки текстового поля.
	IsHint	Свойство IsHint определяет отображение подсказки при наведении курсора мыши на фоновую картинку текстового поля.
	IsPassword	Свойство IsPassword определяет признак замены введенного текста звездочками.
	IsWatermark	Свойство IsWatermark определяет признак отрисовки прозрачного текста, если текстовое поле пустое и не имеет фокуса.
	MaxLength	Свойство MaxLength определяет максимальную длину текста в текстовом поле.
	RowImgIndex	Свойство RowImgIndex определяет индекс столбца спрайта, по которому располагается устанавливаемая фоновая картинка.
	UseImageClass	Свойство UseImageClass определяет CSS-класс компонента фоновой картинки текстового поля.
	ValidState	Свойство ValidState определяет состояние текстового поля как корректно или некорректно заполненное, устанавливая соответствующую подсветку.
	WatermarkText	Свойство WatermarkText определяет текст, который будет отображаться, если текстовое поле пустое и не имеет фокуса.

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

	Имя метода	Краткое описание
	applyNotValidCSS	Метод applyNotValidCSS устанавливает стиль, определяющий подсветку некорректно введенного значения текстового поля.
	applyValidCSS	Метод applyValidCSS устанавливает стиль, определяющий подсветку корректно введенного значения текстового поля.
	blur	Метод blur снимает фокус с текстового поля.
	getImageMargin	Метод getImageMargin возвращает значение отступов фоновой картинки текстового поля.
	selectAll	Метод selectAll выделяет всё текстовое содержимое текстового поля.
	setAllowedSymbols	Метод setAllowedSymbols устанавливает список символов, разрешенных к вводу.
	setRestrictedSymbols	Метод setRestrictedSymbols устанавливает список символов, запрещенных к вводу.

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

	Имя события	Краткое описание
	AfterChange	Событие AfterChange наступает после окончания редактирования текстового поля.
	AfterTimeout	Событие AfterTimeout наступает после окончания редактирования текстового поля по истечении времени задержки между редактированием поля и вызовом события.
	BeforeChange	Событие BeforeChange наступает при начале редактирования текстового поля.
	Blur	Событие Blur наступает при потере фокуса текстовым полем.
	Enter	Событие Enter наступает при нажатии клавиши «Enter»  в активном текстовом поле.
	Focus	Событие Focus наступает при получении фокуса текстовым полем.
	ImageClick	Событие ImageClick наступает при клике левой кнопкой мыши по картинке текстового поля.
	ImageMouseDown	Событие ImageMouseDown наступает при нажатии левой кнопкой мыши на картинке текстового поля.
	ImageMouseOut	Событие ImageMouseOut наступает после выхода курсора мыши на пределы фоновой картинки текстового поля.
	ImageMouseOver	Событие ImageMouseOver наступает после наведения курсора мыши на фоновую картинку текстового поля.
	ImageMouseUp	Событие ImageMouseUp наступает при отпускании левой кнопки мыши при нахождении курсора в области картинки текстового поля.
	TextChanged	Событие TextChanged наступает после изменения текста текстового поля.
	ValueChanged	Событие ValueChanged наступает после изменения значения текстового поля.

Свойства, унаследованные от класса 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

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

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

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

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

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

См. также:

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