ValuePattern.ValuePatternInformation.Value プロパティ

定義

名前空間:

System.Windows.Automation

アセンブリ:

UIAutomationClient.dll

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

C#

public string Value { get; }

プロパティ値

String

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

例

次の例では、 ValuePattern ターゲット コントロールから取得したオブジェクトが、現在 ValuePattern のプロパティ値を取得する関数に渡されます。

C#

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

注釈

単一行の編集コントロールでは、 を介してコンテンツへのプログラムによるアクセスが ValuePatternサポートされます。 ただし、複数行の編集コントロールでは、コントロール パターンは ValuePattern サポートされていません。

複数行編集コントロールのテキスト コンテンツを取得するには、コントロールがコントロール パターンをサポートしている TextPattern 必要があります。 ただし、 TextPattern はコントロールの値の設定はサポートしていません。

ValuePattern は、書式設定情報や部分文字列の値の取得をサポートしていません。 TextPatternこれらのシナリオでは、コントロール パターンを使用する必要があります。

適用対象

こちらもご覧ください

• TextPattern 挿入テキストのサンプル