C++'ta Sunum Özelliklerini Yönet

Giriş

Aspose.Slides for C++ yerleşik ve özel belge özelliklerini destekler. Bu özellikleri yazar, başlık ve kullanıcı tanımlı değerler gibi sunum üst verilerini okumak ve güncellemek için kullanın.

Aspose.Slides, sunum belge özellikleriyle IDocumentProperties arayüzü üzerinden çalışmanıza olanak tanır. Bu arayüzün bir örneği IPresentation::get_DocumentProperties tarafından döndürülür. Aşağıdaki örnekler bu özelliklerin nasıl okunacağını, değiştirileceğini ve yönetileceğini gösterir.

Sunum Özelliklerini Yönet

Belge özellikleri, sunum içeriğiyle birlikte tanımlayıcı bilgileri depolar. İki kategoriye ayrılırlar:

  • Yerleşik özellikler standart üst verileri içerir, örneğin başlık, yazar ve belge istatistikleri.
  • Özel özellikler kullanıcı tanımlı ad/değer çiftlerini depolar.

Aspose.Slides for C++ her iki kategoriye de erişim sağlar. PowerPoint’ta belge üst verilerini incelemek için File → Info → Properties → Advanced Properties seçeneğini seçin. İletişim kutusu bilgileri Summary, Statistics, Contents ve Custom gibi sekmelere gruplar. Kullanıcı tanımlı özellikleri yönetmek için Custom sekmesini kullanın.

Şifrelenmiş Bir Sunumdan Genel Özellikleri Okuma

Açma parolası genellikle hem sunum içeriğini hem de belge özelliklerini korur. Bir sunum, IProtectionManager::set_EncryptDocumentProperties metoduna false geçirildiğinde şifrelenirse, belge özellikleri genel kalır. Bir uygulama daha sonra LoadOptions::set_OnlyLoadDocumentProperties metoduna true geçirerek açma parolasını girmeden genel üst verileri okuyabilir.

LoadOptions::set_OnlyLoadDocumentProperties Aspose.Slides’in neyi yükleyeceğini kontrol eder; hiçbir şeyi çözmez. Özellikler şifrelemeye dahil edilmişse, parolasız yükleme başarısız olur. Sunum şifreli değilse, seçenek yok sayılır ve tam sunum yüklenir.

Örnek, belge özellikleri genel bırakılmış bir şifreli sunum gerektirir. Yükleme modunu IProtectionManager::get_IsOnlyDocumentPropertiesLoaded ile doğrular ve ardından IPresentation::get_DocumentProperties üzerinden yerleşik özellikleri okur:

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <DOM/LoadOptions.h>
#include <DOM/IProtectionManager.h>

using namespace Aspose::Slides;

auto loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_OnlyLoadDocumentProperties(true);

auto presentation = System::MakeObject<Presentation>(u"public-properties-encrypted.pptx", loadOptions);

if (presentation->get_ProtectionManager()->get_IsOnlyDocumentPropertiesLoaded())
{
    auto documentProperties = presentation->get_DocumentProperties();

    System::Console::WriteLine(u"Author: {0}", documentProperties->get_Author());
    System::Console::WriteLine(u"Title: {0}", documentProperties->get_Title());
    System::Console::WriteLine(u"Keywords: {0}", documentProperties->get_Keywords());
}
else
{
    System::Console::WriteLine(u"The presentation was not loaded in document-properties-only mode.");
}

Bu modda, slayt içeriği yüklenmez. Slaytlar, ana slaytlar, yerleşimler, şekiller, medya ve diğer sunum nesneleri kullanılamaz. Uygulamalar, tam sunum nesne modelini gerektiren bir işlem yapmadan önce her zaman IProtectionManager::get_IsOnlyDocumentPropertiesLoaded kontrol etmelidir.

Şifreli Bir Sunumun Özelliklerini Güncelleme

Şifreli bir PPTX dosyası için, LoadOptions::set_OnlyLoadDocumentProperties metoduna true geçirilerek yüklenen bir sunum, genel üst verileri okumak için tasarlanmıştır. Aspose.Slides, yalnızca üst veri nesnesinden değiştirilen özellikleri kaydedemez çünkü genel özellikler şifreli sunumdaki ilgili verilerle tutarlı olmalıdır. Bu nedenle güncelleme, doğru açma parolasını ve tam bir yüklemeyi gerektirir.

