UndoEngine クラス

リファレンス

定義

名前空間:: System.ComponentModel.Design

アセンブリ:: System.Design.dll

アセンブリ:: System.Windows.Forms.Design.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

標準の元に戻したりやり直したりするデザイン時の機能を指定します。

public ref class UndoEngine abstract : IDisposable

public abstract class UndoEngine : IDisposable

type UndoEngine = class
    interface IDisposable

Public MustInherit Class UndoEngine
Implements IDisposable

継承: Object
UndoEngine

実装: IDisposable

注釈

抽象クラスは UndoEngine 、デザイン時に元に戻す機能の既定の実装を提供します。元に戻す単位は、取り消し可能な作業の 1 つの単位を表します。このユニットはスタックに追加され、ユーザーはスタックを歩いて各アクションを元に戻すことができます。元に戻す単位は、通常、トグルするように設計されています。つまり、元に戻すを 2 回呼び出すと、アプリケーションは開始状態に戻ります。

クラスは UndoEngine 、デザイナー内で実行されているオブジェクトの次の特性を利用します。

すべての興味深いオブジェクトは、デザイナーローダーによって何らかの形式で永続化できます。
すべてのオブジェクトは、プロパティが変更されたときにプロパティ変更通知を生成します。
IDesignerHost はトランザクションのアイデアを提供します。これは、複数の小さなアクションにまたがる元に戻すアクションを作成するために使用できます。

これらの機能を使用すると、 UndoEngine 必要な元に戻す単位を自動的に作成できます。

注意

プロパティ値を直接変更しないでください。クラスでは UndoEngine 、適切な TypeDescriptor を使用してプロパティ値を変更する必要があります。

UndoEngine は変更通知を監視して元に戻す単位を作成し、単位自体はシリアル化されたオブジェクトの状態で構成されます。次の表に、作成時 UndoEngine に使用できる必要があるサービスを示します。

サービス	説明
ComponentSerializationService	変更の前後にコンポーネントのプロパティとオブジェクトの値を保存します。
IComponentChangeService	コンポーネントに加えられた変更を元に戻すエンジンに通知します。
IDesignerHost	トランザクションを追跡するために使用されます。

注意

クラスには UndoEngine と IComponentChangeServiceが必要ComponentSerializationServiceであるため、デザイン時にのみ使用できます。

元に戻すエンジンはトランザクションを追跡し、トランザクションを含む単一の元に戻す単位を作成します。その結果、元に戻すエンジンは、元に戻すことのできない操作の期間を制御できます。また、トランザクションには名前を付けることができるため、元に戻すことができるアクションは、現在のトランザクションから名前を継承します。使用できるトランザクションがなく、変更が報告された場合、元に戻すエンジンは変更の種類 (たとえば、"Change property 'Text") に基づいて元に戻す名前を作成します。

コンストラクター

UndoEngine(IServiceProvider)

UndoEngine クラスの新しいインスタンスを初期化します。

プロパティ

Enabled	UndoEngine を有効または無効にします。
UndoInProgress	元に戻す操作が実行中であることを示します。

メソッド

AddUndoUnit(UndoEngine+UndoUnit)	UndoEngine.UndoUnit を、元に戻すスタックに追加します。
CreateUndoUnit(String, Boolean)	新しい UndoEngine.UndoUnit を作成します。
DiscardUndoUnit(UndoEngine+UndoUnit)	UndoEngine.UndoUnit を破棄します。
Dispose()	UndoEngine によって使用されているすべてのリソースを解放します。
Dispose(Boolean)	UndoEngine によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetRequiredService(Type)	要求したサービスを取得します。
GetService(Type)	要求したサービスを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnUndoing(EventArgs)	Undoing イベントを発生させます。
OnUndone(EventArgs)	Undone イベントを発生させます。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

イベント

Undoing	元に戻す操作が実行される直前に発生します。
Undone	元に戻す操作が実行された直後に発生します。

適用対象

製品	バージョン
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

次の方法で共有