xlCoerce

S’applique à: Excel 2013 | Office 2013 | Visual Studio

Convertit un type deXLOPER12XLOPER/ en un autre ou recherche les valeurs de cellule sur une feuille.

Excel12(xlCoerce, LPXLOPER12 pxRes, 2, LPXLOPER12 pxSource, LPXLOPER12 pxDestType);

Paramètres

pxSource

LaXLOPER12XLOPER/ source qui doit être convertie.

pxDestType (xltypeInt)

(Facultatif). Masque de bits des types résultants que vous êtes prêt à accepter. Vous devez utiliser l’opérateur OR au niveau du bit ( | ) pour spécifier plusieurs types possibles. Si cet argument est omis, les références à des cellules uniques sont converties en l’un des types de valeurs xltypeStr, xltypeNum, xltypeBool, xltypeErr, xltypeNil (si la cellule référencée est vide), et les références aux blocs de cellules sont converties en xltypeMulti. XlCoerce est ainsi le moyen le plus pratique de rechercher des valeurs de cellule.

Valeur de propriété/valeur de renvoi

Renvoie la valeur coerced (xltypeStr, xltypeNum, xltypeBool, xltypeErr, xltypeNil ou xltypeMulti).

Remarques

xlCoerce ne peut pas convertir en ou à partir de xltypeBigData ou xltypeFlow. Le passage d’un type xltypeMissing ou xltypeNil en tant que pxDestType équivaut à omettre l’argument. La conversion peut échouer dans certains cas. Par exemple, certaines chaînes ne peuvent pas être converties en nombres, tandis que d’autres le peuvent.

Si un tableau ou une référence à plusieurs cellules est converti en un type valeur unique, le résultat est la valeur de la cellule ou de l’élément tableau supérieur gauche.

Exemple

Le code suivant se trouve dans \SAMPLES\EXAMPLE\EXAMPLE.C.

Remarque

La fonction xlcAlert tente implicitement de convertir son argument en chaîne afin que l’étape de contrainte indiquée ici puisse en fait être supprimée et que xInt puisse être passé directement à xlcAlert. Comme xlcAlert est une macro de commande, ce code fonctionne correctement uniquement lorsqu’il est appelé à partir d’une feuille de macro.

short WINAPI xlCoerceExample(short iVal)
{
   XLOPER12 xStr, xInt, xDestType;
   xInt.xltype = xltypeInt;
   xInt.val.w = iVal;
   xDestType.xltype = xltypeInt;
   xDestType.val.w = xltypeStr;
   Excel12f(xlCoerce, &xStr, 2, (LPXLOPER12)&xInt, (LPXLOPER12)&xDestType);
   Excel12f(xlcAlert, 0, 1, (LPXLOPER12)&xStr);
   Excel12f(xlFree, 0, 1, (LPXLOPER12)&xStr);
   return 1;
}

Voir aussi

xlSet

Fonctions de l’API C à appeler à partir d’un fichier DLL ou XLL