TablePattern.RowHeadersProperty Feld

Definition

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Bezeichnet die Eigenschaft, die die Auflistung der Zeilenheader für eine Tabelle abruft.

public: static initonly System::Windows::Automation::AutomationProperty ^ RowHeadersProperty;

public static readonly System.Windows.Automation.AutomationProperty RowHeadersProperty;

 staticval mutable RowHeadersProperty : System.Windows.Automation.AutomationProperty

Public Shared ReadOnly RowHeadersProperty As AutomationProperty 

Feldwert

AutomationProperty

Beispiele

Im folgenden Beispiel wird ein Array von AutomationElement Objekten abgerufen, die die primäre Zeilen- oder Spaltenheader einer Tabelle darstellen.

Für die Zwecke dieses Beispiels wird eine Beziehung zwischen der RowOrColumnMajor -Eigenschaft und den Zeilen- und Spaltenheaderelementen veranschaulicht. Eine Tabelle kann jedoch unabhängig von der Eigenschaft der RowOrColumnMajor Tabelle Zeilen- und Spaltenüberschriften aufweisen.

///--------------------------------------------------------------------
/// <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

Hinweise

Dieser Bezeichner wird von Benutzeroberflächenautomatisierung Clientanwendungen verwendet. Benutzeroberflächenautomatisierung Anbieter sollten das entsprechende Feld in TablePatternIdentifiersverwenden.

Die Reihenfolge der zurückgegebenen Header ist innerhalb eines Anbieters konsistent, aber nicht unbedingt anbieterübergreifend.

Diese Eigenschaft ist in nicht vorhanden TablePattern.TablePatternInformation und muss mithilfe GetCurrentPropertyValue von oder GetCachedPropertyValueabgerufen werden.

Weitere Informationen

• Verfügbarmachen eines Tabelleninhalts durch Benutzeroberflächenautomatisierung