Пример расширения Excel. Классы Element

Расширение использует классы, которые являются производными от класса UITechnologyElement и представляют элементы управления "Лист" и "Ячейка" в приложении Microsoft Excel.

Базовым элементом для данного расширения является ExcelElement.От этого элемента наследуют классы ExcelWorksheetElement и ExcelCellElement.

Классы Element и ElementInformation

Element является базовым классом для всех элементов пользовательского интерфейса для расширения Excel; он является производным от класса UITechnologyElement.ElementInformation является базовым классом для классов информации об элементах в примере; он не содержит членов.

Ff398058.collapse_all(ru-ru,VS.110).gifПростые свойства и методы

Эти члены возвращают простые значения, например значение свойства Name или ClassName; код этих членов является простым и удобным для чтения.Некоторые значения возвращаются с помощью класса Utility, который рассматривается ниже.Прочие члены возвращают значение null, поскольку они не имеют отношения к данному примеру расширения.Два члена имеют большее значение по сравнению с остальными: свойство QueryId и метод CacheProperties.

Ff398058.collapse_all(ru-ru,VS.110).gifСвойство QueryId

Это свойство возвращает условие, составленное из пары "имя-значение свойства", которое уникальным образом определяет элемент управления во время воспроизведения.Разработчик должен переопределить это свойство в каждом производном классе элемента управления, чтобы возвратить объект IQueryElement, который может использоваться средой для поиска элемента управления в пользовательском интерфейсе.

Ff398058.collapse_all(ru-ru,VS.110).gifМетод CacheProperties

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

Классы WorksheetElement и WorksheetInformation

Класс WorksheetElement представляет лист Excel в среде тестирования; он наследуют от базового класса Element.Для предоставления конкретной информации об объекте листа Excel переопределяются три свойства: ClassName, ControlTypeName и Name.

К этому классу также применяется атрибут ComVisibleAttribute, чтобы сделать класс видимым для модели COM.

Класс WorksheetInformation представляет информацию о листе Excel.У него имеется только один член — свойство SheetName, однако этого достаточно для целей примера.

Классы CellElement и CellInformation

Класс CellElement представляет ячейку Excel; он наследует от базового класса Element.Его единственным переопределенным членом является свойство QueryId, которое возвращает объект IQueryElement, использующий свойства RowIndex и ColumnIndex для определения ячейки.

Классы Utilities и ExcelUtilities

Внутренний класс ExcelUtilities предоставляет некоторые константные значения, такие как имя технологии, а также метод, который определяет, действительно ли указанный дескриптор окна представляет лист Excel.

Класс Utilities содержит вспомогательные методы, которые возвращают самые различные сведения о пользовательском интерфейсе.Некоторые методы используют прямые вызовы внешних системных библиотек DLL, таких как USER32.DLL и OLEACC.DLL, для получения дескрипторов окна из пользовательского интерфейса**.**

См. также

Ссылки

ComVisibleAttribute

IQueryElement

Основные понятия

Расширение закодированных тестов пользовательского интерфейса и записей действий для поддержки Microsoft Excel