Χρήση των συναρτήσεων CALL και REGISTER

Τύποι δεδομένων F και G

Με τους τύπους δεδομένων F και G, μια συνάρτηση μπορεί να τροποποιήσει το buffer συμβολοσειράς που εκχωρείται από το Microsoft Excel. Εάν ο κωδικός τύπου της επιστρεφόμενης τιμής είναι F ή G, τότε το Microsoft Excel παραβλέπει την επιστρεφόμενη τιμή της συνάρτησης. Αντίθετα, το Microsoft Excel αναζητά στη λίστα των ορισμάτων της συνάρτησης τον πρώτο αντίστοιχο τύπο δεδομένων (F ή G) και έπειτα λαμβάνει ως τιμή επιστροφής το τρέχον περιεχόμενο του buffer συμβολοσειράς που έχει εκχωρηθεί για το όρισμα αυτό. Το Microsoft Excel εκχωρεί 256 byte για το όρισμα, έτσι η συνάρτηση μπορεί να επιστρέφει μεγαλύτερη συμβολοσειρά από αυτήν που δέχτηκε.

Αρχή της σελίδας

Τύπος δεδομένων 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] εκχωρεί χώρο αποθήκευσης για πίνακα ενός μόνο στοιχείου. Ο αριθμός των στοιχείων στον πραγματικό πίνακα ισούται με τον αριθμό γραμμών rows επί τον αριθμό στηλών columns.

Αρχή της σελίδας

Τύπος δεδομένων O

Ο τύπος δεδομένων O μπορεί να χρησιμοποιηθεί μόνο ως όρισμα και όχι ως επιστρεφόμενη τιμή. Μεταβιβάζει τρία στοιχεία: ένα δείκτη προς τον αριθμό των γραμμών ενός πίνακα, ένα δείκτη προς τον αριθμό των στηλών ενός πίνακα και ένα δείκτη προς ένα δισδιάστατο πίνακα αριθμών κινητής υποδιαστολής.

Αντί να επιστρέψει μια τιμή, μια συνάρτηση μπορεί να τροποποιήσει έναν πίνακα που έχει μεταβιβαστεί από τον τύπο δεδομένων O. Για να το κάνετε αυτό, μπορείτε να χρησιμοποιήσετε τη φράση "> O" ως το όρισμα κείμενο_τύπου. Για περισσότερες πληροφορίες, ανατρέξτε στην παρακάτω ενότητα "Επιτόπια τροποποίηση — Συναρτήσεις που έχουν δηλωθεί ως άκυρες".

Ο τύπος δεδομένων O δημιουργήθηκε για απευθείας συμβατότητα με τις βιβλιοθήκες DLL της Fortran, που μεταβιβάζουν ορίσματα με αναφορά.

Αρχή της σελίδας

Τύπος δεδομένων Ρ

Ο τύπος δεδομένων P είναι ένας δείκτης για μια δομή δεδομένων OPER. Η δομή OPER περιέχει 8 byte δεδομένων, που ακολουθούνται από ένα αναγνωριστικό των 2 byte που καθορίζει τον τύπο δεδομένων. Με τον τύπο δεδομένων 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;

Το πεδίο type περιέχει μία από αυτές τις τιμές.

Οι δύο τελευταίες τιμές μπορούν να χρησιμοποιηθούν μόνο ως ορίσματα και όχι ως επιστρεφόμενες τιμές. Η τιμή ορίσματος που έχει παραλειφθεί (128) μεταβιβάζεται όταν η καλούσα συνάρτηση παραλείπει κάποιο όρισμα. Η τιμή κενού κελιού (256) μεταβιβάζεται όταν η καλούσα συνάρτηση μεταβιβάζει μια αναφορά σε κενό κελί.

Αρχή της σελίδας

Τύπος δεδομένων R — Κλήση συναρτήσεων του Microsoft Excel από DLL

