Os arquivos do PowerPoint contêm metadados ou propriedades do documento que fornecem informações adicionais sobre a apresentação. Estes incluem informações como título, data, autor, etc., da apresentação. Neste artigo, você aprenderá como acessar e modificar as propriedades em apresentações do PowerPoint usando C++.
- API C++ para acessar e modificar propriedades de apresentações do PowerPoint
- Tipos de propriedades em apresentações do PowerPoint
- Acessar propriedades internas em apresentações do PowerPoint
- Modificar propriedades internas em apresentações do PowerPoint
- Adicionar propriedades personalizadas em apresentações do PowerPoint
- Acessar e modificar propriedades personalizadas em apresentações do PowerPoint
API C++ para acessar e modificar propriedades de apresentações do PowerPoint
Aspose.Slides for C++ é uma API C++ para trabalhar com arquivos do PowerPoint. Ele permite que você crie, leia e atualize arquivos do PowerPoint sem precisar de software adicional. Além disso, a API permite acessar e modificar as propriedades das apresentações do PowerPoint. Você pode instalar a API por meio do NuGet ou baixá-la diretamente da seção Downloads.
PM> Install-Package Aspose.Slides.Cpp
Tipos de propriedades em apresentações do PowerPoint
Existem dois tipos de propriedades nas apresentações do PowerPoint: internas e personalizadas. As propriedades internas armazenam informações gerais sobre as apresentações, como título, data, etc. Por outro lado, as propriedades personalizadas armazenam informações personalizadas em pares chave/valor. As seções a seguir abordam como adicionar, acessar e modificar propriedades internas e personalizadas de apresentações do PowerPoint.
Acesse propriedades internas em apresentações do PowerPoint usando C++
A seguir estão as etapas para acessar as propriedades internas em apresentações do PowerPoint.
- Primeiramente, carregue o arquivo PowerPoint usando a classe Apresentação.
- Acesse as propriedades usando o método Apresentação->getDocumentProperties().
- Leia as propriedades individuais usando o objeto IDocumentProperties com métodos como IDocumentProperties->getCategory(), IDocumentProperties->getAuthor(), etc.
O código de exemplo a seguir mostra como acessar propriedades internas em apresentações do PowerPoint usando C++.
// Caminho de arquivo
const String sourceFilePath = u"SourceDirectory\\Slides\\SamplePresentation.pptx";
// Carregar o arquivo de apresentação
auto presentation = System::MakeObject<Presentation>(sourceFilePath);
// Obter referência de propriedades do documento
System::SharedPtr<IDocumentProperties> documentProperties = presentation->get_DocumentProperties();
// Imprima os valores da propriedade
System::Console::WriteLine(u"Category : {0}", documentProperties->get_Category());
System::Console::WriteLine(u"Current Status : {0}", documentProperties->get_ContentStatus());
System::Console::WriteLine(u"Creation Date : {0}", documentProperties->get_CreatedTime().ToString());
System::Console::WriteLine(u"Author : {0}", documentProperties->get_Author());
System::Console::WriteLine(u"Description : {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"Supervisor : {0}", documentProperties->get_Manager());
System::Console::WriteLine(u"Modified Date : {0}", documentProperties->get_LastSavedTime().ToString());
System::Console::WriteLine(u"Presentation Format : {0}", documentProperties->get_PresentationFormat());
System::Console::WriteLine(u"Last Print Date : {0}", documentProperties->get_LastPrinted().ToString());
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());
Modificar propriedades internas em apresentações do PowerPoint usando C++
A seguir estão as etapas para modificar as propriedades internas em apresentações do PowerPoint.
- Primeiramente, carregue o arquivo PowerPoint usando a classe Apresentação.
- Recupere as propriedades no objeto IDocumentProperties usando o método Presentation->getDocumentProperties().
- Modifique as propriedades usando o objeto IDocumentProperties com métodos como IDocumentProperties->setAuthor(System::String value), IDocumentProperties->setTitle(System::String value), etc. .
- Finalmente, salve a apresentação usando o método Presentation->Save(System::String fname, Export::SaveFormat format).
O código de exemplo a seguir mostra como modificar as propriedades internas do PowerPoint usando C++.
// Caminhos de arquivo
const String sourceFilePath = u"SourceDirectory\\Slides\\SamplePresentation.pptx";
const String outputFilePath = u"OutputDirectory\\ModifyBuiltinProperties_out.pptx";
// Carregar o arquivo de apresentação
auto presentation = System::MakeObject<Presentation>(sourceFilePath);
// Obter referência de propriedades do documento
System::SharedPtr<IDocumentProperties> documentProperties = presentation->get_DocumentProperties();
// Modifique as propriedades internas
documentProperties->set_Author(u"Aspose.Slides for C++");
documentProperties->set_Title(u"Modifying Presentation Properties");
documentProperties->set_Subject(u"Aspose Subject");
documentProperties->set_Comments(u"Aspose Comments");
documentProperties->set_Manager(u"Aspose Manager");
// Salvar apresentação
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
Adicionar propriedades personalizadas em apresentações do PowerPoint usando C++
A seguir estão as etapas para adicionar propriedades personalizadas em apresentações do PowerPoint.
- Primeiramente, carregue o arquivo PowerPoint usando a classe Apresentação.
- Recupere as propriedades no objeto IDocumentProperties usando o método Presentation->getDocumentProperties().
- Adicione as propriedades personalizadas usando o IDocumentProperties->idxset(System::String name, System::SharedPtrSystem::Object valor) método.
- Finalmente, salve a apresentação usando o método Presentation->Save(System::String fname, Export::SaveFormat format).
O código de exemplo a seguir mostra como adicionar propriedades personalizadas em apresentações do PowerPoint.
// Caminhos de arquivo
const String sourceFilePath = u"SourceDirectory\\Slides\\SamplePresentation.pptx";
const String outputFilePath = u"OutputDirectory\\AddCustomProperties_out.pptx";
// Carregar o arquivo de apresentação
auto presentation = System::MakeObject<Presentation>(sourceFilePath);
// Obter referência de propriedades do documento
auto documentProperties = presentation->get_DocumentProperties();
// Adicionando propriedades personalizadas
documentProperties->idx_set(u"New Custom", ObjectExt::Box<int32_t>(12));
documentProperties->idx_set(u"My Name", ObjectExt::Box<String>(u"Aspose"));
documentProperties->idx_set(u"Custom", ObjectExt::Box<int32_t>(124));
// Obtendo o nome da propriedade em um índice específico
String getPropertyName = documentProperties->GetCustomPropertyName(2);
// Removendo a propriedade selecionada
documentProperties->RemoveCustomProperty(getPropertyName);
// Salvar apresentação
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
Acessar e modificar propriedades personalizadas em apresentações do PowerPoint
A seguir estão as etapas para acessar e modificar propriedades personalizadas em apresentações do PowerPoint.
- Primeiramente, carregue o arquivo PowerPoint usando a classe Apresentação.
- Recupere as propriedades no objeto IDocumentProperties usando o método Presentation->getDocumentProperties().
- Percorra as propriedades e acesse o nome e o valor de cada propriedade usando os métodos IDocumentProperties->GetCustomPropertyName(int32t index) e IDocumentProperties->idxget(System::String name), respectivamente.
- Modifique as propriedades personalizadas necessárias usando o método IDocumentProperties->SetCustomPropertyValue() com base no tipo do valor que você deseja armazenar.
- Finalmente, salve a apresentação usando o método Presentation->Save(System::String fname, Export::SaveFormat format).
O código de exemplo a seguir mostra como acessar e modificar propriedades personalizadas em apresentações do PowerPoint usando C++.
// Caminhos de arquivo
const String sourceFilePath = u"SourceDirectory\\Slides\\SamplePresentation.pptx";
const String outputFilePath = u"OutputDirectory\\AccessAndModifyCustomProperties_out.pptx";
// Carregar o arquivo de apresentação
auto presentation = System::MakeObject<Presentation>(sourceFilePath);
// Crie uma referência ao objeto DocumentProperties associado à Apresentação
System::SharedPtr<IDocumentProperties> documentProperties = presentation->get_DocumentProperties();
// Acesse propriedades personalizadas
for (int32_t i = 0; i < documentProperties->get_CountOfCustomProperties(); i++)
{
// Imprima o nome e o valor das propriedades personalizadas
System::Console::WriteLine(u"Custom Property Name : {0}", documentProperties->GetCustomPropertyName(i));
System::Console::WriteLine(u"Custom Property Value : {0}", documentProperties->idx_get(documentProperties->GetCustomPropertyName(i)));
// Modificar a propriedade personalizada
documentProperties->SetCustomPropertyValue(documentProperties->GetCustomPropertyName(i), String::Format(u"Title : {0}", i));
}
// Salvar apresentação
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
Obtenha uma licença gratuita
Para experimentar a API sem limitações de avaliação, você pode solicitar uma licença temporária gratuita.
Conclusão
Neste artigo, você aprendeu como acessar e modificar propriedades internas em apresentações do PowerPoint. Além disso, você viu como adicionar, acessar e modificar propriedades personalizadas do PowerPoint usando Aspose.Slides for C++ API. É uma API robusta com muitos recursos adicionais para automatizar suas tarefas relacionadas ao PowerPoint. Você pode explorar a API em detalhes visitando a documentação oficial. Em caso de dúvidas, sinta-se à vontade para nos contatar em nosso fórum de suporte gratuito.