IFileSaveDialog::SetProperties method

Provides a property store that defines the default values to be used for the item being saved.

Syntax


HRESULT SetProperties(
  [in]  IPropertyStore *pStore
);

Parameters

pStore [in]

Type: IPropertyStore*

Pointer to the interface that represents the property store that contains the associated metadata.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method can be called at any time before the dialog is opened or while the dialog is showing. If an item has inherent properties, this method should be called with those properties before showing the dialog.

When using Save As, the application should provide the properites of the item being saved to the Save dialog. Those properties should be retreived from the original item by calling GetPropertyStore with the GPS_HANDLERPROPERTIESONLY flag.

To retrieve the properties of the saved item (which may have been modified by the user) after the dialog closes, call IFileSaveDialog::GetProperties.

To turn on property collection and indicate which properties should be displayed in the Save dialog, use IFileSaveDialog::SetCollectedProperties.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

See also

IFileSaveDialog
IFileSaveDialog::GetProperties
IFileSaveDialog::SetCollectedProperties

 

 

Community Additions

ADD
Show:
© 2014 Microsoft