変換コントロール パターン

  • [アーティクル]

プロパティとメソッドに関する情報など、 ITransformProvider と ITransformProvider2 を実装するためのガイドラインと規則について説明します。 Transform コントロール パターンは、2 次元空間内で移動、サイズ変更、または回転できるコントロールをサポートするために使用されます。

このコントロール パターンを実装するコントロールの例については、「コントロールの 種類とサポートされているコントロール パターン」を参照してください。

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

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

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

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

ITransformProvider の必須メンバー

ITransformProvider インターフェイスを実装するために、次のプロパティとメソッドが必要です。

必須メンバー メンバーの型 メモ
CanMove プロパティ なし
CanResize プロパティ なし
CanRotate プロパティ なし
[詳細ビュー] 方法 なし
サイズ変更 方法 なし
回転 方法 なし

 

ITransformProvider2 インターフェイスを実装するために、次の追加のプロパティとメソッドが必要です。

必須メンバー メンバーの型 メモ
CanZoom プロパティ なし
Zoom 方法 なし
ZoomByUnit 方法 なし
ZoomLevel プロパティ なし
ZoomMaximum プロパティ なし
ZoomMinimum プロパティ なし

 

このコントロール パターンには、関連するイベントがありません。

コントロール型とそのサポートされているコントロール パターン

UI オートメーション コントロール パターンの概要

UI オートメーション ツリーの概要