TextBoxBase.BeginChange Metoda

Definice

Obor názvů:

System.Windows.Controls.Primitives

Sestavení:

PresentationFramework.dll

Začne blok změn.

public:
 void BeginChange();

public void BeginChange();

member this.BeginChange : unit -> unit

Public Sub BeginChange ()

Příklady

Následující příklad ukazuje, jak pomocí BeginChange a EndChange metod vytvořit blok změn.

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

Poznámky

Note

Při volání musíte také volat BeginChangeEndChange k dokončení bloku změn, jinak bude vyvolán výjimka.

Blok změn logicky seskupí několik změn do jedné jednotky pro vrácení zpět a zabrání vyvolání událostí změny textu nebo výběru, dokud se nezmění blok změn. Tímto způsobem můžete provést více úprav textového prvku bez nebezpečí změny textového prvku najednou jiným naslouchacím procesem. Blok změn se vytvoří voláním DeclareChangeBlock metody. BeginChange Volání metody způsobí, že všechny následné změny budou zahrnuty do zadaného bloku změn, dokud nebude provedeno odpovídající volání EndChange metody.

Viz také

• Undo()
• Redo()
• EndChange()