Ejemplo Creating an XPS Document

Artículo
10/07/2008

Actualización: noviembre 2007

XpsSave muestra cómo escribir un documento XML Paper Specification (XPS) en un archivo ya sea sincrónica o asincrónicamente. Cuando se ejecuta, el ejemplo muestra un objeto ComboBox "Seleccionar contenido" que permite al usuario elegir uno de los cinco tipos de contenido predefinidos: un solo elemento visual, varios elementos visuales, un documento de flujo, un solo documento reparado o varios documentos reparados. El contenido seleccionado se muestra en el control DocumentViewer situado en el panel derecho de la ventana de la aplicación. Una vez seleccionado el contenido, se habilitan dos botones de impresión: "Guardar: sincrónicamente" y "Guardar: asincrónicamente". Si presiona cualquiera de estos botones, se abre un cuadro de diálogo "Guardar como" que inicia la escritura del documento XML Paper Specification (XPS) en un archivo especificado.

"Guardar: sincrónicamente" muestra las operaciones básicas para escribir un documento XPS. Durante la escritura sincrónica la interfaz de usuario espera hasta que se complete la impresión. Esperar a que se complete la escritura puede ser correcto para documentos pequeños en los que el tiempo de impresión es rápido, pero no se suele recomendar ya que los documentos grandes podrían tardar bastante tiempo en guardarse.

"Guardar: asincrónicamente" permite que la interfaz de usuario prosiga mientras la operación de escritura de XPS continúa independientemente. El guardado asincrónico requiere un poco de configuración adicional de código, pero se recomienda como el "procedimiento recomendado" para que siga respondiendo correctamente una interfaz de usuario.

Este ejemplo muestra una característica específica de Windows Presentation Foundation (WPF) y, por consiguiente, no sigue los procedimientos recomendados para el desarrollo de aplicaciones. Para obtener la información completa sobre los procedimientos recomendados para el desarrollo de aplicaciones de Windows Presentation Foundation (WPF) y Microsoft .NET Framework, vea la siguiente información según convenga:

Accesibilidad: Procedimientos de accesibilidad recomendados

Seguridad: Seguridad de Windows Presentation Foundation

Localización: Información general sobre la localización y globalización de WPF

Download sample

Generar el ejemplo

Instale el Kit de desarrollo de software de Windows (SDK) y abra la ventana de comandos del entorno de compilación. En el menú Inicio, elija Todos los programas, Microsoft Windows SDK y haga clic en Shell CMD.
Descargue el ejemplo, que encontrará en la documentación del kit de desarrollo de software (SDK), al disco duro.
Para generar el ejemplo en la ventana de comados del entorno de compilación, vaya al directorio de origen del ejemplo. En el símbolo del sistema, escriba MSBUILD.
Para generar el ejemplo en Microsoft Visual Studio, cargue la solución de ejemplo o el archivo del proyecto y presione CTRL+MAYÚS+B.

Ejecutar el ejemplo

Para ejecutar el ejemplo compilado con depuración en Visual Studio, presione F5.
Para ejecutar el ejemplo desde una ventana de símbolo del sistema de Shell CDM, ejecute el archivo .exe ubicado en la carpeta de origen del ejemplo.