UI オートメーション Transform コントロール パターンの実装
メモ |
---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、プロパティ、メソッド、イベントに関する情報など、ITransformProvider を実装するガイドラインと規則について説明します。 追加参照へのリンクはトピックの最後に示します。
TransformPattern コントロール パターンは、2 次元空間内での移動、サイズ変更、または回転が可能なコントロールをサポートするために使用します。 このコントロール パターンを実装するコントロールの例については、「UI オートメーション クライアントのコントロール パターン マッピング」を参照してください。
このトピックは、次のセクションで構成されています。
- 実装のガイドラインと規則
- ITransformProvider の必須メンバー
- 例外
- 関連トピック
実装のガイドラインと規則
Transform コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。
このコントロール パターンのサポートは、デスクトップ上のオブジェクトに限定されません。 コンテナーの境界内でコンテナー オブジェクトの子を自由に移動、サイズ変更、または回転できるようにするには、このコントロール パターンが子でもサポートされている必要があります。
操作後の画面位置が完全にそのコンテナーの座標外となり、そのためにキーボードやマウスからアクセスできなくなる場合 (たとえば、トップレベル ウィンドウが画面外に移動したり、子オブジェクトがコンテナーのビューポートの境界外に移動したりした場合) は、オブジェクトの移動、サイズ変更、および回転はできません 。 このような場合、上辺または左辺の座標をコンテナー境界内にオーバーライドして、要求された画面座標のできるだけ近くにオブジェクトを配置します。
マルチモニター システムでは、結合したデスクトップ画面座標の完全に外へオブジェクトを移動、サイズ変更、または回転した場合、プライマリ モニター上の、要求された画面座標のできるだけ近くにオブジェクトを配置します。
すべてのパラメーターとプロパティ値は絶対値で、ロケールには依存しません。
ITransformProvider の必須メンバー
次のプロパティとメソッドは、ITransformProvider の実装時に必要です。
必須メンバー |
メンバー型 |
説明 |
---|---|---|
プロパティ |
なし |
|
プロパティ |
なし |
|
プロパティ |
なし |
|
メソッド |
なし |
|
メソッド |
なし |
|
メソッド |
なし |
このコントロール パターンに関連付けられたイベントはありません。
例外
プロバイダーは次の例外をスローする必要があります。
例外の種類 |
状態 |
---|---|
|
|
|
|
|
参照
処理手順
UI オートメーション プロバイダーでのコントロール パターンのサポート