ValuePattern.ValuePatternInformation.Value Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém o valor do elemento Automatização da Interface de Utilizador.
public:
property System::String ^ Value { System::String ^ get(); };
public string Value { get; }
member this.Value : string
Public ReadOnly Property Value As String
Valor de Propriedade
O valor do elemento Automatização da Interface de Utilizador como cadeia. O padrão é uma cadeia de caracteres vazia.
Exemplos
No exemplo seguinte, um ValuePattern objeto obtido a partir de um controlo alvo é passado para uma função que recupera os valores atuais ValuePattern das propriedades.
///--------------------------------------------------------------------
/// <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
Observações
Os controlos de edição de linha única suportam acesso programático ao seu conteúdo através ValuePatternde . No entanto, os controlos de edição multi-linha não suportam o ValuePattern padrão de controlo.
Para recuperar o conteúdo textual dos controlos de edição multi-linha, os controlos devem suportar o TextPattern padrão de controlo. No entanto, TextPattern não suporta a definição do valor de um controle.
ValuePattern não suporta a recuperação de informações de formatação ou valores de substring. O TextPattern padrão de controlo deve ser utilizado nestes cenários.