xlfCaller
S’applique à: Excel 2013 | Office 2013 | Visual Studio
Retourne des informations sur la cellule, la plage de cellules, la commande d’un menu, un outil dans une barre d’outils ou un objet qui a appelé la commande ou la fonction DLL en cours d’exécution.
| Code appelé à partir de | Renvoie |
|---|---|
| DLL |
ID de registre. |
| Une seule cellule |
Référence à cellule unique. |
| Formule matricielle à plusieurs cellules |
Référence à plusieurs cellules. |
| Expression de mise en forme conditionnelle |
Référence à la cellule à laquelle la condition de mise en forme est appliquée. |
| Un menu |
Tableau à ligne unique à quatre éléments : ID de barre. Position du menu. Position du sous-menu. Position de la commande. |
| Barre d’outils |
Tableau à ligne unique à deux éléments : Numéro de barre d’outils pour les barres d’outils intégrées ou nom de barre d’outils pour les barres d’outils personnalisées. Position dans la barre d’outils. |
| Objet graphique |
Identificateur de l’objet (nom de l’objet). |
| Commande associée à un xlcOnEnter, ON. ENTRÉE, interruption d’événements |
Référence à la ou aux cellules entrées. |
| Commande associée à un xlcOnDoubleclick, ON. DOUBLECLICK, interruption d’événements. | Cellule qui a été double-cliqué (pas nécessairement la cellule active). |
| macro Auto_Open, fermeture automatique, Auto_Activate ou Auto_Deactivate |
Nom de la feuille appelante. |
| Autres méthodes non répertoriées |
#REF! Erreur |
Excel12(xlfCaller, (LPXLOPER12) pxRes,0);
Valeur de propriété/valeur de renvoi
La valeur de retour est l’un des types de données XLOPER/ XLOPER12 suivants : xltypeRef, xltypeSRef, xltypeNum, xltypeStr, xltypeErr ou xltypeMulti. Étant donné que trois de ces types pointent vers la mémoire allouée, la valeur de retour de xlfCaller doit toujours être libérée dans un appel à la fonction xlFree lorsqu’elle n’est plus nécessaire.
Pour plus d’informations sur XLOPERs/ XLOPER12s , voir Gestion de la mémoire dans Excel.
Remarques
Cette fonction est la seule fonction non-feuille de calcul qui peut être appelée à partir d’une fonction de feuille de calcul DLL/XLL. D’autres fonctions d’informations XLM peuvent uniquement être appelées à partir de commandes ou de fonctions équivalentes de feuille de macro.
Exemple
\SAMPLES\EXAMPLE\EXAMPLE.C. Cette fonction appelle une macro de commande (xlcSelect) et fonctionne correctement uniquement lorsqu’elle est appelée à partir d’une feuille de macro.
short WINAPI CallerExample(void)
{
XLOPER12 xRes;
Excel12(xlfCaller, &xRes, 0);
Excel12(xlcSelect, 0, 1, (LPXLOPER12)&xRes);
Excel12(xlFree, 0, 1, (LPXLOPER12)&xRes);
return 1;
}