Propiedad Form. OnInsert (Access)Form.OnInsert property (Access)

Establece o devuelve el valor del cuadro Antes de insertar en la ventana de Propiedades de un formulario.Sets or returns the value of the Before Insert box in the Properties window of a form. String de lectura y escritura.Read/write String.

SintaxisSyntax

expresión. OnInsertexpression.OnInsert

expresión Variable que representa un objeto Form.expression A variable that represents a Form object.

ObservacionesRemarks

Esta propiedad es útil para cambiar mediante programación la acción que Microsoft Access lleva a cabo cuando se desencadena un evento.This property is helpful for programmatically changing the action that Microsoft Access takes when an event is triggered. Por ejemplo, entre llamadas de evento desea cambiar los parámetros de una expresión o cambiar de un procedimiento de evento a una expresión o macro, según las circunstancias en las que se haya activado el evento.For example, between event calls you may want to change an expression's parameters, or switch from an event procedure to an expression or macro, depending on the circumstances under which the event was triggered.

Aunque el nombre de esta propiedad es OnInsert, lo que realmente establece es el valor del cuadro Antes de insertar.Although the name of this property is OnInsert, setting this property actually sets the value of the Before Insert box.

El evento BeforeInsert se produce cuando el usuario escribe el primer carácter de un nuevo registro, pero antes de que el registro se cree realmente.The BeforeInsert event occurs when the user types the first character in a new record, but before the record is actually created.

OnInsert tendrá uno de los siguientes valores, en función de lo que se seleccione en la ventana Elegir generador, a la que se tiene acceso eligiendo el botón generar situado junto al cuadro antes de insertar de la ventana Propiedades del formulario:The OnInsert value will be one of the following, depending on the selection chosen in the Choose Builder window (accessed by choosing the Build button next to the Before Insert box in the form's Properties window):

  • Si elige el generador de expresiones, el valor será =expresión, donde expresión es la expresión de la ventana del generador de expresiones.If you choose Expression Builder, the value will be =expression, where expression is the expression from the Expression Builder window.

  • Si elige el generador de macros, el valor es el nombre de la macro.If you choose Macro Builder, the value is the name of the macro.

  • Si elige el generador de código, el valor será [procedimiento de evento].If you choose Code Builder, the value will be [Event Procedure].

Si el cuadro Antes de insertar se deja en blanco, el valor de la propiedad es una cadena vacía.If the Before Insert box is blank, the property value is an empty string.

EjemploExample

El ejemplo siguiente imprime el valor de la propiedad OnInsert en la ventana inmediato para el formulario de entrada de pedido .The following example prints the value of the OnInsert property in the Immediate window for the Order Entry form.

Debug.Print Forms("Order Entry").OnInsert

Soporte técnico y comentariosSupport and feedback

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación?Have questions or feedback about Office VBA or this documentation? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.