Робота з властивостями документа

Властивості документа дозволяють зберегти деяку корисну інформацію про ваш документ. Ці властивості можна розділити на дві групи:

  • Системні або вбудовані, що містять такі значення, як назва документа, ім’я автора, статистика документа та інші.
  • Визначені користувачем або призначені для користувача, що надаються у вигляді пар ім’я-значення, де користувач може визначити як ім’я, так і значення.

Корисно знати, що інформація про API та номер версії записується безпосередньо у вихідні документи. Наприклад, при перетворенні документа в PDF, Aspose.Words заповнює поле “додаток” значенням “Aspose.Words”, а поле “виробник PDF” - значенням “Aspose.Words для C++ YY.M. N”, де YY.M.N - це версія Aspose.Words, яка використовується для перетворення. Додаткові відомості див. в розділі Назва генератора або виробника, зазначена у вихідних документах.

Доступ до властивостей документа

Щоб отримати доступ до властивостей документа в Aspose.Words, використовуйте:

BuiltInDocumentProperties

BuiltInDocumentProperties

Клас DocumentProperty дозволяє отримати ім’я, значення і тип властивості документа. Value повертає об’єкт, але існує набір методів, які дозволяють перетворити значення властивості на певний тип. Після того, як ви дізнаєтесь, до якого типу належить властивість, ви можете скористатися одним із методів DocumentProperty.ToXXX, таких як DocumentProperty.ToString та DocumentProperty.ToInt, щоб отримати значення відповідного типу.

Наступний приклад коду показує, як перерахувати всі вбудовані та користувацькі властивості в документі:

У Microsoft Word ви можете отримати доступ до властивостей документа за допомогою меню “Файл → Властивості”.

work-with-document-properties-aspose-words-cpp_1.png

Додавання або видалення властивостей документа

Ви не можете додавати або видаляти вбудовані властивості документа за допомогою Aspose.Words. Ви можете лише змінювати або оновлювати їх значення.

Щоб додати власні властивості документа за допомогою Aspose.Words, використовуйте метод Add, передавши назву нової властивості та значення відповідного типу. Метод повертає щойно створений об’єкт DocumentProperty.

Щоб видалити власні властивості, використовуйте метод Remove, передавши йому ім’я властивості для видалення, або метод RemoveAt, щоб видалити властивість за індексом. Ви також можете видалити всі властивості, використовуючи метод Clear.

Наступний приклад коду перевіряє, чи існує в документі властивість користувача із заданим іменем, і додає ще кілька властивостей користувача документа:

Наступний приклад коду показує, як видалити властивість користувача документа:

Оновлення вбудованих властивостей документа

Aspose.Words не оновлює властивості документа автоматично, як це відбувається з деякими властивостями Microsoft Word, але надає метод оновлення деяких статистичних вбудованих властивостей документа. Викличте метод UpdateWordCount для перерахунку та оновлення наступних властивостей:

Створіть нову властивість користувача, пов’язану з вмістом

Aspose.Words надає метод AddLinkToContent для створення нового користувацького властивості документа, пов’язаного з вмістом. Ця властивість повертає щойно створений об’єкт властивостей або значення null, якщо значення LinkSource недійсне.

Наступний приклад коду показує, як налаштувати посилання на властивість користувача:

Отримання змінних документа

Ви можете отримати набір змінних документа, використовуючи властивість Variables. Імена та значення змінних є рядками.

Наступний приклад коду показує, як перераховувати змінні документа:

Видалити особисту інформацію з документа

Якщо ви хочете поділитися документом Word з іншими користувачами, Ви можете видалити особисту інформацію, таку як ім’я автора та компанія. Для цього використовуйте властивість RemovePersonalInformation, щоб встановити прапор, який вказує на те, що Microsoft Word видалить всю інформацію Користувача з коментарів, редагувань та властивостей документа під час збереження документа.

Наступний приклад коду показує, як видалити особисту інформацію:

Перетворення між одиницями виміру в C++