Örnek, genel belge özellikleri olan şifreli bir PPTX sunumu ve bilinen bir açma parolası gerektirir. Sunumu, LoadOptions::set_Password ile tam olarak açar, genel yerleşik özellikleri günceller ve sonucu kaydeder. Ardından IPresentationInfo::get_IsEncrypted kullanarak şifrelemenin korunduğunu doğrular ve yeni değerleri kontrol etmek için parolasız olarak genel üst verileri tekrar açar:

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <DOM/LoadOptions.h>
#include <DOM/IProtectionManager.h>
#include <DOM/PresentationFactory.h>
#include <DOM/IPresentationInfo.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

const System::String inputPath = u"public-properties-encrypted.pptx";
const System::String outputPath = u"updated-public-properties-encrypted.pptx";

auto loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_Password(u"open_password");

auto presentation = System::MakeObject<Presentation>(inputPath, loadOptions);

auto documentProperties = presentation->get_DocumentProperties();
documentProperties->set_Title(u"Updated Product Roadmap");
documentProperties->set_Keywords(u"roadmap, planning, indexed");

presentation->Save(outputPath, SaveFormat::Pptx);

auto presentationInfo = PresentationFactory::get_Instance()->GetPresentationInfo(outputPath);
System::Console::WriteLine(u"The presentation is encrypted: {0}", presentationInfo->get_IsEncrypted());

auto metadataLoadOptions = System::MakeObject<LoadOptions>();
metadataLoadOptions->set_OnlyLoadDocumentProperties(true);

auto metadataPresentation = System::MakeObject<Presentation>(outputPath, metadataLoadOptions);

if (metadataPresentation->get_ProtectionManager()->get_IsOnlyDocumentPropertiesLoaded())
{
    System::Console::WriteLine(u"Title: {0}", metadataPresentation->get_DocumentProperties()->get_Title());
    System::Console::WriteLine(u"Keywords: {0}", metadataPresentation->get_DocumentProperties()->get_Keywords());
}
else
{
    System::Console::WriteLine(u"The presentation was not loaded in document-properties-only mode.");
}

Bir uygulamaya sunum içeriğini çözme veya yükleme izni verilmemişse, şifreli bir PPTX dosyasının genel özelliklerini yalnızca okunabilir olarak ele almalıdır.

Yerleşik Özelliklere Erişim

IDocumentProperties arayüzü, get_Author, get_Title ve get_CreatedTime gibi tiplenmiş alıcılar aracılığıyla yerleşik üst verileri ortaya çıkarır. Bu örnek mevcut bir sunumu açar ve depolanan üst verileri konsola yazdırır. Değerler girdi sunumuna bağlıdır; bazı alanlar boş olabilir.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>

using namespace Aspose::Slides;

auto presentation = System::MakeObject<Presentation>(u"AccessBuiltInProperties.pptx");

auto documentProperties = presentation->get_DocumentProperties();

System::Console::WriteLine(u"Category: {0}", documentProperties->get_Category());
System::Console::WriteLine(u"Content status: {0}", documentProperties->get_ContentStatus());
System::Console::WriteLine(u"Creation date: {0}", documentProperties->get_CreatedTime());
System::Console::WriteLine(u"Author: {0}", documentProperties->get_Author());
System::Console::WriteLine(u"Comments: {0}", documentProperties->get_Comments());
System::Console::WriteLine(u"Keywords: {0}", documentProperties->get_Keywords());
System::Console::WriteLine(u"Last modified by: {0}", documentProperties->get_LastSavedBy());
System::Console::WriteLine(u"Manager: {0}", documentProperties->get_Manager());
System::Console::WriteLine(u"Modified date: {0}", documentProperties->get_LastSavedTime());
System::Console::WriteLine(u"Presentation format: {0}", documentProperties->get_PresentationFormat());
System::Console::WriteLine(u"Last print date: {0}", documentProperties->get_LastPrinted());
System::Console::WriteLine(u"Is shared between producers: {0}", documentProperties->get_SharedDoc());
System::Console::WriteLine(u"Subject: {0}", documentProperties->get_Subject());
System::Console::WriteLine(u"Title: {0}", documentProperties->get_Title());

