TextBoxBase.BeginChange メソッド

定義

名前空間:

System.Windows.Controls.Primitives

アセンブリ:

PresentationFramework.dll

変更ブロックを開始します。

public:
 void BeginChange();

public void BeginChange ();

member this.BeginChange : unit -> unit

Public Sub BeginChange ()

例

次の例では、 BeginChange メソッドと EndChange メソッドを使用して変更ブロックを作成する方法を示します。

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()

注釈

注意

を呼び出すときは、 を呼び出BeginChangeEndChangeして変更ブロックを完了する必要もあります。そうしないと、例外がスローされます。

変更ブロックは、複数の変更を 1 つの元に戻す単位に論理的にグループ化し、テキストコンテンツまたは選択変更イベントが変更ブロックの後まで発生しないようにします。 これにより、テキスト要素が別のリスナーによって同時に変更される危険性なしに、テキスト要素に対して複数の編集を行うことができます。 変更ブロックは、 メソッドを呼び出すことによって作成されます DeclareChangeBlock 。 メソッドを BeginChange 呼び出すと、後続のすべての変更が、メソッドの対応する呼び出しが行われるまで、指定された変更ブロックに EndChange 含められます。

こちらもご覧ください

• Undo()
• Redo()
• EndChange()