Compartir a través de


TempStrConst/TempStr12

Hace referencia a: Excel 2013 | Office 2013 | Visual Studio

Función de biblioteca de marcos que crea un XLOPER/XLOPER12 temporal que contiene una cadena xltypeStr , tomando una cadena de origen terminada en NULL como entrada. La función asigna un nuevo búfer de memoria y copia la cadena pasada en él. La cadena de entrada no se modifica y, por lo tanto, se declara como const.

LPXLOPER TempStrConst(const LPSTR str);
LPXLOPER12 TempStr12(const XCHAR* lpstr);

Parameters

str

Puntero a la cadena de origen terminada en null. En el caso de XLOPERs, TempStrConst trunca las cadenas que tienen más de 255 bytes. En el caso de XLOPER12s, TempStr12Const trunca las cadenas que tienen más de 32 767 caracteres Unicode.

Valor devuelto

Devuelve una cadena xltypeStr que contiene una copia del búfer de cadena pasado.

Comentarios

Tenga en cuenta que la función framework de cadena XLOPER , TempStr, se comporta de manera diferente e intenta sobrescribir el primer carácter de la cadena proporcionada con la longitud de la cadena posterior. Esto no siempre es seguro: Microsoft Excel podría bloquearse si se pasa una cadena de solo lectura. Esta forma de crear cadenas temporales ahora está en desuso en favor de la forma en que funcionan TempStrConst y TempStr12 . Por lo tanto, el primer carácter de la cadena de entrada se trata como el inicio de la cadena, es decir, no como un carácter de longitud o como un espacio para un carácter de longitud. No debe pasar cadenas que tengan un carácter de longitud codificado al principio, ya que las consecuencias podrían ser imprevisibles.

Ejemplo

En este ejemplo se usa la función TempStr12 para crear una cadena para un cuadro de mensaje.

\SAMPLES\EXAMPLE\EXAMPLE.C

short WINAPI TempStrExample(void)
{
   Excel12f(xlcAlert, 0, 1, TempStr12Const(L"Made it!"));
   return 1;
}

Vea también

Funciones de la biblioteca de marcos