クライアントの UI オートメーションコントロールパターン

[アーティクル]
08/09/2011

メモ
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

ここでは、UI オートメーションクライアントのコントロールパターンについて説明します。 UI オートメーションクライアントがコントロールパターンを使用して、user interface (UI) の情報にアクセスするしくみについても説明します。

コントロールパターンは、コントロールの型や外観に関係なく、コントロールの機能を分類したり公開したりするための手段です。 UI オートメーションクライアントは、AutomationElement を調べてどのコントロールパターンがサポートされているか特定し、そのコントロールの動作を確実に実行することができます。

すべてのコントロールパターンの一覧については、「UI オートメーションコントロールパターンの概要」を参照してください。

このトピックは、次のセクションで構成されています。

コントロールパターンの取得
コントロールパターンのプロパティの取得
可変パターンを持つコントロール
関連トピック

コントロールパターンの取得

クライアントは、AutomationElement.GetCachedPattern または AutomationElement.GetCurrentPattern を呼び出して、AutomationElement からコントロールパターンを取得します。

クライアントは、GetSupportedPatterns メソッドまたは個別の IsPatternAvailable プロパティ (IsTextPatternAvailableProperty など) を使用して、パターンまたはパターンのグループが AutomationElement でサポートされているかどうかを判断できます。ただし、サポートされているプロパティを確認してコントロールパターンを取得するよりも、コントロールパターンを取得して null 参照に対するテストを試行する方が、プロセス間呼び出しが少なくなるため効率的です。

AutomationElement から TextPattern コントロールパターンを取得する方法を次の例に示します。

// Specify the control type we're looking for, in this case 'Document'
PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

// target --> The root AutomationElement.
AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

targetTextPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

if (targetTextPattern == null)
{
    Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
    return;
}

コントロールパターンのプロパティの取得

クライアントは、AutomationElement.GetCachedPropertyValue または AutomationElement.GetCurrentPropertyValue を呼び出し、返されたオブジェクトを適切な型にキャストすることで、コントロールパターンのプロパティ値を取得することができます。 UI Automation プロパティの詳細については、「クライアントの UI オートメーションプロパティ」を参照してください。

GetPropertyValue メソッドに加え、common language runtime (CLR) アクセサーを介してパターンの UI Automation プロパティにアクセスすることでプロパティ値を取得することもできます。

可変パターンを持つコントロール

一部のコントロール型は、状態やコントロールの使用方法に応じた複数のパターンをサポートしています。可変パターンを持つコントロールの例としては、リストビュー (サムネイル、タイル、アイコン、リスト、詳細)、Microsoft Excel グラフ (円、線、横棒、式を使用するセル値)、Microsoft Word のドキュメント領域 (標準、Web レイアウト、アウトライン、印刷レイアウト、印刷プレビュー)、Microsoft Windows Media Player スキンなどがあります。

カスタムコントロール型を実装するコントロールは、機能を表すために必要なコントロールパターンの任意のセットを持つことができます。

参照

クライアントの UI オートメーション コントロール パターン

コントロール パターンの取得

コントロール パターンのプロパティの取得

可変パターンを持つコントロール

参照

処理手順

概念

その他の技術情報

その他のリソース

クライアントの UI オートメーションコントロールパターン

コントロールパターンの取得

コントロールパターンのプロパティの取得