Utilisation des fonctions FONCTION.APPELANTE et REGISTRE

Types de données F et G

À l’aide des types de données F et G, une fonction peut modifier un tampon de chaîne alloué par Microsoft Excel. Si le code du type de la valeur renvoyée est F ou G, Microsoft Excel ne prend pas en compte la valeur renvoyée par la fonction. Dans ce cas, celui-ci recherche dans la liste des arguments de la fonction le premier type de données correspondant (F ou G) et prend comme valeur renvoyée le contenu effectif du tampon de chaîne alloué. Comme Microsoft Excel alloue 256 octets à l’argument, la fonction peut renvoyer une chaîne plus longue que celle qu’elle a reçue.

Haut de la page

Type de données K

Le type de données K utilise un pointeur sur une structure FP de taille variable. Vous devez définir cette structure dans la DLL ou dans la ressource de code, comme suit :

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

La déclaration double array[1] alloue l’espace nécessaire pour stocker une matrice à un seul élément. Le nombre d’éléments de la matrice réelle est égal au nombre de lignes multiplié par le nombre de colonnes.

Haut de la page

Type de données O

Le type de données O peut être utilisé uniquement comme un argument, et non comme une valeur renvoyée. Il transfère trois éléments : un pointeur sur le nombre de lignes dans une matrice, un autre sur le nombre de colonnes dans une matrice et un troisième sur une matrice bidimensionnelle contenant des nombres à virgule flottante.

Au lieu de retourner une valeur, une fonction peut modifier un tableau passé par le type de données O. Pour ce faire, vous pouvez utiliser « >O » comme argument type_text. Pour plus d’informations, consultez « Modification sur place — Fonctions déclarées comme Void » ci-dessous.

Le type de données O a été créé pour des raisons de compatibilité directe avec les DLL Fortran, qui transfèrent les arguments par référence.

Haut de la page

Type de données P

Le type de données P est un pointeur sur une structure OPER. Celle-ci contient 8 octets de données, suivis par un identificateur de 2 octets indiquant le type de données. Avec le type de données P, une fonction ou une ressource de code DLL peut accepter et renvoyer tout type de données Microsoft Excel.

La structure OPER se définit comme suit :

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;

Le champ type contient l’une des valeurs suivantes.

Les deux dernières valeurs peuvent être utilisées uniquement comme des arguments et non comme des valeurs renvoyées. La valeur « argument manquant » (128) est transférée lorsque l’appelant omet un argument. La valeur « cellule vide » (256) est transférée lorsque l’appelant communique une référence à une cellule vide.

Haut de la page

Type de données R — Appel de fonctions Microsoft Excel à partir de DLL

Le type de données R est un pointeur sur une structure XLOPER, version améliorée de la structure OPER. Dans les versions 4.0 et ultérieures de Microsoft Excel, vous pouvez utiliser le type de données R pour écrire des DLL et des ressources de code appelant des fonctions de Microsoft Excel. Avec la structure XLOPER, une fonction DLL peut transférer des références de feuilles en plus des données et mettre en place un contrôle de flux. Une description complète du type de données R et de l’API de Microsoft Excel dépasse le cadre de cette rubrique. Le Guide du développeur Microsoft Office XP contient des informations détaillées sur le type de données R, l’interface API de Microsoft Excel et autres aspects techniques de Microsoft Excel.

Haut de la page

Fonctions volatiles et recalcul

En règle générale, Microsoft Excel calcule une fonction DLL (ou une ressource de code) uniquement lorsqu’elle est entrée dans une cellule, lorsque l’un de ses antécédents change ou que la cellule est calculée lors de l’exécution d’une macro. Dans une feuille de calcul, vous pouvez rendre volatile une fonction ou une ressource de code DLL, ce qui signifie qu’elle sera recalculée à chaque recalcul de la feuille de calcul. Pour rendre une fonction volatile, mettez un point d’exclamation (!) comme dernier caractère de l’argument type_texte.

Par exemple, dans Microsoft Excel pour Windows, la formule de feuille de calcul suivante est recalculée à chaque recalcul de la feuille de calcul :

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

Haut de la page

Modification sur place — Fonctions déclarées void

Dans l’argument type_texte, vous pouvez utiliser un chiffre unique n pour le code de type renvoyé, n étant un nombre compris entre 1 et 9. Il indique à Microsoft Excel de modifier sur place la variable désignée par le n-ième argument de l’argument type_texte, au lieu de renvoyer une valeur. Cette option est également connue sous le nom de modification sur place. Le n-ième argument doit être un type de données transféré par référence (C, D, E, F, G, K, L, M, N, O, P ou R). La fonction ou la ressource de code DLL doit également être déclarée avec le mot clé « void » en langage C (ou le mot clé « procédure » en langage Pascal).

Par exemple, une fonction DLL qui accepte une chaîne terminée par le caractère nul et deux pointeurs sur des nombres entiers comme arguments peut modifier la chaîne sur place. Utilisez « 1FMM » comme argument type_texte et déclarez la fonction comme void.

Les versions de Microsoft Excel antérieures à la version 4.0 utilisaient le caractère > pour modifier sur place le premier argument ; il n’existait aucun moyen de modifier un autre argument que le premier. Le caractère > équivaut à n = 1 dans les versions 4.0 et ultérieures de Microsoft Excel.

Haut de la page