Share via


Implementing the UI Automation GridItem Control Pattern

This topic introduces guidelines and conventions for implementing IGridItemProvider, including information about properties. Links to additional references are listed at the end of the overview.

The GridItemPattern control pattern is used to support individual child controls of containers that implement IGridProvider. For examples of controls that implement this control pattern, see Control Pattern Mapping for UI Automation Clients.

This topic contains the following sections.

  • Implementation Guidelines and Conventions
  • Required Members for IGridItemProvider
  • Exceptions
  • Related Topics

Implementation Guidelines and Conventions

When implementing IGridProvider, note the following guidelines and conventions:

  • Grid coordinates are zero-based with the upper left cell having coordinates (0, 0).

  • Merged cells will report their Row and Column properties based on their underlying anchor cell as defined by the UI Automation provider. Typically, it will be the topmost and leftmost row or column.

  • IGridItemProvider does not provide for active manipulation of the grid such as merging or splitting cells.

  • Controls that implement IGridItemProvider can typically be traversed (that is, a UI Automation client can move to adjacent controls) by using the keyboard.

Required Members for IGridItemProvider

The following properties and methods are required for implementing IGridItemProvider.

Required members Member type Notes

Row

Property

None

Column

Property

None

RowSpan

Property

None

ColumnSpan

Property

None

ContainingGrid

Property

None

This control pattern has no associated methods or events.

Exceptions

This control pattern has no associated exceptions.

See Also

Tasks

Support Control Patterns in a UI Automation Provider
Use Caching in UI Automation

Concepts

UI Automation Control Patterns Overview
UI Automation Control Patterns for Clients
Implementing the UI Automation Grid Control Pattern
UI Automation Tree Overview