TextBoxBase.BeginChange Metoda

Definice

Obor názvů:

System.Windows.Controls.Primitives

Sestavení:

PresentationFramework.dll

Zahájí 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í metod BeginChange EndChange 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

Poznámka

Při volání BeginChangemusíte také volat EndChange , aby se dokončil blok změn, jinak se vyvolá výjimka.

Blok změn logicky seskupí více změn do jedné jednotky pro vrácení zpět a zabrání vyvolání událostí změny textového obsahu 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 současně 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 se neprovedla odpovídající volání EndChange metody.

Viz také

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