Ο τύπος δεδομένων R είναι ένας δείκτης για μια δομή XLOPER, η οποία είναι μια εμπλουτισμένη έκδοση της δομής OPER. Στην έκδοση 4.0 και σε νεότερες εκδόσεις του Microsoft Excel, μπορείτε να χρησιμοποιήσετε τον τύπο δεδομένων R, για να συντάξετε DLL και πόρους κώδικα που καλούν συναρτήσεις του Microsoft Excel. Με τη δομή XLOPER, μια συνάρτηση DLL, εκτός από τη μεταβίβαση δεδομένων, μπορεί να μεταβιβάσει αναφορές σε φύλλα εργασίας και να υλοποιήσει έλεγχο ροής. Η πλήρης περιγραφή του τύπου δεδομένων R και του ΑΡΙ (application programming interface) του Microsoft Excel είναι εκτός του πεδίου ενδιαφέροντος αυτού του θέματος. Το βιβλίο Microsoft Office XP Developer's Guide περιέχει λεπτομερείς πληροφορίες σχετικά με τον τύπο δεδομένων R, το Microsoft Excel API και πολλά άλλα τεχνικά θέματα του Microsoft Excel.

Αρχή της σελίδας

Δυναμικές συναρτήσεις και επανάληψη υπολογισμού

Το Microsoft Excel υπολογίζει συνήθως μια συνάρτηση DLL (ή πόρο κώδικα) μόνο όταν καταχωρείται σε κάποιο κελί, όταν κάποια από τις προηγούμενες συναρτήσεις αλλάξει ή όταν το κελί υπολογίζεται κατά την εκτέλεση μιας μακροεντολής. Σε ένα φύλλο εργασίας, μπορείτε να ορίσετε ως δυναμική μια συνάρτηση DLL ή έναν πόρο κώδικα, πράγμα το οποίο σημαίνει ότι επανυπολογίζεται κάθε φορά που επαναλαμβάνεται ο υπολογισμός του φύλλου εργασίας. Για να γίνει μια συνάρτηση δυναμική, προσθέστε ένα θαυμαστικό (!) ως τελευταίο χαρακτήρα στο όρισμα κείμενο_τύπου.

Για παράδειγμα, στο Microsoft Excel για Windows, ο παρακάτω τύπος φύλλου εργασίας επανυπολογίζεται κάθε φορά που επαναλαμβάνεται ο υπολογισμός του φύλλου εργασίας:

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

Αρχή της σελίδας

Επιτόπια τροποποίηση — Δήλωση συναρτήσεων ως Void

Μπορείτε να χρησιμοποιήσετε στο όρισμα κείμενο_τύπου έναν μονοψήφιο αριθμό n για τον κώδικα τύπου επιστρεφόμενων δεδομένων, όπου n είναι ένας αριθμός από το 1 μέχρι το 9. Με αυτόν τον τρόπο, το Microsoft Excel τροποποιεί τη μεταβλητή στη θέση που υποδεικνύεται από το νιοστό (n) όρισμα στο κείμενο_τύπου, αντί να επιστρέψει μια τιμή. Η μέθοδος αυτή λέγεται επιτόπια τροποποίηση. Το νιοστό (n) όρισμα πρέπει να είναι ένας τύπος μεταβίβασης με αναφορά (C, D, E, F, G, K, L, M, N, O, P ή R). Επίσης, η συνάρτηση DLL ή ο πόρος κώδικα πρέπει να δηλωθούν με τη λέξη-κλειδί void στη γλώσσα C (ή τη λέξη-κλειδί procedure στη γλώσσα Pascal).

Για παράδειγμα, μια συνάρτηση DLL που δέχεται ως ορίσματα μια συμβολοσειρά που τελειώνει σε χαρακτήρα null και δύο δείκτες προς ακέραιους αριθμούς μπορεί να τροποποιήσει τη συμβολοσειρά επιτόπου. Χρησιμοποιήστε στο όρισμα κείμενο_τύπου την τιμή "1FMM" και δηλώστε τη συνάρτηση ως void.

Οι εκδόσεις πριν από το Microsoft Excel 4.0 χρησιμοποιούσαν τον χαρακτήρα > για την επιτόπου τροποποίηση του πρώτου ορίσματος. Δεν υπήρχε τρόπος για την τροποποίηση άλλου ορίσματος, εκτός του πρώτου. Ο χαρακτήρας > είναι ισοδύναμος με τον n = 1 στο Microsoft Excel έκδοση 4.0 και νεότερες εκδόσεις.

Αρχή της σελίδας