SetCapture

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

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

(HWND SetCapture HWND  hWnd / / לטפל של חלון כדי לקבל לכידת העכבר);
 

פרמטרים

hWnd
לטפל לחלון בהליך המשנה הנוכחית כי היא ללכוד את העכבר.

להחזיר ערכים

הערך המוחזר הוא נקודת האחיזה של חלון שבו בעבר שתפסו את העכבר. אם אין חלון כזה, הערך המוחזר הוא NULL.

הערות

רק חלון קידמה ללכוד את העכבר. כאשר חלון רקע מנסה לעשות זאת, החלון מקבל הודעות רק עבור אירועי עכבר המתרחשות בעת המגע הסמן נמצא בתוך החלק הגלוי של החלון. כמו כן, גם אם יש חלון קידמה לכידת העכבר, המשתמש עדיין ללחוץ חלון אחר, להביא אותה אל החזית.

כאשר החלון דורשת עוד כל קלט עכבר, הליך המשנה שיצר את החלון יש לבצע קריאה לפונקציה ReleaseCapture כדי לשחרר את לחצן העכבר.

לא ניתן להשתמש בפונקציה זו כדי לכידת קלט עכבר מיועד תהליך אחר.

Windows 95: קריאה SetCapture גורמת החלון שבו הוא הפסד לכידת העכבר כדי לקבל הודעה WM_CAPTURECHANGED.

QuickInfo

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

ראה גם

מבט כולל על קלט עכבר, פונקציות קלט של העכבר, GetCapture, ReleaseCapture, WM_CAPTURECHANGED

Index