UI オートメーション Transform コントロールパターンの実装

更新 : 2007 年 11 月

ここでは、プロパティ、メソッド、イベントに関する情報など、ITransformProvider を実装するガイドラインと規則について説明します。追加参照へのリンクはトピックの最後に示します。

TransformPattern コントロールパターンは、2 次元空間内での移動、サイズ変更、または回転が可能なコントロールをサポートするために使用します。このコントロールパターンを実装するコントロールの例については、「UI オートメーションクライアントのコントロールパターンマッピング」を参照してください。

このトピックには次のセクションが含まれています。

実装のガイドラインと規則

Transform コントロールパターンを実装する場合は、次のガイドラインと規則に注意してください。

このコントロールパターンのサポートは、デスクトップ上のオブジェクトに限定されません。コンテナの境界内でコンテナオブジェクトの子を自由に移動、サイズ変更、または回転できるようにするには、このコントロールパターンが子でもサポートされている必要があります。
操作後の画面位置が完全にそのコンテナの座標外となり、そのためにキーボードやマウスからアクセスできなくなる場合 (たとえば、トップレベルウィンドウが画面外に移動したり、子オブジェクトがコンテナのビューポートの境界外に移動したりした場合) は、オブジェクトの移動、サイズ変更、および回転はできません。このような場合、上辺または左辺の座標をコンテナ境界内にオーバーライドして、要求された画面座標のできるだけ近くにオブジェクトを配置します。
マルチモニタシステムでは、結合したデスクトップ画面座標の完全に外へオブジェクトを移動、サイズ変更、または回転した場合、プライマリモニタ上の、要求された画面座標のできるだけ近くにオブジェクトを配置します。
すべてのパラメータとプロパティ値は絶対値で、ロケールには依存しません。

次のプロパティとメソッドは、ITransformProvider の実装時に必要です。

このコントロールパターンに関連付けられたイベントはありません。

プロバイダは次の例外をスローする必要があります。

例外の種類	条件
InvalidOperationException	Move CanMoveProperty が false の場合。
InvalidOperationException	Resize CanResizeProperty が false の場合。
InvalidOperationException	Rotate CanRotateProperty が false の場合。