TextBoxBase.BeginChange Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Rozpoczyna blok zmiany.
public:
void BeginChange();public void BeginChange ();member this.BeginChange : unit -> unitPublic Sub BeginChange ()Przykłady
W poniższym przykładzie pokazano, jak utworzyć blok zmian za BeginChange pomocą metod i 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()
Uwagi
Uwaga
Podczas wywoływania BeginChangemetody należy również wywołać EndChange metodę w celu ukończenia bloku zmian. W przeciwnym razie zostanie zgłoszony wyjątek.
Blok zmiany logicznie grupuje wiele zmian w jedną jednostkę cofania i uniemożliwia wywoływanie zawartości tekstowej lub zdarzeń zmiany zaznaczenia aż po bloku zmiany. Dzięki temu można wprowadzić wiele edycji do elementu tekstowego bez zagrożenia, że element tekstowy jest zmieniany w tym samym czasie przez inny odbiornik. Blok zmian jest tworzony przez wywołanie DeclareChangeBlock metody . BeginChange Wywołanie metody powoduje, że wszystkie kolejne zmiany zostaną uwzględnione w określonym bloku zmian, EndChange dopóki nie zostanie wykonane odpowiednie wywołanie metody.