TextBoxBase.BeginChange メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
変更ブロックを開始します。
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 含められます。
適用対象
こちらもご覧ください
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET