ValuePattern.ValuePatternInformation.Value Eigenschaft

public:
 property System::String ^ Value { System::String ^ get(); };

public string Value { get; }

member this.Value : string

Public ReadOnly Property Value As String

Eigenschaftswert

Der Wert des Benutzeroberflächenautomatisierung-Elements als Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.

Beispiele

Im folgenden Beispiel wird ein ValuePattern objekt, das aus einem Zielsteuerelement abgerufen wird, an eine Funktion übergeben, die die aktuellen ValuePattern Eigenschaftswerte abruft.

///--------------------------------------------------------------------
/// <summary>
/// Gets the current property values from target.
/// </summary>
/// <param name="valuePattern">
/// A ValuePattern control pattern obtained from 
/// an automation element representing a target control.
/// </param>
/// <param name="automationProperty">
/// The automation property of interest.
/// </param>
///--------------------------------------------------------------------
private object GetValueProperty(
    ValuePattern valuePattern,
    AutomationProperty automationProperty)
{
    if (valuePattern == null || automationProperty == null)
    {
        throw new ArgumentNullException("Argument cannot be null.");
    }

    if (automationProperty.Id ==
        ValuePattern.ValueProperty.Id)
    {
        return valuePattern.Current.Value;
    }
    return null;
}

'''--------------------------------------------------------------------
''' <summary>
''' Gets the current property values from target.
''' </summary>
''' <param name="valuePattern">
''' A ValuePattern control pattern obtained from 
''' an automation element representing a target control.
''' </param>
''' <param name="automationProperty">
''' The automation property of interest.
''' </param>
'''--------------------------------------------------------------------
Private Function GetValueProperty( _
ByVal valuePattern As ValuePattern, _
ByVal automationProperty As AutomationProperty) As Object
    If (valuePattern Is Nothing Or automationProperty Is Nothing) Then
        Throw New ArgumentNullException("Argument cannot be null.")
    End If

    If automationProperty.Id = valuePattern.ValueProperty.Id Then
        Return valuePattern.Current.Value
    End If
    Return Nothing

End Function 'GetValueProperty

Hinweise

Einzeilige Bearbeitungssteuerelemente unterstützen programmgesteuerten Zugriff auf ihre Inhalte über ValuePattern. Mehrzeilige Bearbeitungssteuerelemente unterstützen jedoch nicht das ValuePattern Steuerelementmuster.

Zum Abrufen des Textinhalts von mehrzeiligen Bearbeitungssteuerelementen müssen die Steuerelemente das TextPattern Steuerelementmuster unterstützen. TextPattern Das Festlegen des Werts eines Steuerelements wird jedoch nicht unterstützt.

ValuePattern unterstützt nicht das Abrufen von Formatierungsinformationen oder Teilzeichenfolgenwerten. Das TextPattern Steuerelementmuster muss in diesen Szenarien verwendet werden.