Utilizar as funções CHAMAR e REGISTO

Tipos de dados F e G

Com os tipos de dados F e G, uma função pode alterar uma memória intermédia de cadeia atribuída pelo Microsoft Excel. Se o código do tipo de valor devolvido for F ou G, o Microsoft Excel ignora o valor devolvido pela função. Em vez disso, o Microsoft Excel procura na lista de argumentos da função, o primeiro tipo de dados correspondente (F ou G) e, em seguida, assume o conteúdo atual da memória intermédia da cadeia atribuída como valor devolvido. O Microsoft Excel atribui ao argumento 256 bytes, para que a função possa devolver uma cadeia maior do que a recebida.

Início da Página

Tipo de dados K

O tipo de dados K utiliza um apontador para uma estrutura FP de tamanho variável. Tem de definir esta estrutura na DLL ou recurso de código da seguinte 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] atribui memória para apenas uma matriz de elemento único. O número de elementos na matriz atual é igual 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 utilizado apenas como um argumento, não como um valor devolvido. Transfere três itens: um apontador para o número de linhas numa matriz, um apontador para o número de colunas numa matriz e um apontador para uma matriz bidimensional de números em vírgula flutuante.

Em vez de devolver um valor, uma função pode modificar uma matriz transmitida pelo tipo de dados O. Para tal, pode utilizar ">O" como argumento type_text. Para obter mais informações, veja "Modifying in Place — Functions Declared as Void" (Modificar no Local — Funções Declaradas como Nulas) abaixo.

O tipo de dados O foi criado para direcionar a compatibilidade com DLLs FORTRAN que transferem argumentos por referência.

Início da Página

Tipo de dados P

O tipo de dados P é um apontador para uma estrutura OPER. A estrutura OPER contém oito bytes de dados, acompanhados por um apontador de dois bytes que especifica o tipo de dados. Com o tipo de dados P, uma função DLL ou recurso de código podem assumir e devolver qualquer tipo de dados do Microsoft Excel.

A estrutura OPER é definida do seguinte modo:

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 só podem ser utilizados como argumentos e não como valores devolvidos. O valor do argumento em falta (128) é transferido quando o autor da chamada omite um argumento. O valor da célula vazia (256) é transferido quando o autor da chamada transfere uma referência para uma célula vazia.

Início da Página

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

O tipo de dados R é um apontador para uma estrutura XLOPER, uma versão melhorada da estrutura OPER. Na versão 4.0 e posteriores do Microsoft Excel, é possível utilizar o tipo de dados R para escrever DLL e recursos de código que chamam funções do Microsoft Excel. Com a estrutura XLOPER, uma função de DLL pode transferir referências a folhas de cálculo e implementar o controlo do fluxo, além de transferir dados. Uma descrição completa do tipo de dados R e da API Application Programming Interface do Microsoft Excel está para além do âmbito deste tópico. O Microsoft Office XP Developer's Guide contém informações detalhadas sobre o tipo de dados R, a API do Microsoft Excel e muitos outros aspetos técnicos do Microsoft Excel.

Início da Página

Funções voláteis e Recalcular

O Microsoft Excel normalmente só calcula uma função de DLL (ou um recurso de código) ao ser introduzida numa célula quando um dos seus precedentes for alterado ou quando a célula for calculada durante uma macro. Numa folha de cálculo, pode tornar volátil uma função de DLL ou recurso de código, o que significa que ela efetuará o novo cálculo sempre que a folha de cálculo o efetuar também. Para tornar uma função volátil, adicione um ponto de exclamação (!) como o último caráter no argumento tipo_texto.

Por exemplo, no Microsoft Excel para Windows, a fórmula da folha de cálculo seguinte efetua o novo cálculo sempre que a folha de cálculo o efetuar também:

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

Início da Página

Alterar na posição — Funções declaradas como Void

É possível utilizar um único dígito n para o código de tipo de valor a devolver em tipo_texto, onde n é um número de 1 a 9. Assim, é dada ao Microsoft Excel ordem para modificar a variável na localização apontada pelo enésimo argumento em tipo_texto, em vez de devolver um valor. Isto também é conhecido como alteração na posição. O enésimo argumento pode ser um tipo de dados passado por referência (C, D, E, F, G, K, L, M, N, O, P ou R). A função de DLL ou recurso de código também deve ser declarada com a palavra-chave Void em linguagem C (ou com a palavra-chave Procedure na linguagem Pascal)

Por exemplo, uma função de DLL que assuma como argumentos uma cadeia terminada pelo caráter nulo e dois apontadores para inteiros, pode alterar a cadeia numa determinada posição. Utilize "1FMM" como argumento tipo_texto e declare a função como Void.

Versões anteriores do Microsoft Excel 4.0 utilizavam o caráter > para alterar o primeiro argumento na primeira posição-não havia hipótese de alterar outro argumento que não o primeiro. O caráter > é equivalente a n = 1 no Microsoft Excel versão 4.0 e versões posteriores.

Início da Página