ValuePattern.ValuePatternInformation.Value Vlastnost

Definice

Obor názvů:

System.Windows.Automation

Sestavení:

UIAutomationClient.dll

Získá hodnotu prvku automatizace uživatelského rozhraní.

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

public string Value { get; }

member this.Value : string

Public ReadOnly Property Value As String

Hodnota vlastnosti

String

Hodnota elementu automatizace uživatelského rozhraní jako řetězec. Výchozí hodnota je prázdný řetězec.

Příklady

V následujícím příkladu ValuePattern je objekt získaný z cílového ovládacího prvku předán funkci, která načte aktuální ValuePattern hodnoty vlastností.

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

Poznámky

Jednořádkové ovládací prvky pro úpravy podporují programový přístup k jejich obsahu prostřednictvím ValuePattern. Ovládací prvky pro víceřádkové úpravy ale model ovládacích ValuePattern prvků nepodporují.

Pokud chcete načíst textový obsah ovládacích prvků pro úpravy více řádků, musí ovládací prvky podporovat TextPattern vzor ovládacího prvku. TextPattern Nepodporuje však nastavení hodnoty ovládacího prvku.

ValuePattern nepodporuje načítání informací o formátování nebo hodnot podřetěžce. V TextPattern těchto scénářích se musí použít vzor řízení.

Viz také

• TextPattern – ukázka vložení textu