Share via


Introducción de datos por el usuario en los cuadros de diálogo

Los cuadros de diálogo suelen utilizarse para pedir al usuario datos que necesita la aplicación. El formulario que muestra el cuadro de diálogo se encarga de procesar la información. Cuando se muestra un cuadro de diálogo, es importante saber cómo se cerró o su "resultado". Por ejemplo, si el usuario hace clic en un botón Cancelar, los datos escritos por el usuario se desechan en lugar de conservarse. Puede utilizar la propiedad Form.DialogResult para averiguar cómo se cerró un cuadro de diálogo.

Desde el formulario que muestra el cuadro de diálogo (conocido como formulario primario del cuadro de diálogo), puede utilizar el valor de la propiedad DialogResult para determinar si se hizo clic en un botón Aceptar o Cancelar. Sobre la base del valor de DialogResult devuelto, puede decidir si es necesario recuperar la información del cuadro de diálogo. Puede establecer el valor de la propiedad DialogResult de un cuadro de diálogo cuando no utilice controles Button en el cuadro de diálogo pero aún desee devolver un valor de DialogResult.

Cuando un formulario se muestra como un cuadro de diálogo modal, al hacer clic en el botón Cerrar (el botón con una X situado en la esquina superior derecha del formulario) se oculta el formulario y la propiedad DialogResult se establece en DialogResult.Cancel. No se llama automáticamente al método Close cuando el usuario hace clic en el botón Cerrar de un cuadro de diálogo o establece el valor de la propiedad DialogResult. En su lugar, el formulario se oculta y puede volver a mostrarse sin tener que volver a crear una nueva instancia del cuadro de diálogo. Como consecuencia de este comportamiento, es necesario llamar al método Dispose del formulario cuando la aplicación deja de necesitar dicho formulario.

Nota

Puede invalidar el valor asignado a la propiedad DialogResult cuando el usuario haga clic en el botón Cerrar estableciendo la propiedad DialogResult en un controlador de eventos para el evento Closing del formulario.

Vea también

Tareas

Cómo: Crear cuadros de diálogo en tiempo de diseño

Cómo: Cerrar cuadros de diálogo y conservar los datos introducidos por el usuario

Cómo: Recuperar el resultado de los cuadros de diálogo

Otros recursos

Cuadros de diálogo en formularios Windows Forms