TempStrConst/TempStr12
Aplica-se a: Excel 2013 | Office 2013 | Visual Studio
Função de biblioteca de estrutura que cria um XLOPER/XLOPER12 temporário que contém uma cadeia de caracteres xltypeStr , tomando uma cadeia de caracteres de origem terminada nulo como entrada. A função aloca um novo buffer de memória e copia a cadeia de caracteres passada para ele. A cadeia de caracteres de entrada não é alterada e, portanto, é declarada como const.
LPXLOPER TempStrConst(const LPSTR str);
LPXLOPER12 TempStr12(const XCHAR* lpstr);
Parâmetros
str
Um ponteiro para a cadeia de caracteres de origem terminada em nulo. No caso de XLOPERs, TempStrConst trunca cadeias de caracteres com mais de 255 bytes. No caso de XLOPER12s, TempStr12Const trunca cadeias de caracteres com mais de 32.767 caracteres Unicode.
Valor de retorno
Retorna uma cadeia de caracteres xltypeStr que contém uma cópia do buffer de cadeia de caracteres passada.
Comentários
Observe que a função XLOPER string Framework, TempStr, se comporta de forma diferente e tenta substituir o primeiro caractere da cadeia de caracteres fornecida com o comprimento da cadeia de caracteres subsequente. Nem sempre isso é uma coisa segura a se fazer: o Microsoft Excel pode falhar se passar uma cadeia de caracteres somente leitura. Essa forma de criar cadeias de caracteres temporárias agora é preterida em favor da maneira como tempStrConst e TempStr12 funcionam. Portanto, o primeiro caractere da cadeia de caracteres de entrada é tratado como o início da cadeia de caracteres, ou seja, não como um caractere de comprimento ou como um espaço para um caractere de comprimento. Você não deve passar cadeias de caracteres que têm um caractere de comprimento codificado no início, pois as consequências podem ser imprevisíveis.
Exemplo
Este exemplo usa a função TempStr12 para criar uma cadeia de caracteres para uma caixa de mensagem.
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI TempStrExample(void)
{
Excel12f(xlcAlert, 0, 1, TempStr12Const(L"Made it!"));
return 1;
}