TextBoxBase.BeginChange Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Начинает блок изменений.
public:
void BeginChange();public void BeginChange();member this.BeginChange : unit -> unitPublic 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()
Комментарии
Note
При вызове BeginChangeнеобходимо также вызвать EndChange блокировку изменений, в противном случае будет создано исключение.
Блок изменений логически группирует несколько изменений в одну единицу отмены и предотвращает создание событий изменения текста или выделения до тех пор, пока блок изменения не будет изменен. Таким образом можно внести несколько изменений в текстовый элемент без опасности изменения текстового элемента одновременно другим прослушивателем. Блок изменений создается путем вызова DeclareChangeBlock метода. BeginChange Вызов метода приводит к тому, что все последующие изменения будут включены в указанный блок изменений до тех пор, пока не будет выполнен соответствующий вызов EndChange метода.
