範例 Excel 延伸模組:Element 類別

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

此擴充功能使用衍生自 UITechnologyElement 的類別,代表 Microsoft Excel 中的工作表控制項和儲存格控制項。

這個擴充功能的基底項目是 ExcelElementExcelWorksheetElement 類別和 ExcelCellElement 類別繼承自該項目。

Element 是此 Excel 擴充功能所有使用者介面項目的基底類別,繼承自 UITechnologyElement 類別。 ElementInformation 是範例中項目資訊類別的基底類別,並沒有成員。

簡單屬性和方法

這些成員會傳回簡單值,例如 Name 屬性的值或 ClassName 屬性的值,而且程式碼很清楚易讀。 有些值是透過 Utility 類別傳回,稍後將予以討論。 有些會傳回 null,因為它們在這個範例擴充功能中是不相關的。 兩個成員值得說明:QueryId 屬性和 CacheProperties 方法。

QueryId 屬性

這個屬性傳回的條件是由屬性名稱值組所構成,會在播放期間唯一識別控制項。 針對每個衍生的控制項類別,程式開發人員必須覆寫這個屬性,以傳回架構可用來尋找 UI 控制項的 IQueryElement 物件。

CacheProperties 方法

這個方法是由測試架構在錄製程序期間呼叫,以便告知項目儲存重要屬性的快照。 即使實際 UI 控制項不再顯示在螢幕上,這也會讓屬性保持可用。

WorksheetElement 類別代表測試架構中的 Excel 工作表,是繼承自 Element 基底類別。 三個屬性會被覆寫以提供 Excel 工作表物件的特定資訊:ClassNameControlTypeNameName

ComVisibleAttribute 也會套用至這個類別,讓它對 COM 是可見的。

WorksheetInformation 類別代表 Excel 工作表的相關資訊。 它只有一個成員 SheetName 屬性,對這個範例而言是夠用的。

CellElement 類別代表 Excel 儲存格,是繼承自 Element 基底類別。 唯一覆寫的成員是 QueryId 屬性,會傳回 IQueryElement,它可使用 RowIndexColumnIndex 屬性識別儲存格。

內部 ExcelUtilities 類別提供一些常數值 (例如技術名稱),以及判斷提供的視窗控制代碼是否代表 Excel 工作表的方法。

Utilities 類別有 Helper 方法,會傳回 UI 的各種資訊。 有些方法會透過直接呼叫外部系統 DLLs (例如 USER32.DLLOLEACC.DLL),從 UI 取得視窗控制代碼.

ComVisibleAttribute
IQueryElement
擴充自動程式碼 UI 測試和動作記錄以支援 Microsoft Excel

顯示: