ValuePattern.ValuePatternInformation.Value Propriété

Définition

Espace de noms:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Obtient la valeur de l’élément UI Automation.

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

public string Value { get; }

member this.Value : string

Public ReadOnly Property Value As String

Valeur de propriété

String

Valeur de l’élément UI Automation sous forme de chaîne. La valeur par défaut est une chaîne vide.

Exemples

Dans l’exemple suivant, un ValuePattern objet obtenu à partir d’un contrôle cible est passé dans une fonction qui récupère les valeurs de propriété actuelles ValuePattern .

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

Remarques

Les contrôles d’édition à ligne unique prennent en charge l’accès par programmation à leur contenu via ValuePattern. Toutefois, les contrôles de modification multiligne ne prennent pas en charge le modèle de ValuePattern contrôle.

Pour récupérer le contenu textuel des contrôles d’édition multilignes, les contrôles doivent prendre en charge le modèle de TextPattern contrôle. Toutefois, TextPattern ne prend pas en charge la définition de la valeur d’un contrôle.

ValuePattern ne prend pas en charge la récupération des informations de mise en forme ou des valeurs d’une sous-chaîne. Le TextPattern modèle de contrôle doit être utilisé dans ces scénarios.

Voir aussi

• TextPattern Insert Text Sample