Propriétés de Présentation

Accéder aux Propriétés de Présentation

Comme nous l’avons décrit précédemment, Aspose.Slides pour C++ prend en charge deux types de propriétés de document, à savoir les propriétés Intégrées et Personnalisées. Ainsi, les développeurs peuvent accéder à ces deux types de propriétés grâce à l’API Aspose.Slides pour C++. Aspose.Slides pour C++ fournit une classe IDocumentProperties qui représente les propriétés du document associées à un fichier de présentation via la méthode Presentation::get_DocumentProperties(). Les développeurs peuvent utiliser la méthode get_DocumentProperties() exposée par l’objet Presentation pour accéder aux propriétés du document des fichiers de présentation comme décrit ci-dessous :

Veuillez noter que vous ne pouvez pas définir de valeurs pour les champs Application et Producteur, car Aspose Ltd. et Aspose.Slides pour C++ x.x.x seront affichés dans ces champs.

Microsoft PowerPoint offre une fonctionnalité pour ajouter certaines propriétés aux fichiers de présentation. Ces propriétés de document permettent de stocker des informations utiles avec les documents (fichiers de présentation). Il existe deux types de propriétés de document comme suit :

Propriétés Définies par le Système (Intégrées)
Propriétés Définies par l’Utilisateur (Personnalisées)

Les propriétés Intégrées contiennent des informations générales sur le document telles que le titre du document, le nom de l’auteur, les statistiques du document, etc. Les propriétés Personnalisées sont celles qui sont définies par les utilisateurs sous forme de paires Nom/Valeur, où le nom et la valeur sont tous deux définis par l’utilisateur. En utilisant Aspose.Slides pour C++, les développeurs peuvent accéder et modifier les valeurs des propriétés intégrées ainsi que des propriétés personnalisées. Microsoft PowerPoint 2007 permet de gérer les propriétés du document des fichiers de présentation. Tout ce que vous avez à faire est de cliquer sur l’icône Office et ensuite sur l’élément de menu Préparer | Propriétés | Propriétés Avancées de Microsoft PowerPoint 2007. Après avoir sélectionné l’élément de menu Propriétés Avancées, une boîte de dialogue apparaîtra vous permettant de gérer les propriétés du document du fichier PowerPoint. Dans la Boîte de dialogue Propriétés, vous pouvez voir qu’il existe de nombreux onglets tels que Général, Résumé, Statistiques, Contenus et Personnalisé. Tous ces onglets permettent de configurer différents types d’informations liées aux fichiers PowerPoint. L’onglet Personnalisé est utilisé pour gérer les propriétés personnalisées des fichiers PowerPoint.

Accéder aux Propriétés Intégrées

Ces propriétés exposées par l’objet IDocumentProperties incluent : Créateur(Auteur), Description, MotsClés, Créé (Date de Création), Modifié (Date de Modification), Imprimé (Date de Dernière Impression), DernièreModifiéPar, MotsClés, DocPartagé (Est partagé entre différents producteurs ?), FormatDePrésentation, Sujet et Titre.

Modifier les Propriétés Intégrées

Modifier les propriétés intégrées des fichiers de présentation est aussi simple que d’y accéder. Vous pouvez simplement assigner une valeur de chaîne à n’importe quelle propriété souhaitée et la valeur de la propriété serait modifiée. Dans l’exemple ci-dessous, nous avons démontré comment nous pouvons modifier les propriétés de document intégrées du fichier de présentation.

Ajouter des Propriétés de Présentation Personnalisées

Aspose.Slides pour C++ permet également aux développeurs d’ajouter des valeurs personnalisées pour les propriétés du document de présentation. Un exemple est donné ci-dessous qui montre comment définir les propriétés personnalisées pour une présentation.

// Instancier la classe Presentation
auto présentation = System::MakeObject<Presentation>();

// Obtenir les Propriétés du Document
auto propriétésDocument = présentation->get_DocumentProperties();

