Просмотр исходного текста страницы OnAnimationEvent - Form

[[Category:Скриптинг]]
[[Category:Papyrus]]
[[Category:Events]]
{{MemberOfScripts|parents=[[ActiveMagicEffect Script]], [[Alias Script]], и [[Form Script]]}}
Событие вызывается, когда активный магический эффект/алиас/форма получили одно из наблюдаемых анимационных событий.

== {{Syntax}} ==
<source lang="papyrus">
Event OnAnimationEvent(ObjectReference akSource, string asEventName)
</source>

== {{Parameters}} ==
*'''akSource''': [[ObjectReference Script|Ссылка]], отправившая событие.
*'''asEventName''': [[Animation Events|Событие]], которое было получено.

== {{Example}} ==
<source lang="papyrus">
Function SomeFunction()
  RegisterForAnimationEvent(JoeBob, "IdleFurnitureExit") ; Перед использованием OnAnimationEvent нужно зарегистрировать обработчик.
EndFunction

Event OnAnimationEvent(ObjectReference akSource, string asEventName)
  If (akSource == self) && (asEventName == "Reset")
    Debug.Trace("Мы получили событие сброса анимационного графа от самого объекта, наблюдающего за событием!")
  EndIf
EndEvent
</source>

'''Другой пример: проверка событий через скрипт'''
<source lang="papyrus">
Scriptname DetectCastEventScript extends Quest

Event OnInit()
    RegisterForAnimationEvent(Game.GetPlayer(), "BeginCastRight") 
    RegisterForAnimationEvent(Game.GetPlayer(), "BeginCastLeft") 
    RegisterForAnimationEvent(Game.GetPlayer(), "MRh_SpellFire_Event") 
endEvent

Event OnAnimationEvent(ObjectReference akSource, string asEventName)
 	If (akSource == Game.GetPlayer()) && (asEventName == "BeginCastRight")
   		Debug.MessageBox("Обнаружено событие BeginCastRight!")
 	EndIf
	If (akSource == Game.GetPlayer()) && (asEventName == "MRh_SpellFire_Event")
   		Debug.MessageBox("Обнаружено событие SpellFire_Event!")
 	EndIf
EndEvent
</source>

== {{Notes}} ==
* Алиасы и квесты будут автоматически убирать отслеживание этого события при остановке квеста. Активные магические эффекты будут автоматически убирать отслеживание события, когда будут удалены.
* Это событие '''не''' передается/ретрансируется к каким-либо алиасам или магическим эффектам, присоединенным к данной форме.
* Это событие '''будет''' передаваться/ретранслироваться другим скриптам, присоединенным к данному объекту. Например: На форме квеста с 2 основными квестовыми скриптами и скриптовом фрагментом, событие обновления, зарегистрированное в одном скрипте будет получено всеми тремя скриптами.
* Игра позволяет вам регистрировать обработчик на ЛЮБОЕ анимационное событие, валидное или не валидное. Хотя они и могут быть успешно зарегистрированы, это не обязательно значит, что такие события будут сгенерированы. [[Talk:RegisterForAnimationEvent_-_Form|Для более подробной информации смотри страницу обсуждения.]]

== {{See Also}} ==
*[[ActiveMagicEffect Script]]
*[[Alias Script]]
*[[Form Script]]
*[[RegisterForAnimationEvent - Form]]
*[[UnregisterForAnimationEvent - Form]]
*[[Анимационные события]]