Zarządzanie właściwościami prezentacji w PHP
Wprowadzenie
Aspose.Slides obsługuje dwa typy właściwości dokumentu: Built-in i Custom. Oba te typy właściwości można łatwo uzyskać i zarządzać nimi za pomocą API Aspose.Slides.
Aspose.Slides umożliwia pracę z właściwościami dokumentu prezentacji za pośrednictwem klasy DocumentProperties . Instancja tej klasy jest zwracana przez metodę Presentation::getDocumentProperties . Poniższe przykłady pokazują, jak odczytywać, modyfikować i zarządzać tymi właściwościami.
Zarządzanie właściwościami prezentacji
Microsoft PowerPoint udostępnia funkcję dodawania niektórych właściwości do plików prezentacji. Te właściwości dokumentu pozwalają na przechowywanie przydatnych informacji razem z dokumentami (plikami prezentacji). Istnieją dwa rodzaje właściwości dokumentu:
- Systemowe (Built-in) właściwości
- Definiowane przez użytkownika (Custom) właściwości
Właściwości Built-in zawierają ogólne informacje o dokumencie, takie jak tytuł dokumentu, imię autora, statystyki dokumentu itp. Właściwości Custom to te, które są definiowane przez użytkowników jako pary Nazwa/Wartość, gdzie zarówno nazwa, jak i wartość są określane przez użytkownika. Korzystając z Aspose.Slides for PHP via Java, programiści mogą uzyskać dostęp i modyfikować wartości zarówno wbudowanych, jak i własnych właściwości.
Właściwości dokumentu w programie PowerPoint
Microsoft PowerPoint 2007 umożliwia zarządzanie właściwościami dokumentu plików prezentacji. Wystarczy kliknąć ikonę Office, a następnie wybrać pozycję menu Prepare | Properties | Advanced Properties w programie Microsoft PowerPoint 2007, jak pokazano poniżej:
| Wybór pozycji menu Advanced Properties | ** |
|---|---|
 |
|
| Po wybraniu pozycji menu Advanced Properties pojawi się dialog umożliwiający zarządzanie właściwościami dokumentu pliku PowerPoint, jak pokazano poniżej na rysunku: |
| Dialog właściwości | ** |
|---|---|
 |
