PHP'de Sunum Görünüm Özelliklerini Al ve Güncelle
Giriş
Normal görünüm üç içerik bölgesinden oluşur: slayt kendisi, bir yan içerik bölgesi ve bir alt içerik bölgesi. Farklı içerik bölgelerinin konumlandırılmasıyla ilgili özellikler. Bu bilgi, uygulamanın görünüm durumunu dosyaya kaydetmesini sağlar, böylece yeniden açıldığında görünüm, sunum son kaydedildiği zamanki durumla aynı olur.
Sunumun normal görünüm özelliklerine erişim sağlamak için ViewProperties::getNormalViewProperties yöntemi eklenmiştir.
NormalViewProperties, NormalViewRestoredProperties sınıfları ve onun türevleri, SplitterBarStateType enumu eklendi.
INormalViewProperties Hakkında
Normal görünüm özelliklerini temsil eder.
getShowOutlineIcons ve setShowOutlineIcons yöntemleri, normal görünüm modunda içerik bölgelerinden birinde taslak içeriği görüntüleniyorsa uygulamanın simgeleri gösterip göstermeyeceğini belirler.
getSnapVerticalSplitter ve setSnapVerticalSplitter yöntemleri, yan bölge yeterince küçük olduğunda dikey bölücünün küçültülmüş bir duruma kilitlenip kilitlenmeyeceğini belirler.
getPreferSingleView ve setPreferSingleView özellikleri, kullanıcının üç içerik bölgesiyle standart normal görünüm yerine tam pencere tek içerik bölgesi görmeyi tercih edip etmediğini belirler. Etkinleştirilirse, uygulama içerik bölgelerinden birini tüm pencerede görüntülemeyi seçebilir.
getVerticalBarState ve getHorizontalBarState yöntemleri, yatay veya dikey bölücü çubuğunun gösterilmesi gereken durumu belirtir. Yatay bölücü çubuğu, slaytı slaytın altındaki içerik bölgesinden ayırırken, dikey bölücü çubuğu slaytı yan içerik bölgesinden ayırır. Olası değerler: SplitterBarStateType::Minimized, SplitterBarStateType::Maximized ve SplitterBarStateType::Restored.
getRestoredLeft ve getRestoredTop yöntemleri, normal görünümde üst veya yan slayt bölgesinin boyutlandırılmasını, SplitterBarStateType::Restored değerinin getVerticalBarState ve getHorizontalBarState için uygulanması durumunda belirtir.
INormalViewProperties Geri Yüklenmesi Hakkında
Normal görünümde bölge değişken bir geri yüklenmiş boyuta (ne küçültülmüş ne de genişletilmiş) sahip olduğunda, slayt bölgesinin (getRestoredTop altıysa genişlik, getRestoredLeft altıysa yükseklik) boyutlandırmasını belirtir.
getDimensionSize yöntemi, slayt bölgesinin (restoredTop altıysa genişlik, restoredLeft altıysa yükseklik) boyutunu belirtir.
getAutoAdjust yöntemi, uygulama içinde görünümü içeren pencere yeniden boyutlandırıldığında yan içerik bölgesinin boyutunun yeni boyuta göre ayarlanıp ayarlanmayacağını belirtir.
Aşağıda verilen örnek, bir sunum için ViewProperties::getNormalViewProperties özelliklerine nasıl erişileceğini gösterir.
$pres = new Presentation();
try {
$pres->getViewProperties()->getNormalViewProperties()->setHorizontalBarState(SplitterBarStateType::Restored);
$pres->getViewProperties()->getNormalViewProperties()->setVerticalBarState(SplitterBarStateType::Maximized);
# Sunumun görünüm özelliklerini geri yükle
$pres->getViewProperties()->getNormalViewProperties()->getRestoredTop()->setAutoAdjust(true);
$pres->getViewProperties()->getNormalViewProperties()->getRestoredTop()->setDimensionSize(80);
$pres->getViewProperties()->getNormalViewProperties()->setShowOutlineIcons(true);
$pres->save("presentation_normal_view_state.pptx", SaveFormat::Pptx);
} finally {
$pres->dispose();
}
Varsayılan Yakınlaştırma Değerini Ayarlama
Görünüm özelliklerini ayarlamak için aşağıdaki adımları izleyin:
- Presentation sınıfının bir örneğini oluşturun.
- Presentation için View Properties ayarlayın.
- Sunumu bir PPTX dosyası olarak yazın.
Aşağıda verilen örnekte, slayt görünümü ve not görünümü için yakınlaştırma değerini ayarladık.
$presentation = new Presentation();
try {
# Sunumun görünüm özelliklerini ayarlama
$presentation->getViewProperties()->getSlideViewProperties()->setScale(100); // Slayt görünümü için yüzde cinsinden yakınlaştırma değeri
$presentation->getViewProperties()->getNotesViewProperties()->setScale(100); // Not görünümü için yüzde cinsinden yakınlaştırma değeri
$presentation->save("Zoom_out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
SSS
Bir sunumun farklı bölümleri için farklı görünüm ayarları belirleyebilir miyim?
View settings sunum düzeyinde (Normal View/Slide View) tanımlanır, bölüm bazında değil; bu nedenle sunum açıldığında tüm belgeye tek bir parametre seti uygulanır.
Farklı kullanıcılar için farklı görünüm durumları önceden tanımlayabilir miyim?
Hayır. Ayarlar dosyada depolanır ve paylaşılır. Görüntüleyici uygulamalar kullanıcı tercihlerini dikkate alabilir, ancak dosya kendisi tek bir görünüm özelliği seti içerir.
Önceden tanımlanmış View Properties ile bir şablon hazırlayabilir miyim, böylece yeni sunumlar aynı şekilde açılır?
Evet. view properties sunum düzeyinde depolandığı için, bunları bir şablona gömebilir ve aynı başlangıç görünüm yapılandırmasıyla yeni belgeler oluşturabilirsiniz.