TempStrConst/TempStr12
S’applique à: Excel 2013 | Office 2013 | Visual Studio
Fonction de bibliothèque d’infrastructure qui crée une xlOPER/XLOPER12 temporaire qui contient une chaîne xltypeStr , en prenant comme entrée une chaîne source terminée par null. La fonction alloue une nouvelle mémoire tampon et copie la chaîne passée dans celle-ci. La chaîne d’entrée n’est pas modifiée et est donc déclarée const.
LPXLOPER TempStrConst(const LPSTR str);
LPXLOPER12 TempStr12(const XCHAR* lpstr);
Paramètres
str
Pointeur vers la chaîne source terminée par null. Dans le cas de XLOPER, TempStrConst tronque les chaînes de plus de 255 octets. Dans le cas de XLOPER12, TempStr12Const tronque les chaînes de plus de 32 767 caractères Unicode.
Valeur renvoyée
Retourne une chaîne xltypeStr contenant une copie de la mémoire tampon de chaîne passée.
Remarques
Notez que la fonction String Framework XLOPER , TempStr, se comporte différemment et tente de remplacer le premier caractère de la chaîne fournie par la longueur de la chaîne suivante. Ce n’est pas toujours une chose sûre à faire : Microsoft Excel peut se bloquer si une chaîne en lecture seule est transmise. Cette façon de créer des chaînes temporaires est désormais déconseillée en faveur de la façon dont TempStrConst et TempStr12 fonctionnent. Par conséquent, le premier caractère de la chaîne d’entrée est traité comme le début de la chaîne, c’est-à-dire pas comme un caractère de longueur ou comme un espace pour un caractère de longueur. Vous ne devez pas passer de chaînes dont le caractère de longueur est codé au début, car les conséquences peuvent être imprévisibles.
Exemple
Cet exemple utilise la fonction TempStr12 pour créer une chaîne pour une boîte de message.
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI TempStrExample(void)
{
Excel12f(xlcAlert, 0, 1, TempStr12Const(L"Made it!"));
return 1;
}