EditStreamCallback

הפונקציה EditStreamCallback היא פונקציית התקשרות חזרה מוגדרת על-ידי היישום המשמש עם הודעות EM_STREAMIN ו- EM_STREAMOUT . הוא משמש כדי להעביר זרם של נתונים לתוך או מתוך פקד עריכה עשירה. סוג EDITSTREAMCALLBACK מגדיר מצביע לפונקציה זו התקשרות חזרה. EditStreamCallback הוא מציין מיקום עבור שם הפונקציה המוגדרת על-ידי יישום.

(DWORD התקשרות חזרה EditStreamCallback DWORD  dwCookie, / / מוגדר על-ידי יישום ערךLPBYTEpbBuff, / / מצביע למאגרארוך cb, / / מספר הבתים כדי לקרוא או לכתובארוך* עדינות / / מצביע על מספר הבתים שהועברו);
 

פרמטרים

dwCookie

מציין את הערך של החבר dwCookie של מבנה EDITSTREAM . היישום מציין ערך זה כאשר הוא שולח את ההודעה EM_STREAMIN או EM_STREAMOUT.

pbBuff

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

cb

מציין את מספר הבתים כדי לקרוא או לכתוב.

עדינות

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

להחזיר ערכים

מחזירה פונקציית התקשרות חזרה אפס כדי לציין הצלחה.

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

הערות

כאשר אתה שולח את EM_STREAMIN או את ההודעה EM_STREAMOUT לפקד עריכה עשירה, חבר pfnCallback של מבנה EDITSTREAM מציין מצביע פונקציה לא EditStreamCallback . פקד עריכה עשירה קוראת שוב ושוב את הפונקציה להעביר זרם של נתונים לתוך או מתוך הפקד.

כאשר אתה שולח את ההודעה EM_STREAMIN או EM_STREAMOUT, תציין ערך עבור חבר dwCookie של מבנה EDITSTREAM . פקד עריכה עשירה משתמש בפרמטר dwCookie להעביר ערך זה לפונקציה EditStreamCallback שלך. לדוגמה, ייתכן שתשתמש dwCookie להעברת נקודת אחיזה קובץ פתוח. פונקציית התקשרות חזרה ניתן להשתמש לאחר מכן נקודת האחיזה dwCookie לקרוא או לכתוב לקובץ.

הפקד קורא את פונקציית התקשרות חזרה שוב ושוב, העברת חלק מהנתונים עם כל שיחה. הפקד ממשיכה לקרוא את פונקציית התקשרות חזרה עד יתרחש אחד המצבים הבאים:

• ערך שאינו אפס מחזירה פונקציית התקשרות חזרה.
• מחזירה פונקציית התקשרות חזרה אפס * הפרמטר עדינות.
• הערך המוחזר ב- * עדינות הפרמטר הוא פחות ממספר הבתים המבוקש בפרמטר cb.
• מתרחשת שגיאה המונעת את העברת נתונים לתוך או מתוך עצמו את פקד עריכה עשירה. דוגמאות לכך הן מצבים של זיכרון, כשל של פונקציית מערכת, או מאגר הקריאה מכיל תו לא חוקי.
• פעולת זרם-in, הקוד RTF מכיל נתונים ציון סוף בלוק RTF.
• עבור זרם-in פעולת פקד עריכה שורה בודדת, חזרה קורא CRLF.

QuickInfo

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

ראה גם

מבט כולל על פקדי עריכה עשיר, פונקציות התקשרות חזרה של עריכה עשיר, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Index