Compartilhar via


TableItemPattern.ColumnHeaderItemsProperty Campo

Definição

Identifica a propriedade que recupera todos os cabeçalhos de coluna associados a um item ou uma célula da tabela.

public: static initonly System::Windows::Automation::AutomationProperty ^ ColumnHeaderItemsProperty;
public static readonly System.Windows.Automation.AutomationProperty ColumnHeaderItemsProperty;
 staticval mutable ColumnHeaderItemsProperty : System.Windows.Automation.AutomationProperty
Public Shared ReadOnly ColumnHeaderItemsProperty As AutomationProperty 

Valor do campo

AutomationProperty

Exemplos

No exemplo a seguir, uma matriz de objetos de elemento de automação que representam os itens de cabeçalho de linha ou coluna primária de uma tabela é recuperada.

Para os fins deste exemplo, uma relação entre a RowOrColumnMajor propriedade e os itens de cabeçalho de linha e coluna é demonstrada. No entanto, uma tabela pode ter cabeçalhos de linha e coluna, independentemente da RowOrColumnMajor propriedade da tabela.

///--------------------------------------------------------------------
/// <summary>
/// Obtains an array of primary table headers.
/// </summary>
/// <param name="targetControl">
/// The target control of interest.
/// </param>
/// <param name="roworcolumnMajor">
/// The RowOrColumnMajor specifier.
/// </param>
/// <returns>
/// An AutomationElement array object.
/// </returns>
///--------------------------------------------------------------------
private Object GetPrimaryHeaders(
    AutomationElement targetControl, RowOrColumnMajor roworcolumnMajor)
{
    if (targetControl == null)
    {
        throw new ArgumentException("Target element cannot be null.");
    }

    try
    {
        if (roworcolumnMajor ==
            RowOrColumnMajor.RowMajor)
        {
            return targetControl.GetCurrentPropertyValue(
                TableItemPattern.RowHeaderItemsProperty);
        }

        if (roworcolumnMajor ==
            RowOrColumnMajor.ColumnMajor)
        {
            return targetControl.GetCurrentPropertyValue(
                TableItemPattern.ColumnHeaderItemsProperty);
        }
    }
    catch (InvalidOperationException)
    {
        // TableItemPattern not supported.
        // TO DO: error processing.
    }

    return null;
}
    '''--------------------------------------------------------------------
    ''' <summary>
    ''' Obtains an array of primary table headers.
    ''' </summary>
    ''' <param name="targetControl">
    ''' The target control of interest.
    ''' </param>
    ''' <param name="roworcolumnMajor">
    ''' The RowOrColumnMajor specifier.
    ''' </param>
    ''' <returns>
    ''' An AutomationElement array object.
    ''' </returns>
    '''--------------------------------------------------------------------
    Private Function GetPrimaryHeaders( _
    ByVal targetControl As AutomationElement, _
    ByVal roworcolumnMajor As RowOrColumnMajor) As [Object]
        If targetControl Is Nothing Then
            Throw New ArgumentException("Target element cannot be null.")
        End If

        Try
            If roworcolumnMajor = roworcolumnMajor.RowMajor Then
                Return targetControl.GetCurrentPropertyValue( _
                TableItemPattern.RowHeaderItemsProperty)
            End If

            If roworcolumnMajor = roworcolumnMajor.ColumnMajor Then
                Return targetControl.GetCurrentPropertyValue( _
                TableItemPattern.ColumnHeaderItemsProperty)
            End If
        Catch
        End Try
        ' TableItemPattern not supported.
        ' TO DO: error processing.

        Return Nothing

    End Function 'GetPrimaryHeaders
End Class

Comentários

Esse identificador é usado por aplicativos cliente Automação da Interface do Usuário. Automação da Interface do Usuário provedores devem usar o campo equivalente em TableItemPatternIdentifiers.

Essa propriedade não está presente TableItemPattern.TableItemPatternInformation e deve ser recuperada usando GetCurrentPropertyValue ou GetCachedPropertyValue.

Aplica-se a

Confira também