TextBoxBase.BeginChange Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicia un bloque de cambios.
public:
void BeginChange();public void BeginChange ();member this.BeginChange : unit -> unitPublic Sub BeginChange ()Ejemplos
En el ejemplo siguiente se muestra cómo usar los BeginChange métodos y EndChange para crear un bloque de cambios.
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()
Comentarios
Nota
Cuando se llama a , también debe llamar BeginChangeEndChange a para completar el bloque de cambios; de lo contrario, se producirá una excepción.
Un bloque de cambios agrupa lógicamente varios cambios en una sola unidad de deshacer y evita que se generen eventos de cambio de contenido de texto o selección hasta después del bloque de cambio. De este modo, puede realizar varias modificaciones en el elemento de texto sin el peligro de que otro agente de escucha cambie al mismo tiempo el elemento de texto. Se crea un bloque de cambios mediante una llamada al DeclareChangeBlock método . Al llamar al BeginChange método, todos los cambios posteriores se incluirán en el bloque de cambios especificado hasta que se realice una llamada correspondiente al EndChange método .