שימוש בפונקציות CALL ו- REGISTER

סוגי הנתונים F ו- G

בעזרת סוגי הנתונים F ו- G, הפונקציה יכולה לשנות מאגר מחרוזות שהוקצה על-ידי Microsoft Excel. אם קוד הסוג של ערך ההחזרה הוא F או G, ‏Microsoft Excel מתעלם מהערך שהפונקציה מחזירה. במקום זאת, Microsoft Excel מחפש ברשימת הארגומנטים של הפונקציה אחר סוג הנתונים הראשון המתאים (F או G) ולאחר מכן משתמש בתוכן הנוכחי של מאגר המחרוזות שהוקצה כערך ההחזרה. Microsoft Excel מקצה לארגומנט 256 בתים, כך שהפונקציה יכולה להחזיר מחרוזת גדולה מזו שקיבלה.

לראש הדף

סוג הנתונים K

סוג הנתונים K משתמש במצביע למבנה FP בעל גודל משתנה. עליך להגדיר מבנה זה בקובץ ה- DLL או במשאב הקוד כך:

typedef struct _FP
{
    unsigned short int rows;
    unsigned short int columns;
    double array[1];        /* Actually, array[rows][columns] */
} FP;

ההצהרה double array[1] מקצה אמצעי אחסון למערך עם רכיב יחיד. מספר הרכיבים במערך בפועל שווה למספר השורות כפול מספר העמודות.

לראש הדף

סוג הנתונים O

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

במקום להחזיר ערך, פונקציה יכולה לשנות מערך שהועבר על-ידי סוג הנתונים O. לשם כך, באפשרותך להשתמש ב>O" type_text הארגומנט. לקבלת מידע נוסף, ראה "שינוי במקום — פונקציות שהוצהרה כריק" להלן.

סוג הנתונים O נוצר לצורך תאימות ישירה עם קבצי DLL של Fortran, המעבירים ארגומנטים באמצעות הפניה.

לראש הדף

סוג הנתונים P

סוג הנתונים P הוא מצביע למבנה OPER. מבנה זה מכיל 8 בתים של נתונים, ולאחריהם מזהה בן שני בתים המציין את סוג הנתונים. עם סוג הנתונים P, פונקציה של קובץ DLL או משאב קוד יכולים לקבל ולהחזיר כל סוג נתונים של Microsoft Excel.

מבנה OPER מוגדר באופן הבא:

typedef struct _oper

{
    union
    {
        double num;
        unsigned char *str;
        unsigned short int bool;
        unsigned short int err;
        struct
        {
            struct _oper *lparray;
            unsigned short int rows;
            unsigned short int columns;
        } array;
    } val;
    unsigned short int type;
} OPER;

שדה הסוג מכיל את אחד הערכים הבאים.

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

לראש הדף

סוג הנתונים R - קריאה לפונקציות של Microsoft Excel מקבצי DLL

סוג הנתונים R הוא מצביע למבנה XLOPER, שהוא גירסה מורחבת של מבנה OPER. בגירסה 4.0 ואילך של Microsoft Excel, באפשרותך להשתמש בסוג הנתונים R לכתיבת קבצי DLL ומשאבי קוד המבצעים קריאה לפונקציות של Microsoft Excel. בעזרת מבנה XLOPER, פונקציית DLL יכולה להעביר הפניות גיליון וליישם בקרת זרימה, בנוסף להעברת נתונים. תיאור מלא של סוג הנתונים R וממשק תיכנות היישומים (API) של Microsoft Excel חורג מההיקף של נושא זה. המדריך למפתחים של Microsoft Office XP מכיל מידע מפורט אודות סוג הנתונים R, ממשק תיכנות היישומים של Microsoft Excel והיבטים טכניים רבים אחרים של Microsoft Excel.

לראש הדף

פונקציות נדיפות וחישוב מחדש

Microsoft Excel מחשב בדרך כלל פונקציות DLL (או משאבי קוד) רק בעת הזנה בתא, כאשר אחד מהתאים המזינים משתנה או כאשר התא מחושב במהלך פעולת מאקרו. בגליון עבודה, באפשרותך להפוך פונקציית DLL או משאב קוד לנדיפים, כלומר שהם מחושבים מחדש בכל פעם שגליון העבודה מחושב מחדש. כדי להפוך פונקציה לנדיפה, הוסף סימן קריאה (!) כתו האחרון בארגומנט type_text.

לדוגמה, ב- Microsoft Excel for Windows, נוסחת גליון העבודה הבאה מחושבת מחדש בכל פעם שהגיליון מחושב מחדש:

CALL("Kernel32","GetTickCount","J!")‎

לראש הדף

שינוי במקום - פונקציות שהוצהרו כריקות

באפשרותך להשתמש בספרה יחידה n עבור קוד סוג ההחזרה בארגומנט type_text, שבו n הוא מספר מ- 1 עד 9. פעולה זו מורה ל- Microsoft Excel לשנות את המשתנה במיקום שעליו מצביע הארגומנט מספר n ב- type_text, במקום להחזיר ערך. תכונה זו נקראת גם שינוי במקום. הארגומנט מספר n חייב להיות סוג נתונים המועבר על-ידי הפניה (C, ‏D, ‏E, ‏F,‏ G, ‏K, ‏L, ‏M, ‏N, ‏O, ‏P או R). כמו כן, הפונקציה DLL או משאב הקוד חייבים להיות מוצהרים עם מילת מפתח ריקה בשפת C (או מילת המפתח של הפרוצדורה בשפת פקסל).

לדוגמה, פונקציית DLL, המקבלת כארגומנטים מחרוזת המסתיימת ב- Null ושני מצביעים למספרים שלמים, יכולה לשנות את המחרוזת במקום. השתמש ב- "1FMM" כארגומנט של type_text והצהר על הפונקציה כריקה.

בגירסאות קודמות ל- Microsoft Excel 4.0 נעשה שימוש בתו < כדי לשנות את הארגומנט הראשון במקום; לא היתה כל דרך לשנות ארגומנט כלשהו, פרט לראשון. התו < שווה ערך ל- n = 1 ב- Microsoft Excel 4.0 ואילך.

לראש הדף