Identifies a data grid control.
If the data grid has a vertical scroll bar, rows which are not in the visible area of the data grid do not expose any information (e.g. text, caption). In order to interact with such a row or retrieve information about the row it needs to be scrolled into view first.
'Declaration Public Class SLDataGrid _ Inherits SLBase
| Name | Description |
|---|---|
| AutomationId | a string containing the UI Automation identifier (ID) for the element. (Inherited from SLBase) |
| CanSelectMultiple | whether the data grid allows more than one row to be selected concurrently. |
| ClassName | the simple class name of the element. (Inherited from SLBase) |
| ColumnCount | the number of columns in the data grid |
| ColumnHeaders | a list containing the header item for every column |
| ColumnHeaderTexts | a list containing the text of the header item for every column |
| ControlType | a string containing the control type for the element. (Inherited from SLBase) |
| HelpText | a string containing the help text (e.g. tooltip text) for the element. (Inherited from SLBase) |
| HorizontallyScrollable | a value that indicates whether the data grid can scroll horizontally. |
| HorizontalScrollPercent | the current horizontal scroll position or negative one (-1) if there is no valid scroll position. |
| IsEnabled | a value that indicates whether the element is enabled. (Inherited from SLBase) |
| Name | a string containing the UI Automation name for the element. (Inherited from SLBase) |
| RowCount | the number of rows in the data grid |
| Rows | a list of rows in the data grid |
| RowTexts | a list of row texts in the data grid. The text for every row is returned as a string that contains the text of every cell separated with a blank character. |
| SelectedCell | the currently selected cell or Nothing if no cell is selected |
| SelectedCellText | the text of the currently selected cell or an empty string if no cell is selected |
| SelectedRow | the currently selected row or Nothing if no row is selected |
| SelectedRows | a list of currently selected rows or an empty list if no row is selected |
| SelectedRowText | the text of the currently selected row or an empty string if no row is selected |
| SelectedRowTexts | the text of the currently selected rows or an empty list if no row is selected |
| Text | The text of the control. (Inherited from TestObject) |
| Value | The value of the control, e.g.: text in a text control. (Inherited from TestObject) |
| VerticallyScrollable | a value that indicates whether the data grid can scroll vertically. |
| VerticalScrollPercent | the current vertical scroll position or negative one (-1) if there is no valid scroll position. |
| Name | Description |
|---|---|
| CaptureBitmap | Saves a bitmap image of this object to a file. If you do not specify an absolute file name, the bitmap is saved to the default bitmap location on the machine that runs the Agent, which is %LOCALAPPDATA%/Silk/SilkTest/capturedBitmaps. The captured bitmap's pixels are stored in 32bit RGB order; when parsing the image the 4th byte (alpha channel) of every pixel must be ignored as it is used only for padding. In .NET, the constant System.Drawing.Imaging.PixelFormat.Format32bppRgb can be used for this purpose. (Inherited from TestObject) |
| Click | Clicks on the object. (Inherited from IClickable) |
| DoubleClick | Double-clicks a mouse button on the object. (Inherited from IClickable) |
| Exists | Checks if any child object matching the locator exists for an object in the application under test. If the timeout parameter is passed the agent retries finding until the given timeout expires. If no timeout is specified and no object is found initially false is returned immediately. (Inherited from TestObject) |
| Exists | Checks if an object exists in the application under test. (Inherited from TestObject) |
| Find | Finds an object specified by an XPath locator. (Inherited from TestObject) |
| FindAll | Finds all objects specified by an XPath locator. (Inherited from TestObject) |
| GenerateLocator | Returns a locator for this object. (Inherited from TestObject) |
| GetChildren | Returns the child objects of this object. (Inherited from TestObject) |
| GetDynamicMethodList | Returns a list of methods (including their signature) that can be dynamically invoked on this TestObject. (Inherited from TestObject) |
| GetParent | Looks up the parent of this object in the test application. (Inherited from TestObject) |
| GetProperty | Returns the value of the specified property. (Inherited from TestObject) |
| GetPropertyList | Returns a list of property names that can be retrieved for the given object. (Inherited from TestObject) |
| GetRawChildren | Gets the raw child element of this element. This method can be used to access elements that would otherwise not be recognized as children. Optionally one of the MSUIA control types can be specified to only return children of a certain type. (Inherited from SLBase) |
| GetRect | Returns the size and position of this object. Per default the returned coordinates are relative to the parent window that contains this object. (Inherited from TestObject) |
| HighlightObject | Highlights this object. (Inherited from TestObject) |
| ImageClick | Clicks on specified image asset. (Inherited from TestObject) |
| ImageClickFile | Clicks on the specified image. (Inherited from TestObject) |
| ImageExists | Returns whether the specified image asset exists. (Inherited from TestObject) |
| ImageExistsFile | Returns whether the specified image exists. (Inherited from TestObject) |
| ImageRectangle | Returns the object-relative rectangle of the specified image asset. (Inherited from TestObject) |
| ImageRectangleFile | Returns the object-relative rectangle of the specified image. (Inherited from TestObject) |
| Invoke | Dynamically invokes a method on the test object. (Inherited from TestObject) |
| InvokeMethods | Dynamically invokes a sequence of methods starting at this TestObject. (Inherited from TestObject) |
| IsFocused | Return whether the control has focus. (Inherited from IFocusable) |
| MouseMove | Moves the pointer to the specified location in the object. This method is not supported for mobile Web applications. (Inherited from IClickable) |
| PressKeys | Presses (but does not release) a set of keys or mouse buttons. (Inherited from IKeyable) |
| PressMouse | Presses (but does not release) a mouse button in the object. This method is not supported for mobile Web applications. (Inherited from IClickable) |
| ReleaseKeys | Releases a set of keys or mouse buttons. (Inherited from IKeyable) |
| ReleaseMouse | Releases a mouse button. This method is not supported for mobile Web applications. (Inherited from IClickable) |
| ScrollHorizontal | Scrolls the currently visible region of the content area, horizontally, the specified ScrollAmount. |
| ScrollIntoView | Scrolls the specified row or cell into view. |
| ScrollVertical | Scrolls the currently visible region of the content area, vertically, the specified ScrollAmount. |
| Select | Selects the specified row. |
| SelectCell | Selects the specified cell. |
| SetFocus | Gives focus to the control. (Inherited from IFocusable) |
| SetHorizontalScrollPercent | Sets the horizontal scroll position as a percentage of the total content area within the data grid. |
| SetProperty | Sets the value of the specified property. (Inherited from TestObject) |
| SetVerticalScrollPercent | Sets the vertical scroll position as a percentage of the total content area within the data grid. |
| StartScreenRecording | Starts screen recording (Inherited from TestObject) |
| StopScreenRecording | Stops screen recording (Inherited from TestObject) |
| TextCapture | Returns the text in this object's visible area. (Inherited from TestObject) |
| TextClick | Clicks in the center of the specified text. (Inherited from TestObject) |
| TextExists | Returns whether the specified text exists. (Inherited from TestObject) |
| TextRectangle | Returns the object-relative rectangle of the specified text. (Inherited from TestObject) |
| TypeKeys | Sends a set of keystrokes to the object. (Inherited from IKeyable) |
| TypePasswordKeys | Types an encrypted password into an object, for example a text field. (Inherited from IKeyable) |
| WaitForChildDisappearance | Waits until the specified child object does not exist or until the timeout is reached. If you don't explicitly pass a timeout using the optional timeout parameter, the timeout specified by the option OPT_WAIT_RESOLVE_OBJDEF will be used. An exception is thrown if the timeout is reached. (Inherited from TestObject) |
| WaitForDisappearance | Waits until the object does not exist or until the timeout is reached. If you don't explicitly pass a timeout using the optional timeout parameter, the timeout specified by the option OPT_WAIT_RESOLVE_OBJDEF will be used. An exception is thrown if the timeout is reached. (Inherited from TestObject) |
| WaitForObject | Waits for an object that matches the specified locator. If no object matches within an timeout an ObjectNotFoundException is thrown. The default timeout is 5 seconds and you can change the timeout by setting the value of the option OPT_WAIT_RESOLVE_OBJDEF. Use WaitForObject if the AUT takes a long time to display a specific object, for example when a transaction is processed before showing any results. By default, an action in the UI does not require a WaitForObject, because of the built-in synchronization. If you receive random timeout errors during normal script execution, consider increasing the default timeout instead of adding WaitForObject statements to your scripts. (Inherited from TestObject) |
| WaitForProperty | Waits until the specified property has the specified value or until the timeout is reached.If you don't explicitly pass a timeout using the optional timeout parameter, the timeout specified by the option OPT_WAIT_RESOLVE_OBJDEF will be used. An exception is thrown if the timeout is reached. (Inherited from TestObject) |
| WaitForPropertyNotEquals | Waits until the specified property has a value that is different to the specified value or until the timeout is reached.If you don't explicitly pass a timeout using the optional timeout parameter, the timeout specified by the option OPT_WAIT_RESOLVE_OBJDEF will be used. An exception is thrown if the timeout is reached. (Inherited from TestObject) |
| WaitForScreenshotStable | Waits until the control is visually stable and does not change its position, by comparing screenshots taken with the specified interval. If you don't explicitly pass a timeout using the optional timeout parameter, the timeout specified by the option OPT_WAIT_SCREENSHOT_STABLE will be used. The default interval is 200 milliseconds. An exception is thrown if the timeout is reached. (Inherited from TestObject) |