Cuadros de diálogo (Windows Installer)
Los cuadros de diálogo se especifican en la columna Diálogo de la tabla Dialog. Para obtener más información sobre cómo agregar un cuadro de diálogo o una cartelera a una interfaz de usuario, consulte Uso de la interfaz de usuario.
Nombres de cuadros de diálogo reservados
Los siguientes nombres de cuadro de diálogo están reservados por Windows Installer y no deben usarse para los cuadros de diálogo personalizados creados por el usuario. El instalador requiere que estos cuadros de diálogo aparezcan en la tabla Dialog con los siguientes nombres reservados. Cada cuadro de diálogo y nombre solo se pueden enumerar una vez. Los desarrolladores deben crear estos cuadros de diálogo en la interfaz de usuario. Para obtener más información sobre cómo previsualizar los cuadros de diálogo, consulteImportación de la interfaz de usuario.
Nombre del cuadro de diálogo | Descripción breve del cuadro de diálogo |
---|---|
Diálogo FilesInUse | Alerta al usuario para que procese la sobrescritura o eliminación de archivos. |
Diálogo FirstRun | Recoge el nombre de usuario, el nombre de la empresa y el identificador de producto. |
Diálogo MsiRMFilesInUse | Alerta al usuario para que procese la sobrescritura o eliminación de archivos y proporciona al usuario la opción de usar el Administrador de reinicio para cerrar y reiniciar las aplicaciones. |
Cuadros de diálogo obligatorios
Durante la instalación, determinados eventos hacen que Windows Installer compruebe las tablas de secuencia de la interfaz de usuario del paquete y muestre el cuadro de diálogo especificado. Por ejemplo, en el caso de un error irrecuperable, Windows Installer muestra el cuadro de diálogo que aparece con un número de secuencia de -3 en la tabla de secuencia de la interfaz de usuario, independientemente de cómo se denomine ese cuadro de diálogo en la tabla Dialog. La siguiente tabla enumera los eventos específicos y su número de secuencia correspondiente en la tabla de secuencia de la interfaz de usuario:
Tipo de evento | Número de secuencia de tabla de secuencia de interfaz de usuario | Descripción del cuadro de diálogo |
---|---|---|
Error irrecuperable | -3 | La instalación se terminó debido a un error irrecuperable. |
Salida del usuario | -2 | La instalación finalizó según solicitud del usuario. |
Salir | -1 | Instalación completada correctamente. |
Además, el autor del paquete debe crear un cuadro de diálogo genérico para mostrar los mensajes de error de Windows Installer. Se le puede poner cualquier nombre a este cuadro de diálogo, pero ese nombre debe especificarse en la propiedad ErrorDialog .
Cuadros de diálogo modales típicos
Los siguientes cuadros de diálogo son opcionales y se incluyen normalmente en la interfaz de usuario creada para un paquete de instalación. Estos diálogos son típicos de la mayoría de los asistentes para la interfaz de usuario al instalar archivos. Estos cuadros de diálogo pueden tener cualquier nombre en la tabla Dialog. Los nombres que se muestran solo se recomiendan para mayor claridad y se pueden modificar según sea necesario. Por ejemplo, se pueden usar dos cuadros de diálogo LicenseAgreement personalizados diferentes en el paquete y distinguirlos en la tabla Dialog por los nombres ProfessionalLicenseAgreement y LimitedLicenseAgreement.
Tipo de cuadro de diálogo | Descripción breve del cuadro de diálogo |
---|---|
DiskCost (Cuadro de diálogo) | Indica espacio en disco insuficiente para la instalación. |
Examinar (Cuadro de diálogo) | Permite al usuario seleccionar un directorio. |
Cancel (Cuadro de diálogo) | Confirma una solicitud para finalizar la instalación. |
Contrato de licencia (Cuadro de diálogo) | Cuadro modal que muestra el contrato de licencia. |
Selección (Cuadro de diálogo) | Cuadro modal que le permite al usuario seleccionar elementos. |