Menggunakan fungsi CALL dan REGISTER

Tipe Data F dan G

Dengan tipe data F dan G, fungsi bisa memodifikasi buffer string yang dialokasikan oleh Microsoft Excel. Jika kode tipe nilai yang dikembalikan adalah F atau G, maka Microsoft Excel mengabaikan nilai yang dikembalikan oleh fungsi. Sebagai gantinya, Microsoft Excel mencari daftar argumen fungsi untuk tipe data pertama yang terkait (F atau G) lalu menggunakan konten dari buffer string yang dialokasikan saat itu sebagai nilai yang dikembalikan. Microsoft Excel mengalokasikan 256 byte untuk argumen tersebut, jadi fungsi mungkin mengembalikan string lebih besar dari yang diterima.

Atas halaman

Tipe Data K

Tipe data K menggunakan penunjuk ke struktur FP berukuran variabel. Anda harus menentukan struktur ini dalam DLL atau sumber kode seperti berikut:

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

Deklarasi double array[1] mengalokasikan penyimpanan hanya untuk array elemen tunggal. Jumlah elemen di array sebenarnya sama dengan jumlah baris yang dikalikan dengan jumlah kolom.

Atas halaman

Tipe Data O

Tipe data O hanya dapat digunakan sebagai argumen, bukan sebagai nilai yang dikembalikan. Tipe data O mengirim 3 item: penunjuk ke jumlah baris dalam satu array, penunjuk ke jumlah kolom dalam satu array, dan penunjuk ke array dua dimensi bilangan riil.

Alih-alih mengembalikan nilai, fungsi bisa mengubah array yang dilewati oleh tipe data O. Untuk melakukan ini, Anda dapat menggunakan ">O" sebagai argumen type_text. Untuk informasi selengkapnya, lihat "Memodifikasi di Tempat — Fungsi Dideklarasikan sebagai Batal" di bawah ini.

Tipe data O dibuat untuk kompatibilitas langsung dengan DLL Fortran, yang mengirim argumen sesuai dengan referensi.

Atas halaman

Tipe Data P

Tipe data P adalah penunjuk ke struktur OPER. Struktur OPER berisi data 8-byte, diikuti dengan pengidentifikasi 2-byte yang menentukan tipe data. Dengan tipe data P, fungsi DLL atau sumber kode dapat menggunakan dan mengembalikan tipe data Microsoft Excel apa pun.

Struktur OPER didefinisikan seperti berikut:

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;

Bidang tipe berisi salah satu dari nilai ini.

Dua nilai terakhir hanya bisa digunakan sebagai argumen, bukan nilai yang dikembalikan. Nilai argumen yang hilang (128) dikirim saat pemanggil menghilangkan sebuah argumen. Nilai sel kosong (256) dikirim saat pemanggil mengirim referensi ke sel kosong.

Atas halaman

Tipe Data R — Memanggil Fungsi Microsoft Excel dari DLL

Tipe data R adalah penunjuk ke struktur XLOPER, yang merupakan versi struktur OPER yang telah ditingkatkan. Di Microsoft Excel versi 4.0 dan yang lebih baru, Anda bisa menggunakan tipe data R untuk menulis DLL dan sumber kode yang memanggil fungsi Microsoft Excel. Dengan struktur XLOPER, fungsi DLL bisa mengirim referensi lembar dan mengimplementasikan kontrol alur, selain mengirim data. Deskripsi lengkap tipe data R dan antarmuka pemrograman aplikasi (API, Application Programming Interface) Microsoft Excel di luar lingkup topik ini. Panduan Pengembang Microsoft Office XP berisi informasi detail tentang tipe data R, API Microsoft Excel, dan banyak aspek teknis Microsoft Excel lainnya.

Atas halaman

Fungsi Tidak Tetap and Perhitungan Ulang

Microsoft Excel umumnya menghitung fungsi DLL (atau sumber kode) hanya saat dimasukkan ke dalam sel, saat salah satu prioritasnya berubah, atau saat sel dihitung selama makro dijalankan. Di lembar kerja, Anda bisa membuat fungsi DLL atau sumber kode yang tidak tetap, yang berarti bahwa hanya akan menghitung ulang setiap kali lembar kerja menghitung ulang. Untuk membuat fungsi tidak tetap, tambahkan tanda seru (!) sebagai karakter terbaik di argumen type_text.

Sebagai contoh, di Microsoft Excel untuk Windows, rumus lembar kerja berikut menghitung ulang setiap kali lembar kerja menghitung ulang:

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

Atas halaman

Memodifikasi di Tempat — Fungsi Dideklarasikan sebagai Void (tidak mengembalikan nilai)

Anda bisa menggunakan digit tunggal n untuk kode tipe yang dikembalikan di type_text, di mana n adalah angka dari 1 sampai 9. Ini memberitahu Microsoft Excel untuk memodifikasi variabel di lokasi yang ditunjuk oleh argumen ke-n di type_text, bukan mengembalikan nilai. Ini juga disebut sebagai memodifikasi di tempat. Argumen ke-n harus merupakan tipe data kirim secara referensi (C, D, E, F, G, K, L, M, N, O, P, atau R). Fungsi DLL atau sumber kode harus dideklarasi dengan kata kunci void dalam bahasa C (atau kata kunci prosedur dalam bahasa Pascal).

Sebagai contoh, fungsi DLL yang menggunakan string yang diakhiri karakter null bukan nol dan dua penunjuk ke bilangan bulat sebagai argumen bisa memodifikasi string di tempat. Gunakan "1FMM" sebagai argumen type_text, dan deklarasikan fungsi sebagai void.

Versi sebelum Microsoft Excel 4.0 menggunakan karakter > untuk memodifikasi argumen pertama di tempat; tidak ada cara untuk memodifikasi argumen selain argumen pertama. Karakter > sama dengan n = 1 di Microsoft Excel versi 4.0 dan lebih baru.

Atas halaman