Компоненты ввода и отображения чисел, дат и времени Компоненты ввода и отображения чисел Компонент UpDown

Страница Win32

Компонент TUpDownпредставляет собой пару кнопок со стрелками, подобными стрелкам счетчика. Щелкая мышью на этих кнопках, можно изменять численные значения величин, относящихся к компоненту, обслуживаемому этими кнопками. Как правило,TUpDownсвязывается с окном редактированияTEdit. В этом случаеTEditпревращается в компонент, в котором пользователь может выбирать целое число, изменяя его кнопками со стрелками. Если к тому же установить вtrueсвойство окнаReadOnly, то пользователь просто не сможет ввести в окно какой-либо свой текст и вынужден будет ограничиться выбором числа.

Associate :TWinControl –связывает кнопки со стрелками с одним из расположенных на форме оконных компонентов, обычно сTEdit.

AlignButton:TUDAlignButton, гдеTUDAlignButton = (udLeft, udRight) – определяет слева (при значении udLeft) или справа (при значении udRight) от окна редактирования будут размещаться кнопки.

Orientation:TUDOrientation, где TUDOrientation = (udHorizontal, udVertical) – определяет расположение кнопок: udHorizontal - кнопки влево-вправо одна рядом с другой, udVertical - кнопки вверх-вниз одна под другой

ArrowKeys:Boolean– определяет, будут ли управлять компонентом клавиши клавиатуры со стрелками.

Thousands :Boolean– определяет наличие или отсутствие разделительного пробела между каждыми тремя цифрами разрядов вводимого число.

Min:SmallIntзадает минимальное значения чисел.

Max:SmallInt– задает максимальное значения чисел.

Increment:Integer– задает приращение числа при каждом нажатии на кнопку.

Position:SmallInt– определяет текущее значение числа. Это свойство можно читать, чтобы узнать, какое число задал пользователь. Его можно задать во время проектирования в диапазонеMin-Max. Тогда это будет значение числа по умолчанию, отображаемое в окне в начале выполнения приложения.

Wrap:Boolean–определяет, как ведет себя компонент при достижении максимального или минимального значений. ЕслиWrap=false, то при увеличении или уменьшении числа до максимального или минимального значения это число фиксируется на предельном значении и нажатие кнопки, пытающейся увеличить максимальное число или уменьшить минимальное, ни к чему не приводит. Если жеWrap=true, то попытка превысить максимальное число приводит к его сбросу на минимальное значение. Аналогично, попытка уменьшить минимальное число приводит к его сбросу на максимальное значение. Т.е. изменение чисел "закольцовывается".

События

OnChanging Наступает перед измением значения Position. В обработчике можно запретить изменение

OnChangingEx Наступает перед измением значения Position. В обработчике можно запретить изменение. В отличие от OnChanging можно определить намечаемое значение Position и направление изменения (уменьшение, увеличение, выход за допустимые пределы)

OnClick Наступает при щелчке пользователя на кнопке компонента. В обработчике можно определить кнопку, на которой произведен щелчок.

Компонент SpinEdit

Страница Samples

Этот компонент представляет собой комбинацию обычного редактирующего элемента и кнопки со стрелками вверх и вниз (TSpinButton). Такие элементы управления стали практически повсеместными для редактирования числовых величин. При большом изменении величины удобней набрать ее в редакторе заново, а в случае небольшого — скорректировать несколькими нажатиями стрелок.

EditorEnabled: Boolean –В состоянииFalseзапрещает изменение значений в редакторе.

ReadOnly: Boolean– В состоянииTrueполностью запрещает изменение значений (при помощи кнопок и редактора).

MinValue: Longint –Содержит минимальное допустимое значение.

MaxValue: Longint– Содержит максимальное допустимое значение.

MaxLength:Integer– Содержит значение максимального количества символов (цифр, знаков '-' и '+')в редакторе.

Increment:Longint– Содержит величину, на которую изменяется значение в редакторе при каждом нажатии кнопки

Value:Longint– Содержит текущее значение.

Text :TCaption– Содержит текст окна редактирования. Свойство только для чтения.

События

Щелчки мышью на компоненте интерпретируются следующим образом. Если щелчок или двойной щелчок произошли над областью редактора, то возникают соответственно события:

OnClick

OnDblClick

Если щелчок произошел над областью кнопки, то возникают специфические для нее события

OnUpClickили

OnDownClick,

а в самом компоненте только отражается произошедшее изменение:

OnChange

Событие OnChangeвозникает также при редактировании текста (если оно не запрещено). Если нажать и не отпускать одну из кнопок, то в это время соответствующие события происходят периодически (период 400 мс).