Prezentáció nézet tulajdonságainak lekérése és frissítése .NET‑ben
Bevezetés
A normál nézet három tartalomrégióból áll: a dia maga, egy oldalsó tartalomrégió, és egy alsó tartalomrégió. A különböző tartalomrégiók elhelyezésével kapcsolatos tulajdonságok. Ez az információ lehetővé teszi az alkalmazás számára, hogy elmentse a nézet állapotát a fájlba, így a megnyitáskor a nézet ugyanabban az állapotban lesz, mint amikor a bemutatót utoljára elmentették.
A IViewProperties.NormalViewProperties property hozzá lett adva, hogy hozzáférést biztosítson a bemutató normál nézet tulajdonságaihoz.
INormalViewProperties, INormalViewRestoredProperties interfészei és azok leszármazottai, valamint a SplitterBarStateType felsorolt enum hozzá lett adva.
Az INormalViewProperties leírása
A normál nézet tulajdonságait képviseli.
A ShowOutlineIcons property azt határozza meg, hogy az alkalmazás ikonokat jelenítsen-e meg, ha a körvonal tartalmat bármelyik tartalomrégióban a normál nézet módban jeleníti meg.
A SnapVerticalSplitter property azt határozza meg, hogy a függőleges elválasztó pálca minimalizált állapotba „csapódjon‑be”, ha az oldalsó régió elég kicsi.
A PreferSingleView property azt határozza meg, hogy a felhasználó inkább egy teljes ablakot kitöltő egyetlen tartalomrégiót szeretne-e a három tartalomrégiós szabványos normál nézet helyett. Ha engedélyezve van, az alkalmazás egy tartalomrégiót megjeleníthet az egész ablakban.
A VerticalBarState és HorizontalBarState propertyk azt az állapotot határozzák meg, amelyben a függőleges vagy vízszintes elválasztó pálcát meg kell jeleníteni. A vízszintes elválasztó pálca elválasztja a diát a dia alatti tartalomrégiótól, a függőleges elválasztó pálca elválasztja a diát az oldalsó tartalomrégiótól. Lehetséges értékek: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized és SplitterBarStateType.Restored.
A RestoredLeft és RestoredTop propertyk a normál nézet felső vagy oldalsó diarégiójának méretezését határozzák meg, amikor a VerticalBarState és HorizontalBarState megfelelően a SplitterBarStateType.Restored értéket kapja.
Az INormalViewProperties helyreállításáról
Meghatározza a diarégió (szélesség, ha a RestoredTop gyermekéről van szó, magasság, ha a RestoredLeft gyermekéről van szó) méretét a normál nézetben, amikor a régió változó, visszaállított méretű (sem minimalizált, sem maximalizált) állapotban van.
A DimensionSize property a diarégió méretét határozza meg (szélesség, ha a restoredTop gyermekéről van szó, magasság, ha a restoredLeft gyermekéről van szó).
A AutoAdjust property azt határozza meg, hogy az oldalsó tartalomrégió mérete kompenzálja‑e az új méretet, amikor a nézetet tartalmazó ablakot átméretezik az alkalmazásban.
Az alábbi példa bemutatja, hogyan érheti el a ViewProperties.NormalViewProperties propertyket egy bemutatóhoz.
using Aspose.Slides;
using Aspose.Slides.Export;
using (Presentation pres = new Presentation("demo.pptx"))
{
pres.ViewProperties.NormalViewProperties.HorizontalBarState = SplitterBarStateType.Restored;
pres.ViewProperties.NormalViewProperties.VerticalBarState = SplitterBarStateType.Maximized;
// Állítsa vissza a bemutató nézet tulajdonságait
pres.ViewProperties.NormalViewProperties.RestoredTop.AutoAdjust = true;
pres.ViewProperties.NormalViewProperties.RestoredTop.DimensionSize = 80;
pres.ViewProperties.NormalViewProperties.ShowOutlineIcons = true;
pres.Save("presentation_normal_view_state.pptx", SaveFormat.Pptx);
}
Az Alapértelmezett Nagyítási Szint Beállítása
Az Aspose.Slides for .NET most már támogatja az alapértelmezett nagyítási szint beállítását a bemutatóhoz, így a bemutató megnyitásakor a nagyítás már be van állítva. Ez a ViewProperties beállításával történhet meg egy bemutatónál. A dia nézet tulajdonságai, valamint a NotesViewProperties programozottan beállíthatók. Ebben a témában egy példán keresztül megmutatjuk, hogyan állítható be a Bemutató View tulajdonságai az Aspose.Slides‑ben.
A nézet tulajdonságainak beállításához kövesse az alábbi lépéseket:
- Hozzon létre egy példányt a Presentation osztályból
- Állítsa be a Bemutató Properties tulajdonságait
- Írja ki a bemutatót PPTX fájlként
Az alábbi példában beállítottuk a nagyítási értéket a dia nézethez és a jegyzet nézethez egyaránt.
using Aspose.Slides;
using Aspose.Slides.Export;
using (Presentation presentation = new Presentation("demo.pptx"))
{
// A bemutató nézet tulajdonságainak beállítása
presentation.ViewProperties.SlideViewProperties.Scale = 100; // Nagyítási érték százalékban a dia nézethez
presentation.ViewProperties.NotesViewProperties.Scale = 100; // Nagyítási érték százalékban a jegyzet nézethez
presentation.Save("Zoom_out.pptx", SaveFormat.Pptx);
}
Rács Távolság Beállítása
Használja a Presentation.ViewProperties elemet a bemutató szintű nézetbeállítások eléréséhez. Az IViewProperties.GridSpacing property az alapul szolgáló szerkesztő rács intervallumát olvassa vagy módosítja. Ez a beállítás az egész bemutatóra vonatkozik, nem egyedi diára. A rács távolság pontokban van megadva, ahol 72 pont egy hüvelyknek felel meg. Pozitív értéket használjon, ahogyan azt az API dokumentációja előírja.
Az alábbi példa megnyit egy meglévő demo.pptx fájlt, kiírja a jelenlegi rács távolságot, negyed hüvelykes intervallumra állítja, majd elmenti az eredményt.
using System;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("demo.pptx");
var gridSpacing = presentation.ViewProperties.GridSpacing;
Console.WriteLine($"Current grid spacing: {gridSpacing} points");
presentation.ViewProperties.GridSpacing = 18f;
presentation.Save("grid-spacing.pptx", SaveFormat.Pptx);
A rács különbözik a drawing guides-tól. A rács távolság szabályos intervallumot szabályoz, míg a rajzoló segédvonalak egyenként elhelyezett vízszintes vagy függőleges igazító vonalak. A segédvonalak hozzáadása, mozgatása vagy törlése nem változtatja meg a rács távolságát.
Mind a rács, mind a rajzoló segédvonalak szerkesztési segédeszközök. Nem jelennek meg diatartalomként PDF‑ben, képeken, SVG‑ben vagy diavetítésben. A rács távolság tárolása nem garantálja, hogy egy szerkesztő megjeleníti a rácsot: annak láthatósága a megjelenítő vagy szerkesztő beállításaitól is függ.
Kommentárok Megjelenítése vagy Elrejtése a Bemutató Megnyitásakor
Használja a Presentation.ViewProperties elemet a bemutató szintű nézetbeállítások eléréséhez. Olvassa vagy módosítsa az IViewProperties.ShowComments propertyt, hogy tárolja, a kommentárokat meg kell‑e jeleníteni, amikor a bemutató megnyílik a PowerPoint‑ban vagy egy másik kompatibilis szerkesztőben.
Ez a beállítás csak a tárolt nézetpreferenciát szabályozza. Nem ad hozzá, nem távolít el, nem szerkeszt és nem old meg kommentárokat. A kommentárok elrejtése megőrzi azok tartalmát, szerzőit, pozícióit, válaszait és állapotát. Lásd a Presentation Comments oldalt a kommentárok magukon végzett műveletekhez.
Az alábbi példához egy meglévő comments.pptx fájlra van szükség, amely tartalmaz kommentárokat. Kiírja a jelenlegi láthatósági beállítást, kéri a kommentárok elrejtését, és ment egy új PPTX‑et anélkül, hogy bármely kommentárt eltávolítana. Emellett beállítja az IViewProperties.LastView propertyt a ViewType.SlideView értékre, hogy az első szerkesztői nézetet a kommentár láthatóságával együtt konfigurálja.
using System;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("comments.pptx");
var showComments = presentation.ViewProperties.ShowComments;
Console.WriteLine($"Current comment visibility: {showComments}");
presentation.ViewProperties.ShowComments = NullableBool.False;
presentation.ViewProperties.LastView = ViewType.SlideView;
presentation.Save("comments-hidden.pptx", SaveFormat.Pptx);
Ez a beállítás nem határozza meg, hogy a kommentárok szerepelnek‑e a PDF, HTML, kép, jegyzet vagy szórólap exportokban. A megfelelő export‑specifikus beállításokat külön kell konfigurálni.
GYIK
Miért nem látható a rács a bemutató újranyitása után?
A fájl tárolja a rács távolságát, de a szerkesztő dönt arról, hogy a rács megjelenik‑e. Ellenőrizze a szerkesztő rács‑láthatósági beállításait.
A rajzoló segédvonalak törlése megváltoztatja‑e a rács távolságát?
Nem. A rajzoló segédvonalak és a rács távolság független beállítások. A segédvonalak törlése nem módosítja a tárolt rács intervallumot.
Beállíthatok‑e különböző nézetbeállításokat a bemutató különböző szakaszaihoz?
A nézetbeállítások a bemutató szintjén vannak definiálva (Normál nézet / Dia nézet), nem szakaszonként, ezért egyetlen paraméterkészlet vonatkozik a teljes dokumentumra a megnyitáskor.
Előre meghatározhatok‑e különböző nézetállapotokat különböző felhasználóknak?
Nem. A beállítások a fájlban vannak tárolva, és megosztottak. A megjelenítő alkalmazások tiszteletben tarthatják a felhasználói preferenciákat, de a fájl maga csak egy nézet‑tulajdonság‑készletet tartalmaz.
Létrehozhatok‑e sablont előre definiált View Property‑kkel, hogy az új bemutatók ugyanúgy nyíljanak meg?
Igen. Mivel a view property‑k a bemutató szintjén vannak tárolva, beágyazhatja őket egy sablonba, és új dokumentumok létrehozásakor ugyanazzal a kezdeti nézet‑konfigurációval indulnak.