تشریح کامل تابع clearmouseclick(event)
در محیطهای گرافیکی، ورودیهای کاربر (مانند فشار دادن کلید، حرکت ماوس، یا کلیک ماوس) به صورت رویداد (Events) در یک صف (Queue) ذخیره میشوند. برنامه شما در یک حلقه (Loop) مدام این صف را بررسی میکند.
1. هدف اصلی: مدیریت صف رویداد (Event Queue Management)
هدف اصلی clearmouseclick(event) این است که یک رویداد خاص را که قبلاً تشخیص داده شده و پردازش شده است، از این صف خارج کند تا از پردازش مجدد آن در تکرارهای بعدی حلقه جلوگیری شود.
2. ساختار آرگومانها: event
آرگومان event مشخص میکند که کدام نوع رویداد باید از صف پاک شود. در محیطهایی که از این تابع استفاده میشود، این آرگومانها معمولاً با مقادیری مانند:
WM_LBUTTONDOWN: رویداد فشار دادن دکمه چپ ماوس.
WM_LBUTTONUP: رویداد رها کردن دکمه چپ ماوس.
WM_RBUTTONDOWN: رویداد فشار دادن دکمه راست ماوس.
و… (که در ویندوز با نامهای WM_... شناخته میشوند).
تفاوت با ismouseclick()
ismouseclick(event): فقط بررسی میکند که آیا رویداد مورد نظر در حال حاضر در صف وجود دارد یا خیر (عملیات Read-Only).
clearmouseclick(event): رویداد مورد نظر را از صف حذف میکند (عملیات Write/Mutating).