Compartilhar via


Funções na Biblioteca de Estruturas

Aplica-se a: Excel 2013 | Office 2013 | Visual Studio

A Biblioteca de Estruturas foi criada para ajudar a facilitar a gravação de XLLs. Ele inclui funções simples para gerenciara memória XLOPER12XLOPER/ , criarXLOPER12XLOPER/ temporárias, chamar robustamente as funções de retorno de chamada do Microsoft Excel (Excel4, Excel4v, Excel12, Excel12v) e imprimir cadeias de caracteres de depuração em um terminal anexado.

As funções incluídas nesta biblioteca ajudam a simplificar um pedaço de código que se parece com o seguinte.

XLOPER12 xMissing, xBool;
xMissing.xltype = xltypeMissing;
xBool.xltype = xltypeBool;
xBool.val.xbool = 0;
Excel12(xlcDisplay, 0, 2, (LPXLOPER12) &xMissing, (LPXLOPER12) &xBool);

O código simplificado se parece com o exemplo a seguir.

Excel12f(xlcDisplay, 0, 2, TempMissing12(), TempBool12(0));
As seguintes funções estão incluídas na biblioteca framework:
debugPrintf
GetTempMemory
FreeAllTempMemory
InitFramework
QuitFramework
Funções usadas com XLOPERs Funções usadas com XLOPER12s
Excel
Excel12f
TempNum
TempNum12
TempStr
TempStr12
TempStrConst
TempStr12Const
TempBool
TempBool12
TempInt
TempInt12
TempErr
TempErr12
TempActiveRef
TempActiveRef12
TempActiveCell
TempActiveCell12
TempActiveRow
TempActiveRow12
TempActiveColumn
TempActiveColumn12
TempMissing
TempMissing12

O uso dessas funções reduz o tempo necessário para gravar uma DLL ou XLL. Iniciar o desenvolvimento do aplicativo de exemplo GENERIC também reduz o tempo de desenvolvimento. Use GENERIC. C como um modelo para ajudar a configurar a estrutura de uma XLL e, em seguida, substituir o código existente por seu próprio.

As funções deXLOPER12XLOPER/ temporárias criam valoresde XLOPER12XLOPER/ usando memória de um heap local gerenciado pela biblioteca framework. Os valoresde XLOPER12XLOPER/ permanecem válidos até que você chame a função FreeAllTempMemory ou qualquer uma das funções excel ou Excel12f. (As funções Excel e Excel12f liberam toda a memória temporária antes de retornar.)

Para usar as funções da biblioteca framework, você deve incluir o FRAMEWRK. Arquivo H no código C e adicione o FRAMEWRK. C ou FRMWRK32. Arquivos LIB para seu projeto de código.

Confira também