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 つの undo 単位をグループ化し、テキスト コンテンツまたは選択変更イベントが変更のブロックが終了するまで発生していることを防ぎます。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. 呼び出す、BeginChangeメソッドに対応する呼び出しまで、指定された変更のブロックに含まれるすべての後続の変更は、EndChangeメソッドを作成します。Calling 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.

適用対象

こちらもご覧ください