EzGridItem
EzGridItem is created using an existing element who has a ControlType of DataItem. This class opens up grid item specific functionality; this element type will always have a parent grid
💡 Note
If the underlying element being used to construct EzGridItem does not have a ControlType of DataItem, an exception will be thrown on construction
Syntax
public class EzGridItem : EzElement
Constructors
Name | Input | Description |
---|---|---|
EzGridItem(EzElement element) | EzElement | Creates a new instance of EzGridItem based on an existing EzElement |
EzGridItem(EzRoot root) | EzRoot | Creates a new instance of EzGridItem based on an existing EzRoot |
EzGridItem(AutomationElement element) | AutomationElement | Creates a new instance of EzGridItem based on an existing AutomationElement |
Properties
Name | Type | Description |
---|---|---|
GridItemPattern | GridItemPattern | Houses the underlying windows GridItemPattern. Will return null if ExposeBackingWindowsPatterns is not set to true |
RowNum | int | Houses the row number of the current EzGridItem in relation to its EzGrid |
RowSpan | int | Houses the value of the row span |
ColumnNum | int | Houses the column number of the current EzGridItem in relation to its EzGrid |
ColumnSpan | int | Houses the value of the column span |
Samples and Usage
The EzGridItem element is usually constructed with an instance of EzElement (or more practically, EzGrid). It provides functionality specific to an item within a grid.
Sample:
//Simple method to launch Windows' built in calculator application const string calculatorPath = C:\\Windows\\System32\\calc.exe"; //Get an instance of EzProcess in order to create EzRoot. Wrap it in a using statement to ensure that //.Dispose() is called using (EzProcess process = new EzProcess(calculatorPath, "Calculator")) { process.StartProcess(); //Get the root element of the application EzRoot root = new EzRoot(process); //Use the .FindChildByAutomationId to query all children of the root for the first element whose //AutomationId property is equal to "TestGridName" EzElement element = root.RootElement.FindChildByAutomationId("TestGridName"); //Create a new EzGrid instance with our EzElement instance. Note that if the control type of our //EzElement intance is not DataGrid, an exception will be thrown EzGrid grid = new EzGrid(element); //Find the first child of the grid element whose AutomationId property equals "TestGridItem" EzElement gridElement = grid.FindChildByAutomationId("TestGridItem"); //Create an instance of EzGridItem using our instance of EzGrid. Note that if element's control type //is not DataItem an exception will be thrown EzGridItem gridItem = new EzGridItem(gridElement); //Get the column number of the grid item within its parent grid int columnNum = gridItem.ColumnNum; }