|
| W powyższym Dialogu właściwości można zobaczyć wiele zakładek, takich jak General, Summary, Statistics, Contents oraz Custom. Wszystkie te zakładki umożliwiają konfigurowanie różnych rodzajów informacji związanych z plikami PowerPoint. Zakładka Custom służy do zarządzania własnymi właściwościami plików PowerPoint. |
Praca z właściwościami dokumentu przy użyciu Aspose.Slides for PHP via Java
Jak opisaliśmy wcześniej, Aspose.Slides for PHP via Java obsługuje dwa rodzaje właściwości dokumentu, czyli Built-in i Custom. Programiści mogą więc uzyskać dostęp do obu rodzajów właściwości przy użyciu API Aspose.Slides for PHP via Java. Aspose.Slides for PHP via Java udostępnia klasę DocumentProperties, która reprezentuje właściwości dokumentu powiązane z plikiem prezentacji poprzez właściwość Presentation.DocumentProperties.
Programiści mogą używać właściwości DocumentProperties udostępnionej przez obiekt Presentation, aby uzyskać dostęp do właściwości dokumentu plików prezentacji, jak opisano poniżej:
Dostęp do wbudowanych właściwości
Te właściwości udostępnione przez obiekt DocumentProperties obejmują: Creator (Autor), Description, Keywords, Created (Data utworzenia), Modified (Data modyfikacji), Printed (Data ostatniego wydruku), LastModifiedBy, Keywords, SharedDoc (Czy współdzielone między różnymi producentami?), PresentationFormat, Subject oraz Title.
# Utwórz instancję klasy Presentation, która reprezentuje prezentację
$pres = new Presentation("Presentation.pptx");
try {
# Utwórz referencję do obiektu IDocumentProperties powiązanego z prezentacją
$dp = $pres->getDocumentProperties();
# Wyświetl wbudowane właściwości
echo("Category : " . $dp->getCategory());
echo("Current Status : " . $dp->getContentStatus());
echo("Creation Date : " . $dp->getCreatedTime());
echo("Author : " . $dp->getAuthor());
echo("Description : " . $dp->getComments());
echo("KeyWords : " . $dp->getKeywords());
echo("Last Modified By : " . $dp->getLastSavedBy());
echo("Supervisor : " . $dp->getManager());
echo("Modified Date : " . $dp->getLastSavedTime());
echo("Presentation Format : " . $dp->getPresentationFormat());
echo("Last Print Date : " . $dp->getLastPrinted());
echo("Is Shared between producers : " . $dp->getSharedDoc());
echo("Subject : " . $dp->getSubject());
echo("Title : " . $dp->getTitle());
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Modyfikacja wbudowanych właściwości
Modyfikowanie wbudowanych właściwości plików prezentacji jest tak proste, jak ich odczytywanie. Wystarczy przypisać wartość tekstową do dowolnej wybranej właściwości, a wartość zostanie zmodyfikowana. W poniższym przykładzie pokazaliśmy, jak można modyfikować wbudowane właściwości dokumentu prezentacji przy użyciu Aspose.Slides for PHP via Java.
$pres = new Presentation("Presentation.pptx");
try {
# Utwórz referencję do obiektu IDocumentProperties powiązanego z prezentacją
$dp = $pres->getDocumentProperties();
# Ustaw wbudowane właściwości
$dp->setAuthor("Aspose.Slides for PHP via Java");
$dp->setTitle("Modifying Presentation Properties");
$dp->setSubject("Aspose Subject");
$dp->setComments("Aspose Description");
$dp->setManager("Aspose Manager");
# Zapisz prezentację do pliku
$pres->save("DocProps.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Ten przykład modyfikuje wbudowane właściwości prezentacji, które można zobaczyć poniżej:
| Wbudowane właściwości dokumentu po modyfikacji | ** |
|---|---|
 |
Dodawanie własnych właściwości dokumentu
Aspose.Slides for PHP via Java umożliwia programistom również dodawanie własnych wartości właściwości dokumentu prezentacji. Poniżej podany jest przykład, który pokazuje, jak ustawić własne właściwości dla prezentacji.
$pres = new Presentation();
try {
# Pobieranie właściwości dokumentu
$dProps = $pres->getDocumentProperties();
# Dodawanie własnych właściwości
$dProps->set_Item("New Custom", 12);
$dProps->set_Item("My Name", "Mudassir");
$dProps->set_Item("Custom", 124);
# Pobieranie nazwy własności pod określonym indeksem
$getPropertyName = $dProps->getCustomPropertyName(2);
# Usuwanie wybranej własności
$dProps->removeCustomProperty($getPropertyName);
# Zapisywanie prezentacji
$pres->save("CustomDemo.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
| Dodane własne właściwości dokumentu | ** |
|---|---|
 |
Dostęp i modyfikacja własnych właściwości
Aspose.Slides for PHP via Java pozwala programistom także na dostęp do wartości własnych właściwości. Poniżej znajduje się przykład, który pokazuje, jak uzyskać dostęp i modyfikować wszystkie te własne właściwości dla prezentacji.
$pres = new Presentation("Presentation.pptx");
try {
# Utwórz referencję do obiektu DocumentProperties powiązanego z prezentacją
$dp = $pres->getDocumentProperties();
# Uzyskaj dostęp i zmodyfikuj własne właściwości
for($i = 0; $i < java_values($dp->getCountOfCustomProperties()) ; $i++) {
# Wyświetl nazwy i wartości własnych właściwości
echo("Custom Property Name : " . $dp->getCustomPropertyName($i));
echo("Custom Property Value : " . $dp->get_Item($dp->getCustomPropertyName($i)));
# Modyfikuj wartości własnych właściwości
$dp->set_Item($dp->getCustomPropertyName($i), "New Value " . $i + 1);
}
# Zapisz swoją prezentację do pliku
$pres->save("CustomDemoModified.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Ten przykład modyfikuje własne właściwości PPTX prezentacji. Następujące ilustracje pokazują własne właściwości prezentacji przed i po modyfikacji:
| Własne właściwości przed modyfikacją | ** |
|---|---|
 |
| Własne właściwości po modyfikacji | ** |
|---|---|
 |
Zaawansowane właściwości dokumentu
Dwie nowe metody readDocumentProperties i updateDocumentProperties zostały dodane do klasy PresentationInfo. Zapewniają szybki dostęp do właściwości dokumentu i pozwalają zmieniać oraz aktualizować właściwości bez wczytywania całej prezentacji.
Typowy scenariusz: wczytanie właściwości, zmiana niektórych wartości i aktualizacja dokumentu można zaimplementować w następujący sposób:
# pobierz informacje o prezentacji
$info = PresentationFactory->getInstance()->getPresentationInfo("presentation.pptx");
# uzyskaj bieżące właściwości
$props = $info->readDocumentProperties();
# ustaw nowe wartości pól Autor i Tytuł
$props->setAuthor("New Author");
$props->setTitle("New Title");
# zaktualizuj prezentację nowymi wartościami
$info->updateDocumentProperties($props);
$info->writeBindedPresentation("presentation.pptx");
Istnieje inny sposób wykorzystania właściwości konkretnej prezentacji jako szablonu do aktualizacji właściwości w innych prezentacjach:
$info = PresentationFactory->getInstance()->getPresentationInfo("template.pptx");
$template = $info->readDocumentProperties();
$template->setAuthor("Template Author");
$template->setTitle("Template Title");
$template->setCategory("Template Category");
$template->setKeywords("Keyword1, Keyword2, Keyword3");
$template->setCompany("Our Company");
$template->setComments("Created from template");
$template->setContentType("Template Content");
$template->setSubject("Template Subject");
updateByTemplate("doc1.pptx", $template);
updateByTemplate("doc2.odp", $template);
updateByTemplate("doc3.ppt", $template);
Nowy szablon można utworzyć od podstaw, a następnie użyć go do aktualizacji wielu prezentacji:
$template = new DocumentProperties();
$template->setAuthor("Template Author");
$template->setTitle("Template Title");
$template->setCategory("Template Category");
$template->setKeywords("Keyword1, Keyword2, Keyword3");
$template->setCompany("Our Company");
$template->setComments("Created from template");
$template->setContentType("Template Content");
$template->setSubject("Template Subject");
updateByTemplate("doc1.pptx", $template);
updateByTemplate("doc2.odp", $template);
updateByTemplate("doc3.ppt", $template);
Ustaw język korekty
Aspose.Slides udostępnia właściwość LanguageId (udostępnianą przez klasę PortionFormat), aby umożliwić ustawienie języka korekty dla dokumentu PowerPoint. Język korekty to język, dla którego sprawdzane są pisownia i gramatyka w PowerPoint.
Ten kod PHP pokazuje, jak ustawić język korekty dla PowerPoint: xxx Dlaczego właściwość LanguageId jest nieobecna w klasie Java PortionFormat?
$pres = new Presentation($pptxFileName);
try {
$autoShape = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
$paragraph = $autoShape->getTextFrame()->getParagraphs()->get_Item(0);
$paragraph->getPortions()->clear();
$newPortion = new Portion();
$font = new FontData("SimSun");
$portionFormat = $newPortion->getPortionFormat();
$portionFormat::setComplexScriptFont($font);
$portionFormat::setEastAsianFont($font);
$portionFormat::setLatinFont($font);
$portionFormat::setLanguageId("zh-CN");// ustaw Id języka korekty
$newPortion->setText("1。");
$paragraph->getPortions()->add($newPortion);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Ustaw domyślny język
Ten kod PHP pokazuje, jak ustawić domyślny język dla całej prezentacji PowerPoint:
$loadOptions = new LoadOptions();
$loadOptions->setDefaultTextLanguage("en-US");
$pres = new Presentation($loadOptions);
try {
# Dodaje nowy prostokątny kształt z tekstem
$shp = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 150, 50);
$shp->getTextFrame()->setText("New Text");
# Sprawdza język pierwszej części
echo($shp->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->getLanguageId());
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Przykład na żywo
Wypróbuj aplikację online Aspose.Slides Metadata, aby zobaczyć, jak pracować z właściwościami dokumentu za pomocą API Aspose.Slides:
FAQ
Jak mogę usunąć wbudowaną właściwość z prezentacji?
Wbudowane właściwości są integralną częścią prezentacji i nie mogą być całkowicie usunięte. Można je jednak zmienić ich wartości lub ustawić na pustą, jeśli dana właściwość na to pozwala.
Co się stanie, jeśli dodam własną właściwość, która już istnieje?
Jeśli dodasz własną właściwość, która już istnieje, jej bieżąca wartość zostanie zastąpiona nową. Nie musisz usuwać ani sprawdzać właściwości wcześniej, ponieważ Aspose.Slides automatycznie aktualizuje wartość właściwości.
Czy mogę uzyskać dostęp do właściwości prezentacji bez pełnego wczytywania prezentacji?
Tak, możesz uzyskać dostęp do właściwości prezentacji bez pełnego wczytywania jej, używając metody getPresentationInfo z klasy PresentationFactory. Następnie użyj metody readDocumentProperties udostępnionej przez klasę PresentationInfo, aby efektywnie odczytać właściwości, oszczędzając pamięć i zwiększając wydajność.