Estensione Excel di esempio: classi Element
L'estensione utilizza classi derivate da UITechnologyElement e rappresenta i controlli di cella e di foglio di lavoro in Microsoft Excel.
L'elemento base per questa estensione è ExcelElement. La classe ExcelWorksheetElement e la classe ExcelCellElement ereditano entrambe da tale elemento.
Classi Element ed ElementInformation
La classe Element è la classe base per tutti gli elementi dell'interfaccia utente per l'estensione di Excel ed eredita dalla classe UITechnologyElement. In questo esempio, ElementInformation è la classe base per le classi delle informazioni sugli elementi e non dispone di membri.
Proprietà e metodi semplici
Questi membri restituiscono valori semplici, ad esempio il valore della proprietà Name o il valore della proprietà ClassName e il codice risulta semplice e di facile lettura. Alcuni valori vengono restituiti tramite la classe Utility, illustrata più avanti. Altri restituiscono null poiché non sono attinenti in questa estensione di esempio. Due membri sono più interessanti degli altri: la proprietà QueryId e il metodo CacheProperties.
Proprietà QueryId
Questa proprietà restituisce una condizione formata da coppie nome/valore della proprietà che identificano in modo univoco il controllo durante la riproduzione. Per ogni classe del controllo derivata, lo sviluppatore deve eseguire l'override di questa proprietà per restituire un oggetto IQueryElement che il framework possa utilizzare per trovare il controllo nell'Interfaccia utente.
Metodo CacheProperties
Questo metodo viene chiamato dal framework di test durante il processo di registrazione per fare in modo che l'elemento salvi uno snapshot delle proprietà importanti. Ciò consente di mantenere le proprietà disponibili anche quando il controllo effettivo dell'interfaccia utente non è più sullo schermo.
Classi WorksheetElement e WorksheetInformation
La classe WorksheetElement rappresenta un foglio di lavoro di Excel nel framework di test ed eredita dalla classe base Element. Viene eseguito l'override di tre proprietà per fornire informazioni specifiche sull'oggetto foglio di lavoro di Excel: ClassName, ControlTypeNamee Name.
L'oggetto ComVisibleAttribute viene applicato anche a questa classe per renderlo visibile a COM.
La classe WorksheetInformation rappresenta le informazioni su un foglio di lavoro di Excel. Dispone di solo un membro, la proprietà SheetName che è sufficiente ai fini di questo esempio.
Classi CellElement e CellInformation
La classe CellElement rappresenta una cella di Excel ed eredita dalla classe base Element. L'unico membro ignorato è la proprietà QueryId che restituisce un oggetto IQueryElement che utilizza le proprietà RowIndex e ColumnIndex per identificare la cella.
Classi Utilities e ExcelUtilities
La classe ExcelUtilities interna fornisce alcuni valori costanti, quali il nome di tecnologia e un metodo che determina se l'handle della finestra fornito rappresenta un foglio di lavoro di Excel.
La classe Utilities dispone di metodi di supporto che restituiscono una varietà di informazioni sull'interfaccia utente. Alcuni metodi utilizzano chiamate dirette in DLL di sistema esterne, quali USER32.DLL e OLEACC.DLL, per ottenere handle della finestra dall'interfaccia utente**.**