Настраиваемые шаблоны Excel

В этом разделе описываются пользовательские шаблоны модель автоматизации пользовательского интерфейса, предоставляемые в Microsoft Excel для Windows. Эти шаблоны можно запрашивать и использовать из узла поставщика для определенного листа Excel.

Для экспериментов мы создали специальные скрипты PowerShell в коллекция PowerShell, которые осуществляют каждый настраиваемый шаблон Excel. Они явно выделяются с каждым шаблоном, или вы можете найти коллекция PowerShell, CustomPatternClient_Excel чтобы просмотреть все скрипты Excel. Эти скрипты можно запустить в окне PowerShell в работающем экземпляре Excel на Windows 11, чтобы увидеть, какие выходные данные создают пользовательские шаблоны. Скрипты самостоятельно документируются с помощью справки на основе комментариев.

Main целью этих шаблонов является предоставление сведений о листе, не сужаемых с видимой областью листа. Имена и диапазоны — это режим обмена данными, а не объекты специальных возможностей. Для ячеек имя, используемое в этих шаблонах, также доступно в качестве UIA_AutomationIdPropertyId.

Операнды, общие для всех методов

Существует 3 фиксированных входных операнда для каждого вызова метода пользовательского шаблона.

Оператор	Тип	Описание
0	ConnectBoundObject	Объект Pattern
1	GUID	Guid метода
2	Int32	Общее количество входных и выходных аргументов

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

Каждый описанный здесь метод возвращает HRESULT для CallExtension, указывающий на успех или сбой. Успешная операция возвращает S_OK, а неудачная операция даст UIA_E_INVALIDOPERATON.

ISheetCellInventory

Описание

Guid: {654823FE-A483-4915-8709-67266866E518}

Это шаблон на листе, который собирает ячейки, соответствующие определенным признакам. Во всех случаях они возвращают коллекцию строк, которые являются именами ячеек.

Сценарий PowerShell

CustomPatternClient_Excel_Cell_Inventory.ps1

Методы

GetCellsWithFormula

Guid: {24E137F2-4FFF-4F50-84AD-2ACD780E7E1F}

Возвращает имена ячеек на листе с формулами

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена ячеек

GetCellsWithHyperlink

Guid: {B640F40E-E51A-4CDD-9604-843AA5107C1C}

Возвращает имена ячеек с литеральными гиперlnk. Другими словами, ячейки со значением, которое является URL-адресом.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена ячеек

GetCellsWithFormulaHyperlink

Guid: {0AAF2B49-015B-4AB3-A093-21F055E8E0F5}

Возвращает имена ячеек с гиперлинками формул. Другими словами, ячейки, использующие функцию HYPERLINK в формуле.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена ячеек

GetCellsWithNote

Guid: {8F171892-A3B1-4F92-9CE1-CE818B848F52}

Возвращает имена ячеек, с которыми связаны заметки или непоточные устаревшие комментарии.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена ячеек

GetCellsWithComment

Guid: {4D4E49BC-CE16-44CD-AC48-1DAA2E862C41}

Возвращает имена ячеек, с которыми связаны потоковые комментарии.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена ячеек

ISheetRangeInventory

Описание

Guid: {62F8DBCE-13DC-4EF2-AF53-5247ED2A4980}

Этот шаблон листа собирает диапазоны ячеек. Эти методы возвращают коллекцию строк, представляющих диапазон ячеек. Диапазон можно описать именем (если применимо) и при необходимости ссылкой на диапазон ячеек, отделенной от имени строкой входного разделителя.

Сценарий PowerShell

CustomPatternClient_Excel_Range_Inventory.ps1

Методы

GetTableNamesAndRanges

Guid: {3FB8E49A-BB4A-4B6C-8B25-CB7E612DA92E}

Возвращает имена таблиц списков и их диапазоны по запросу. Спецификации диапазона отделяются от имени таблицы строкой входного разделителя.

Оператор	Role	Тип	Описание
3	Input	Логический	Включить спецификации диапазона
4	Input	String	Разделитель полей имен и диапазонов
5	Выходные данные	StringArray	Имена диапазонов и ссылки при запросе

GetPivotTableNamesAndRanges

Guid: {B22CD312-E265-49AE-9C73-11CE3D7B8526}

Возвращает имена сводных таблиц и их диапазоны по запросу. Спецификации диапазона отделяются от имени таблицы строкой входного разделителя.

Оператор	Role	Тип	Описание
3	Input	Логический	Включить спецификации диапазона
4	Input	String	Разделитель полей имен и диапазонов
5	Выходные данные	StringArray	Имена диапазонов и ссылки при запросе

GetNamedRanges

Guid: {EFC59F27-E965-48A5-8C79-7BB9E70958FD}

Возвращает именованные диапазоны и их спецификации по запросу. Это диапазоны ячеек, которые были названы с помощью диспетчера имен, и не включают диапазоны, поступающие из таблиц. Спецификации диапазона отделяются от имени таблицы строкой входного разделителя.

Оператор	Role	Тип	Описание
3	Input	Логический	Включить спецификации диапазона
4	Input	String	Разделитель полей имен и диапазонов
5	Выходные данные	StringArray	Имена диапазонов и ссылки при запросе

GetUnnamedDataRanges

Guid: {60EBB5D1-299D-471D-8DAB-00EE39EBA79E}

Возвращает диапазоны ячеек с данными, которые в противном случае не являются частью именованного диапазона или таблицы.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Ссылки на диапазон

GetRowRangesOnPageBreaks

Guid: {2544B784-764D-4EAA-A72F-BABBF28B5504}

Возвращает ссылки на один диапазон строк, охватывающие печатаемую область листа, которая предшествует горизонтальному разрыву страницы.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Ссылки на диапазон

GetColumnRangesOnPageBreaks

Guid: {BEA372DC-2FD8-4852-A8BC-2DA34CEA5456}

Возвращает ссылки на диапазон одного столбца, охватывающие печатаемую область листа, которая предшествует вертикальному разрыву страницы.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Ссылки на диапазон

ISheetObjectInventory

Описание

Guid: {62F8DBCE-13DC-4EF2-AF53-5247ED2A4980}

Этот шаблон листа возвращает коллекцию именованных объектов на листе указанного типа.

Сценарий PowerShell

CustomPatternClient_Excel_Object_Inventory.ps1

Методы

GetChartNames

Guid: {6D199DC0-7AF0-43CC-A572-8CF9EE556F75}

Возвращает имена диаграмм на листе.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена диаграмм

GetSmartDiagramNames

Guid: {AF8706FA-6389-4F90-9EF8-F64AED618C4F}

Возвращает имена схем Smart Art на листе.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена схем

GetSlicerNames

Guid: {7D6295DF-E9CC-4B86-BE9F-60BACCB7289D}

Возвращает имена объектов среза на листе.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена срезов

GetTimeSlicerNames

Guid: {F8768BF3-9733-4BD9-9251-507649FF3257}

Возвращает имена объектов среза времени на листе.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена срезов времени

GetImageNames

Guid: {A2807141-BA1F-4088-85A1-4C00F140998C}

Возвращает имена объектов рисунков на листе.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена рисунков

GetShapeNames

Guid: {C50C4B9E-2F62-4E47-993D-A961D0C6A03D}

Возвращает имена фигур рисования на листе.

Оператор	Role	Тип	Описание
3	Выходные данные	StringArray	Имена фигур

ISheetContentSelect

Описание

Guid: {5979E0BC-12AC-4105-B10A-2FD04546E9C2}

