UndoEngine クラス

  • リファレンス

定義

名前空間:
System.ComponentModel.Design
アセンブリ:
System.Design.dll
アセンブリ:
System.Windows.Forms.Design.dll

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

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

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

適用対象

こちらもご覧ください