PHP'de Sunum Üst Bilgi ve Alt Bilgileri Yönetme
Genel Bakış
PowerPoint, sayfa türüne bağlı olarak farklı üst bilgi ve alt bilgi tutamacı (placeholder) kullanır. Aspose.Slides for PHP via Java, bu tutamacıların metnini ve görünürlüğünü üst bilgi/alt bilgi yöneticisi sınıfları aracılığıyla kontrol etmenizi sağlar.
| Kapsam | Üst Bilgi | Alt Bilgi | Tarih/Zaman | Slayt/Sayfa Numarası |
|---|---|---|---|---|
| Normal slayt | Hayır | Evet | Evet | Evet |
| Notlar ana taslağı | Evet | Evet | Evet | Evet |
| Not slaytı | Evet | Evet | Evet | Evet |
| Dağıtım ana taslağı | Evet | Evet | Evet | Evet |
Normal bir sunum slaytının üst bilgi tutamacı yoktur. Üst bilgiler not sayfalarında ve dağıtımlarda bulunur. Normal slaytlar için alt bilgi, tarih/zaman ve slayt numarası tutamacı kullanılmalıdır.
Bir değişikliğin kapsamı kullandığınız yöneticisine bağlıdır. SlideHeaderFooterManager sınıfı tek bir normal slaytı kontrol eder. NotesSlideHeaderFooterManager sınıfı tek bir not slaytını kontrol eder. Ana taslak ve düzen yöneticileri ayarları bağımlı slaytlara da yayabilir, MasterHandoutSlideHeaderFooterManager sınıfı ise dağıtım ana taslağını kontrol eder.
Normal Slaytlarda Alt Bilgi, Tarih/Zaman ve Slayt Numaralarını Ayarlama
Normal slaytlar için temel iş akışı, her slaytın üst bilgi/alt bilgi yöneticisine erişmek, alt bilgi ve tarih/zaman metnini ayarlamak, gerekli tutamacı etkinleştirmek ve sunumu kaydetmektir. Slayt numaraları sunum tarafından oluşturulur, bu yüzden yalnızca görünürlüklerini kontrol etmeniz yeterlidir.
setFooterText ve setDateTimeText ile metin ayarlayın, setFooterVisibility, setDateTimeVisibility ve setSlideNumberVisibility ile ilgili tutamacı gösterin.
Aşağıdaki uçtan uca örnek, aynı alt bilgi, tarih/zaman metni ve slayt numarası görünürlüğünü tüm normal slaytlara uygular:
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("presentation.pptx");
try {
foreach ($presentation->getSlides() as $slide) {
$headerFooterManager = $slide->getHeaderFooterManager();
$headerFooterManager->setFooterText("Company Confidential");
$headerFooterManager->setFooterVisibility(true);
$headerFooterManager->setDateTimeText("Date and time text");
$headerFooterManager->setDateTimeVisibility(true);
$headerFooterManager->setSlideNumberVisibility(true);
}
$presentation->save("presentation_with_slide_footers.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Yalnızca bir slaytı güncellemeniz gerekiyorsa, tüm koleksiyonu döngüyle gezmek yerine getSlides yöntemini kullanarak o slayta doğrudan erişin.
Notlar Ana Taslağında Üst Bilgi ve Alt Bilgi Ayarlama
Notlar ana taslağı, not sayfaları için ortak biçimlendirme ve tutamacı davranışlarını tanımlar. Sadece notlar ana taslağını değiştirmek istediğinizde MasterNotesSlideHeaderFooterManager sınıfını kullanın.
Aşağıdaki örnek, notlar ana taslağında üst bilgi, alt bilgi ve tarih/zaman metnini ayarlar ve o ana taslaktaki tüm desteklenen tutamacı görünür hâle getirir:
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("presentation.pptx");
try {
$masterNotesSlide = $presentation->getMasterNotesSlideManager()->getMasterNotesSlide();
if (!java_is_null($masterNotesSlide)) {
$headerFooterManager = $masterNotesSlide->getHeaderFooterManager();
$headerFooterManager->setHeaderText("Notes header");
$headerFooterManager->setHeaderVisibility(true);
$headerFooterManager->setFooterText("Notes footer");
$headerFooterManager->setFooterVisibility(true);
$headerFooterManager->setDateTimeText("Date and time text");
$headerFooterManager->setDateTimeVisibility(true);
$headerFooterManager->setSlideNumberVisibility(true);
}
$presentation->save("presentation_with_notes_master_footers.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
getMasterNotesSlide yöntemi, sunumda bir notlar ana taslağı bulunmadığında null döndürür.
Notlar Ana Taslağı Ayarlarını Çocuk Not Slaytlarına Uygulama
Bir notlar ana taslağı, üst bilgi ve alt bilgi ayarlarını kendisine ve tüm bağımlı not slaytlarına uygulayabilir. Aynı ayarların notlar hiyerarşisi boyunca uygulanması gerektiğinde MasterNotesSlideHeaderFooterManager üzerindeki özel yayma yöntemlerini kullanın.
Örneğin, setHeaderAndChildHeadersText ve setHeaderAndChildHeadersVisibility notlar ana taslağı üst bilgisini ve tüm çocuk üst bilgilerini günceller. Alt bilgiler, tarih/zaman ve slayt numaraları için eşdeğer yöntemler mevcuttur.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("presentation.pptx");
try {
$masterNotesSlide = $presentation->getMasterNotesSlideManager()->getMasterNotesSlide();
if (!java_is_null($masterNotesSlide)) {
$headerFooterManager = $masterNotesSlide->getHeaderFooterManager();
$headerFooterManager->setHeaderAndChildHeadersText("Notes header");
$headerFooterManager->setHeaderAndChildHeadersVisibility(true);
$headerFooterManager->setFooterAndChildFootersText("Notes footer");
$headerFooterManager->setFooterAndChildFootersVisibility(true);
$headerFooterManager->setDateTimeAndChildDateTimesText("Date and time text");
$headerFooterManager->setDateTimeAndChildDateTimesVisibility(true);
$headerFooterManager->setSlideNumberAndChildSlideNumbersVisibility(true);
}
$presentation->save("presentation_with_child_notes_footers.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Yukarıda kullanılan yayma yöntemleri şunlardır: setFooterAndChildFootersText, setFooterAndChildFootersVisibility, setDateTimeAndChildDateTimesText, setDateTimeAndChildDateTimesVisibility, ve setSlideNumberAndChildSlideNumbersVisibility.
Bireysel Not Slaytında Üst Bilgi ve Alt Bilgi Ayarlama
Bir not slaytı, belirli bir normal slayta aittir. Sadece o not sayfasını özelleştirmek istediğinizde NotesSlideHeaderFooterManager sınıfını kullanın.
addNotesSlide yöntemi, geçerli slayt için not slaytını döndürür ve henüz mevcut değilse bir tane oluşturur. Aşağıdaki örnek, ilk sunum slaytıyla ilişkili not sayfasını yapılandırır:
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("presentation.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$notesSlide = $slide->getNotesSlideManager()->addNotesSlide();
$headerFooterManager = $notesSlide->getHeaderFooterManager();
$headerFooterManager->setHeaderText("Header for the first notes page");
$headerFooterManager->setHeaderVisibility(true);
$headerFooterManager->setFooterText("Footer for the first notes page");
$headerFooterManager->setFooterVisibility(true);
$headerFooterManager->setDateTimeText("Date and time text");
$headerFooterManager->setDateTimeVisibility(true);
$headerFooterManager->setSlideNumberVisibility(true);
$presentation->save("presentation_with_custom_notes_footers.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Önce notlar ana taslağından ayarları yayar, ardından bireysel bir not slaytını değiştirirseniz, sonraki slayt‑başına‑başına ayarlar o not sayfasını bağımsız olarak özelleştirmenizi sağlar.
Dağıtım Ana Taslağında Üst Bilgi ve Alt Bilgi Ayarlama
Dağıtım sayfaları, üst bilgi, alt bilgi, tarih/zaman ve sayfa numarası tutamacı için dağıtım ana taslağını kullanır. Not sayfalarından farklı olarak, dağıtım ayarları bireysel dağıtım slaytları yerine dağıtım ana taslağı üzerinden yönetilir.
getMasterHandoutSlide yöntemi ile dağıtım ana taslağına erişin. Mevcut değilse, varsayılan dağıtım ana taslağını oluşturmak için setDefaultMasterHandoutSlide metodunu çağırın.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("presentation.pptx");
try {
$masterHandoutSlide = $presentation->getMasterHandoutSlideManager()->getMasterHandoutSlide();
if (java_is_null($masterHandoutSlide)) {
$masterHandoutSlide = $presentation->getMasterHandoutSlideManager()->setDefaultMasterHandoutSlide();
}
if (!java_is_null($masterHandoutSlide)) {
$headerFooterManager = $masterHandoutSlide->getHeaderFooterManager();
$headerFooterManager->setHeaderText("Handout header");
$headerFooterManager->setHeaderVisibility(true);
$headerFooterManager->setFooterText("Handout footer");
$headerFooterManager->setFooterVisibility(true);
$headerFooterManager->setDateTimeText("Date and time text");
$headerFooterManager->setDateTimeVisibility(true);
$headerFooterManager->setSlideNumberVisibility(true);
}
$presentation->save("presentation_with_handout_footers.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Kapsam ve Kalıtımı Anlamak
Değiştirmek istediğiniz kapsamla eşleşen üst bilgi/alt bilgi yöneticisini seçin:
SlideHeaderFooterManagerbir normal slayt için alt bilgi, tarih/zaman ve slayt numarası ayarlarını değiştirir.LayoutSlideHeaderFooterManagerbir düzen slaytını kontrol eder ve desteklenen ayarları bağımlı slaytlara yayabilir.MasterSlideHeaderFooterManagerbir normal slayt ana taslağını kontrol eder ve desteklenen ayarları bağımlı slaytlara yayabilir.MasterNotesSlideHeaderFooterManagernotlar ana taslağını kontrol eder ve tüm bağımlı not slaytlarına ayarları yayabilir.NotesSlideHeaderFooterManagerbir not slaytını değiştirir ve üst bilgi tutamacını, alt bilgi, tarih/zaman ve slayt numarasını destekler.MasterHandoutSlideHeaderFooterManagerdağıtım ana taslağını değiştirir ve dört tutamacı da destekler.
Aynı ayarın hiyerarşinin tamamında uygulanması gerektiğinde bir ana taslak veya düzen üzerinden yayma kullanın. Tek bir sayfa için yerel bir ayar gerektiğinde bireysel slayt veya not‑slayt yöneticisini kullanın.
SSS
Normal bir slayta üst bilgi ekleyebilir miyim?
Hayır. PowerPoint, normal slaytlar için bir üst bilgi tutamacı tanımlamaz. Normal slaytlarda alt bilgi, tarih/zaman ve slayt‑numarası tutamacı kullanılmalıdır. Üst bilgi tutamacı not sayfalarında ve dağıtımlarda mevcuttur.
Bir alt bilgi, tarih/zaman veya slayt‑numarası tutamacı görünür değilse ne yapmalıyım?
İlgili üst bilgi/alt bilgi yöneticisini kullanarak görünürlüğünü kontrol edin ve gerektiğinde etkinleştirin. Örneğin, isFooterVisible bir alt bilgi tutamacının mevcut olup olmadığını bildirir, setFooterVisibility ise görünürlüğünü değiştirir.
Slayt numaralandırmasını 1 yerine farklı bir değerden başlatabilir miyim?
Sunumun setFirstSlideNumber metodunu çağırın. Slayt‑numarası tutamacı daha sonra güncellenen numaralandırma sırasını kullanır.
PDF, görüntüler veya HTML olarak dışa aktarırken üst bilgi ve alt bilgi ne olur?
Görünür üst bilgi ve alt bilgi öğeleri, çıktının formatında sunum içeriğiyle birlikte işlenir. Görünüm, dışa aktarılan sayfa tipine ve ilgili tutamacı görünürlük ayarlarına bağlıdır.