مدیریت ویژگیهای ارائه در جاوا
مقدمه
Aspose.Slides دو نوع ویژگی سند را پشتیبانی میکند: Built-in و Custom. هر دو نوع این ویژگیها را میتوان به سادگی با استفاده از API Aspose.Slides دسترسی یافت و مدیریت کرد.
Aspose.Slides به شما امکان میدهد تا با ویژگیهای سند ارائه از طریق اینترفیس IDocumentProperties کار کنید. یک نمونه از این اینترفیس توسط متد Presentation.getDocumentProperties برگردانده میشود. مثالهای زیر نشان میدهند چگونه این ویژگیها را بخوانید، تغییر دهید و مدیریت کنید.
ویژگیهای سند در PowerPoint
Microsoft PowerPoint 2007 امکان مدیریت ویژگیهای سند فایلهای ارائه را فراهم میکند. تنها کاری که باید انجام دهید کلیک بر روی آیکون Office و سپس گزینه Prepare | Properties | Advanced Properties در منوی Microsoft PowerPoint 2007 همانطور که در زیر نشان داده شده است:
| انتخاب گزینه Advanced Properties | ** |
|---|---|
 |
|
| پس از انتخاب گزینه Advanced Properties، دیالوگی ظاهر میشود که امکان مدیریت ویژگیهای سند فایل PowerPoint را همانطور که در شکل زیر میبینید، فراهم میکند: |
| دیالوگ ویژگیها | ** |
|---|---|
 |
