KUTSU- ja REKISTERÖI-funktioiden käyttäminen

Tietotyypit F ja G

Kun käytetään tietotyyppejä F ja G, funktio voi muokata Microsoft Excelin varaamaa merkkijonopuskuria. Jos palautusarvon tietotyyppi on F tai G, Microsoft Excel ohittaa funktion palauttaman arvon. Sen sijaan Microsoft Excel etsii argumenttiluettelosta ensimmäisen vastaavan tietotyypin (F tai G) ja vie varatun merkkijonopuskurin senhetkisen sisällön palautusarvoksi. Microsoft Excel varaa argumentille 256 tavua, joten funktio saattaa palauttaa suuremman merkkijonon kuin se otti vastaan.

Sivun alkuun

Tietotyyppi K

Tietotyyppi K käyttää osoitinta muuttuvankokoiseen FP-rakenteeseen. Tämä rakenne on määriteltävä DLL:ssä tai koodiresurssissa seuraavasti:

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

Määritys double array[1] varaa muistitilaa vain yksiosaiselle matriisille. Matriisin osien määrä on rivien ja sarakkeiden määrien tulo.

Sivun alkuun

Tietotyyppi O

Tietotyyppiä O voidaan käyttää vain argumenttina, ei palautusarvona. Se välittää osoittimen kolmeen kohtaan: matriisin rivien määrään, matriisin sarakkeiden määrään ja kaksiulotteiseen liukulukumatriisiin.

Arvon palauttamisen sijasta funktio voi muokata O-tietotyypin välittämää matriisia. Tätä varten tyyppi_teksti-argumentiksi voidaan määrittää ">O". Saat lisätietoja tämän ohjeaiheen kohdassa "Suora muokkaus – Void-funktiot".

O-tietotyyppi takaa suoran yhteensopivuuden Fortran DLL:n kanssa, joka välittää argumentit viittauksina.

Sivun alkuun

Tietotyyppi P

Tietotyyppi P on osoitin OPER-rakenteeseen. OPER-rakenteessa on 8 datatavua ja niiden jäljessä 2-tavuinen tietotyypin tunniste. Kun käytät P-tietotyyppiä, DLL-funktio ja koodiresurssi pystyvät ottamaan vastaan ja palauttamaan kaikkia Microsoft Excelin tietotyyppejä.

OPER-rakenne määritellään seuraavasti:

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-kentässä on jokin näistä arvoista:

Kahta viimeistä arvoa voidaan käyttää vain argumentteina, ei palautusarvoina. Ohjelma palauttaa Puuttuva argumentti ‑arvon (128), kun kutsujasta puuttuu argumentti. Ohjelma palauttaa Tyhjä solu -arvon (256), kun kutsuja välittää viittauksen tyhjään soluun.

Sivun alkuun

Tietotyyppi R – Microsoft Excelin funktioiden kutsuminen DLL:stä

Tietotyyppi R on osoitin XLOPER-rakenteeseen, joka on OPER-rakenteen laajennettu versio. Jos käytät Microsoft Excel 4.0:aa tai uudempaa versiota, voit käyttää R-tietotyyppiä Microsoft Excelin funktioita kutsuvien DLL-funktioiden ja koodiresurssien kirjoittamiseen. XLOPER-rakenteen avulla DLL-funktio voi välittää taulukkoviittauksia ja käyttää vuonohjausta tietojen välittämisen lisäksi. R-tietotyypin ja Microsoft Excelin ohjelmointirajapinnan tarkempi kuvaus ei kuulu tämän ohjeen aihepiiriin. Microsoft Office XP Developer's Guide sisältää yksityiskohtaiset tiedot R-tietotyypistä, Microsoft Excelin ohjelmointirajapinnasta ja monista muista Microsoft Excelin teknisistä ominaisuuksista.

Sivun alkuun

Muuttuvat funktiot ja uudelleenlaskenta

Microsoft Excel laskee yleensä DLL-funktion (tai koodiresurssin) vain, kun funktio kirjoitetaan soluun, kun jokin sen edeltäjistä muuttuu tai kun ohjelma laskee solun makron suorittamisen yhteydessä. Taulukossa DLL-funktiosta tai koodiresurssista voi tehdä muuttuvan, jolloin ohjelma laskee sen aina taulukon uudelleenlaskennan yhteydessä. Funktio muutetaan muuttuvaksi lisäämällä huutomerkki (!) tyyppi_teksti-argumentin viimeiseksi merkiksi.

Esimerkiksi Microsoft Windows Excelissä ohjelma laskee seuraavan taulukkokaavan aina taulukon uudelleenlaskennan yhteydessä:

KUTSU(”Kernel32”,”GetTickCount”,”J!”)

Sivun alkuun

Suora muokkaus – Void-funktiot

Voit antaa tyyppi_teksti-argumentin palautusarvon tyypiksi luvun n, joka on 1–9. Tällöin Microsoft Excel ei palauta arvoa vaan muokkaa muuttujaa, joka on tyyppi_teksti-argumentin n:nnen argumentin osoittamassa paikassa. Tätä kutsutaan myös suoraksi muokkaukseksi. Argumentin n on oltava välitysviittaus (C, D, E, F, G, K, L, M, N, O, P tai R). Tällöin myös DLL-funktio tai koodiresurssi on määritettävä C-kielessä avainsanalla void (tai avainsanalla procedure Pascal-kielessä).

DLL-funktio, jonka argumentteina voi olla nollaan päättyvä merkkijono ja kaksi kokonaislukuihin osoittavaa osoitinta, voi muokata merkkijonoa arvon palauttamisen sijasta. Anna tyyppi_teksti-argumentin arvoksi "1FMM" ja määritä funktio void-funktioksi.

Microsoft Excel 4.0:aa aiemmissa versioissa käytettiin >-merkkiä ensimmäisen argumentin muokkaamiseen. mitään muuta argumenttia ei voi muokata kuin ensimmäistä. > on sama kuin n = 1 Microsoft Excelin versiossa 4.0 ja uudemmissa versioissa.

Sivun alkuun