Compartilhar via

xlSheetId

Aplica-se a: Excel 2013 | Office 2013 | Visual Studio

Localiza a ID da planilha de uma planilha nomeada para construir referências externas.

Excel12(xlSheetId, LPXLOPER12 pxRes, 1, LPXLOPER12 pxSheetName);

Parâmetros

pxSheetName (xltypeStr)

(Opcional). O nome do livro e da planilha sobre o qual você deseja descobrir. Se omitida, a função xlSheetId retornará a ID da planilha ativa (front).

Valor de retorno

Retorna a ID da planilha em pxRes-val.mref.idSheet>.

Observação

O ponteiro de matriz pxRes-val.mref.lpmref> é definido como NULL após essa chamada para que não seja necessário chamar xlFree para liberar a memória que esse tipo normalmente contém, embora seja completamente seguro fazê-lo.

Comentários

A pasta de trabalho que contém a planilha especificada deve estar aberta para usar essa função. Não há como construir uma referência a uma pasta de trabalho não aberta a partir de uma DLL. Para obter mais informações sobre como usar xlSheetId para construir referências, consulte Gerenciamento de Memória no Excel para obter exemplos de construção xltypeRef .

Exemplo

\SAMPLES\EXAMPLE\EXAMPLE.C

short WINAPI xlSheetIdExample(void)
{       
   XLOPER12 xSheetName, xRes;
   xSheetName.xltype = xltypeStr;
   xSheetName.val.str = L"\022[BOOK1.XLSX]Sheet1";
   Excel12(xlSheetId, &xRes, 1, (LPXLOPER12)&xSheetName);
   Excel12f(xlcAlert, 0, 1, TempNum12(xRes.val.mref.idSheet));
   Excel12(xlFree, 0, 1, (LPXLOPER12)&xRes);
   return 1;
}

Confira também