TextBoxBase.BeginChange Methode

Definition

Beginnt einen Änderungsblock.

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

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie die BeginChange Methoden und EndChange verwenden, um einen Änderungsblock zu erstellen.

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

Hinweise

Hinweis

Wenn Sie aufrufen BeginChange, müssen Sie auch aufrufen EndChange , um den Änderungsblock abzuschließen, andernfalls wird eine Ausnahme ausgelöst.

Ein Änderungsblock gruppiert mehrere Änderungen logisch in einer einzelnen Rückgängig-Einheit und verhindert, dass Textinhalts- oder Auswahländerungsereignisse bis nach dem Änderungsblock ausgelöst werden. Auf diese Weise können Sie mehrere Bearbeitungen am Textelement vornehmen, ohne dass das Textelement gleichzeitig von einem anderen Listener geändert wird. Durch Aufrufen der -Methode wird ein DeclareChangeBlock Änderungsblock erstellt. Durch das Aufrufen der BeginChange -Methode werden alle nachfolgenden Änderungen in den angegebenen Änderungsblock einbezogen, bis ein entsprechender Aufruf der EndChange Methode erfolgt.

Gilt für:

Weitere Informationen