روش dispatchEvent() XML DOM

تعریف و استفاده

روش dispatchEvent() رویداد ترکیبی را به نقطه تخصیص می‌دهد.

قوانین دستور زبان:

dispatchEvent(evt)
پارامتر وصف
evt لازم است. شامل Event باید تخصیص داده شود.

برگشت

در صورت اینکه در طول فرآیند گسترش رویداد روش evt از روش preventDefault()، به false بازمی‌گردد، در غیر این صورت به true بازمی‌گردد.

پراند

اگر شامل Event evt نشده است، یا نوع خاصیت آن null یا خالی است، این روش یک استثنا خواهد پراند.

وصف

این روش یک رویداد ترکیبی را تخصیص می‌دهد که توسط Document.createEvent() ایجاد، توسط روش اولیه Event یا یکی از زیر رابط‌های آن تعریف شده.

نقطه‌ای که این روش فراخوانی می‌شود، هدف نقطه رویداد خواهد بود، که اولین بار در فاز جلب توجه رویداد در مسیر درختی مستند به پایین حرکت می‌کند. اگر خاصیت bubbles رویداد به true باشد، پس از پردازش رویداد در نقطه هدف، آن رویداد از مسیر درختی مستند به بالا شروع به شناور شدن خواهد کرد.