Поделиться через


TextBoxBase.BeginChange Метод

Определение

Начинает блок изменений.

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

Комментарии

Примечание

При вызове BeginChangeнеобходимо также вызвать для EndChange завершения блока изменений, в противном случае возникнет исключение.

Блок изменений логически группирует несколько изменений в один блок отмены и предотвращает возникновение событий изменения текстового содержимого или выделения до тех пор, пока не будет изменен блок изменений. Таким образом, вы можете внести несколько изменений в текстовый элемент без опасности одновременного изменения текстового элемента другим прослушивателем. Блок изменений создается путем вызова DeclareChangeBlock метода . BeginChange Вызов метода приводит к включению всех последующих изменений в указанный блок изменений до тех пор, пока не будет выполнен соответствующий EndChange вызов метода .

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

См. также раздел