Событие Error

Имеет место при возникновении в методе ошибки этапа выполнения.

Применение

CheckBox, ComboBox, CommandButton, CommandGroup, Объект Container, Объект Control, Cursor, Custom, DataEnvironment, EditBox, Form, FormSet, Grid, Image, Label, Line, ListBox, Связанный элемент управления OLE, Элемент управления OLE - контейнер, OptionButton, OptionGroup, Page, PageFrame, Relation, Shape, Spinner, TextBox, Timer, ToolBar

Синтаксис

PROCEDURE Object.Error
LPARAMETERS [nIndex,] nError, cMethod, nLine

Параметры

Visual FoxPro передает событию Error три или четыре параметра в следующем поря ке.

nIndex

Однозначно идентифицирует элемент управления, если он принадлежит массиву э ементов управления.

nError

Содержит номер ошибки Visual FoxPro. Список ошибок по их номерам приведен в теме Сообщения об ошибках в Техническом справочнике.

cMethod

Содержит имя метода, вызвавшего ошибку. Однако если метод вызывает пользовате ьскую функцию и ошибка происходит при выполнении этой функции, аргумент cMethod содержит имя пользовательской функции, а не имя вызвавшего ее метода.

nLine

Содержит номер строки с ошибкой в методе или пользовательской функции.

Комментарии

С помощью события Error объект может обрабатывать ошибки. Это событие отменяет действие текущей программы ON ERROR и позволяет объектам выявлять и обрабат вать ошибки своими внутренними средствами.

Важное замечание Событие Error вызывается только в случае возникновения ошибки в коде.

Если при выполнении процедуры события Error, обрабатывающей ошибку, возникает еще одна ошибка, Visual FoxPro вызывает программу ON ERROR. Если программы ON ERROR не существует, Visual FoxPro прекращает работу и сообщает об ошибке, как если бы не были определены ни событие Error, ни программа ON ERROR.