mouse_event

הפונקציה mouse_event יוצרת תנועה העכבר ולוחץ על לחצן.

Windows NT: פונקציה זו הוחלף. השתמש במקום זאת ב- SendInput.

(Mouse_event האין DWORD  dwFlags, / / דגלים ציון שונים תנועה/לחץ על משתניםDWORD dx, / / אופקי מיקום העכבר או שינוי מיקוםDWORD dy, / / אנכי מיקום העכבר או שינוי מיקוםDWORDdwData, / / בסכום של תנועת גלגלDWORDdwExtraInfo / / 32 סיביות מידע המוגדר על-ידי היישום);
 

פרמטרים

dwFlags
ערכת הסיביות דגל לציין היבטים שונים של תנועה העכבר ולחיצה על לחצן. Bits פרמטר זה יכול להיות כל שילוב סביר הערכים הבאים:
ערך משמעות
MOUSEEVENTF_ABSOLUTE מציין הפרמטרים dx , dy להכיל מנורמל קואורדינטות מוחלטות. אם לא הוגדר, פרמטרים אלה מכילים נתונים יחסי: שינוי מיקום מאז האחרון דיווח מיקום. דגל זה ניתן להגדיר, או אינו מוגדר, בלי קשר של איזה סוג של עכבר או התקן דמוי העכבר, אם בכלל, הוא מחובר למערכת. לקבלת מידע נוסף אודות תנועת העכבר יחסית, עיין בסעיף הערות הבאות.
MOUSEEVENTF_MOVE מציין כי התנועה התרחשה בעת.
MOUSEEVENTF_LEFTDOWN מציין כי הלחצן השמאלי למטה.
MOUSEEVENTF_LEFTUP מציין כי הלחצן השמאלי למעלה.
MOUSEEVENTF_RIGHTDOWN ציון הלחצן הימני הוא למטה.
MOUSEEVENTF_RIGHTUP מציין כי הלחצן הימני למעלה.
MOUSEEVENTF_MIDDLEDOWN מציין כי הלחצן האמצעי הוא למטה.
MOUSEEVENTF_MIDDLEUP מציין כי הלחצן האמצעי הוא למעלה.
MOUSEEVENTF_WHEEL Windows NT: מציין כי הגלגל הועבר, אם העכבר יש גלגל. מידת התנועה הוא ברשתו של dwData

dx
מציין מיקום מוחלט של העכבר לאורך ציר ה-x או את כמות התנועה מאז האירוע האחרון של העכבר הופק, בהתאם להגדרה של MOUSEEVENTF_ABSOLUTE. נתונים מוחלטת נתונה כמספר של העכבר בפועל קואורדינטת x; נתונים יחסיים ניתנת כמספר עבר mickeys. מיקי הוא הכמות הכוללת עכבר כדי להעביר אותו דוח זה שהועבר.
dy
מציין מיקום מוחלט של העכבר לאורך ציר ה-y או את כמות התנועה מאז האירוע האחרון של העכבר הופק, בהתאם להגדרה של MOUSEEVENTF_ABSOLUTE. נתונים מוחלטת נתונה כמספר של העכבר בפועל קואורדינטת y; נתונים יחסיים ניתנת כמספר עבר mickeys.
dwData
אם dwFlags MOUSEEVENTF_WHEEL, dwData מציין את כמות תנועת גלגל. ערך חיובי מציין הגלגל היה מסובב קדימה, הרחק המשתמש; ערך שלילי מציין הגלגל היה לסובב לאחור, כלפי המשתמש. לחץ על גלגל אחד מוגדר כ- WHEEL_DELTA, אשר הוא 120.

אם dwFlags לא MOUSEEVENTF_WHEEL, לאחר מכן dwData אמור להיות אפס.

dwExtraInfo
ציון ערך 32 סיביות נוסף שמשויכת לאירוע העכבר. יישום הקורא GetMessageExtraInfo כדי לקבל מידע נוסף זה.

