Метод IFileSaveDialog::SetProperties (shobjidl_core.h)

Предоставляет хранилище свойств, которое определяет значения по умолчанию для сохраняемого элемента.

Синтаксис

HRESULT SetProperties(
  [in] IPropertyStore *pStore
);

Параметры

[in] pStore

Тип: IPropertyStore*

Указатель на интерфейс, представляющий хранилище свойств, содержащее связанные метаданные.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод можно вызвать в любое время перед открытием диалогового окна или во время его отображения. Если элементу присущи свойства, этот метод должен вызываться с этими свойствами перед отображением диалогового окна.

При использовании команды Сохранить как приложение должно предоставить свойства сохраняемого элемента в диалоговом окне Сохранить . Эти свойства должны быть извлечены из исходного элемента путем вызова GetPropertyStore с флагом GPS_HANDLERPROPERTIESONLY .

Чтобы получить свойства сохраненного элемента (который мог быть изменен пользователем) после закрытия диалогового окна, вызовите метод IFileSaveDialog::GetProperties.

Чтобы включить коллекцию свойств и указать, какие свойства должны отображаться в диалоговом окне Сохранить , используйте IFileSaveDialog::SetCollectedProperties.

Требования

См. также раздел

IFileSaveDialog

IFileSaveDialog::GetProperties

IFileSaveDialog::SetCollectedProperties