Udostępnij za pośrednictwem


TextBoxBase.BeginChange Metoda

Definicja

Rozpoczyna blok zmiany.

public:
 void BeginChange();
public void BeginChange ();
member this.BeginChange : unit -> unit
Public 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.

Dotyczy

Zobacz też