להחזיר ערכים

פונקציה זו יש ערך החזרה.

הערות

אם העכבר עבר, המצוין על-ידי הגדרת, MOUSEEVENTF_MOVE dx , dy החזק מידע על תנועה זו. המידע ניתן כמספר ערכי מספרים שלמים מוחלט או יחסי.

אם צוין ערך MOUSEEVENTF_ABSOLUTE, dx dy מכילים מנורמל קואורדינטות מוחלטות בין 0 ל- 65,535. שגרת האירוע ממפה קואורדינטות אלה על פני התצוגה. לתאם מפות (0,0) אל הפינה השמאלית העליונה של משטח התצוגה, מפות (65535,65535) אל הפינה הימנית התחתונה.

אם לא צוין ערך MOUSEEVENTF_ABSOLUTE, dx , dy לציין את תנועות יחסית החל כאשר היה אירוע עכבר האחרון שנוצר (המיקום שדווחה האחרון). ערכים חיוביים מתכוון העכבר עבר מימין (או למטה); ערכים שליליים מתכוון העכבר עבר שמאלה (או עד).

תנועה יחסית העכבר כפוף ההגדרות עבור מהירות העכבר ורמת האצה. משתמש קצה קובע ערכים אלה באמצעות היישום עכבר של לוח הבקרה. יישום מקבל ומגדיר את ערכים אלו SystemParametersInfo הפונקציה.

המערכת חל שתי בדיקות תנועה שצוין העכבר יחסית כאשר החלה האצה. אם המרחק שצוין לאורך ציר x או y גדול יותר מערך הסף העכבר הראשון, רמת ההאצה של העכבר אינה אפס, מערכת ההפעלה מכפילה את המרחק. אם המרחק שצוין לאורך ציר x או y גדול מהערך סף עכבר השני רמת תאוצת העכבר שווה שתיים, מערכת ההפעלה מכפילה את המרחק הנובעות החלת במבחן סף הראשון. לכן אפשרי עבור מערכת ההפעלה להכפיל את העכבר שצוינה יחסית תנועה לאורך ציר x או y ציר על-ידי עד ארבע פעמים.

לאחר החלת האצה, המערכת שינוי הערך תוצאות לפי מהירות העכבר הרצוי. מהירות העכבר יכולים לנוע בין 1 (האיטית ביותר) ל- 20 (המהירה ביותר) ומייצג כמה מצביע מבוסס על המרחק העכבר זז. ערך ברירת המחדל הוא 10, שתוצאתה ללא כל שינוי נוסף לתנועה העכבר.

הפונקציה mouse_event משמשת משתמשים בטריק אירועי עכבר על-ידי יישומים הדרושים לשם כך. הוא משמש גם על-ידי יישומים הדרושים כדי להשיג מידע מהעכבר מאשר המיקום שלו ומצב לחצן. לדוגמה, אם יצרן הלוח מעוניין להעביר מידע מבוססי עט ליישומים משלה, שהוא יכול לכתוב של ספריית קישור דינאמי (DLL) אשר מתקשר ישירות לחומרת מחשב הלוח, משיג את המידע הנוסף ושומר אותו בתור. קובץ ה-DLL מכן קורא mouse_event עם לחצן רגיל ו- x / y למקם נתונים, יחד עם, בפרמטר dwExtraInfo , המצביע מסוימים או אינדקס למידע נוסף בתור. כאשר היישום דורש מידע נוסף, הוא קורא את קובץ ה-DLL עם המצביע או אינדקס המאוחסן ב- dwExtraInfo, ה-DLL ומחזירה את המידע הנוסף.

חלונות CE: Windows CE אינו תומך קבוע MOUSEEVENTF_WHEEL בפרמטר dwFlags.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.

ראה גם

מבט כולל על קלט עכבר, בפונקציות קלט עכבר, GetMessageExtraInfo, SystemParametersInfo

Index