Численный тип данных. BINDEVENT() возвращает число привязок к событию объекта.

BINDEVENT( ) всегда возвращает 1, когда создана привязка к событию Windows message. В этом случае не производится выявления ошибки, так что в случае, если в качестве значений hWnd и nMessage были указаны недействительные величины, функция по-прежнему будет возвращать 1 и привязка будет действовать до тех пор, пока она не будет высвобождена.

Вы можете связывать любые действительные события, свойства или методы, включая методы Access и Assign объектов Visual FoxPro. Однако, событие и уполномоченные методы (делегаты) должны быть членами класса с областью видимости public, не являться protected или hidden.

Вы не можете привязаться к событию, имеющему параметры, которые пересылаются по ссылке. Хотя вызов BINDEVENT() достигает цели, поднятие метода, например, с помощью функции RAISEEVENT( ), не сработает.

Когда вы привязываете свойство, вы должны связать его напрямую, а не через метод Assign. Если же вы привязываетесь к методу Assign, имейте в виду, что методы Access и Assign маркированы, как Protected и не видимыми, за исключением видимости в пределах класса.

Замечание
Если вы привязываетесь к свойству, которое имеет метод Assign, метод-делегат может сработать дважды. Первый раз он сработает, когда производится вызов присвоения свойства. Второй раз он будет вызван, когда значение свойства будет реально установлено, внутри метода Assign, в значение параметра, которое ему передается. Метод-делегат должен предусматривать такую возможность.

Применяются обычные правила наследования. Если метод-делегат не содержит в себе никакого кода, Visual FoxPro ищет код для метода вверх по иерархии родителя.

Обработчик события вызывается, когда происходит срабатывание метода или когда он вызывается, как собственно метод. Вызов события,  как метода, поднимает событие, если вы не указали значение флага nFlags равным 2 или 3.

По умолчанию, Visual FoxPro вызывает метод-делегат до события. Однако, вы можете изменить дефолтное поведение с помощью соответствующей установки nFlags.

Если вы укажете свойство, как событие, которое вы желаете привязать, Visual FoxPro безусловно привязывает это свойство методу Assign. Когда свойство события изменяется, Visual FoxPro поднимает событие.

Если в качестве параметра было послано недействительное значение, Visual FoxPro сгенерирует ошибку, "Function argument value, type, or count is invalid." Однако, если проблема возникнет во время операции привязки, то Visual FoxPro не генерирует ошибки. Вы можете использовать возвращаемое функцией BINDEVENT( ) значение, для определения числа привязок.

Определенные события управляющих элементов такие, как GotFocus, LostFocus, InteractiveChange и ProgrammaticChange не работают, если установлен второй бит параметра nFlags, например, nFlags установлен в значение 2. Эти события Visual FoxPro внутренне рассматривает, как вызовы методов, даже несмотря на то, что они подразумеваются, как события. Аналогичное поведение применяется и к методу Refresh объекта на форме, который вызывается в случае, если вызван метод Refresh формы. Определенные события, такие, как When и Valid сработают только в том случае, если содержат в себе какой-либо код.

BINDEVENT() не поддерживает напрямую свойство Value, так как оно обслуживается Visual FoxPro особым образом. Вместо этого свойства, вы должны использовать события InteractiveChange и ProgrammaticChange, если желаете привязаться к этому значению. В дополнение к сказанному, отметьте себе, что свойство ActivePage не поддерживается.

Если оригинальное событие содержит в своем процедурном коде команду NODEFAULT, Visual FoxPro продолжает обслуживание события, по той причине, что метод-делегат содержит код и вызывается до события. NODEFAULT применяется только к "родным" объектам Visual FoxPro.

Если вы производите точный дубликат вызова BINDEVENT( ), Visual FoxPro сбрасывает вызов, но продолжит возвращать число привязок к событию объекта. Если вы измените установку nFlags, вы можете вызвать BINDEVENT() для перепривязки события.

При привязке к событиям Windows message (Win Msg), может существовать только один дескриптор hWnd для спаривания Windows message. Вы можете послать значение 0 в качестве hWnd, если вы желаете привязать все окна к одному и тому же событию Windows message. Привязка события Windows message может быть высвобождена с помощью функции UNBINDEVENTS() и командой CLEAR. Кроме того, если объект обработчика, указанный в параметре oEventHandler более не существует, привязка высвобождается, когда происходит его Windows message.

С привязкой события Windows message, ваш пользовательский код будет исполняться каждый раз, при наступлении события, включая сценарии, в который отображается модальный диалог. Это происходит потому, что Window Procedure обязана всегда обработать сообщение и вернуть результат. Поскольку возможно получение рекурсии события во время исполнения вашего, определенного для этой конкретной привязки, кода, вы можете пожелать указать значение 4 для nFlags, с целью предотвращения подобного поведения.

Замечание
Привязка к событию Windows message должна выполняться с учетом того, что ваш код привязан к событию, поднимаемому операционной системой Windows и эти события могут наступить там, где вы совсем не предполагали их.

Задачи

Справочное руководство

Концепции

Процие ресурсы