// Ajouter des propriétés personnalisées
propriétésDocument->idx_set(u"Nouveau Personnalisé", ObjectExt::Box<int32_t>(12));
propriétésDocument->idx_set(u"Mon Nom", ObjectExt::Box<String>(u"Mudassir"));
propriétésDocument->idx_set(u"Personnalisé", ObjectExt::Box<int32_t>(124));

// Obtenir le nom de la propriété à un index particulier
String getNomPropriété = propriétésDocument->GetCustomPropertyName(2);

// Supprimer la propriété sélectionnée
propriétésDocument->RemoveCustomProperty(getNomPropriété);

// Enregistrer la présentation
présentation->Save(u"CustomDocumentProperties_out.pptx", SaveFormat::Pptx);

Accéder et Modifier les Propriétés Personnalisées de Présentation

Aspose.Slides pour C++ permet également aux développeurs d’accéder aux valeurs des propriétés personnalisées. Un exemple est donné ci-dessous qui montre comment vous pouvez accéder et modifier toutes ces propriétés personnalisées pour une présentation.

Vérifier si la Présentation est Modifiée ou Créée

Aspose.Slides pour C++ fournit une fonctionnalité pour vérifier si une présentation est modifiée ou créée. Un exemple est donné ci-dessous qui montre comment vérifier si la présentation est créée ou modifiée.

auto info = PresentationFactory::get_Instance()->GetPresentationInfo(u"props.pptx");

auto props = info->ReadDocumentProperties();

String app = props->get_NameOfApplication();
String ver = props->get_AppVersion();

Définir la Langue de Vérification

Aspose.Slides fournit la propriété LanguageId (exposée par la classe PortionFormat) pour vous permettre de définir la langue de vérification pour un document PowerPoint. La langue de vérification est la langue pour laquelle l’orthographe et la grammaire dans le PowerPoint sont vérifiées.

Ce code C++ vous montre comment définir la langue de vérification pour un PowerPoint :

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(pptxFileName);
System::SharedPtr<AutoShape> autoShape = System::ExplicitCast<AutoShape>(pres->get_Slide(0)->get_Shape(0));

System::SharedPtr<IParagraph> paragraphe = autoShape->get_TextFrame()->get_Paragraph(0);
System::SharedPtr<IPortionCollection> portions = paragraphe->get_Portions();
portions->Clear();

System::SharedPtr<Portion> nouvellePortion = System::MakeObject<Portion>();

System::SharedPtr<IFontData> police = System::MakeObject<FontData>(u"SimSun");
System::SharedPtr<IPortionFormat> formatPortion = nouvellePortion->get_PortionFormat();
formatPortion->set_ComplexScriptFont(police);
formatPortion->set_EastAsianFont(police);
formatPortion->set_LatinFont(police);

formatPortion->set_LanguageId(u"zh-CN");
// définir l'Id d'une langue de vérification

nouvellePortion->set_Text(u"1。");
portions->Add(nouvellePortion);

Définir la Langue par Défaut

Ce code C++ vous montre comment définir la langue par défaut pour une présentation PowerPoint entière :

System::SharedPtr<LoadOptions> optionsChargement = System::MakeObject<LoadOptions>();
optionsChargement->set_DefaultTextLanguage(u"en-US");

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(optionsChargement);

// Ajoute une nouvelle forme rectangulaire avec du texte
System::SharedPtr<IAutoShape> shp = pres->get_Slide(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50.0f, 50.0f, 150.0f, 50.0f);
System::SharedPtr<ITextFrame> cadreTexte = shp->get_TextFrame();
cadreTexte->set_Text(u"Nouveau Texte");

// Vérifie la langue de la première portion
System::Console::WriteLine(cadreTexte->get_Paragraph(0)->get_Portion(0)->get_PortionFormat()->get_LanguageId());

Sécurité de la présentation Commentaires de présentation