ValuePattern.ValuePatternInformation.Value 屬性

定義

命名空間:

System.Windows.Automation

組件:

UIAutomationClient.dll

取得使用者介面自動化專案的值。

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

public string Value { get; }

member this.Value : string

Public ReadOnly Property Value As String

屬性值

String

UI Automation 元素的值做為字串。 預設為空字串。

範例

在下列範例中， ValuePattern 從目標控件取得的物件會傳遞至擷取目前 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

備註

單行編輯控制項支援透過 ValuePattern以程式設計方式存取其內容。 不過，多行編輯控件不支援 ValuePattern 控件模式。

若要擷取多行編輯控件的文字內容，控件必須支援 TextPattern 控件模式。 不過， TextPattern 不支援設定控制項的值。

ValuePattern 不支援擷取格式設定資訊或子字串值。 這些 TextPattern 案例中必須使用控制項模式。

另請參閱

• TextPattern 插入文字樣本