Gestionar propiedades de presentación en C++
Introducción
Aspose.Slides admite dos tipos de propiedades de documento: Incorporadas y Personalizadas. Ambos tipos de propiedades se pueden acceder y gestionar fácilmente mediante la API de Aspose.Slides.
Aspose.Slides le permite trabajar con las propiedades del documento de presentación a través de la interfaz IDocumentProperties. Una instancia de esta interfaz se devuelve mediante el método Presentation::get_DocumentProperties. Los ejemplos siguientes muestran cómo leer, modificar y gestionar estas propiedades.
Note
Tenga en cuenta que no puede establecer valores en los campos Application y Producer, ya que se mostrarán Aspose Ltd. y Aspose.Slides for C++ x.x.x en esos campos.Administrar propiedades de la presentación
Microsoft PowerPoint ofrece una función para agregar algunas propiedades a los archivos de presentación. Estas propiedades de documento permiten almacenar información útil junto con los documentos (archivos de presentación). Existen dos tipos de propiedades de documento, como se indica a continuación
- Propiedades definidas por el sistema (Incorporadas)
- Propiedades definidas por el usuario (Personalizadas)
Incorporadas las propiedades contienen información general sobre el documento, como el título del documento, el nombre del autor, estadísticas del documento, etc. Personalizadas son aquellas definidas por los usuarios como pares Nombre/Valor, donde tanto el nombre como el valor son definidos por el usuario. Con Aspose.Slides for C++, los desarrolladores pueden acceder y modificar los valores de las propiedades incorporadas así como de las personalizadas. Microsoft PowerPoint 2007 permite gestionar las propiedades del documento de los archivos de presentación. Todo lo que tiene que hacer es hacer clic en el icono de Office y, a continuación, en el elemento del menú Prepare | Properties | Advanced Properties de Microsoft PowerPoint 2007. Después de seleccionar el elemento del menú Advanced Properties, aparecerá un cuadro de diálogo que le permite gestionar las propiedades del documento del archivo PowerPoint. En el Diálogo de propiedades, puede observar que hay varias pestañas como General, Summary, Statistics, Contents y Custom. Todas estas pestañas permiten configurar diferentes tipos de información relacionada con los archivos PowerPoint. La pestaña Custom se utiliza para gestionar las propiedades personalizadas de los archivos PowerPoint.
Acceder a las propiedades incorporadas
Estas propiedades expuestas por el objeto IDocumentProperties incluyen: Creator(Author), Description, KeyWords, Created (fecha de creación), Modified (fecha de modificación), Printed (fecha de la última impresión), LastModifiedBy, Keywords, SharedDoc (¿se comparte entre diferentes productores?), PresentationFormat, Subject y Title.
Modificar propiedades incorporadas
Modificar las propiedades incorporadas de los archivos de presentación es tan fácil como acceder a ellas. Simplemente puede asignar un valor de cadena a cualquier propiedad deseada y el valor de la propiedad se modificará. En el ejemplo que se muestra a continuación, hemos demostrado cómo podemos modificar las propiedades de documento incorporadas del archivo de presentación.
Agregar propiedades personalizadas de la presentación
Aspose.Slides for C++ también permite a los desarrolladores añadir valores personalizados a las propiedades del documento de la presentación. A continuación se muestra un ejemplo que indica cómo establecer las propiedades personalizadas para una presentación.
#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/object_ext.h>
#include <system/string.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
// Instanciar la clase Presentation
// Obtener propiedades del documento
// Añadiendo propiedades personalizadas
String getPropertyName = documentProperties->GetCustomPropertyName(2);
// Obtener el nombre de la propiedad en un índice concreto
// Eliminar la propiedad seleccionada
// Guardando la presentación
Acceder y modificar propiedades personalizadas
Aspose.Slides for C++ también permite a los desarrolladores acceder a los valores de las propiedades personalizadas. A continuación se muestra un ejemplo que demuestra cómo puede acceder y modificar todas esas propiedades personalizadas para una presentación.
Establecer idioma de corrección
Aspose.Slides proporciona la propiedad LanguageId (expuesta por la clase PortionFormat) para permitirle establecer el idioma de corrección de un documento PowerPoint. El idioma de corrección es el idioma para el que se verifican la ortografía y la gramática en PowerPoint.
Este código C++ muestra cómo establecer el idioma de corrección para un PowerPoint:
#include <DOM/AutoShape.h>
#include <DOM/Fonts/FontData.h>
#include <DOM/IFontData.h>
#include <DOM/IParagraph.h>
#include <DOM/IPortionCollection.h>
#include <DOM/IPortionFormat.h>
#include <DOM/ISlide.h>
#include <DOM/ITextFrame.h>
#include <DOM/Portion.h>
#include <DOM/Presentation.h>
using namespace Aspose::Slides;
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"sample.pptx");
System::SharedPtr<AutoShape> autoShape = System::ExplicitCast<AutoShape>(pres->get_Slide(0)->get_Shape(0));
System::SharedPtr<IParagraph> paragraph = autoShape->get_TextFrame()->get_Paragraph(0);
System::SharedPtr<IPortionCollection> portions = paragraph->get_Portions();
portions->Clear();
System::SharedPtr<Portion> newPortion = System::MakeObject<Portion>();
System::SharedPtr<IFontData> font = System::MakeObject<FontData>(u"SimSun");
System::SharedPtr<IPortionFormat> portionFormat = newPortion->get_PortionFormat();
portionFormat->set_ComplexScriptFont(font);
portionFormat->set_EastAsianFont(font);
portionFormat->set_LatinFont(font);
portionFormat->set_LanguageId(u"zh-CN");
// establecer el Id de un idioma de corrección
newPortion->set_Text(u"1。");
portions->Add(newPortion);
Establecer idioma predeterminado
Este código C++ muestra cómo establecer el idioma predeterminado para toda una presentación PowerPoint:
#include <DOM/IAutoShape.h>
#include <DOM/IParagraph.h>
#include <DOM/IPortion.h>
#include <DOM/IPortionFormat.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ITextFrame.h>
#include <DOM/LoadOptions.h>
#include <DOM/Presentation.h>
#include <DOM/ShapeType.h>
#include <system/console.h>
using namespace Aspose::Slides;
System::SharedPtr<LoadOptions> loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_DefaultTextLanguage(u"en-US");
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(loadOptions);
// Añade una nueva forma rectangular con texto
System::SharedPtr<IAutoShape> shp = pres->get_Slide(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50.0f, 50.0f, 150.0f, 50.0f);
System::SharedPtr<ITextFrame> textFrame = shp->get_TextFrame();
textFrame->set_Text(u"New Text");
// Comprueba el idioma de la primera porción
System::Console::WriteLine(textFrame->get_Paragraph(0)->get_Portion(0)->get_PortionFormat()->get_LanguageId());
Ejemplo en vivo
Pruebe la aplicación en línea Aspose.Slides Metadata para ver cómo trabajar con las propiedades del documento mediante la API de Aspose.Slides:
Preguntas frecuentes
¿Cómo puedo eliminar una propiedad incorporada de una presentación?
Las propiedades incorporadas son una parte integral de la presentación y no pueden eliminarse por completo. Sin embargo, puede cambiar sus valores o establecerlas como vacías si la propiedad lo permite.
¿Qué ocurre si agrego una propiedad personalizada que ya existe?
Si agrega una propiedad personalizada que ya existe, su valor actual se sobrescribirá con el nuevo. No es necesario eliminar o comprobar la propiedad previamente, ya que Aspose.Slides actualiza automáticamente el valor de la propiedad.
¿Puedo acceder a las propiedades de la presentación sin cargarla completamente?
Sí. Utilice IPresentationFactory::GetPresentationInfo y luego IPresentationInfo::ReadDocumentProperties para leer los metadatos almacenados del documento sin crear una instancia de Presentation. Consulte Build a Lightweight Presentation Inventory para obtener un ejemplo completo de informe y limitaciones específicas de formato.