Recuperar y actualizar propiedades de vista de la presentación en Java
La vista normal consta de tres regiones de contenido: la diapositiva en sí, una región de contenido lateral y una región de contenido inferior. Propiedades relacionadas con la posición de las diferentes regiones de contenido. Esta información permite que la aplicación guarde el estado de la vista en el archivo, de modo que al volver a abrirse la vista esté en el mismo estado que cuando se guardó la presentación por última vez.
El método IViewProperties.getNormalViewProperties se ha añadido para proporcionar acceso a las propiedades de vista normal de la presentación.
Los interfaces INormalViewProperties, INormalViewRestoredProperties y sus descendientes, el enum SplitterBarStateType se han añadido.
Acerca de INormalViewProperties
Representa las propiedades de vista normal.
Los métodos getShowOutlineIcons y setShowOutlineIcons especifican si la aplicación debe mostrar íconos al presentar contenido de esquema en cualquiera de las regiones de contenido del modo de vista normal.
Los métodos getSnapVerticalSplitter y setSnapVerticalSplitter especifican si la barra divisora vertical debe ajustarse a un estado minimizado cuando la región lateral es lo suficientemente pequeña.
La propiedad getPreferSingleView y setPreferSingleView especifican si el usuario prefiere ver una única región de contenido a pantalla completa en lugar de la vista normal estándar con tres regiones de contenido. Si está habilitado, la aplicación puede elegir mostrar una de las regiones de contenido en toda la ventana.
Los métodos getVerticalBarState y getHorizontalBarState especifican el estado en que debe mostrarse la barra divisora horizontal o vertical. Una barra divisora horizontal separa la diapositiva de la región de contenido situada debajo de ella; una barra divisora vertical separa la diapositiva de la región de contenido lateral. Los valores posibles son: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized y SplitterBarStateType.Restored.
Los métodos getRestoredLeft y getRestoredTop especifican el dimensionado de la región superior o lateral de la diapositiva en la vista normal, cuando se aplica el valor SplitterBarStateType.Restored a getVerticalBarState y a getHorizontalBarState respectivamente.
Acerca de Restoring INormalViewProperties
Especifica el dimensionado de la región de diapositiva (ancho cuando es hijo de getRestoredTop, altura cuando es hijo de getRestoredLeft) de la vista normal, cuando la región tiene un tamaño restaurado variable (ni minimizado ni maximizado).
El método getDimensionSize especifica el tamaño de la región de diapositiva (ancho cuando es hijo de restoredTop, altura cuando es hijo de restoredLeft).
El método getAutoAdjust especifica si el tamaño de la región de contenido lateral debe compensar el nuevo tamaño al redimensionar la ventana que contiene la vista dentro de la aplicación.
A continuación se muestra un ejemplo que indica cómo acceder a las propiedades ViewProperties.getNormalViewProperties de una presentación.
Presentation pres = new Presentation();
try {
pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(SplitterBarStateType.Restored);
pres.getViewProperties().getNormalViewProperties().setVerticalBarState(SplitterBarStateType.Maximized);
// Restaurar las propiedades de vista de la presentación
pres.getViewProperties().getNormalViewProperties().getRestoredTop().setAutoAdjust(true);
pres.getViewProperties().getNormalViewProperties().getRestoredTop().setDimensionSize(80);
pres.getViewProperties().getNormalViewProperties().setShowOutlineIcons(true);
pres.save("presentation_normal_view_state.pptx", SaveFormat.Pptx);
} finally {
pres.dispose();
}
Establecer el valor de zoom predeterminado
Para establecer las propiedades de vista, siga los pasos a continuación:
- Cree una instancia de la clase Presentation.
- Establezca las View Properties de la Presentation.
- Guarde la presentación como un archivo PPTX.
En el ejemplo que se muestra a continuación, hemos configurado el valor de zoom tanto para la vista de diapositiva como para la vista de notas.
Presentation presentation = new Presentation();
try {
// Estableciendo las propiedades de vista de la presentación
presentation.getViewProperties().getSlideViewProperties().setScale(100); // Valor de zoom en porcentajes para la vista de diapositiva
presentation.getViewProperties().getNotesViewProperties().setScale(100); // Valor de zoom en porcentajes para la vista de notas
presentation.save("Zoom_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
FAQ
¿Puedo establecer diferentes configuraciones de vista para distintas secciones de una presentación?
Los view settings se definen a nivel de presentación (Normal View/Slide View), no por sección, por lo que un único conjunto de parámetros se aplica a todo el documento cuando se abre.
¿Puedo predefinir diferentes estados de vista para distintos usuarios?
No. Los ajustes se almacenan en el archivo y se comparten. Las aplicaciones de visualización pueden respetar las preferencias del usuario, pero el propio archivo contiene un único conjunto de propiedades de vista.
¿Puedo crear una plantilla con View Properties predefinidos para que las nuevas presentaciones se abran de la misma manera?
Sí. Dado que las view properties se guardan a nivel de presentación, puede incorporarlas en una plantilla y crear nuevos documentos a partir de ella con la misma configuración de vista inicial.