EDIT.OnSuccessfulChange

Синтаксис

PROPERTY [RW, E] OnSuccessfulChange: PROC;

Описание

Ссылка на процедуру - обработчик успешного изменения значения поля. Может принимать пустое значение. В случае попытки установить значением свойства ссылку на функцию, выбрасывается исключение 176. Значение по умолчанию, устанавливаемое при создании объекта: пустое.

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

Обработчик принимает два параметра: ссылку на изменившееся поле ввода, экземпляр EDIT, и значение поля до изменения. Заголовок обработчика может иметь, например, следующий вид.

PROCEDURE OnSuccessfulChangeProc(Edit: EDIT; Prev: ANYTYPE);

Факт изменения поля фиксируется в момент, когда фокус переходит к другому полю ввода или к кнопке, экземпляру PUSH_BUTTON, при нажатии кнопки, а также, если данный экземпляр EDIT - это поле со списком, при выборе элемента из списка. До версии 14.252.020 изменение поля с выпадающим списком фиксировалось также при переборе значения комбинациями клавиш Ctrl+Влево и Ctrl+Вправо. Изменение является успешным, если измененный текст прошел проверку системой на соответствие требующемуся типу данных, и установлено новое значение свойства EDIT.Value. В случае, если текст не прошел проверку, фокус возвращается в изменившееся поле ввода, при этом пользователю предлагается возможность вернуть в поле ввода последнее корректное значение, установленное программно или введенное пользователем и затем проверенное системой.

См. также

Свойство добавлено в версии 14.164.020.