ValuePattern.ValuePatternInformation.Value プロパティ

定義

UI オートメーション要素の値を取得します。

public:
 property System::String ^ Value { System::String ^ get(); };
public string Value { get; }
member this.Value : string
Public ReadOnly Property Value As String

プロパティ値

文字列としての UI オートメーション要素の値。 既定値は空の文字列です。

次の例では、 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これらのシナリオでは、コントロール パターンを使用する必要があります。

適用対象

こちらもご覧ください