Partilhar via


TablePattern.ColumnHeadersProperty Campo

Definição

Identifica a propriedade que obtém a coleção de cabeçalhos de coluna de uma tabela.

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

Valor do campo

AutomationProperty

Exemplos

No exemplo a seguir, uma matriz de AutomationElement objetos que representa os cabeçalhos de linha ou coluna primária de uma tabela é recuperada.

Para fins deste exemplo, uma relação entre a propriedade e os RowOrColumnMajor 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 array of automation elements.
/// </returns>
///--------------------------------------------------------------------
private AutomationElement[] GetPrimaryHeaders(
    AutomationElement targetControl, RowOrColumnMajor roworcolumnMajor)
{
    if (targetControl == null)
    {
        throw new ArgumentException("Target element cannot be null.");
    }

    try
    {
        if (roworcolumnMajor ==
            RowOrColumnMajor.RowMajor)
        {
            return targetControl.GetCurrentPropertyValue(
                TablePattern.RowHeadersProperty) as AutomationElement[];
        }

        if (roworcolumnMajor ==
            RowOrColumnMajor.ColumnMajor)
        {
            return targetControl.GetCurrentPropertyValue(
                TablePattern.ColumnHeadersProperty) as AutomationElement[];
        }
    }
    catch (InvalidOperationException)
    {
        // TablePattern 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>
''' Automation element array objects.
''' </returns>
'''--------------------------------------------------------------------
Private Overloads Function GetPrimaryHeaders( _
ByVal targetControl As AutomationElement, _
ByVal roworcolumnMajor As RowOrColumnMajor) As AutomationElement()
    If targetControl Is Nothing Then
        Throw New ArgumentException("Target element cannot be null.")
    End If

    Try
        If roworcolumnMajor = roworcolumnMajor.RowMajor Then
            Return DirectCast(targetControl.GetCurrentPropertyValue( _
            TablePattern.RowHeadersProperty), AutomationElement())
        End If

        If roworcolumnMajor = roworcolumnMajor.ColumnMajor Then
            Return DirectCast(targetControl.GetCurrentPropertyValue( _
            TablePattern.ColumnHeadersProperty), AutomationElement())
        End If
    Catch exc As InvalidOperationException
        ' TablePattern not supported.
        ' TO DO: error processing.
    End Try

    Return Nothing

End Function 'GetPrimaryHeaders

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 TablePatternIdentifiers.

A ordem dos cabeçalhos retornados será consistente dentro de um provedor, mas não necessariamente entre provedores.

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

Aplica-se a

Confira também