|
| در دیالوگ ویژگیها بالا، میتوانید ببینید که صفحات تب متعددی مانند General, Summary, Statistics, Contents و Custom وجود دارد. همه این صفحات تب اجازه پیکربندی انواع مختلف اطلاعات مرتبط با فایلهای PowerPoint را میدهند. تب Custom برای مدیریت ویژگیهای سفارشی فایلهای PowerPoint استفاده میشود. |
کار با ویژگیهای سند با استفاده از Aspose.Slides برای Java
همانطور که پیشتر توضیح دادیم Aspose.Slides برای Java دو نوع ویژگی سند را پشتیبانی میکند: ویژگیهای Built-in و Custom. بنابراین توسعهدهندگان میتوانند با استفاده از API Aspose.Slides برای Java به هر دو نوع دسترسی پیدا کنند. Aspose.Slides برای Java کلاسی به نام IDocumentProperties فراهم میکند که ویژگیهای سند مربوط به یک فایل ارائه را از طریق ویژگی Presentation.DocumentProperties نمایان میسازد.
توسعهدهندگان میتوانند از ویژگی IDocumentProperties که توسط شیء Presentation در دسترس قرار میگیرد، برای دسترسی به ویژگیهای سند فایلهای ارائه همانطور که در زیر توضیح داده شده است، استفاده کنند:
دسترسی به ویژگیهای Built-in
این ویژگیها که توسط شیء IDocumentProperties در دسترس هستند شامل: Creator (نویسنده)، Description, Keywords, Created (تاریخ ایجاد)، Modified (تاریخ تغییر)، Printed (تاریخ آخرین چاپ)، LastModifiedBy, SharedDoc (آیا بین تولیدکنندگان مختلف بهاشتراکگذاری شده است؟)، PresentationFormat, Subject و Title میشوند.
// ایجاد نمونهای از کلاس Presentation که نمایانگر ارائه است
Presentation pres = new Presentation("Presentation.pptx");
try {
// ایجاد مرجع به شیء IDocumentProperties مرتبط با Presentation
IDocumentProperties dp = pres.getDocumentProperties();
// نمایش ویژگیهای داخلی
System.out.println("Category : " + dp.getCategory());
System.out.println("Current Status : " + dp.getContentStatus());
System.out.println("Creation Date : " + dp.getCreatedTime());
System.out.println("Author : " + dp.getAuthor());
System.out.println("Description : " + dp.getComments());
System.out.println("KeyWords : " + dp.getKeywords());
System.out.println("Last Modified By : " + dp.getLastSavedBy());
System.out.println("Supervisor : " + dp.getManager());
System.out.println("Modified Date : " + dp.getLastSavedTime());
System.out.println("Presentation Format : " + dp.getPresentationFormat());
System.out.println("Last Print Date : " + dp.getLastPrinted());
System.out.println("Is Shared between producers : " + dp.getSharedDoc());
System.out.println("Subject : " + dp.getSubject());
System.out.println("Title : " + dp.getTitle());
} finally {
if (pres != null) pres.dispose();
}
تغییر ویژگیهای Built-in
تغییر ویژگیهای ساختهشدهٔ فایلهای ارائه به آسانی دسترسی به آنها است. میتوانید به سادگی یک مقدار رشتهای به هر ویژگی دلخواه اختصاص دهید و مقدار ویژگی تغییر خواهد کرد. در مثال زیر نشان داده شده است که چگونه میتوان ویژگیهای سند ساختهشدهٔ یک فایل ارائه را با استفاده از Aspose.Slides برای Java تغییر داد.
Presentation pres = new Presentation("Presentation.pptx");
try {
// ایجاد مرجعی به شیء IDocumentProperties مرتبط با Presentation
IDocumentProperties dp = pres.getDocumentProperties();
// تنظیم ویژگیهای داخلی
dp.setAuthor("Aspose.Slides for Java");
dp.setTitle("Modifying Presentation Properties");
dp.setSubject("Aspose Subject");
dp.setComments("Aspose Description");
dp.setManager("Aspose Manager");
// ذخیرهٔ ارائه شما در یک فایل
pres.save("DocProps.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
این مثال ویژگیهای ساختهشدهٔ ارائه را که میتواند همانطور که در زیر نشان داده شده است، مشاهده کنید، تغییر میدهد:
| ویژگیهای سند Built-in پس از تغییر | ** |
|---|---|
 |
افزودن ویژگیهای سفارشی سند
Aspose.Slides برای Java همچنین به توسعهدهندگان اجازه میدهد مقادیر سفارشی برای ویژگیهای سند ارائه اضافه کنند. مثالی در زیر نشان میدهد چگونه میتوانید ویژگیهای سفارشی برای یک ارائه تنظیم کنید.
Presentation pres = new Presentation();
try {
// دریافت ویژگیهای سند
IDocumentProperties dProps = pres.getDocumentProperties();
// افزودن ویژگیهای سفارشی
dProps.set_Item("New Custom", 12);
dProps.set_Item("My Name", "Mudassir");
dProps.set_Item("Custom", 124);
// دریافت نام ویژگی در اندیس خاص
String getPropertyName = dProps.getCustomPropertyName(2);
// حذف ویژگی انتخابشده
dProps.removeCustomProperty(getPropertyName);
// ذخیرهٔ ارائه
pres.save("CustomDemo.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
| ویژگیهای سفارشی سند اضافه شده | ** |
|---|---|
 |
دسترسی و تغییر ویژگیهای سفارشی
Aspose.Slides برای Java همچنین به توسعهدهندگان اجازه میدهد به مقادیر ویژگیهای سفارشی دسترسی پیدا کنند. مثالی در زیر نشان میدهد چگونه میتوانید تمام این ویژگیهای سفارشی برای یک ارائه را دسترسی پیدا کنید و تغییر دهید.
Presentation pres = new Presentation("Presentation.pptx");
try {
// ایجاد مرجع به شیء DocumentProperties مرتبط با Presentation
IDocumentProperties dp = pres.getDocumentProperties();
// دسترسی و تغییر ویژگیهای سفارشی
for (int i = 0; i < dp.getCountOfCustomProperties(); i++) {
// نمایش نامها و مقادیر ویژگیهای سفارشی
System.out.println("Custom Property Name : " + dp.getCustomPropertyName(i));
System.out.println("Custom Property Value : " + dp.get_Item(dp.getCustomPropertyName(i)));
// تغییر مقادیر ویژگیهای سفارشی
dp.set_Item(dp.getCustomPropertyName(i), "New Value " + (i + 1));
}
// ذخیرهٔ ارائه شما در یک فایل
pres.save("CustomDemoModified.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
این مثال ویژگیهای سفارشی ارائهٔ PPTX را تغییر میدهد. شکلهای زیر ویژگیهای سفارشی ارائه را قبل و بعد از تغییر نشان میدهند:
| ویژگیهای سفارشی قبل از تغییر | ** |
|---|---|
 |
| ویژگیهای سفارشی پس از تغییر | ** |
|---|---|
 |
ویژگیهای پیشرفته سند
دو متد جدید ReadDocumentProperties و UpdateDocumentProperties به اینترفیس IPresentationInfo اضافه شدهاند. این متدها دسترسی سریع به ویژگیهای سند را فراهم میکنند و امکان تغییر و بهروزرسانی ویژگیها بدون بارگذاری کل ارائه را میدهند.
سناریوی معمول بارگذاری ویژگیها، تغییر مقدار و بهروزرسانی سند میتواند به شکل زیر پیادهسازی شود:
// خواندن اطلاعات ارائه
IPresentationInfo info = PresentationFactory.getInstance().getPresentationInfo("presentation.pptx");
// obtain the current properties
IDocumentProperties props = info.readDocumentProperties();
// set the new values of Author and Title fields
props.setAuthor("New Author");
props.setTitle("New Title");
// update the presentation with a new values
info.updateDocumentProperties(props);
info.writeBindedPresentation("presentation.pptx");
راه دیگری نیز وجود دارد که میتوان از ویژگیهای یک ارائهٔ خاص بهعنوان قالب برای بهروزرسانی ویژگیها در ارائههای دیگر استفاده کرد:
IPresentationInfo info = PresentationFactory.getInstance().getPresentationInfo("template.pptx");
DocumentProperties template = (DocumentProperties) 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);
private static void updateByTemplate(String path, IDocumentProperties template)
{
IPresentationInfo toUpdate = PresentationFactory.getInstance().getPresentationInfo(path);
toUpdate.updateDocumentProperties(template);
toUpdate.writeBindedPresentation(path);
}
یک قالب جدید میتواند از ابتدا ایجاد شده و سپس برای بهروزرسانی چندین ارائه استفاده شود:
DocumentProperties 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);
private static void updateByTemplate(String path, IDocumentProperties template)
{
IPresentationInfo toUpdate = PresentationFactory.getInstance().getPresentationInfo(path);
toUpdate.updateDocumentProperties(template);
toUpdate.writeBindedPresentation(path);
}
تنظیم زبان تصحیح
Aspose.Slides ویژگی LanguageId (که توسط کلاس PortionFormat افشا میشود) را فراهم میکند تا به شما اجازه دهد زبان تصحیح را برای یک سند PowerPoint تنظیم کنید. زبان تصحیح زبانی است که املا و دستور زبان در PowerPoint برای آن بررسی میشود.
این کد Java نشان میدهد چگونه زبان تصحیح برای یک PowerPoint تنظیم شود: xxx چرا LanguageId در کلاس Java PortionFormat وجود ندارد؟
Presentation pres = new Presentation(pptxFileName);
try {
AutoShape autoShape = (AutoShape)pres.getSlides().get_Item(0).getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getPortions().clear();
Portion newPortion = new Portion();
IFontData font = new FontData("SimSun");
IPortionFormat portionFormat = newPortion.getPortionFormat();
portionFormat.setComplexScriptFont(font);
portionFormat.setEastAsianFont(font);
portionFormat.setLatinFont(font);
portionFormat.setLanguageId("zh-CN"); // تنظیم شناسه زبان تصحیح
newPortion.setText("1。");
paragraph.getPortions().add(newPortion);
} finally {
if (pres != null) pres.dispose();
}
تنظیم زبان پیشفرض
این کد Java نشان میدهد چگونه میتوانید زبان پیشفرض را برای تمام ارائهٔ PowerPoint تنظیم کنید:
LoadOptions loadOptions = new LoadOptions();
loadOptions.setDefaultTextLanguage("en-US");
Presentation pres = new Presentation(loadOptions);
try {
// یک شکل مستطیل جدید با متن اضافه میکند
IAutoShape shp = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 50);
shp.getTextFrame().setText("New Text");
// زبان اولین بخش را بررسی میکند
System.out.println(shp.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat().getLanguageId());
} finally {
if (pres != null) pres.dispose();
}
مثال زنده
سعی کنید برنامهٔ آنلاین Aspose.Slides Metadata را امتحان کنید تا ببینید چگونه میتوان با ویژگیهای سند از طریق API Aspose.Slides کار کرد:
*سوالات متداول
چگونه میتوان یک ویژگی Built-in را از یک ارائه حذف کرد؟
ویژگیهای Built-in جزئی اساسی از ارائه هستند و نمیتوان آنها را بهطور کامل حذف کرد. با این حال میتوانید مقادیر آنها را تغییر دهید یا در صورت اجازه ویژگی خاص، به مقدار خالی تنظیم کنید.
اگر یک ویژگی سفارشی که از قبل وجود دارد را اضافه کنم چه اتفاقی میافتد؟
اگر یک ویژگی سفارشی که قبلاً وجود دارد را اضافه کنید، مقدار موجود آن با مقدار جدید بازنویسی میشود. نیازی به حذف یا بررسی قبلی ویژگی ندارید، زیرا Aspose.Slides بهصورت خودکار مقدار ویژگی را بهروز میکند.
آیا میتوان ویژگیهای ارائه را بدون بارگذاری کامل ارائه دسترسی پیدا کرد؟
بله، میتوانید بدون بارگذاری کامل ارائه با استفاده از متد getPresentationInfo از کلاس PresentationFactory به ویژگیهای ارائه دسترسی پیدا کنید. سپس با بهرهگیری از متد readDocumentProperties ارائهشده توسط اینترفیس IPresentationInfo میتوانید ویژگیها را بهصورت مؤثر بخوانید و حافظه مصرفی و عملکرد را بهبود بخشید.