TextBoxBase.EndChange TextBoxBase.EndChange TextBoxBase.EndChange TextBoxBase.EndChange Method

定義

変更ブロックを終了します。Ends a change block.

public:
 void EndChange();
public void EndChange ();
member this.EndChange : unit -> unit
Public Sub EndChange ()

次の例は、メソッドBeginChangeEndChangeメソッドを使用して変更ブロックを作成する方法を示しています。The following example shows how to use the BeginChange and EndChange methods to create a change block.

TextBox myTextBox = new TextBox();

// Begin the change block. Once BeginChange() is called
// no text content or selection change events will be raised 
// until EndChange is called. Also, all edits made within
// a BeginChange/EndChange block are wraped in a single undo block.
myTextBox.BeginChange();

// Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox";

// Make other changes if desired...

// Whenever BeginChange() is called EndChange() must also be
// called to end the change block.
myTextBox.EndChange();
Dim myTextBox As New TextBox()

' Begin the change block. Once BeginChange() is called
' no text content or selection change events will be raised 
' until EndChange is called. Also, all edits made within
' a BeginChange/EndChange block are wraped in a single undo block.
myTextBox.BeginChange()

' Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox"

' Make other changes if desired...

' Whenever BeginChange() is called EndChange() must also be
' called to end the change block.
myTextBox.EndChange()

注釈

注意

を呼び出しBeginChangeた場合、変更ブロックをEndChange完了するためにもを呼び出す必要があります。そうしないと、例外がスローされます。When you call BeginChange, you must also call EndChange to complete the change block otherwise an exception will be thrown.

変更ブロックは、複数の変更を論理的に1つの取り消し単位にグループ化し、変更ブロックの後までテキストの内容または選択の変更イベントが発生しないようにします。A change block logically groups multiple changes into a single undo unit and prevents text content or selection change events from being raised until after the change block. こうすることで、テキスト要素が別のプロセスによって同時に変更されることなく、テキスト要素に対して複数の編集を行うことができます。This way you can make multiple edits to the text element without the danger of the text element being changed at the same time by another process. 変更ブロックは、 DeclareChangeBlockメソッドを呼び出すことによって作成されます。A change block is created by calling the DeclareChangeBlock method. メソッドを呼び出すと、メソッドへの対応する呼び出しが行われるまで、後続のすべての変更が指定された変更ブロックに含まれます。EndChange BeginChangeCalling the BeginChange method causes all subsequent changes to be included in the specified change block until a corresponding call to the EndChange method is made.

適用対象

こちらもご覧ください