Usando as funções CHAMAR e REGISTRO

Tipos de dados F e G

Com os tipos de dados F e G, uma função pode modificar um buffer de cadeia de caracteres que está alocado pelo Microsoft Excel. Se o código do tipo de valor de retorno é F ou G, o Microsoft Excel ignora o valor retornado pela função. O Microsoft Excel procura na lista de argumentos de função o primeiro tipo de dados correspondente (F ou G) e usa o conteúdo atual do buffer de cadeia de caracteres alocado como o valor de retorno. O Microsoft Excel aloca 256 bytes para o argumento, de modo que a função possa retornar uma cadeia de caracteres maior do que a recebida.

Início da Página

Tipo de dados K

O tipo de dados K usa um ponteiro para uma estrutura FP de tamanho variável. Você deve definir essa estrutura na DLL ou no recurso de código desta forma:

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

A declaração double array[1] aloca armazenamento para apenas uma matriz de elemento único. O número de elementos na matriz real equivale ao número de linhas multiplicado pelo número de colunas.

Início da Página

Tipo de dados O

O tipo de dados O pode ser usado apenas como um argumento, não como um valor de retorno. Ele passa três itens: um ponteiro para o número de linhas em uma matriz, um ponteiro para o número de colunas em uma matriz e um ponteiro para uma matriz bidimensional de números de ponto flutuante.

Em vez de retornar um valor, uma função pode modificar uma matriz passada pelo tipo de dados O. Para fazer isso, você pode usar "> O" como o argumento tipo_texto. Para saber mais, confira o artigo “Modificando no local — Funções declaradas como nulas”, abaixo.

O tipo de dados O foi criado para ter compatibilidade direta com DLLs do Fortran, que passam argumentos por referência.

Início da Página

Tipo de dados P

O tipo de dados P é um ponteiro para uma estrutura OPER. A estrutura OPER contém 8 bytes de dados, seguidos de um identificador de 2 bytes que especifica o tipo de dados. Com o tipo de dados P, uma função de DLL ou um recurso de código pode usar e retornar qualquer tipo de dados do Microsoft Excel.

A estrutura OPER é definida desta forma:

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;

O campo de tipo contém um destes valores.

Os dois últimos valores podem ser usados apenas como argumentos, e não como valores de retorno. O valor de argumento ausente (128) é passado quando o chamador omite um argumento. O valor de célula vazia (256) é passado quando o chamador passa uma referência para uma célula vazia.

Início da Página

Tipo de dados R — Chamando funções do Microsoft Excel a partir de DLLs

O tipo de dados R é um ponteiro para uma estrutura XLOPER, que é uma versão aprimorada da estrutura OPER. No Microsoft Excel versão 4.0 e posterior, você pode usar o tipo de dados R para escrever DLLs e recursos de código que chamam funções do Microsoft Excel. Com a estrutura XLOPER, uma função de DLL pode passar referências de planilha e implementar controle de fluxo, além de passar dados. Uma descrição completa do tipo de dados R e da interface de programação de aplicativo (API) do Microsoft Excel vai além do escopo deste tópico. O Guia do Desenvolvedor do Microsoft Office XP contém informações detalhadas sobre o tipo de dados R, a API do Microsoft Excel e muitos outros aspectos técnicos do Microsoft Excel.

Início da Página

Funções voláteis e recálculo

Geralmente, o Microsoft Excel calcula uma função de DLL (ou um recurso de código) apenas quando ele é inserido em uma célula, quando um de seus precedentes é alterado ou quando a célula é calculada durante uma macro. Em uma planilha, você pode tornar uma função de DLL ou um recurso de código volátil, o que significa que ele é recalculado sempre que a planilha é recalculada. Para tornar uma função volátil, adicione um ponto de exclamação (!) como o último caractere no argumento tipo_texto.

Por exemplo, no Microsoft Excel para Windows, a seguinte fórmula de planilha é recalculada sempre que a planilha é recalculada:

CHAMAR("Kernel32";"GetTickCount";"J!")

Início da Página

Modificando no local — Funções declaradas como nulas

Você pode usar um único dígito n para o código de tipo de retorno em tipo_texto, onde n é um número de 1 a 9. Isso diz ao Microsoft Excel para modificar a variável no local apontado pelo enésimo argumento em tipo_texto, em vez de retornar um valor. Isso também é conhecido como modificar no local. O enésimo argumento deve ser um tipo de dados que passa por referência (C, D, E, F, G, K, L, M, N, O, P ou R). A função de DLL ou o recurso de código deve ser também declarado com a palavra-chave void na linguagem C (ou a palavra-chave procedure na linguagem Pascal).

Por exemplo, uma função de DLL que usa como argumentos uma cadeia terminada por caractere nulo e dois ponteiros para inteiros pode modificar a cadeia no local. Use "1FMM" como o argumento tipo_texto e declare a função como nula.

Versões anteriores ao Microsoft Excel 4.0 usavam o caractere > para modificar o primeiro argumento no local; não havia como modificar um argumento diferente do primeiro. O caractere > é equivalente a n = 1 no Microsoft Excel versões 4.0 e posterior.

Início da Página