TextBoxBase.BeginChange Метод

Определение

Начинает блок изменений.Begins a change block.

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

Примеры

В следующем примере показано, как использовать BeginChange методы и EndChange для создания блока изменений.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 для завершения блока Change, иначе будет создано исключение.When you call BeginChange, you must also call EndChange to complete the change block otherwise an exception will be thrown.

Блок изменений логически группирует несколько изменений в одну единицу отката и предотвращает появление текстового содержимого или событий изменения выбора до тех пор, пока не закончится блок изменений.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 listener. Блок изменений создается путем вызова 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.

Применяется к

Дополнительно