Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Обработчик события

Компонент позволяет создать пользовательское событие с возможностью передачи его аргументов. Реализован на базе компонента Команда (Action) и буфера аргументов Args типа Буфер аргументов события.

Компонент можно использовать, например, когда необходимо, чтобы аргументы события, произошедшего на одной форме проекта, были переданы на другую форму в момент наступления события. Для этого:

  1. На форме, ожидающей передачи аргументов события, создается экземпляр обработчика события EventHandler, а на форме, где ожидается наступление события и генерация его аргументов – ссылка на обработчик события pEventHandler.
  2. Когда нужно уведомить EventHandler о наступлении события:
    1. В экземпляр pEventHandler помещается аргумент события. Для этого используется вложенный объект pEventHandler.Args. Аргумент помещается в буфер с помощью команды:
      pEventHandler.Args.Push(string arg)
    2. Затем вызывается функция Invoke() экземпляра pEventHandler, активирующая событие EventHandler.
  3. В обработчике события Invoked экземпляра EventHandler:
    1. Сначала извлекается переданный аргумент с помощью команды:
      EventHandler.Args.Get()
    2. Затем выполняется обработка полученного аргумента.

Для корректной работы буфера с аргументами следует соблюдать следующие правила:

  • один раз вызывать функцию Push() перед вызовом функции Invoke() экземпляра pEventHandler при формировании события;
  • один раз вызывать функцию Get() при получении аргументов события в обработчике EventHandler.