Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

GridItem Control Pattern

Describes guidelines and conventions for implementing IGridItemProvider, including information about properties. The GridItem 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 Types and Their Supported Control Patterns.

This topic contains the following sections.

Implementation Guidelines and Conventions

When implementing the GridItem control pattern, 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 Microsoft UI Automation provider. Typically, it will be the topmost and leftmost row or column.
  • IGridProvider does not provide for active manipulation of the grid such as merging or splitting cells.
  • Controls that implement IGridProvider 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 are required for implementing the IGridItemProvider interface.

Required membersMember typeNotes
Row PropertyNone
Column PropertyNone
RowSpan PropertyNone
ColumnSpan PropertyNone
ContainingGrid PropertyNone


This control pattern has no associated methods or events.

Related topics

Control Types and Their Supported Control Patterns
Grid Control Pattern
UI Automation Control Patterns Overview
UI Automation Tree Overview



© 2017 Microsoft