Fonctions dans la bibliothèque d’infrastructure
S’applique à: Excel 2013 | Office 2013 | Visual Studio
La bibliothèque de framework a été créée pour faciliter l’écriture des XLL. Il inclut des fonctions simples pour gérer xlOPER/ XLOPER12 mémoire, créerdes XLOPER12XLOPER/ temporaires, appeler de manière robuste les fonctions de rappel Microsoft Excel (Excel4, Excel4v, Excel12, Excel12v) et imprimer des chaînes de débogage sur un terminal attaché.
Les fonctions incluses dans cette bibliothèque permettent de simplifier un élément de code semblable à ce qui suit.
XLOPER12 xMissing, xBool;
xMissing.xltype = xltypeMissing;
xBool.xltype = xltypeBool;
xBool.val.xbool = 0;
Excel12(xlcDisplay, 0, 2, (LPXLOPER12) &xMissing, (LPXLOPER12) &xBool);
Le code simplifié ressemble à l’exemple suivant.
Excel12f(xlcDisplay, 0, 2, TempMissing12(), TempBool12(0));
| Les fonctions suivantes sont incluses dans la bibliothèque framework : |
|---|
|
debugPrintf |
|
GetTempMemory |
|
FreeAllTempMemory |
|
InitFramework |
|
QuitFramework |
| Fonctions utilisées avec XLOPERs | Fonctions utilisées avec 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 |
L’utilisation de ces fonctions raccourcit le temps nécessaire à l’écriture d’une DLL ou d’une XLL. Le démarrage du développement à partir de l’exemple d’application GENERIC raccourcit également le temps de développement. Utilisez GENERIC. C comme modèle pour vous aider à configurer l’infrastructure d’un XLL, puis à remplacer le code existant par le vôtre.
Les fonctions deXLOPER12XLOPER/ temporaires créent des valeurs deXLOPER12XLOPER/ à l’aide de la mémoire d’un tas local géré par la bibliothèque Framework. Les valeurs XLOPER12 XLOPER/ restent valides jusqu’à ce que vous appeliez la fonction FreeAllTempMemory ou l’une des fonctions Excel ou Excel12f. (Les fonctions Excel et Excel12f libèrent toute la mémoire temporaire avant de revenir.)
Pour utiliser les fonctions de bibliothèque d’infrastructure, vous devez inclure FRAMEWRK. Fichier H dans votre code C et ajoutez frameWRK. C ou FRMWRK32. Fichiers LIB dans votre projet de code.