Yerleşik Özellikleri Değiştirme

Yerleşik üst verileri güncellemek için IPresentation::get_DocumentProperties tarafından döndürülen nesnenin ayarlayıcılarını kullanın. Bu örnek mevcut bir sunumu açar, set_Author, set_Title, set_Subject, set_Comments ve set_Manager metodlarını çağırır, ardından Presentation::Save ile güncellenmiş sunumu kaydeder. Kaydedilen PPTX yeni üst verileri içerir.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"ModifyBuiltInProperties.pptx");

auto documentProperties = presentation->get_DocumentProperties();

documentProperties->set_Author(u"Aspose.Slides for C++");
documentProperties->set_Title(u"Manage PowerPoint Presentation Properties");
documentProperties->set_Subject(u"Modify Built-in Properties");
documentProperties->set_Comments(u"Aspose description");
documentProperties->set_Manager(u"Aspose manager");

presentation->Save(u"DocumentProperties_output.pptx", SaveFormat::Pptx);

Köprü Temelini Yönetme

IDocumentProperties::get_HyperlinkBase göreli köprüler için belge düzeyinde temel adresi okur. Bu, bir sunumu ve ona bağlı dosyaları başka bir konuma taşırken faydalıdır. Bu, tek bir köprünün IHyperlink::get_ExternalUrl metodundan ayrı bir özelliktir; temeli değiştirmek saklanan köprü adreslerini yeniden yazmaz ya da mutlak hedefleri değiştirmez.

Örnek, target.html gibi bir göreli bağlantı ve https://example.org/absolute.html gibi bir mutlak bağlantı içeren bir sunum gerektirir. Mevcut temeli okur, yeni bir temel adresi IDocumentProperties::set_HyperlinkBase ile atar ve değeri kontrol etmek için sunumu kaydedip tekrar açar. Ardından temeli u"" ile temizler ve ayrı bir kaydedilmiş dosyada boş değeri doğrular. Örnek temel adresi, bağladığınız dosyaların konumuyla değiştirin.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"hyperlinks.pptx");

System::Console::WriteLine(u"Original base: {0}", presentation->get_DocumentProperties()->get_HyperlinkBase());

const System::String newBase = u"https://example.com/new/";
presentation->get_DocumentProperties()->set_HyperlinkBase(newBase);
presentation->Save(u"hyperlinks-updated.pptx", SaveFormat::Pptx);

auto updatedPresentation = System::MakeObject<Presentation>(u"hyperlinks-updated.pptx");
System::Console::WriteLine(u"Base preserved: {0}", (updatedPresentation->get_DocumentProperties()->get_HyperlinkBase() == newBase));

updatedPresentation->get_DocumentProperties()->set_HyperlinkBase(u"");
updatedPresentation->Save(u"hyperlinks-cleared.pptx", SaveFormat::Pptx);

auto clearedPresentation = System::MakeObject<Presentation>(u"hyperlinks-cleared.pptx");
System::Console::WriteLine(u"Base cleared: {0}", (clearedPresentation->get_DocumentProperties()->get_HyperlinkBase() == u""));

İki doğrulama mesajı True yazdırmalıdır. Temelin temizlenmesi, bireysel köprü adreslerini etkilenmemiş bırakır.

target.pptx öğesine göreli bir bağlantı, temel old klasörüne işaret ettiğinde old/target.pptx dosyasını açtı. Temel new klasörüne değiştirildikten, kaydedilip sunum tekrar açıldıktan sonra aynı bağlantı new/target.pptx dosyasını açtı. Mutlak bir bağlantı aynı dosyayı açmaya devam etti. Sunumu taşımadan önce ve sonra ya da temelini değiştirdikten sonra PowerPoint’te göreli bağlantılarınızı test edin.

Özel Sunum Özellikleri Ekleme

Özel özellikler, karşılık gelen yerleşik bir alanı olmayan üst verileri depolar. IDocumentProperties::idx_set bir özellik adına değer atamanıza izin verir. Bu örnek bir sunum oluşturur, iki metin değeri ve bir tamsayı sürüm değeri ekler ve Presentation::Save ile sunumu kaydeder. Mevcut bir ada değer atamak, o özelliğin değerini değiştirir.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <Export/SaveFormat.h>
#include <system/object_ext.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>();

