xlAddInManagerInfo/xlAddInManagerInfo12 (traduction automatique)

Dernière modification : mercredi 18 mars 2009

S’applique à : Excel 2010 | Office 2010 | VBA | Visual Studio

Important

Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Appelée par Microsoft Excel lorsque le Gestionnaire de compléments est appelé pour la première fois dans une session Excel. Cette fonction est utilisée pour fournir au Gestionnaire de compléments les informations sur votre complément.

Excel 2007 appelle xlAddInManagerInfo12 de préférence à xlAddInManagerInfo lorsqu'ils sont exportés par la XLL. La fonction xlAddInManagerInfo12 doit fonctionner de la même façon que xlAddInManagerInfo pour éviter les différences spécifiques à la version de comportement de la XLL. Excel s'attend à xlAddInManagerInfo12 pour renvoyer un type de données XLOPER12, tandis que xlAddInManagerInfo doit renvoyer une XLOPER.

La fonction xlAddInManagerInfo12 n'est pas appelée par les versions d'Excel antérieures à Excel 2007, comme ces ne prennent pas en charge la XLOPER12.

Excel ne nécessite pas un XLL mettre en œuvre et d'exportation de ces fonctions.

LPXLOPER WINAPI xlAddInManagerInfo(LPXLOPER pxAction);
LPXLOPER12 WINAPI xlAddInManagerInfo12(LPXLOPER12 pxAction);

Paramètres

pointeur pxAction: A pour un XLOPER/XLOPER12 numérique (xltypeInt ou xltypeNum).

Les informations que vous demande d'Excel.

Valeur de propriété/Valeur renvoyée

Si pxAction est ou peut être forcé à correspondre au numéro 1, votre implémentation de cette fonction doit retourner une chaîne contenant des informations sur la macro complémentaire, généralement son nom et éventuellement un numéro de version. Dans le cas contraire, elle doit renvoyer # Value!.

Si vous ne renvoyez pas une chaîne, Excel essaie de convertir la valeur retournée pour une chaîne.

Notes

Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Remarques

Si la chaîne retournée pointe vers la mémoire tampon allouée de manière dynamique, assurez-vous que ce tampon est finalement libéré. Si la chaîne a été allouée par Excel, cela en définissant xlbitXLFree. Si la chaîne a été allouée par la DLL, pour ce faire, la définition de xlbitDLLFree et vous devez également implémenter dans xlAutoFree (si vous renvoyez un XLOPER) ou xlAutoFree12 (si vous renvoyez un XLOPER12).

Exemple

\SAMPLES\GENERIC\GENERIC.C

LPXLOPER12 WINAPI xlAddInManagerInfo12(LPXLOPER12 xAction)
{
    static XLOPER12 xInfo, xIntAction;

/*
** This code coerces the passed-in value to an integer. This is how the
** code determines what is being requested. If it receives a 1, it returns a
** string representing the long name. If it receives anything else, it
** returns a #VALUE! error.
*/

    Excel12f(xlCoerce, &xIntAction, 2, xAction, TempInt12(xltypeInt));

    if(xIntAction.val.w == 1) 
    {
        xInfo.xltype = xltypeStr;
        xInfo.val.str = L"\026Example Standalone DLL";
    }
    else 
    {
        xInfo.xltype = xltypeErr;
        xInfo.val.err = xlerrValue;
    }

// Word of caution - returning static XLOPERs/XLOPER12s is not thread safe
// for UDFs declared as thread safe. Use alternate memory allocation mechanisms.

    return (LPXLOPER12)&xInfo;
} 

Voir aussi

Concepts

Gestionnaire de compléments et fonctions d’interface XLL (traduction automatique)