ValuePattern.ValuePatternInformation.Value Propriedade

Definição

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Obtém o valor do elemento Automação da Interface do Usuário.

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

public string Value { get; }

member this.Value : string

Public ReadOnly Property Value As String

Valor da propriedade

String

O valor do elemento Automação da Interface do Usuário como uma cadeia de caracteres. O padrão é uma cadeia de caracteres vazia.

Exemplos

No exemplo a seguir, um ValuePattern objeto obtido de um controle de destino é passado para uma função que recupera os valores de propriedade atuais 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

Comentários

Os controles de edição de linha única dão suporte ao acesso programático ao seu conteúdo por meio de ValuePattern. No entanto, os controles de edição de várias linhas não dão suporte ao ValuePattern padrão de controle.

Para recuperar o conteúdo textual dos controles de edição de várias linhas, os controles devem dar suporte ao TextPattern padrão de controle. No entanto, TextPattern não dá suporte à configuração do valor de um controle.

ValuePattern não dá suporte à recuperação de informações de formatação ou valores de subcadeia de caracteres. O TextPattern padrão de controle deve ser usado nesses cenários.

Confira também

• Exemplo de Texto de Inserção de Texto do TextPattern