auto documentProperties = presentation->get_DocumentProperties();

documentProperties->idx_set(u"Reviewed by", System::ObjectExt::Box<System::String>(u"John Smith"));
documentProperties->idx_set(u"Confidentiality level", System::ObjectExt::Box<System::String>(u"Internal"));
documentProperties->idx_set(u"Document version", System::ObjectExt::Box(2));

presentation->Save(u"CustomDocumentProperties_output.pptx", SaveFormat::Pptx);

Özel Özelliklere Erişim ve Değiştirme

Bu örnek, özel özellikler içeren bir sunumu açar ve get_CountOfCustomProperties ile bunlar üzerinde döner. GetCustomPropertyName sıfır‑bazlı bir indeks alır ve IDocumentProperties::idx_get ve idx_set tarafından kullanılan adı döndürür. Örnek, her orijinal adı ve değeri yazdırır, her değeri orijinal tipine bakılmaksızın numaralı bir dizeyle değiştirir ve değişiklikleri kaydeder. Özel özellik yoksa, döngü hiçbir değişiklik yapmaz.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <Export/SaveFormat.h>
#include <system/object_ext.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"AccessAndModifyProperties.pptx");

auto documentProperties = presentation->get_DocumentProperties();

for (auto i = 0; i < documentProperties->get_CountOfCustomProperties(); i++)
{
    auto propertyName = documentProperties->GetCustomPropertyName(i);
    auto propertyValue = documentProperties->idx_get(propertyName);

    System::Console::WriteLine(u"Custom property name: {0}", propertyName);
    System::Console::WriteLine(u"Custom property value: {0}", propertyValue);

    documentProperties->idx_set(propertyName, System::ObjectExt::Box(System::String::Format(u"New Value {0}", i + 1)));
}

presentation->Save(u"CustomProperties_output.pptx", SaveFormat::Pptx);

Canlı Örnek

Aspose.Slides API’sını kullanarak belge özellikleriyle nasıl çalışılacağını görmek için çevrimiçi uygulama olan PowerPoint Üst Bilgilerini Görüntüle ve Düzenle‘yi deneyin:

PowerPoint Üst Bilgilerini Görüntüle ve Düzenle

SSS

Bir sunumdan yerleşik bir özelliği nasıl kaldırabilirim?

Yerleşik özellikler, bir sunumun bütünleyici parçasıdır ve tamamen kaldırılamaz. Ancak, değerlerini değiştirebilir veya ilgili özellik izin veriyorsa boş olarak ayarlayabilirsiniz.

Zaten var olan bir özel özelliği eklersem ne olur?

Eğer zaten var olan bir özel özellik eklenirse, mevcut değeri yeni değerle üzerine yazılır. Özelliği önceden kaldırmanıza veya kontrol etmenize gerek yoktur; Aspose.Slides otomatik olarak özelliğin değerini günceller.

Sunumu tamamen yüklemeden sunum özelliklerine erişebilir miyim?

Evet. PresentationFactory::GetPresentationInfo kullanın ve ardından IPresentationInfo::ReadDocumentProperties ile bir Presentation örneği oluşturmadan saklanan belge üst verilerini okuyun. Tam bir raporlama örneği ve format‑spesifik sınırlamalar için Hafif Sunum Envanteri Oluşturma sayfasına bakın.

Şifreli bir sunumun genel özelliklerini açma parolasına sahip olmadan okuyabilir miyim?

Evet. Sunum, IProtectionManager::set_EncryptDocumentProperties metoduna false geçirilerek şifrelenmiş olmalı ve LoadOptions::set_OnlyLoadDocumentProperties metoduna true geçirilerek yüklenmiş olmalıdır.

Belge‑özellikleri‑sadece modunda şifreli bir PPTX dosyasını güncelleyebilir miyim?

Hayır. Genel ve şifreli özellik verileri tutarlı olmalıdır; bu nedenle şifreli bir PPTX dosyasını güncellemek, doğru açma parolasıyla tam sunumu yüklemeyi gerektirir.