TablePattern.ColumnHeadersProperty Feld

Definition

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

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

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 

Feldwert

AutomationProperty

Beispiele

Im folgenden Beispiel wird ein Array von AutomationElement Objekten abgerufen, das die primären Zeilen- oder Spaltenüberschriften einer Tabelle darstellt.

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

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

Die Reihenfolge der zurückgegebenen Kopfzeilen ist innerhalb eines Anbieters konsistent, aber nicht unbedingt für alle Anbieter.

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

Siehe auch

• Verfügbarmachen eines Tabelleninhalts durch Benutzeroberflächenautomatisierung