Этот шаблон предоставляет средства для выбора любой ячейки, коллекции ячеек или объекта на листе независимо от текущего состояния представления. Ячейки, которые не отображаются, не имеют доступных элементов для реализации шаблона элемента выделения, поэтому этот шаблон позволяет выбирать по имени ячейки. Имя ячейки также является свойством AutomationID, если требуется вернуться к ранее посещенной ячейке. Этот метод также позволяет указать диапазон ячеек для выбора формы :. Объекты также могут быть выбраны по имени, возвращаемого ISheetObjectInventory.

Сценарий PowerShell

CustomPatternClient_Excel_Selector.ps1

Методы

SelectRange

Guid: {BB66F5D4-795E-4B6E-9D62-F14804FC240C}

Выделяет и делает видимой ячейку или диапазон ячеек на листе.

Оператор	Role	Тип	Описание
3	Input	String	Имя ячейки, ссылка на диапазон или имя диапазона

SelectObject

Guid: {E36D84D6-B003-47D2-9AC2-9A1B8BA6EB62}

Выделяет и делает видимым объект на листе.

Оператор	Role	Тип	Описание
3	Input	String	Имя объекта

ISheetCellValue

Описание

Guid: {238037C4-BBA3-4C0E-9371-66046B81E957}

Этот шаблон используется для получения текущих значений ячейки или ячеек в адресе ячейки, диапазоне или строке или столбце таблицы на листе, независимо от того, виден лист или нет. Выходные данные — это строка с текущим значением ячейки или массив строк пар "адрес-значение" ячейки при запросе диапазона или таблицы строки или столбца.

Сценарий PowerShell

CustomPatternClient_Excel_Cell_Value.ps1

Методы

GetCellValue

Guid: {4C6CA843-D4F0-4CB6-B1AF-EF8DADEE9B2C}

Возвращает текущее значение ячейки.

Оператор	Role	Тип	Описание
3	Input	String	Имя ячейки
4	Выходные данные	String	Текущее значение ячейки

Сценарий PowerShell

CustomPatternClient_Excel_Range_Values.ps1

Методы

GetRangeValues

Guid: {1D69601E-D934-472B-BDCD-13147EE5A3A9}

Требование: Microsoft 365 версии 2410 (сборка 18129.xxxxx)

Возвращает непустые пары "адрес-значение" ячейки во входном диапазоне в указанном порядке. Пары "адрес—значение" ячейки разделяются входным разделителем.

Оператор	Role	Тип	Описание
3	Input	String	Диапазон ячеек
4	Input	String	Разделитель между адресом ячейки и значением ячейки
5	Input	Логический	Порядок основных строк или столбцов
6	Выходные данные	StringArray	Пары "адрес—значение ячейки"

Сценарий PowerShell

CustomPatternClient_Excel_Table_Values.ps1

Методы

GetTableColumnValues

Guid: {1F6DDBC5-F90E-4C07-BE5E-A7322AD3B737}

Требование: Microsoft 365 версии 2410 (сборка 18129.xxxxx)

Возвращает пары "адрес-значение" ячейки для столбца или строки адреса входной ячейки. Значение заголовка столбца может быть включено, как указано во входных данных.

Оператор	Role	Тип	Описание
3	Input	String	Адрес ячейки
4	Input	Логический	Включить заголовок
5	Выходные данные	StringArray	Значения ячеек в столбце таблицы, содержащего входную ячейку

GetTableRowValues

Guid: {03F8C2C6-C58A-4CDF-B8CB-54C198F7525D}

Требование: Microsoft 365 версии 2410 (сборка 18129.xxxxx)

Возвращает пары "адрес-значение" ячейки для столбца или строки адреса входной ячейки.

Оператор	Role	Тип	Описание
3	Input	String	Адрес ячейки
4	Выходные данные	StringArray	Значения ячеек в строке таблицы, содержащей входную ячейку

Требования

Если для метода не указано по-разному, требуется версия Microsoft 365 версии 2107 (сборка 14326.xxxxx).

См. также

UIA_AutomationIdPropertyId

Пользовательские свойства, события и шаблоны элементов управления

Реализация пользовательских шаблонов элементов управления

Клиентские скрипты пользовательских шаблонов Excel