UI オートメーション Transform コントロール パターンの実装
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、プロパティ、メソッド、イベントに関する情報など、 ITransformProviderの実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。
TransformPattern コントロール パターンは、2 次元空間で移動、サイズ変更、または回転できるコントロールをサポートするために使用されます。 このコントロール パターンを実装するコントロールの例については、「 Control Pattern Mapping for UI Automation Clients」をご覧ください。
実装のガイドラインと規則
Transform コントロール パターンを実装する場合は、次のガイドラインと規則にご留意ください。
このコントロール パターンのサポートは、デスクトップ上のオブジェクトに制限されません。 コンテナーの境界内で子が自由に移動、サイズ変更、または回転できるようにする場合は、そのコンテナー オブジェクトの子もこのコントロール パターンをサポートしている必要があります。
操作後の画面位置が完全にそのコンテナーの座標外となり、キーボードやマウスからアクセスできなくなる場合 (たとえば、トップレベルのウィンドウが画面外に移動したり、子オブジェクトがコンテナーのビューポートの境界外へ移動したりする場合) は、オブジェクトの移動、サイズ変更、および回転はできません。 このような場合、上辺または左辺の座標をコンテナーの境界内にオーバーライドして、要求された画面座標のできるだけ近くにオブジェクトが配置されます。
マルチモニター システムでは、結合したデスクトップ画面座標の完全に外へオブジェクトを移動、サイズ変更、または回転した場合、プライマリ モニター上の、要求された画面座標のできるだけ近くにオブジェクトが配置されます。
すべてのパラメーターとプロパティの値は絶対値で、ロケールには依存しません。
ITransformProvider の必須メンバー
ITransformProviderの実装には、次のプロパティとメソッドが必要です。
| 必須メンバー | メンバーの型 | メモ |
|---|---|---|
| CanMove | プロパティ | なし |
| CanResize | プロパティ | なし |
| CanRotate | プロパティ | なし |
| Move | 方法 | なし |
| Resize | 方法 | なし |
| Rotate | 方法 | なし |
このコントロール パターンには、関連するイベントがありません。
例外
プロバイダーは、次の例外をスローする必要があります。
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | Move - CanMoveProperty が false の場合。 |
| InvalidOperationException | Resize - CanResizeProperty が false の場合。 |
| InvalidOperationException | Rotate - CanRotateProperty が false の場合。 |