xlSheetId

  • Статья

Область применения: Excel 2013 | Office 2013 | Visual Studio

Находит идентификатор листа с именем для создания внешних ссылок.

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

Параметры

pxSheetName (xltypeStr)

(Необязательно). Имя книги и листа, о которой вы хотите узнать. Если этот параметр опущен, функция xlSheetId возвращает идентификатор активного (переднего) листа.

Возвращаемое значение

Возвращает идентификатор листа в pxRes-val.mref.idSheet>.

Примечание.

После этого вызова указатель массива pxRes-val.mref.lpmref> имеет значение NULL, поэтому нет необходимости вызывать xlFree для освобождения памяти, которая обычно содержится в этом типе, хотя это совершенно безопасно.

Замечания

Книга, содержащая указанный лист, должна быть открыта для использования этой функции. Создать ссылку на неоткрытую книгу из библиотеки DLL нельзя. Дополнительные сведения об использовании xlSheetId для создания ссылок см. в разделе Управление памятью в Excel для примеров создания xltypeRef .

Пример

\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;
}

См. также