ValuePattern.ValuePatternInformation.Value Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de waarde van het UI Automation-element op.
public:
property System::String ^ Value { System::String ^ get(); };
public string Value { get; }
member this.Value : string
Public ReadOnly Property Value As String
Waarde van eigenschap
De waarde van het UI Automation-element als een tekenreeks. De standaardwaarde is een lege tekenreeks.
Voorbeelden
In het volgende voorbeeld wordt een ValuePattern object dat is verkregen uit een doelbesturingselement doorgegeven aan een functie waarmee de huidige ValuePattern eigenschapswaarden worden opgehaald.
///--------------------------------------------------------------------
/// <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
Opmerkingen
Besturingselementen voor bewerkingen met één regel bieden ondersteuning voor programmatische toegang tot hun inhoud via ValuePattern. Besturingselementen voor bewerken met meerdere regels bieden echter geen ondersteuning voor het ValuePattern besturingspatroon.
Als u de tekstuele inhoud van besturingselementen voor bewerken met meerdere regels wilt ophalen, moeten de besturingselementen het TextPattern besturingspatroon ondersteunen. TextPattern ondersteunt echter niet het instellen van de waarde van een bedieningselement.
ValuePattern biedt geen ondersteuning voor het ophalen van opmaakgegevens of subtekenreekswaarden. Het TextPattern besturingspatroon moet in deze scenario's worden gebruikt.