ValuePattern.ValuePatternInformation.Value Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Wert des UI Automation-Elements ab.
public:
property System::String ^ Value { System::String ^ get(); };public string Value { get; }member this.Value : stringPublic ReadOnly Property Value As StringEigenschaftswert
Der Wert des UI Automation-Elements als Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.
Beispiele
Im folgenden Beispiel wird ein ValuePattern aus einem Zielsteuerelement abgerufenes Objekt 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 den programmgesteuerten Zugriff auf ihre Inhalte über ValuePattern. Mehrzeilige Bearbeitungssteuerelemente unterstützen das ValuePattern Steuerelementmuster jedoch nicht.
Zum Abrufen des Textinhalts von mehrzeiligen Bearbeitungssteuerelementen müssen die Steuerelemente das TextPattern Steuerelementmuster unterstützen. TextPattern bietet aber nicht die Möglichkeit, den Wert eines Steuerelements festzulegen.
MitValuePattern ist es nicht möglich, Formatierungsinformationen oder Teilzeichenfolgen abzurufen. Das TextPattern Steuerelementmuster muss in diesen Szenarien verwendet werden.
