CreateCaret

הפונקציה CreateCaret יוצר צורה חדשה עבור סימן caret של המערכת ומקצה בעלות סימן הכניסה החלון שצוין. הצורה תו יכול להיות קו, בלוק או מפת סיביות.

(BOOL CreateCaret HWND  hWnd, / / לטפל לחלון הבעליםHBITMAPhBitmap, / / לטפל מפת סיביות עבור הצורה באמצעות סימן הכניסהintnWidth, / / רוחב תוintnHeight / / גובה תו);
 

פרמטרים

hWnd
מזהה את החלון שבבעלותה סימן הכניסה.
hBitmap
מזהה את מפת הסיביות המגדירה את הצורה באמצעות סימן הכניסה. אם פרמטר זה הוא NULL, סימן הכניסה הוא מוצק. אם פרמטר זה (HBITMAP) 1, סימן הכניסה הוא אפור. אם פרמטר זה הוא נקודת אחיזה מפת סיביות, סימן הכניסה היא מפת הסיביות שצוינה. יש נקודת האחיזה של מפת סיביות נוצרו על-ידי CreateBitmap, CreateDIBitmap, או LoadBitmap הפונקציה.

אם hBitmap הוא נקודת אחיזה מפת סיביות, CreateCaret מתעלם פרמטרים nWidth ו- nHeight ; מפת הסיביות מגדיר רוחב וגובה משלו.

nWidth
קביעת הרוחב של סימן הכניסה ביחידות לוגיות. אם פרמטר זה הוא אפס, הרוחב מוגדר רוחב גבול החלון המוגדר על-ידי המערכת. אם hBitmap הוא נקודת אחיזה מפת סיביות, CreateCaret מתעלם פרמטר זה.
nHeight
מציין את הגובה ביחידות לוגיות, של סימן הכניסה. אם פרמטר זה הוא אפס, הגובה מוגדר גובה גבול החלון המוגדר על-ידי המערכת. אם hBitmap הוא נקודת אחיזה מפת סיביות, CreateCaret מתעלם פרמטר זה.

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

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

הערות

פרמטרים nWidth ו- nHeight לציין רוחב וגובה של קארה, ביחידות לוגיות; הרוחב המדויק ואת הגובה, בפיקסלים, תלויות מצב מיפוי של החלון.

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

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

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

חלונות CE: Windows CE אינו תומך הפרמטר hBitmap , להיות מוגדר כ- NULL. ברירת המחדל של Windows CE תו מלאים.

QuickInfo

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

ראה גם

מבט כולל על קווים, פונקציות באמצעות סימן הכניסה, CreateBitmap, CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index