xlSheetNm
Область применения: Excel 2013 | Office 2013 | Visual Studio
Возвращает имя листа или листа макросов из внутреннего идентификатора листа, содержащегося во внешней ссылке, или имя текущего листа при передаче внутренней ссылки.
Excel12(xlSheetNm, LPXLOPER12 pxRes, 1, LPXLOPER12 pxExtref);
Параметры
pxExtref (xltypeRef или xltypeSRef)
Ссылка на лист, имя которого требуется.
Если вы передаете внешнюю ссылку (xltypeRef), она должна содержать только идентификатор листа. Структуры данных, описывающие ячейки на листе, игнорируются и не требуют предоставления. Если идентификатор равен нулю, функция xlSheetNm возвращает имя текущего листа.
При передаче внутренней ссылки (xltypeSef) функция xlSheetNm возвращает имя текущего листа.
Значение свойства и возвращаемое значение
Возвращает имя листа (xltypeStr) в формате [Book1]Sheet1.
Пример
В следующем примере отображается имя листа, с которого была вызвана функция. Функция работает правильно, только если вызывается из листа макросов при выполнении макроса команды XLM. Это связано с тем, что он вызывает xlcAlert, который могут выполнять только команды, и его необходимо вызывать с листа, а не из диалогового окна, меню или панели команд, чтобы xlfCaller возвращал ссылку.
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI xlSheetNmExample(void)
{
XLOPER12 xRes, xSheetName;
Excel12(xlfCaller, &xRes, 0);
Excel12(xlSheetNm, &xSheetName, 1, (LPXLOPER12)&xRes);
Excel12(xlcAlert, 0, 1, (LPXLOPER12)&xSheetName);
Excel12(xlFree, 0, 1, (LPXLOPER12)&xSheetName);
return 1;
}