Excel 拡張子のサンプル: TechnologyManager クラス

2011-08-09

このクラスは UITechnologyManager クラスを拡張し、Microsoft Excel 拡張機能のコアサービスを提供します。基本クラスには多くのメソッドがありますが、このサンプルではその一部のみを使用します。

一部のメソッドは、単にプロパティの値を返します。多くのメソッドは、コード化された UI テストエンジンに組み込まれている既定のアルゴリズムを開発者がオーバーライドできるようにするために用意されています。これらのメソッドは、NotSupportedException をスローするか、null を返して、フレームワークに既定のアルゴリズムを使用するように指示します。

基になるテクノロジの複雑さに応じて、テクノロジマネージャーのコードの開発には数週間から数か月かかる場合があります。 Excel を使用すると、非常に広範なテクノロジマネージャーを作成できる可能性があります。この例では、意図的に Excel のワークシートとセルだけに限定し、使用する形式も制限しています。

可能であれば、テクノロジマネージャーコードは Communicator クラスによって開かれた .NET リモート処理チャネルを使用し、Excel プロセスで実行されているアドインから情報を抽出します。

COM の参照範囲

このクラスと、UITechnologyElement クラスを拡張した各要素クラスのすべてに ComVisibleAttribute があり、COM からそのクラスを参照できるように、値が true になっています。

TechnologyName プロパティ

UITechnologyManager.TechnologyName プロパティのこのオーバーライドは、拡張の他のすべてのコンポーネントの基になるテクノロジを識別する、一意で意味のある名前を提供する必要があります。この拡張では、値は "Excel" です。

GetControlSupportLevel メソッド

UITechnologyManager.GetControlSupportLevel メソッドのこのオーバーライドは、指定されたハンドルによって表されるコントロールに対してテクノロジマネージャーが提供できるサポートレベルを示す数値を返します。数値が大きくなるほど、コントロールに対するテクノロジマネージャーのサポートレベルは高くなります。この場合、メソッドはコントロールが含まれているウィンドウを確認し、それが Excel ワークシートであれば、最も高い値を返します。それ以外の場合は 0 が返され、コントロールはサポートされません。

要素を取得するメソッド

テクノロジに固有の要素を取得するために、コード化された UI テストフレームワークによって使用される、いくつかの重要なメソッドがあります。要素を取得するには、ハンドル、画面上の点、または別のテクノロジの要素を指定します。これらのメソッドのコードは、自己記述的です。基本メソッドは、次のとおりです。

ParseQueryId メソッド

コード化された UI テストの作成時に、ユーザーはテストの一部またはすべてのコントロールのプロパティ値を指定できます。これらのプロパティ値は、テストフレームワークによって、検索プロパティ (テスト中に特定の UI コントロールを見つけるために使用される、名前と値のペア) を作成するために使用されます。すべての検索プロパティが全体で、テクノロジの各要素の UITechnologyElement.QueryId プロパティの値を表しており、これにすべてのコントロールが含まれます。コントロールはテストの実行中に数回検索しなければならない場合があるので、このメソッドはテクノロジマネージャーによる特定のコントロールの検索プロパティの解析を最適化できるようにします。このメソッドは、フレームワークがそのコントロールを後で検索するときに使用できる Cookie も返します。メソッドのこの実装は、AndCondition.Match メソッドを使用して、検索プロパティを解析します。

MatchElement メソッド

テクノロジマネージャーでコントロールの検索を行う場合、UITechnologyManager.Search メソッドは、可能な一致の配列を返すように実装するか、NotSupportedException をスローしてフレームワークが独自の検索アルゴリズムを使用するように実装することができます。どちらの場合も、MatchElement メソッドを実装する必要があり、その実装でも AndCondition.Match メソッドが使用されます。