TextBoxBase.BeginChange Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beginnt einen Änderungsblock.
public:
void BeginChange();public void BeginChange ();member this.BeginChange : unit -> unitPublic 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.
